Mafia¶
Create a lobby, manage players, run a match, and stop it safely.
Access
Member to join; creator or host to control. A server override made with /config access lvl takes precedence over the default.
Required setup¶
The server is activated, the feature is enabled, required roles and channels are configured, and the bot has View Channel, Send Messages, Embed Links, and Read Message History. Role actions also need Manage Roles; voice actions need Connect and Speak.
/mafia2 create¶
Purpose¶
Create a Mafia v2 lobby in the current channel.
Syntax¶
Parameters¶
No parameters.
Who can run it¶
Member to join; creator or host to control.
Server override¶
An administrator can inspect or change the level with /config access lvl. Level 0 is administrator-only; levels 1–5 map to the host profile. Use /qa diagnose for a concrete member.
Required setup¶
The server is activated, the feature is enabled, required roles and channels are configured, and the bot has View Channel, Send Messages, Embed Links, and Read Message History. Role actions also need Manage Roles; voice actions need Connect and Speak.
Procedure¶
- Open an appropriate channel and enter the slash command.
- Fill every required parameter; leave an optional one empty to use the server default where supported.
- Review the confirmation before changing roles, balances, or an active event.
- After the response, verify the created message, profile, or panel record.
Expected result¶
On success, Discord shows a confirmation and an object ID when later cancellation or continuation needs it. Resolve an error before retrying.
Buttons and forms¶
When a command creates a panel, use buttons and forms only from its latest message. If a button no longer works, refresh the message or reopen the panel.
State changes¶
The bot publishes or updates event messages, control panels, winner roles, statistics, and audit records.
Common errors¶
- Access denied. Verify level, direction, and the server override with
/qa diagnose. - Server is not activated. Complete activation in the panel's Server section.
- Feature is disabled. Enable the relevant feature toggle and save settings.
- Channel or role is missing. Configure the required panel field and retry.
- Bot permission is missing. Move the bot role above managed roles and grant the missing Discord permission.
/mafia2 join¶
Purpose¶
Join the active match lobby.
Syntax¶
Parameters¶
No parameters.
Who can run it¶
Member to join; creator or host to control.
Server override¶
An administrator can inspect or change the level with /config access lvl. Level 0 is administrator-only; levels 1–5 map to the host profile. Use /qa diagnose for a concrete member.
Required setup¶
The server is activated, the feature is enabled, required roles and channels are configured, and the bot has View Channel, Send Messages, Embed Links, and Read Message History. Role actions also need Manage Roles; voice actions need Connect and Speak.
Procedure¶
- Open an appropriate channel and enter the slash command.
- Fill every required parameter; leave an optional one empty to use the server default where supported.
- Review the confirmation before changing roles, balances, or an active event.
- After the response, verify the created message, profile, or panel record.
Expected result¶
On success, Discord shows a confirmation and an object ID when later cancellation or continuation needs it. Resolve an error before retrying.
Buttons and forms¶
When a command creates a panel, use buttons and forms only from its latest message. If a button no longer works, refresh the message or reopen the panel.
State changes¶
The bot publishes or updates event messages, control panels, winner roles, statistics, and audit records.
Common errors¶
- Access denied. Verify level, direction, and the server override with
/qa diagnose. - Server is not activated. Complete activation in the panel's Server section.
- Feature is disabled. Enable the relevant feature toggle and save settings.
- Channel or role is missing. Configure the required panel field and retry.
- Bot permission is missing. Move the bot role above managed roles and grant the missing Discord permission.
/mafia2 leave¶
Purpose¶
Leave the lobby before the match starts.
Syntax¶
Parameters¶
No parameters.
Who can run it¶
Member to join; creator or host to control.
Server override¶
An administrator can inspect or change the level with /config access lvl. Level 0 is administrator-only; levels 1–5 map to the host profile. Use /qa diagnose for a concrete member.
Required setup¶
The server is activated, the feature is enabled, required roles and channels are configured, and the bot has View Channel, Send Messages, Embed Links, and Read Message History. Role actions also need Manage Roles; voice actions need Connect and Speak.
Procedure¶
- Open an appropriate channel and enter the slash command.
- Fill every required parameter; leave an optional one empty to use the server default where supported.
- Review the confirmation before changing roles, balances, or an active event.
- After the response, verify the created message, profile, or panel record.
Expected result¶
On success, Discord shows a confirmation and an object ID when later cancellation or continuation needs it. Resolve an error before retrying.
Buttons and forms¶
When a command creates a panel, use buttons and forms only from its latest message. If a button no longer works, refresh the message or reopen the panel.
State changes¶
The bot publishes or updates event messages, control panels, winner roles, statistics, and audit records.
Common errors¶
- Access denied. Verify level, direction, and the server override with
/qa diagnose. - Server is not activated. Complete activation in the panel's Server section.
- Feature is disabled. Enable the relevant feature toggle and save settings.
- Channel or role is missing. Configure the required panel field and retry.
- Bot permission is missing. Move the bot role above managed roles and grant the missing Discord permission.
/mafia2 status¶
Purpose¶
Show the active match state.
Syntax¶
Parameters¶
No parameters.
Who can run it¶
Member to join; creator or host to control.
Server override¶
An administrator can inspect or change the level with /config access lvl. Level 0 is administrator-only; levels 1–5 map to the host profile. Use /qa diagnose for a concrete member.
Required setup¶
The server is activated, the feature is enabled, required roles and channels are configured, and the bot has View Channel, Send Messages, Embed Links, and Read Message History. Role actions also need Manage Roles; voice actions need Connect and Speak.
Procedure¶
- Open an appropriate channel and enter the slash command.
- Fill every required parameter; leave an optional one empty to use the server default where supported.
- Review the confirmation before changing roles, balances, or an active event.
- After the response, verify the created message, profile, or panel record.
Expected result¶
On success, Discord shows a confirmation and an object ID when later cancellation or continuation needs it. Resolve an error before retrying.
Buttons and forms¶
When a command creates a panel, use buttons and forms only from its latest message. If a button no longer works, refresh the message or reopen the panel.
State changes¶
The bot publishes or updates event messages, control panels, winner roles, statistics, and audit records.
Common errors¶
- Access denied. Verify level, direction, and the server override with
/qa diagnose. - Server is not activated. Complete activation in the panel's Server section.
- Feature is disabled. Enable the relevant feature toggle and save settings.
- Channel or role is missing. Configure the required panel field and retry.
- Bot permission is missing. Move the bot role above managed roles and grant the missing Discord permission.
/mafia2 stop¶
Purpose¶
Cancel the active match as its host.
Syntax¶
Parameters¶
No parameters.
Who can run it¶
Member to join; creator or host to control.
Server override¶
An administrator can inspect or change the level with /config access lvl. Level 0 is administrator-only; levels 1–5 map to the host profile. Use /qa diagnose for a concrete member.
Required setup¶
The server is activated, the feature is enabled, required roles and channels are configured, and the bot has View Channel, Send Messages, Embed Links, and Read Message History. Role actions also need Manage Roles; voice actions need Connect and Speak.
Procedure¶
- Open an appropriate channel and enter the slash command.
- Fill every required parameter; leave an optional one empty to use the server default where supported.
- Review the confirmation before changing roles, balances, or an active event.
- After the response, verify the created message, profile, or panel record.
Expected result¶
On success, Discord shows a confirmation and an object ID when later cancellation or continuation needs it. Resolve an error before retrying.
Buttons and forms¶
When a command creates a panel, use buttons and forms only from its latest message. If a button no longer works, refresh the message or reopen the panel.
State changes¶
The bot publishes or updates event messages, control panels, winner roles, statistics, and audit records.
Common errors¶
- Access denied. Verify level, direction, and the server override with
/qa diagnose. - Server is not activated. Complete activation in the panel's Server section.
- Feature is disabled. Enable the relevant feature toggle and save settings.
- Channel or role is missing. Configure the required panel field and retry.
- Bot permission is missing. Move the bot role above managed roles and grant the missing Discord permission.