> For the complete documentation index, see [llms.txt](https://zoomiescore.gitbook.io/zoomiescore-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zoomiescore.gitbook.io/zoomiescore-docs/troubleshooting.md).

# troubleshooting

Quick fixes for the issues that come up most often.

<details>

<summary>The bot appears offline</summary>

1. Bots dashboard/website will not be able to be accessed.
2. If it says online but no commands work, Discord may have de-synced the invite. Re-invite the bot with the button in the dashboard sidebar (this preserves settings).

</details>

<details>

<summary>Slash commands aren't showing up</summary>

* Wait 5 minutes then relaunch your Discord client.
* The bot registers globally — new commands can take up to an hour to propagate on Discord's side.
* If a command exists in the [reference](https://zoomiescore.gitbook.io/zoomiescore-docs/docs/commands/reference) but is greyed out for a user, check Dashboard → **Commands** — a mod may have disabled it.

</details>

<details>

<summary>"You need Manage Server / Administrator to do that"</summary>

The bot enforces the same Discord permissions Discord does. If a moderation command refuses to run:

1. Make sure the bot's role is **above** the target user's highest role.
2. Confirm you have the required permission on your own account (Manage Messages for `/purge`, Ban Members for `/ban`, etc.).

</details>

<details>

<summary>AutoMod isn't deleting messages</summary>

* Open Dashboard → **AutoMod** and confirm the rule is **Enabled**.
* Check the rule's exempt channels/roles — the offending message might be in an exempt scope.
* The bot needs **Manage Messages** in the channel to delete, and **Moderate Members** for timeout actions.
* Look at the **Recent triggers** panel in the AutoMod page — it shows every match with the exact matched substring for debugging.

</details>

<details>

<summary>Tickets panel button does nothing</summary>

* The panel message must be sent by the bot itself (from Dashboard → **Tickets** → *Publish*). Copying an old panel into a new channel won't work.
* Make sure the bot has **Manage Channels** in the category the panel will create tickets under.
* If the panel uses a category dropdown, verify each category still exists in Dashboard → **Ticket Categories**.

</details>

<details>

<summary>Premium says "not active" but I subscribed</summary>

1. Refresh Dashboard → **Premium**. Stripe webhooks usually update within 5 seconds.
2. Confirm you ran `/premium here` in the server you want premium active on, or picked it from the dashboard picker. If you need further assistance join the support server.
3. If you recently transferred, the 24-hour cooldown blocks the next transfer — see [Activate and transfer](https://zoomiescore.gitbook.io/zoomiescore-docs/docs/premium/activate-and-transfer).

</details>

<details>

<summary>Backups fail with "channel skipped"</summary>

Backups snapshot channel, role, category and permission structure. If the bot lacks **Manage Channels** or **Manage Roles**, some items are skipped and reported in the restore report. Grant those permissions and re-run.

</details>

<details>

<summary>Levels aren't tracking XP</summary>

* Check Dashboard → **Levels** — the module has an on/off switch.
* Text XP has a 60-second per-user cooldown to prevent spam farming.
* Ignored channels and roles (configured in the Levels page) don't accrue XP.

</details>

<details>

<summary>Something's still broken</summary>

Grab the exact error text, the command you ran and the timestamp (server time), then post it in the support server. Screenshots help.

</details>