> ## 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.

# Per-server settings for JoBot

> Configure JoBot's AI behavior, conversation history, music volume, and custom system prompt for each Discord server using slash commands.

Each Discord server (guild) has its own independent set of settings. Users with the **Manage Server**, **Manage Channels**, or **Manage Messages** permission can view and change these settings at any time using JoBot's `/settings` slash commands — no bot restart required.

## Viewing current settings

Run `/settings view` to see all settings for your server. JoBot responds with an ephemeral embed showing your current values for history length, AI temperature, and music volume, plus a `system-prompt.txt` file attachment containing the full active system prompt.

## Available settings

<AccordionGroup>
  <Accordion title="System prompt" icon="pen-to-square">
    The system prompt defines JoBot's AI persona, instructions, tone, and memory behavior. It is passed to Claude at the start of every conversation in your server.

    * **Maximum length:** 4,000 characters
    * **Default:** The built-in JoMusic persona (a snarky 26-year-old music expert)
    * **Command:** `/settings set prompt` — opens a modal text editor pre-filled with the current prompt

    If you leave the system prompt at its default, JoBot will behave as JoMusic: a witty, sarcastic music enthusiast who automatically stores and recalls user preferences, and prefers Subsonic for music search when available.
  </Accordion>

  <Accordion title="Max history messages" icon="clock-rotate-left">
    Controls how many previous messages from the channel JoBot includes in each Claude request. Higher values give Claude more context but increase API token usage per message.

    * **Range:** 1–100
    * **Default:** 40
    * **Command:** `/settings set max-history <number>`

    **Example:**

    ```
    /settings set max-history 20
    ```
  </Accordion>

  <Accordion title="AI temperature" icon="thermometer">
    Controls how creative or predictable Claude's responses are. Lower values produce more consistent, focused answers; higher values produce more varied and creative replies.

    * **Range:** 0.0 (deterministic) – 1.0 (most creative)
    * **Default:** 0.7
    * **Command:** `/settings set temperature <value>`

    **Example:**

    ```
    /settings set temperature 0.5
    ```
  </Accordion>

  <Accordion title="Music volume" icon="volume-high">
    Sets the default playback volume for music in your server's voice channels.

    * **Range:** 0–100 (percent)
    * **Default:** 50
    * **Command:** `/settings set volume <number>`

    **Example:**

    ```
    /settings set volume 75
    ```
  </Accordion>
</AccordionGroup>

## Resetting settings

You can reset any individual setting or all settings at once back to their defaults. Both commands require the **Manage Server** permission.

| Command                   | Effect                                                                                                             |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `/settings reset <field>` | Resets one setting (`SystemPrompt`, `MaxHistoryMessages`, `AiTemperature`, or `MusicVolume`) to its default value. |
| `/settings reset-all`     | Resets every setting for your server to its default value.                                                         |

## Required permissions

| Command                     | Required permission                                         |
| --------------------------- | ----------------------------------------------------------- |
| `/settings view`            | Manage Server **or** Manage Channels **or** Manage Messages |
| `/settings set prompt`      | Manage Server **or** Manage Channels **or** Manage Messages |
| `/settings set max-history` | Manage Server **or** Manage Channels **or** Manage Messages |
| `/settings set temperature` | Manage Server **or** Manage Channels **or** Manage Messages |
| `/settings set volume`      | None (any server member)                                    |
| `/settings reset <field>`   | Manage Server                                               |
| `/settings reset-all`       | Manage Server                                               |

<Tip>
  All settings changes take effect immediately — you do not need to restart JoBot or re-invite it to your server.
</Tip>