Documentation

Everything you need to know about setting up and running Village Vote in your Discord server.

Vote Commands

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

Read more →

Dashboard

The /dashboard command gives moderators a secure, time-limited link to a web-based game dashboard for monitoring and managing an active game.

Read more →

Player Actions

The player action system provides a structured workflow for players to submit night actions (or any game action) to moderators, with a two-party confirmation handshake before actio…

Read more →

Assigning Roles

The /assignroles command starts a new game by reading all members of a Discord role and assigning them game roles from a chosen template. It creates the game and gives you a link t…

Read more →

Teams & Death Management

These two moderator commands manage the live state of players during a game:

Read more →

Game Utilities

These commands cover the smaller jobs around running a game: opening channels, swapping players, adding teams mid-game, checking the bot's permissions, and picking things at random…

Read more →

Game Announcements

This bot provides three commands for creating and sharing game announcements across Discord servers:

Read more →

Breadcrumb Trail

A breadcrumb trail is a list of secret words. When a player says one of them in a monitored channel, the bot records the find, can DM the player a message, and tells the moderators…

Read more →

Shop (Players)

Your server may run a game economy: money to earn, items to buy, bets to place, players to rob. Everything happens through a few slash commands, and everything you do is private to…

Read more →

Shop (Moderators)

The Player Shop is a full game economy you run without touching a spreadsheet: currencies, priced items, hidden black markets, lootboxes, betting events, auctions, and optional inc…

Read more →

Leaderboards (Moderators)

A leaderboard is one live message in a channel of your choice that ranks players by points or by Elo rating and rewrites itself as results arrive. Results come from a game: one the…

Read more →

Leaderboard API

You run a game somewhere (a browser game on your own site, a bot, a script that scores a quiz) and a moderator has set up a leaderboard for it on their Discord server. This guide c…

Read more →

Leaderboards: External Games

You have a game that runs outside this bot: a browser game on your own site, a game with its own backend, or a script that scores something. A moderator wants its results on a lead…

Read more →

Leaderboards: Adding Games

You are changing the bot itself to ship a new game that moderators can pick from the catalogue tile on the setup page. There are two kinds, and the first decision is which one you …

Read more →

Server Management

This guide is for trusted config admins — the people who help bring new Discord servers onto Village Vote and keep existing server settings up to date.

Read more →

Werewolf Roles

As an example…

Read more →