> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jobot.jeppdev.com/llms.txt
> Use this file to discover all available pages before exploring further.
# JoBot /settings slash command reference
> Full reference for the /settings command group. View, update, and reset per-guild AI, history, music, and system prompt settings in JoBot.
The `/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 |
**Example:**
```
/settings view
```
***
## /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 prompt
```
Use the system prompt to give JoBot a custom persona, restrict what topics it discusses, or tailor its tone for your server's community.
***
## /settings set max-history
**Syntax:** `/settings set max-history `
**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 |
Sets how many recent messages JoBot remembers when generating a response. A higher value gives the AI more context but increases token usage per request. The default is **40**.
**Example:**
```
/settings set max-history 20
```
***
## /settings set temperature
**Syntax:** `/settings set 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 |
Controls how creative or deterministic JoBot's responses are. Lower values produce more focused, consistent answers. Higher values produce more varied and creative responses. The default is **0.7**.
| 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 |
**Example:**
```
/settings set temperature 0.5
```
***
## /settings set volume
**Syntax:** `/settings set volume `
**Required permissions:** None beyond being a guild member
**Parameters:**
| Parameter | Type | Range | Description |
| --------- | ------- | ----- | ------------------------------------- |
| `volume` | integer | 0–100 | Music playback volume as a percentage |
Sets the guild-wide music playback volume. `0` is silent and `100` is maximum volume. The default is **50** (stored internally as `0.5`).
**Example:**
```
/settings set volume 75
```
***
## /settings reset
**Syntax:** `/settings reset `
**Required permissions:** Manage Guild
**Parameters:**
| Parameter | Type | Options | Description |
| --------- | ---- | -------------------------------------------------------------------- | -------------------- |
| `setting` | enum | `SystemPrompt`, `MaxHistoryMessages`, `AiTemperature`, `MusicVolume` | The setting to reset |
Resets a single setting back to its default value. Use this when you want to revert one field without touching the others.
**Default values:**
| Setting | Default |
| -------------------- | ----------------------------------- |
| `SystemPrompt` | The built-in JoMusic persona prompt |
| `MaxHistoryMessages` | `40` |
| `AiTemperature` | `0.7` |
| `MusicVolume` | `50%` (0.5 internally) |
**Example:**
```
/settings reset AiTemperature
```
***
## /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.
This action immediately overwrites all current settings with their defaults. There is no confirmation prompt and no undo.
**Example:**
```
/settings reset-all
```
***
## 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 |