Skip to main content

FAQ

The Bot Cannot Assign Roles​

Likely cause: Grimoire's role is below the target role.

Check:

/diagnostics permissions

Fix: move Grimoire above every role it must assign or remove.

Verification Role Is Not Being Added​

Likely cause: missing Manage Roles, wrong role hierarchy, or Server Members intent disabled.

Check:

/diagnostics module module:verification

Fix: grant Manage Roles, move the bot role above the verified role, and enable Server Members intent.

Anti-Spam Timeout Does Not Work​

Likely cause: missing Moderate Members or target is not moderatable.

Check:

/diagnostics module module:anti_spam

Fix: grant Moderate Members and check role hierarchy.

Status Blacklist Is Not Detecting Statuses​

Likely cause: Presence intent is disabled or presence data is unavailable.

Check:

/diagnostics module module:status_blacklist

Fix: enable Presence intent and restart the bot. Presence detection is not guaranteed if Discord does not provide presence data.

Slash Commands Are Missing​

Likely cause: commands were not deployed or Discord has not propagated changes.

Fix:

npm run deploy:commands

Then wait for Discord command propagation.

A Configured Channel, Role, or Message Is Missing​

Likely cause: the Discord resource was deleted after Grimoire saved its ID.

Fix: recreate the resource or rerun that module's setup command to select a current channel or role. Regenerate deleted panel messages.

Grimoire Says The Item Already Exists​

Likely cause: the name or option key is already used by that server configuration.

Fix: edit the existing item or choose a different unique name or key.

Reaction Roles Do Not Respond​

Likely cause: missing Add Reactions, Read Message History, or Manage Roles.

Check:

/diagnostics module module:role_menus

Fix: grant permissions and move Grimoire above target roles.

Starboard Does Not Post​

Likely cause: reaction intent, threshold, ignored channel, or output channel permissions.

Check:

/diagnostics module module:starboard

Fix: verify reaction intent, threshold, and channel permissions.

Gang Owner Cannot Add Members​

Likely cause: owner permissions, slot limit, or the user is already active in another gang.

Check:

/diagnostics module module:gang_priority

Fix: remove the user from the old gang first, increase slots if appropriate, and check role hierarchy.

Premium Module Is Locked​

Likely cause: the guild has Normal access.

Check:

/license plan

Fix: upgrade to Premium Monthly or Premium Lifetime.