Skip to Content
Haven Documentation is the shared home for product guides, plugin setup, and release docs.
PluginsThread WatcherSetup

Thread Watcher Setup

Requirements

  • AthenaBot 2.5.1 or newer
  • The core plugin enabled
  • No extra Node packages
  • View Channel, Read Message History, and Manage Threads for every protected forum or media channel
  • Manage Threads for individually protected threads

Installation

  1. Place the plugin folder at plugins/thread_watcher.
  2. Start AthenaBot once so it generates:
    • configuration/thread_watcher.json5
    • configuration/thread_watcher_lang.json5
  3. Stop AthenaBot and open the dashboard or the generated main config.
  4. Add forum or media channel IDs to forum_channel_ids when every post in a channel should stay open.
  5. Add individual post or thread IDs to thread_ids when only selected threads should stay open.
  6. Confirm command_permission matches a key in configuration/permission.json5.
  7. Restart AthenaBot and run /threadwatch list.
  8. Run /threadwatch check to perform the first recovery scan.

Athena needs Manage Threads to reopen archived threads and change archive timers. Forum-wide protection also needs View Channel and Read Message History so archived posts can be discovered.

Add Targets From Discord

Administrators can add targets without editing the config:

  • Run /threadwatch add inside a forum post or thread to protect the current thread.
  • Run /threadwatch add target:<forum> to protect every post in a forum.
  • Run /threadwatch add target:<thread> to protect one thread.

Targets added with the command are stored in Athena’s database. Dashboard or JSON5 targets remain separate, and a target can be protected by both sources.

  1. Set dry_run to true.
  2. Add one test forum or thread.
  3. Run /threadwatch status in the target.
  4. Run /threadwatch check and review the scan results.
  5. Confirm Athena reports that it can manage the target.
  6. Set dry_run to false when the target list and permissions are correct.

Safe Launch Checklist

  • Protect only the forums and threads that should remain open.
  • Confirm Athena can view forum history and manage threads.
  • Keep max_unarchives_per_scan and action_delay_ms at conservative values.
  • Configure a log channel if reopen and error history should be retained in Discord.
  • Test a manually locked thread and confirm it remains closed.
OverviewConfiguration