System Fix

Because Nocturne relies heavily on your server’s roles and channels to function, deleting those items directly in your Discord server settings can sometimes leave ‘ghost’ data in the bot’s database.

The /fix command acts as a comprehensive self-repair tool for Nocturne. If any inconsistencies have been found, this command ensures the bot’s database stays perfectly synchronised with your server.

Running this command will force Nocturne to audit its entire database against your current server configuration and clean up any dead links.

User: Manage Server Bot: Manage Webhook (optional)

Command

/fix

---

What It Fixes

The fix operation will scan for and automatically resolve the following issues:

1. Tree & Role Cleanup

   • Corrupted Trees: Removes any unnamed or null-named trees (this is extremely rare and usually only occurs during an internal database hiccup).
   • Deleted Base Roles: Removes base roles that were deleted from your Discord server. It will also automatically shift the remaining positions in the tree to fill the gap, ensuring your hierarchy ladder doesn’t break.
   • Deleted Linked Roles: Removes any secondary linked roles that were deleted from your Discord server.
   • Deleted Whitelist Roles: Revokes /staff command access from any whitelist roles that no longer exist.

2. Log Channel & Webhooks

   • If you have a log channel configured, Nocturne relies on a Webhook to send messages there. If someone accidentally deletes the channel or the webhook, /fix will attempt to repair it using the following logic:

     • Channel Deleted: If the text channel itself no longer exists, Nocturne will remove the log channel configuration from its database entirely.
     • Webhook Deleted (Permissions Intact): If the channel exists, but the specific webhook was deleted, Nocturne will seamlessly create a new one (provided it still has the Manage Webhooks permission) and restore logging.
     • Webhook Deleted (Permissions Missing): If the channel exists, the webhook is gone, and Nocturne no longer has permission to create a new one, it will safely remove the log channel configuration from its database to prevent future errors.