Skip to main content

Server Configuration

Server configuration changes behavior shared by everyone in a guild, so Kakashi checks Discord management permissions before allowing changes.

This section covers the settings currently exposed by Kakashi's configuration system:

A reliable setup workflow​

For any configuration feature, use the same basic process:

  1. Confirm the person configuring it has the required Discord permission.
  2. Choose/create the target role or channel.
  3. Confirm Kakashi itself can perform the final action there.
  4. Save the configuration.
  5. Use a built-in test/preview when the feature provides one.
  6. Re-test after changing role hierarchy or channel/category permission overwrites.
info

A saved setting does not grant Discord permissions. Kakashi can remember the correct channel or role and still be blocked by Discord when the event happens.

Permission hotspots​

Two Discord rules cause most configuration issues:

Channel overwrites​

A role can have a permission at server level and lose it in one category/channel. Test permissions in the actual destination.

Role hierarchy​

For autoroles, Kakashi's highest role must be above the role it is assigning. Manage Roles cannot bypass hierarchy.

If you are configuring Kakashi from scratch:

  1. Set the server language.
  2. Configure autoroles if your onboarding needs them.
  3. Configure and test welcome / leave messages.
  4. Add confessions only after moderation rules for that channel are clear.
  5. Add Reddit feeds only to channels where Kakashi can manage the delivery webhook.

Troubleshooting​

Use Configuration Troubleshooting for the common failure patterns. If one feature works in one channel but not another, compare channel overrides before changing the global bot role.

In this section​

GuideWhat it covers
AutorolesAutomatically assign roles to new members or bots and avoid Discord role hierarchy problems.
Ban MessagesCustomize the message Kakashi shows when a moderator bans a user.
Confession ChannelChoose where Kakashi sends server confessions.
Server LanguageSet the language Kakashi uses in a server.
Leave MessagesConfigure and test messages sent when a member leaves.
Message VariablesUse dynamic placeholders in configurable Kakashi messages.
Configuration PermissionsUnderstand permissions required to configure Kakashi.
Reddit FeedsPost new subreddit content into a Discord channel through Kakashi.
Configuration TroubleshootingFix common Kakashi server configuration problems.
Welcome MessagesConfigure, preview and test the message Kakashi sends when a member joins.