Skip to main content

Configuration Troubleshooting

Most configuration failures fall into one of four buckets: the saved target is gone, the user lacks the configuration permission, Kakashi lacks the action permission, or Discord hierarchy/overwrites block the final action.

Autorole is not assigned​

Check:

  1. The configured role still exists.
  2. Kakashi has Manage Roles.
  3. The target role is not Discord-managed.
  4. Kakashi's highest role is above the target role.
  5. You configured the correct account type (member vs bot).

Welcome/leave message is missing​

Use the built-in test action, then verify:

  • the destination channel still exists;
  • Kakashi can view/send there;
  • Embed Links/Attach Files are available if the message uses those features;
  • image URLs and color values are valid.

If the test works but a real event does not, you have already ruled out most presentation/permission issues.

A variable appears literally​

Compare the variable against Message Variables. Welcome/leave and ban messages do not expose exactly the same placeholder set.

Reddit feed will not configure​

Check:

  • the server has fewer than 10 feeds;
  • the destination is a text channel;
  • Kakashi has Manage Webhooks there;
  • the subreddit exists and is accepted;
  • it is not already configured;
  • the subreddit is not rejected by the NSFW rule.

Confessions do not post​

Confirm the confession destination still exists and Kakashi can send there. Then test the /confess feature separately from the configuration command.

A setting worked before a role/channel reorganization​

Role ordering and permission overwrites can break a saved configuration without changing the stored ID. Re-check the current Discord layout before deleting/recreating the Kakashi setting.

tip

Change one variable at a time while troubleshooting. If you move roles, change channels and edit the message simultaneously, you lose the ability to tell which change fixed the problem.