Introduction to Modegator
Welcome to the Modegator documentation. Modegator is an advanced Reddit automation and moderation suite designed to supercharge your subreddit's moderation capabilities. It introduces stateful tracking, Cron scheduling, and custom interactive tools directly into Reddit's moderation tools.
Modegator allows moderators to define powerful, event-driven automation rules, inject custom UI actions into the native Reddit experience, and manage recurring scheduled tasks, all from a centralized, private, and secure dashboard.
Unlike legacy bot solutions that require external hosting or complex setups, Modegator runs entirely within the Reddit ecosystem using the Reddit Developer Platform (Devvit).
Architectural Building Blocks
Modegator operates on an execution pipeline that connects event triggers to action chains. The diagram below illustrates how these five core building blocks interact:
- Rules: Event-driven configurations that listen to Reddit webhook events (like a new post or comment) and execute actions.
- Schedulers: Chronological, time-based tasks running background cron sweeps on the subreddit.
- UI Actions: Custom, on-demand moderation buttons injected directly into comments and posts for interactive moderation.
- Macros: Predefined sequences of actions designed to be reused across different rules, schedulers, and UI buttons.
- Actions: The lowest-level operations that are executed (e.g., removing a post, banning a user, or storing a state value).
AutoMod vs. Modgator Comparison
For subreddits utilizing standard configuration mechanisms, here is a side-by-side comparison of Reddit's native AutoModerator and Modgator:
| Feature | Reddit AutoModerator | Modgator |
|---|---|---|
| State & Memory | Stateless (cannot track previous behavior) | Stateful (Redis-backed custom counters and values) |
| Interactive Mod UI | None | Custom UI Actions (mod buttons injected into post/comment menus) |
| External Alerting | None | Slack & Discord Webhooks (native channel alerts) |
| ModMail Events | Send Modmail only | Trigger rules on incoming Modmails |
| Action Control Flow | Basic linear list | Delay execution, macro re-use, and fallback actions |
| Background Cron Tasks | None | Scheduled background jobs (Cron-based sweeps) |
| Execution Latency | Instantaneous (Pre-render filtering) | Near real-time (Asynchronous trigger queue) |
Architecture
Modegator is built using a modern, scalable architecture:
- Devvit: The core runtime environment. It natively listens to subreddit events without polling limits.
- Hono API: A lightweight backend framework routing API requests from the frontend WebView.
- React Frontend: A WebView dashboard utilizing Vite and TailwindCSS for a seamless, modern UI.
- Redis State: All configurations, task queues, and action logs are securely stored in the subreddit's dedicated Redis database.
Ready to get started? Head over to the Installation guide to install Modegator on your subreddit.