View Source on GitHub

Need help? Have a suggestion, comment, or problem? Join the Discord server.

A Discord bot for managing small party voting systems such as a council or small group who want to deliberate on matters democratically. Contributions and suggestions are welcome.

Looking for a bot that provides quick on-the-fly poll-based votes to your entire community? Check out Poll Dancer

These commands can only be run by someone with the Manage Server permission, or with a role named Votum Admin.

Motion options are special flags you can put at the beginning of your motion to change options about the motion. Right now, the only options available are for changing the majority type.

To start a motion with 2/3rd majority, you could use the commands (all are equivalent):

• !motion -m 2/3 Motion text goes here
• !motion --majority 2/3 Motion text goes here
• !motion --majority 66% Motion text goes here

Unanimous motion (all are equivalent):

• !motion -u Motion text goes here
• !motion --unanimous Motion text goes here
• !motion -m 100% Motion text goes here
• !motion -m 1/1 Motion text goes here

• Multiple councils can be defined in one Discord server, as the councils are based on channels.
• Upon a tie, the motion will remain forever until someone breaks the tie.
• The councilor cooldown is not triggered if the motion is killed.
• When a motion expires, the outcome is determined by majority votes. If there are more "yes" than "no" votes, it will pass, and vice-versa.
• If you do not set a Councilor role, the total number of voters is determined by who can see the channel. It's recommended that you set a role for councilors so that you can be sure that only possible voters count towards the total number needed for majority.
• Server admins (or people with a role called Votum Admin) can always create motions.

1. Pick a channel that your councilors will deliberate in.
2. Run !Council My Council to mark this channel as a council. (Change "My Council" to whatever you want it to be named.)
3. Create a role for the members of your council and give it to your voters. Then, run !config councilor.role RoleNameHere.
4. Run !motion This is my first motion. You're all done! Check out the other configuration options above for more advanced use.

With the on.finish.actions configuration point, you can supply custom JSON configuration that tells Votum what to do with your motion once it resolves. Most prominently, you can forward your motion into other councils (based on the majority type) with potentially different options. Use this link to be taken to a form where you can generate a valid JSON configuration for this option. The actions have these fields:

With the vote.weights configuration point, you can supply a JSON mapping between User and Role IDs to the amounts of votes that they will cast. If a councilor has more than one of the roles, their votes will be added together.

The provided JSON should be an object which has role/user ID string keys mapped to numerical values. For example, this is a valid mapping:

{
  "113691352327389188": 5,
  "400057282752151565": 2,
  "601529861244321793": 4,
  "401864080446717952": 8
}

To learn how to get the user and role IDs, check out this help article.