Village Vote Commands Documentation

Overview

This bot provides seven commands for creating and managing votes in your Discord server:

Moderator only: every command on this page requires the server's configured moderator role.

Every active vote also has a Manage page (the ⚙️ Manage button on the vote embed) for changing settings mid-vote, adding or removing voters and options, and setting the per-player vote modifiers: weights and pawns. See Vote Modifiers.

Vote Commands

/vote, /anonvote, /itemvote and /anonitemvote share the same argument structure, but behave differently based on the command used. /denvote has its own smaller set of options, described in its own section.

Option names are typed exactly as Discord shows them, all lowercase (for example hidevotelog:True, not hideVoteLog:True).

Core Arguments

┌──────────┬────────┬─────────────────────────────────────────────────────────┐
│ Argument │ Type   │ Description                                             │
├──────────┼────────┼─────────────────────────────────────────────────────────┤
│ votetime │ String │ When the vote should end                                │
│ votecount│ String │ Number of vote slots (1-4, default 1)                   │
│ voterole │ Role   │ Discord role that determines who can participate        │
└──────────┴────────┴─────────────────────────────────────────────────────────┘

Note: votetime and voterole must come from somewhere: either typed on the command or saved with /votedefaults set. The command refuses with a pointer to /votedefaults when neither is available. votecount falls back to 1.

Optional Arguments

┌────────────────────┬─────────┬───────────────────────────────────────────────┬─────────┐
│ Argument           │ Type    │ Description                                   │ Default │
├────────────────────┼─────────┼───────────────────────────────────────────────┼─────────┤
│ modrole            │ Role    │ Moderators for the game; excluded from voting │ None    │
│ votetitle          │ String  │ Custom title for the vote (max 80 characters) │ Empty   │
│ hidevotelog        │ Boolean │ Hide the vote log showing who voted           │ False   │
│ showanonvotetotals │ Boolean │ Show vote totals after anonymous voting       │ False   │
│ allowabstainvote   │ Boolean │ Allow voters to abstain                       │ False   │
│ closeonmajority    │ Boolean │ Close the vote when a majority is reached     │ False   │
│ closewhenvotesreach│ Integer │ Override the majority threshold (needs        │ None    │
│                    │         │ closeonmajority)                              │         │
│ allowselfvoting    │ Boolean │ Allow voters to vote for themselves           │ False   │
│ announcechannel    │ Channel │ Channel to monitor for votes cast in chat     │ None    │
│ votehotword        │ String  │ Custom word replacing !vote in announce chat  │ !vote   │
│ randomizeoptions   │ Boolean │ Randomize the display order of vote options   │ False   │
└────────────────────┴─────────┴───────────────────────────────────────────────┴─────────┘

Not every option exists on every command:

┌────────────────────┬───────┬───────────┬───────────┬───────────────┐
│ Argument           │ /vote │ /anonvote │ /itemvote │ /anonitemvote │
├────────────────────┼───────┼───────────┼───────────┼───────────────┤
│ modrole            │  ✅   │    ✅     │    ✅     │      ✅       │
│ votetitle          │  ✅   │    ✅     │    ✅     │      ✅       │
│ hidevotelog        │  ✅   │    –      │    ✅     │      –        │
│ showanonvotetotals │  –    │    ✅     │    –      │      ✅       │
│ allowabstainvote   │  ✅   │    ✅     │    ✅     │      ✅       │
│ closeonmajority    │  ✅   │    ✅     │    ✅     │      ✅       │
│ closewhenvotesreach│  ✅   │    ✅     │    ✅     │      ✅       │
│ allowselfvoting    │  ✅   │    ✅     │    –      │      –        │
│ announcechannel    │  ✅   │    ✅     │    –      │      –        │
│ votehotword        │  ✅   │    ✅     │    –      │      –        │
│ randomizeoptions   │  ✅   │    ✅     │    ✅     │      ✅       │
└────────────────────┴───────┴───────────┴───────────┴───────────────┘

Note: hidevotelog only applies to /vote and /itemvote; showanonvotetotals only applies to /anonvote and /anonitemvote.

Note: allowabstainvote applies to all vote commands. When enabled, participants can choose to abstain instead of voting for a specific option.

Note: announcechannel, votehotword and allowselfvoting exist only on the player votes (/vote and /anonvote). Item votes have no player mentions to vote with, and nobody to self-vote for. The bot needs Read Message History, Send Messages and Add Reactions in the announce channel, and refuses to start the vote if any are missing.

Note: votehotword requires announcechannel to be set. It replaces the !vote keyword players type in the announce channel with a custom word — see the Custom Hotword section under the Announce Channel Feature.

Note: closeonmajority applies to all vote commands. When enabled, the vote closes once enough options have each reached a majority of voters (floor(voters/2) + 1). For single-slot votes, one option must reach majority. For multi-slot votes, one option per slot must each independently reach majority.

Note: closewhenvotesreach replaces the computed majority threshold with a fixed number of votes (1 or more). It only works together with closeonmajority:True; the command refuses if it is given on its own.

Note: allowselfvoting lets players vote for themselves in /vote and /anonvote. By default self-votes are rejected, both on the vote embed and in the announce channel.

Note: randomizeoptions applies to all vote commands. When enabled, the order of vote options is shuffled each time the vote embed is displayed.

/vote Command

Create a regular vote where participants vote for other players. Results show who voted for whom.

Examples

Basic player vote:

/vote votetime:+2h votecount:1 voterole:@GamePlayers

Player vote with custom title:

/vote votetime:5:00pm EST tomorrow votecount:3 voterole:@Members votetitle:Who is a wolf?

Player vote with hidden vote log:

/vote votetime:+2h votecount:1 voterole:@GamePlayers hidevotelog:True

Player vote allowing abstentions:

/vote votetime:+2h votecount:1 voterole:@GamePlayers allowabstainvote:True

Player vote with announce channel:

/vote votetime:+2h votecount:1 voterole:@GamePlayers announcechannel:#vote-updates

Player vote with a custom vote hotword:

/vote votetime:+2h votecount:1 voterole:@GamePlayers announcechannel:#vote-updates votehotword:yeet

Player vote that closes when majority is reached:

/vote votetime:+2h votecount:1 voterole:@GamePlayers closeonmajority:True

Player vote that closes at a fixed number of votes:

/vote votetime:+2h votecount:1 voterole:@GamePlayers closeonmajority:True closewhenvotesreach:5

Player vote where players may vote for themselves:

/vote votetime:+2h votecount:1 voterole:@GamePlayers allowselfvoting:True

Player vote with randomized option order:

/vote votetime:+2h votecount:1 voterole:@GamePlayers randomizeoptions:True

Vote Log: By default, the vote history is visible on the web view. Set hidevotelog:True to hide the vote history display. Abstentions: When allowabstainvote:True, participants can choose "Abstain" and won't be flagged for incomplete voting. Abstentions are shown in the results. Announce Channel: When announcechannel is set, the bot monitors that channel for text commands like !vote <@player>, !vote abstain, and !vote remove that participants can use to quickly cast votes. See the Announce Channel section for details. Vote Hotword: When votehotword is set (e.g. yeet), players use that word instead of !vote — yeet @player, yeet abstain — and check their votes with myyeet. See the Custom Hotword section for details. Close on Majority: When closeonmajority:True, the vote ends automatically once enough options have each reached a majority of voters (floor(voters/2) + 1). For single-slot votes, one option must reach majority. Useful for decisive votes where you don't need to wait for all participants. Add closewhenvotesreach to use a fixed threshold instead. Self-Voting: By default a player cannot vote for themselves. Set allowselfvoting:True to allow it. Randomize Options: When randomizeoptions:True, the order of vote options is shuffled. Useful for preventing position bias in player lists.

/anonvote Command

Create an anonymous vote where participants vote for other players, but results don't show who voted for whom.

Examples

Anonymous player vote:

/anonvote votetime:+2h votecount:1 voterole:@GamePlayers

Anonymous vote with moderator exclusion:

/anonvote votetime:+1d votecount:2 voterole:@Everyone modrole:@Moderators votetitle:Secret Vote

Anonymous vote showing totals after close:

/anonvote votetime:+2h votecount:1 voterole:@GamePlayers showanonvotetotals:True

Anonymous vote allowing abstentions:

/anonvote votetime:+2h votecount:1 voterole:@GamePlayers allowabstainvote:True

Anonymous vote with announce channel:

/anonvote votetime:+2h votecount:1 voterole:@GamePlayers announcechannel:#vote-updates

Anonymous vote that closes when majority is reached:

/anonvote votetime:+2h votecount:1 voterole:@GamePlayers closeonmajority:True

Anonymous vote with randomized option order:

/anonvote votetime:+2h votecount:1 voterole:@GamePlayers randomizeoptions:True

Vote Totals: By default, vote totals remain hidden even after the vote closes. Set showanonvotetotals:True to display vote totals once the vote ends (they remain hidden during voting). Abstentions: When allowabstainvote:True, participants can choose "Abstain" and won't be flagged for incomplete voting. Abstentions are not shown in anonymous votes. Announce Channel: When announcechannel is set, the bot monitors that channel for text commands like !vote <@player>, !vote abstain, and !vote remove that participants can use to quickly cast votes. Vote Hotword: When votehotword is set (e.g. yeet), players use that word instead of !vote — yeet @player, yeet abstain — and check their votes with myyeet. See the Custom Hotword section for details. Close on Majority: When closeonmajority:True, the vote ends automatically once enough options have each reached a majority of voters (floor(voters/2) + 1). Add closewhenvotesreach to use a fixed threshold instead. Self-Voting: By default a player cannot vote for themselves. Set allowselfvoting:True to allow it. Randomize Options: When randomizeoptions:True, the order of vote options is shuffled. Useful for preventing position bias in player lists.

/itemvote Command

Create a vote for custom items/options instead of players. Results show who voted for what.

Creating Item Votes

Before running the /itemvote command, post a message with your vote options formatted as markdown headers:

### Option 1 Title

Optional description for option 1

### Option 2 Title

Optional description for option 2

### Option 3 Title

Optional description for option 3

Then run the /itemvote command. The bot will automatically parse your most recent message containing markdown headers as the vote options.

Examples

Basic item vote:

/itemvote votetime:+1d votecount:1 voterole:@Everyone votetitle:Choose an Item

Item vote with moderator exclusion:

/itemvote votetime:+2d votecount:2 voterole:@Members modrole:@Staff votetitle:Server Event Choice

Item vote with hidden vote log:

/itemvote votetime:+1d votecount:1 voterole:@Everyone votetitle:Choose an Item hidevotelog:True

Item vote allowing abstentions:

/itemvote votetime:+1d votecount:1 voterole:@Everyone votetitle:Choose an Item allowabstainvote:True

Item vote that closes when majority is reached:

/itemvote votetime:+1d votecount:1 voterole:@Everyone votetitle:Choose an Item closeonmajority:True

Item vote with randomized option order:

/itemvote votetime:+1d votecount:1 voterole:@Everyone votetitle:Choose an Item randomizeoptions:True

Vote Log: By default, the vote history is visible on the web view. Set hidevotelog:True to hide the vote history display. Abstentions: When allowabstainvote:True, participants can choose "Abstain" and won't be flagged for incomplete voting. Abstentions are shown in the results. No Announce Channel: Item votes have no announcechannel, votehotword or allowselfvoting options. Items have no Discord user mentions to vote with, so all voting happens through the vote embed. Close on Majority: When closeonmajority:True, the vote ends automatically once enough options have each reached a majority of voters (floor(voters/2) + 1). Add closewhenvotesreach to use a fixed threshold instead. Randomize Options: When randomizeoptions:True, the order of vote options is shuffled. Useful for preventing anchoring bias toward the first listed items.

/anonitemvote Command

Create an anonymous vote for custom items/options. Results don't show who voted for what.

Creating Anonymous Item Votes

Follow the same process as /itemvote - post a markdown-formatted message with your options first, then run the command.

Examples

Anonymous item vote:

/anonitemvote votetime:+3d votecount:1 voterole:@Everyone votetitle:Anonymous Poll

Anonymous item vote with custom settings:

/anonitemvote votetime:2:30pm EDT Monday votecount:3 voterole:@Community modrole:@Moderators votetitle:Secret Survey

Anonymous item vote showing totals after close:

/anonitemvote votetime:+3d votecount:1 voterole:@Everyone votetitle:Anonymous Poll showanonvotetotals:True

Anonymous item vote allowing abstentions:

/anonitemvote votetime:+3d votecount:1 voterole:@Everyone votetitle:Anonymous Poll allowabstainvote:True

Anonymous item vote that closes when majority is reached:

/anonitemvote votetime:+3d votecount:1 voterole:@Everyone votetitle:Anonymous Poll closeonmajority:True

Anonymous item vote with randomized option order:

/anonitemvote votetime:+3d votecount:1 voterole:@Everyone votetitle:Anonymous Poll randomizeoptions:True

Vote Totals: By default, vote totals remain hidden even after the vote closes. Set showanonvotetotals:True to display vote totals once the vote ends (they remain hidden during voting). Abstentions: When allowabstainvote:True, participants can choose "Abstain" and won't be flagged for incomplete voting. Abstentions are not shown in anonymous votes. No Announce Channel: Item votes have no announcechannel, votehotword or allowselfvoting options. Items have no Discord user mentions to vote with, so all voting happens through the vote embed. Close on Majority: When closeonmajority:True, the vote ends automatically once enough options have each reached a majority of voters (floor(voters/2) + 1). Add closewhenvotesreach to use a fixed threshold instead. Randomize Options: When randomizeoptions:True, the order of vote options is shuffled. Useful for preventing anchoring bias toward the first listed items.

/denvote Command

Create a mafia or werewolf den vote. Run it inside the den channel (the wolves' or mafia's private channel): the living players who can see that channel become the voters, and the living players who cannot see it become the kill targets. Den members vote on which outside player the pack kills, and optionally on which den member carries out the kill.

Required Arguments

┌──────────┬──────┬──────────────────────────────────────────────────────────────────┐
│ Argument │ Type │ Description                                                      │
├──────────┼──────┼──────────────────────────────────────────────────────────────────┤
│ voterole │ Role │ The role that ALL living players have, inside and outside the den│
└──────────┴──────┴──────────────────────────────────────────────────────────────────┘

Optional Arguments

┌──────────────┬─────────┬───────────────────────────────────────────────────────┬──────────┐
│ Argument     │ Type    │ Description                                           │ Default  │
├──────────────┼─────────┼───────────────────────────────────────────────────────┼──────────┤
│ votetitle    │ String  │ Custom title for the vote (max 80 characters)         │ Den Vote │
│ votetime     │ String  │ When the vote should end                              │ +24h     │
│ killcount    │ Integer │ Number of players the den kills, one vote slot each   │ 1        │
│              │         │ (1-4)                                                 │          │
│ killingplayer│ Boolean │ Also vote on which den member carries out the kill    │ False    │
│ webview      │ Boolean │ Enable the public web view page for this vote         │ False    │
└──────────────┴─────────┴───────────────────────────────────────────────────────┴──────────┘

How It Works

  1. The bot reads every member of voterole, excluding anyone with the server's moderator role, and splits them by whether they can see the current channel. Members who can see it are the den members (the voters); everyone else is a kill target. Out-of-den wolves are valid targets on purpose.
  2. The command refuses if nobody in the role can see the channel, if everybody can (no targets), or if killcount is larger than the number of players outside the den.
  3. A private preview lists the den members and kill targets. Press Start Vote to post the vote or Abandon Vote to discard it.
  4. The live embed shows 🎯 Kill Nominations (current counts per target), 🔪 Killer Nominations when killingplayer:True, and 🗳️ Den Members with how many of their slots each member has filled. Each den member gets one vote button per kill slot (Kill Vote #1, Kill Vote #2, ...) plus a Vote for Killer button when enabled, a Who did I vote for? button, and the moderator Manage button.
  5. When the vote closes, the results embed names the nominated target(s) (ties are called out), the nominated killer, who voted for whom, and any den members who did not cast all of their votes.

Den votes never use the announce channel, saved defaults, or vote modifiers (weights and pawns). The web page for a den vote exists only when webview:True was set.

Examples

Standard den vote, closing in 24 hours:

/denvote voterole:@Alive

Two kills, with a vote on who does the killing:

/denvote voterole:@Alive votetitle:Night 3 killcount:2 killingplayer:True votetime:9pm EST today

Time Format Examples

Discrete Times:

Relative Times:

⚠️ Note: Vote end time must be in the future. Include timezone and day (today/tomorrow) for discrete times.

/modifyvote Command

Modify an existing active vote from Discord. Any moderator can modify any active vote in the channel; the vote's Manage page offers the same changes and more.

Required Arguments

┌─────────────────────┬────────┬─────────────────────────────────────────────────────┐
│ Argument            │ Type   │ Description                                         │
├─────────────────────┼────────┼─────────────────────────────────────────────────────┤
│ votemodificationtype│ Choice │ How to modify the vote                              │
│ votemodid           │ String │ Vote ID (format: vid + alphanumeric characters)     │
└─────────────────────┴────────┴─────────────────────────────────────────────────────┘

Optional Arguments

┌──────────────┬────────┬─────────────────────────────────┬───────────────────────────────────┐
│ Argument     │ Type   │ Description                     │ Required For                      │
├──────────────┼────────┼─────────────────────────────────┼───────────────────────────────────┤
│ votemoduser  │ User   │ The user to add or remove       │ ADD_PLAYER, REMOVE_PLAYER,        │
│              │        │ (or clear / deactivate)         │ CLEAR_PLAYER_VOTES,               │
│              │        │                                 │ TOGGLE_PLAYER_DEACTIVATION        │
│ votemodtime  │ String │ New end time for the vote       │ CHANGE_TIME                       │
└──────────────┴────────┴─────────────────────────────────┴───────────────────────────────────┘

Modification Types

Discord shows each choice by its label; the value in the first column is what the bot stores.

┌───────────────────────────┬──────────────────────────────────┬────────────────────────────────────────────┐
│ Type                      │ Label in Discord                 │ Additional Requirements                    │
├───────────────────────────┼──────────────────────────────────┼────────────────────────────────────────────┤
│ REFRESH                   │ Refresh the vote message         │ None                                       │
│ ADD_PLAYER                │ Add a player to a vote           │ Requires votemoduser. Max 100 players.     │
│ REMOVE_PLAYER             │ Remove a player from a vote      │ Requires votemoduser. Min 1 player.        │
│ CHANGE_TIME               │ Change the time a vote will end  │ Requires votemodtime. Vote must be active. │
│ ADD_VOTE                  │ Add an additional vote slot      │ None. Increases available vote slots.      │
│ CLEAR_PLAYER_VOTES        │ Clear all votes cast by a player │ Requires votemoduser; must be a voter.     │
│ TOGGLE_PLAYER_DEACTIVATION│ Deactivate or reactivate a player│ Requires votemoduser; must be a voter.     │
└───────────────────────────┴──────────────────────────────────┴────────────────────────────────────────────┘

Restrictions

Examples

Refresh vote display:

/modifyvote votemodificationtype:REFRESH votemodid:vid1a2b3c4d5e

Add a player:

/modifyvote votemodificationtype:ADD_PLAYER votemodid:vid1a2b3c4d5e votemoduser:@JohnDoe

Remove a player:

/modifyvote votemodificationtype:REMOVE_PLAYER votemodid:vid1a2b3c4d5e votemoduser:@JaneDoe

Change vote end time:

/modifyvote votemodificationtype:CHANGE_TIME votemodid:vid1a2b3c4d5e votemodtime:+3h

Add an extra vote slot:

/modifyvote votemodificationtype:ADD_VOTE votemodid:vid1a2b3c4d5e

Clear everything a player has voted for:

/modifyvote votemodificationtype:CLEAR_PLAYER_VOTES votemodid:vid1a2b3c4d5e votemoduser:@JohnDoe

Deactivate (or reactivate) a player:

/modifyvote votemodificationtype:TOGGLE_PLAYER_DEACTIVATION votemodid:vid1a2b3c4d5e votemoduser:@JohnDoe

/votedefaults Command

Save your own defaults for the optional vote command options, so you stop retyping the same flags every day. Defaults are per moderator (they follow you, not the server) and apply to /vote, /anonvote, /itemvote and /anonitemvote whenever you leave an option out. Anything you type on the command always wins.

Subcommands

/votedefaults set   [votetime] [votecount] [voterole] [votetitle] [modrole] [announcechannel]
                    [votehotword] [hidevotelog] [showanonvotetotals] [allowabstainvote]
                    [closeonmajority] [closewhenvotesreach] [allowselfvoting] [randomizeoptions]
/votedefaults show
/votedefaults clear [option]

How defaults are applied

With votetime and voterole saved, /vote with no options at all starts a vote.

Announce Channel Feature

The announcechannel argument allows you to designate a channel where participants can use text commands to quickly cast votes. This provides an alternative voting method that's faster than navigating to the vote embed for player votes.

How It Works

When you specify an announcechannel, the bot monitors that channel for specific vote commands:

These commands only work for player votes (created with /vote or /anonvote). Item votes do not support vote commands since items don't have Discord user mentions.

Command Format

Vote commands follow this pattern:

!vote [slot] <target>

Where [slot] is the 1-based vote slot number, and <target> is one of:

Or the standalone info commands:

!vote results
!vote status
!myvotes

Custom Hotword

The optional votehotword argument (on /vote and /anonvote) replaces the !vote keyword with a word of your choice. Setting votehotword:yeet changes every command above:

yeet <@player>       (instead of  !vote <@player>)
yeet 2 <@player>     (instead of  !vote 2 <@player>)
yeet abstain         (instead of  !vote abstain)
yeet remove          (instead of  !vote remove)
yeet results         (instead of  !vote results)
myyeet               (instead of  !myvotes)

The "check my votes" command is always my + hotword. If the hotword starts with a punctuation character, the prefix stays in front — votehotword:$yeet gives $yeet <@player> and $myyeet, mirroring how !vote pairs with !myvotes.

Rules:

Vote Command Behavior

Single Active Vote (single slot): When only one vote is monitoring a channel and it has one slot, commands work seamlessly:

!vote <@Alice>     → ✅ Vote recorded
!vote abstain      → ✅ Abstention recorded
!vote remove       → ✅ Vote removed
!vote results      → ✅ Current standings posted
!myvotes           → ✅ Your votes shown

Single Active Vote (multiple slots): When the vote has more than one slot, the slot number is required:

!vote 1 <@Alice>   → ✅ Vote recorded in slot 1
!vote 2 <@Bob>     → ✅ Vote recorded in slot 2
!vote <@Alice>     → ❌ Rejected (slot required for multi-slot votes)

Multiple Active Votes: If multiple votes are monitoring the same channel, the bot will:

Validation Rules

The bot validates vote commands before recording them:

  1. Self-voting prevention: You cannot vote for yourself unless the vote was created with allowselfvoting:True

    !vote <@YourOwnUser> → ❌ Rejected

  2. Valid vote options: The target must be a valid option in the vote

    !vote <@NonPlayer> → ❌ Rejected (not in the player list)

  3. Abstain permissions: Abstaining requires allowabstainvote:True

    !vote abstain → ❌ Rejected (if abstaining is not enabled)

  4. Bot messages ignored: The bot ignores commands from other bots

Reactions

The bot reacts to vote commands to indicate success or failure:

When closeonmajority:True is set, the bot also adds a countdown reaction alongside ✅ showing how many votes the least-filled slot still needs to reach majority:

No countdown reaction is added when 4 or more votes are still needed.

The countdown is computed after the vote is recorded, so it always shows the final state of that message. When a vote closes because pawns moved on it, the closing message gets 🔒 even if the previous message showed 2️⃣; there is no 1️⃣ in between.

Example Usage

Standard player vote with command channel:

/vote votetime:+2h votecount:1 voterole:@Players announcechannel:#voting votetitle:Day 1 Vote

Participants can then vote in #voting:

User: !vote <@Alice>
Bot: ✅

User: !vote <@Bob>
Bot: ✅

User: !vote abstain
Bot: ✅

Anonymous vote with command channel:

/anonvote votetime:+2h votecount:1 voterole:@Players announcechannel:#voting votetitle:Secret Vote

Commands work the same way, but the vote remains anonymous in the results.

Multi-slot vote with command channel:

/vote votetime:+2h votecount:3 voterole:@Players announcechannel:#voting votetitle:Day 1 Vote

Participants must specify the slot:

User: !vote 1 <@Alice>
Bot: ✅

User: !vote 2 <@Bob>
Bot: ✅

User: !vote 3 <@Carol>
Bot: ✅

Multi-Slot Votes

When votecount is greater than 1, participants must specify the slot number:

!vote 1 <@Alice>  → ✅ Vote recorded in slot 1
!vote 2 <@Bob>    → ✅ Vote recorded in slot 2
!vote 3 <@Carol>  → ✅ Vote recorded in slot 3
!vote <@Alice>    → ❌ Rejected — slot number required

The bot replies with a help message when the slot is omitted, showing the valid slot range.

Compatibility Notes

Technical Details

Vote Modifiers (Manage page)

Two per-player modifiers are set from the vote's Manage page (the ⚙️ Manage button on the vote embed), in the Voters section next to each voter. Neither is available on den votes. Both are logged in the vote history as moderator actions, visible on the web page only when the matching Show weights / Show pawns setting is on.

Vote weight

A player's vote can count for N votes (0–99, default 1). Set it with the Weight box next to the voter. Weight applies to every count: option totals, abstentions, percentages, the results ranking, close-on-majority, and the announce-channel countdown reactions. It does not change how many votes the player has to cast — a ×2 voter still casts one vote per slot. Weight 0 means the player votes but nothing counts (unlike deactivation, which also clears their ballot).

Weights are shown publicly by default (Alice ×2 on the embed, a ×2 chip on the web page, a Modifiers line under the results summary). Turn Show weights off in Vote Settings to keep a weight secret; the counts stay weighted either way.

Vote pawns

A pawn is a player whose vote is cast with their controller's in the last minute of the vote. Pick the controller in the Pawn of dropdown next to the voter. Rules:

Command Comparison

┌────────────────┬──────────────────┬───────────┬───────────────────────────────────────┐
│ Command        │ Target           │ Anonymous │ Results Visibility                    │
├────────────────┼──────────────────┼───────────┼───────────────────────────────────────┤
│ `/vote`        │ Players          │ No        │ Public - shows who voted for whom     │
│ `/anonvote`    │ Players          │ Yes       │ Private - vote counts only*           │
│ `/itemvote`    │ Items            │ No        │ Public - shows who voted for what     │
│ `/anonitemvote`│ Items            │ Yes       │ Private - vote counts only*           │
│ `/denvote`     │ Players outside  │ No        │ Den channel - shows who voted for whom│
│                │ the den channel  │           │                                       │
└────────────────┴──────────────────┴───────────┴───────────────────────────────────────┘

* Vote totals can optionally be shown after the vote closes using showanonvotetotals:True

/votedefaults does not create a vote; it saves your defaults for /vote, /anonvote, /itemvote and /anonitemvote. /denvote ignores saved defaults.

Tips and Best Practices

Choosing the Right Command

Saved Defaults

Finding Your Vote ID

Role Selection

Time Planning

Anonymous Votes

Vote Privacy Options

Abstentions

Close on Majority

Vote Weights

Vote Pawns

Randomize Options

Item Votes

Announce Channel