/settings command group lets Discord server admins view and update JoBot’s per-guild configuration directly from Discord using slash commands. All responses are ephemeral — only you can see them. Settings take effect immediately without restarting the bot.
/settings view
Syntax:/settings view
Required permissions (any one): Manage Guild, Manage Channels, Manage Messages, View Guild Insights, or Moderate Members
Displays the current guild settings as an embedded message and attaches the full system prompt as a system-prompt.txt file. The embed shows the following fields:
| Field | Description |
|---|---|
| Max History | Number of messages kept in the AI conversation context |
| Temperature | Current AI temperature value |
| Music Volume | Current playback volume as a percentage |
| System Prompt | See attached system-prompt.txt file |
/settings set prompt
Syntax:/settings set prompt
Required permissions (any one): Manage Guild, Manage Channels, or Manage Messages
Opens a modal dialog where you can type or edit the guild’s system prompt. The modal pre-fills with the current system prompt so you can make targeted edits rather than rewriting from scratch. The prompt can be up to 4,000 characters.
The system prompt tells JoBot how to behave — its persona, tone, and any special instructions. The default prompt sets JoBot up as a music-focused assistant named JoMusic.
Example:
/settings set max-history
Syntax:/settings set max-history <messages>
Required permissions (any one): Manage Guild, Manage Channels, or Manage Messages
Parameters:
| Parameter | Type | Range | Description |
|---|---|---|---|
messages | integer | 1–100 | Number of messages to retain in the AI conversation context |
/settings set temperature
Syntax:/settings set temperature <temperature>
Required permissions (any one): Manage Guild, Manage Channels, or Manage Messages
Parameters:
| Parameter | Type | Range | Description |
|---|---|---|---|
temperature | float | 0.0–1.0 | AI creativity/randomness level |
| Value | Behavior |
|---|---|
0.0 | Precise and deterministic — same input tends to produce the same output |
0.5 | Balanced — moderate variation in responses |
1.0 | Highly creative — responses vary significantly |
/settings set volume
Syntax:/settings set volume <volume>
Required permissions: None beyond being a guild member
Parameters:
| Parameter | Type | Range | Description |
|---|---|---|---|
volume | integer | 0–100 | Music playback volume as a percentage |
0 is silent and 100 is maximum volume. The default is 50 (stored internally as 0.5).
Example:
/settings reset
Syntax:/settings reset <setting>
Required permissions: Manage Guild
Parameters:
| Parameter | Type | Options | Description |
|---|---|---|---|
setting | enum | SystemPrompt, MaxHistoryMessages, AiTemperature, MusicVolume | The setting to reset |
| Setting | Default |
|---|---|
SystemPrompt | The built-in JoMusic persona prompt |
MaxHistoryMessages | 40 |
AiTemperature | 0.7 |
MusicVolume | 50% (0.5 internally) |
/settings reset-all
Syntax:/settings reset-all
Required permissions: Manage Guild
Resets all guild settings to their default values in a single operation. This includes the system prompt, max history, AI temperature, and music volume.
Example:
Permissions summary
| Command | Required permission (any one) |
|---|---|
/settings view | Manage Guild, Manage Channels, Manage Messages, View Guild Insights, Moderate Members |
/settings set prompt | Manage Guild, Manage Channels, Manage Messages |
/settings set max-history | Manage Guild, Manage Channels, Manage Messages |
/settings set temperature | Manage Guild, Manage Channels, Manage Messages |
/settings set volume | (none — any guild member) |
/settings reset | Manage Guild |
/settings reset-all | Manage Guild |