Quiz events¶
Run quiz and automatic games with score limits, topics, and a media catalog.
Access
Host with Text 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.
/quiz_event media_add¶
Purpose¶
Add an image to an automatic game.
Syntax¶
Parameters¶
| Parameter | Type | yes | Limits | Description |
|---|---|---|---|---|
category |
string | yes | car, footballer |
Media category |
answer |
string | yes | — | Correct answer |
image_url |
string | yes | — | HTTPS image or Wikipedia URL |
aliases |
string | no | — | Accepted answers separated by | |
Who can run it¶
Host with Text 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¶
- 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.
/quiz_event media_remove¶
Purpose¶
Remove an automatic-game image.
Syntax¶
Parameters¶
| Parameter | Type | yes | Limits | Description |
|---|---|---|---|---|
id |
integer | yes | min 1 | Record ID |
Who can run it¶
Host with Text 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¶
- 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.
/quiz_event start¶
Purpose¶
Start a quiz or automatic game.
Syntax¶
Parameters¶
| Parameter | Type | yes | Limits | Description |
|---|---|---|---|---|
mode |
string | yes | quiz, auto |
Operation mode |
target_points |
integer | no | min 1; max 20 | Winning score |
topic |
string | no | autocomplete | Quiz topic |
game |
string | no | math, flag, english, encrypt, capitals, captcha, evenodd, car, footballer |
Automatic game |
question_timeout |
integer | no | min 10; max 180 | Seconds allowed per answer |
Who can run it¶
Host with Text 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¶
- 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.
/quiz_event status¶
Purpose¶
Show event status.
Syntax¶
Parameters¶
No parameters.
Who can run it¶
Host with Text 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¶
- 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.
/quiz_event stop¶
Purpose¶
Stop the active event.
Syntax¶
Parameters¶
No parameters.
Who can run it¶
Host with Text 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¶
- 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.