Voice events

Announce voice events, manage winners, cancel events, and browse the catalog.

Access

Host with Voice direction access. 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.

/voice_mp announce

Purpose

Create a Voice event announcement and control panel.

Syntax

/voice_mp announce <event_type> <event_time> [mode] [poster] [ping_role]

Parameters

Parameter	Type	yes	Limits	Description
event_type	string	yes	autocomplete	Event from the panel catalog
event_time	string	yes	—	Event date and time
mode	string	no	manual, points	Operation mode
poster	attachment	no	—	Custom event poster
ping_role	role	no	—	Role to mention

Who can run it

Host with Voice direction access.

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

1. Open an appropriate channel and enter the slash command.
2. Fill every required parameter; leave an optional one empty to use the server default where supported.
3. Review the confirmation before changing roles, balances, or an active event.
4. 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.

/voice_mp cancel

Purpose

Cancel an active Voice event.

Syntax

/voice_mp cancel [event] [reason]

Parameters

Parameter	Type	yes	Limits	Description
event	string	no	—	Event ID
reason	string	no	—	Reason for the action

Who can run it

Host with Voice direction access.

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

1. Open an appropriate channel and enter the slash command.
2. Fill every required parameter; leave an optional one empty to use the server default where supported.
3. Review the confirmation before changing roles, balances, or an active event.
4. 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.

/voice_mp help

Purpose

Show the Voice event catalog.

Syntax

/voice_mp help

Parameters

No parameters.

Who can run it

Host with Voice direction access.

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

1. Open an appropriate channel and enter the slash command.
2. Fill every required parameter; leave an optional one empty to use the server default where supported.
3. Review the confirmation before changing roles, balances, or an active event.
4. 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.

Related settings

run_voice, events, event_rewards