← Back to Home

Getting Help

Support Server

Join the support Discord server for live help from the community and bot staff.

In-Bot Help

Use /help or /help <command> for command usage info.

Error Codes

Use /error [code] to look up what an error means and how to fix it.

Direct Contact

DM the bot owner on Discord for urgent issues or data requests.

Frequently Asked Questions

Why aren't slash commands showing up?

Global slash commands can take up to 1 hour to propagate across all servers after registration. If commands still don't appear:

  • Ensure the bot was invited with the applications.commands scope.
  • Try kicking and re-inviting the bot with the correct scopes.
  • Check that the bot is online and connected (use the support server to verify).
How do I enable economy or leveling?

Economy and leveling are disabled by default. Server administrators can enable them:

  • /points enable — enables the economy system
  • /levels enable — enables the leveling system

Alternatively, run /autoconfig to use the guided setup wizard which covers these options.

How do permissions work?

Kelpyyium uses a node-based permission system. By default, most commands are denied except basic utility commands. Admins must grant permissions to roles or users.

Example: /permissions role-set @Moderator mod.* true grants all moderation permissions to the Moderator role.

See the full Permissions documentation for details.

Can I use multiple prefix styles?

Yes! Kelpyyium supports both slash commands (the default and recommended method) and prefix commands. Configure the prefix with /prefix set <prefix>. Slash commands always work regardless of prefix settings.

How does global chat work?

Global chat links channels across different servers. One admin creates a channel with /globalchat create <name>, then shares the join code. Other server admins use /globalchat join <code> to link their channel.

Messages are relayed via webhooks with a [GC] prefix for clear attribution. Rate limiting (3s per user) and content limits (2000 chars, 5 attachments) are enforced.

How do I delete my data?

Use /deletedata anywhere (in a server or in DMs). You'll be shown exactly what will be deleted and must click a confirmation button. Deleted data includes:

  • Economy balances and transactions
  • Leveling XP and progress
  • Warning records (where you are the subject)
  • Moderation log entries (where you are the target)
  • Suspicious account records
  • All proxy members and groups you own

This action is irreversible. See our Privacy Policy for more details.

What does the proxy system do?

The proxy system lets users send messages as different identities via webhooks. It's designed for plural systems, roleplay, or anyone who wants to use alternative personas. Create members with /proxy create, set tags, and your messages automatically send through webhooks with that member's name and avatar.

Is the economy real money?

No. All currency is virtual and has absolutely no real-world monetary value. It cannot be exchanged for real money, goods, or services. Gambling features are purely for entertainment. See the Terms of Service for details.

The bot says "insufficient permissions" — what do I do?

This usually means you lack the bot's permission node for that command. Ask a server admin to check your permissions with /permissions check @You <node> and grant the needed node. You can find required nodes on the Commands page.

If the bot itself lacks Discord permissions, ensure it has the necessary Discord role permissions (e.g., Ban Members for /ban, Manage Messages for /purge).

Common Error Codes

If you encounter an error, use /error <code> in Discord for detailed info. Here are some common ones:

CodeMeaningSolution
403Missing bot permissionsEnsure the bot has the required Discord permission (e.g., Ban Members)
703Data operation failedRetry the command. If persistent, check bot logs for disk issues.
710Proxy member not foundCheck the member name/ID with /proxy list
429Rate limitedYou're sending commands too quickly. Wait a few seconds and retry.

Troubleshooting

Bot is offline / not responding?
  • Check if the bot process is running on the host machine.
  • Verify the bot token in config.json is correct and hasn't been regenerated.
  • Check the logs/ directory for error messages.
  • Ensure the host machine has internet access.
Global chat messages not relaying?
  • Confirm both servers are linked to the same global channel (/globalchat info).
  • Check that neither server is muted.
  • Ensure the bot has Manage Webhooks permission in the linked channels.
  • Verify the sending user has the globalchat.use permission.
Proxy messages not working?
  • The bot needs Manage Webhooks and Manage Messages permissions.
  • Ensure your proxy tags are set correctly with /proxy list.
  • The Message Content intent must be enabled in the Developer Portal.