Wolfia
A Discord bot for Mafia / Werewolf and similar games
Project maintained by wolfiabot Hosted on GitHub Pages — Theme by mattgraham
Click the banner above to invite Wolfia
Join the Wolfia Lounge
- Play games
- Get support
- Leave feedback
- Get notified of updates
- Vote on the roadmap of Wolfia
Wolfia setup
- Invite Wolfia to your server (see big button above).
- Revoke Wolfia’s write permission on channels where games should not be played.
- Set your channel settings:
tag cooldownis how often someone can call the tag list, andauto-outwill automactally remove inactive players from the sign-up list. - Set your game settings. See below for details on each game and mode.
- Start playing!
A few notes:
- Wolfia automatically mutes and unmutes players as necessary to prevent non-players and dead players from talking during a game.
- Wolfia also runs private servers just for the Wolves/Mafia. Players receiving one of those roles will also get an invite to such a server in their role PM at the start of the game. You do not need to create any channels for Wolves/Mafia.
Access roleis for playing on private channels. You do not need to configure this unless Wolfia asks you to.
Commands
Starting a game
| Command | What it does | Example usage / aliases |
|---|---|---|
w.in |
sign up for a game | w.in |
w.out |
drop from the sign up list; moderators can out other players | w.out w.out @player |
w.setup |
set up the game in the current channel | w.setup daylength 5 w.setup game mafia w.setup mode classic |
w.start |
start a game | w.start |
w.rolepm |
ask the bot to resend you your rolepm for the ongoing game | w.rpm |
w.status |
show the current status of an ongoing game or sign ups | w.st |
Game actions
| Command | What it does | Example usage / aliases |
|---|---|---|
w.check |
check a players alignment | w.check 6 |
w.shoot |
shoot another player | w.s @player |
w.unvote |
unvote | w.u |
w.vote |
vote a player for lynch | w.v @player |
w.votecount |
post the current votecount | w.vc |
w.nightkill |
vote a player for nightkill (in mafia chat only) | w.nk @player |
w.hohoho |
give a player a present (xmas mode only) | w.ho 5 |
w.items |
list the items that you own (xmas mode only) | w.items |
w.openpresent |
open a present that you received (xmas mode only) | w.op |
Bot Settings
| Command | What it does | Example usage / aliases |
|---|---|---|
w.channelsettings |
set up settings for this channel | w.cs accessrole Mafiaplayer w.channelsettings tagcooldown 10 w.cs auto-out on |
Statistics
| Command | What it does | Example usage / aliases |
|---|---|---|
w.userstats |
show stats of a user | w.userstats @user |
w.guildstats |
show stats of the current guild | w.guildstats w.guildstats <guildId> |
w.botstats |
show bot wide stats | w.botstats |
Other Commands
| Command | What it does | Example usage / aliases |
|---|---|---|
w.auth |
authorize to be added to wolf chat automatically | w.auth |
w.commands |
show a list of all available commands | w.comms |
w.help |
send some help your way | w.help |
w.info |
show some general information about Wolfia | w.info |
w.invite |
post invite links for Wolfia and the Wolfia Lounge | w.inv |
w.rank |
add or remove a rank in the WolfiaLounge | w.rank AlphaWolves |
w.replay |
show the replay of a game | w.replay #gameid |
w.tag |
post or sign up for the tag list of the channel | w.tag + w.tag - w.tag + @role |
Game Modes
Mafia
Town 
against Mafia 
- The Mafia knows their team, they receive an invite to mafia chat with their role pms
- During the day everyone votes to lynch one of the players
- During the night the Mafia kills players
- Town wins when all Mafia are dead, Mafia wins when they reach parity.
Mafia Lite
9+ players
Power roles:
The Cop 
investigates the alignment of a player at night.
Xmas Mafia
7+ players
Power roles:
The Cop investigates the alignment of a player at night.
(Many) Santas 
who give out presents to other players, which contain useful, but also
dangerous items.
Popcorn
Village 
against Wolves 
- The s know their team.
- A holds the
. - If the shoots a , the dies and the can shoot again.
- If the shoots another , the shooter dies, and the goes to the that was shot at.
- s win when all s are dead, s win when they reach parity.
Popcorn Wild
3+ players
The Wild mode randomizes who gets the .
The channel is never be closed, non-players and dead players can post all the time.
Popcorn Classic
3-26 players
The Classic mode allows the s to have a separate hidden chat, where they may decide which gets the .
The game channel is moderated, which means during a game only the living players are allowed to talk in the channel.
Permissions:
Wolfia requires some permissions to run games flawlessly. It will try to automatically set itself up with what it needs, or ask you to give it the required permissions to do so.
Using the official invite link provided at the top of this page, or by running the w.help command to invite Wolfia to your server, will have it request the required permissions. If permissions on your server are broken for Wolfia or the required ones have been updated, kicking and reinviting should restore permissions to a working state.
Nevertheless, and also for the control freaks among us, here is a comprehensive list of what is required and why:
Required
- - Read Message History
- Edit it's own messages after they have been sent
- - Use External Emojis
- The standarized emojis are not enough to display everything clearly, so Wolfia packs a bunch of custom ones
- - Embed Links
- Formatting of messages
- - Add Reactions
- Display vote counts
- - Manage Messages
- Clearing reactions off of votecounts
- - Manage Roles
- Moderate the game channel with permission overrides (and just that; Wolfia does not create or delete any roles for the players)
Optional
- - Create Instant Invite
- Adds invites to the channel where the game is running to role pms and private chat servers which makes for a smooth navigation for players during the game.
β version
Wolfia is currently in beta status, which means the following:
- A small selection of games and modes is supported. More stuff is being worked on.
- Bugs during games might happen. Please drop by the Wolfia Lounge to help sort these out.
- Data and commands might change without notice.
- Output and formatting of messages might look a bit rough.
Special mentions:
- Written in Java using the excellent JDA (Java Discord API). They maintain a super helpful crowd in their Discord guild.
- Several functions and architectural decisions inspired by and/or plain copy pasta’d from Frederikam’s music bot FredBoat.
- Thanks to the folks at Mafia Universe and their Discord guild for helping testing and refining the initial version.
Coded with lots of 
by Napster