Karaoke¶
Run the complete karaoke lifecycle, including announcement, queue, hosts, and session status.
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.
/karaoke announce¶
Purpose¶
Create a karaoke announcement, control panel, and queue.
Syntax¶
Parameters¶
| Parameter | Type | yes | Limits | Description |
|---|---|---|---|---|
time |
string | no | — | Scheduled time |
banner |
attachment | no | — | Announcement banner |
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¶
- 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.
/karaoke remove_host¶
Purpose¶
Remove a host from the karaoke session.
Syntax¶
Parameters¶
| Parameter | Type | yes | Limits | Description |
|---|---|---|---|---|
session_id |
integer | yes | — | Session ID |
user |
user | yes | — | Target user |
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¶
- 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.
/karaoke replace¶
Purpose¶
Replace a karaoke host.
Syntax¶
Parameters¶
| Parameter | Type | yes | Limits | Description |
|---|---|---|---|---|
session_id |
integer | yes | — | Session ID |
old_host |
user | yes | — | Current host |
new_host |
user | yes | — | Replacement host |
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¶
- 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.
/karaoke set_creator¶
Purpose¶
Transfer karaoke lobby ownership.
Syntax¶
Parameters¶
| Parameter | Type | yes | Limits | Description |
|---|---|---|---|---|
session_id |
integer | yes | — | Session ID |
user |
user | yes | — | Target user |
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¶
- 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.
/karaoke status¶
Purpose¶
Show the active karaoke session.
Syntax¶
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¶
- 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.