Quick Start

Get moderation running on your server in a few steps.

Prerequisites

A Robo.js project with a Discord bot (Bots guide)
Bot added to your server with appropriate permissions

The MessageContent privileged intent is required for the rules enforcement feature. Enable it in the Discord Developer Portal under your application's Bot settings.

Install

Add the plugin

npx robo add @robojs/moderation@next

This installs the package and registers the required intents and permissions automatically.

Start your Robo

npx robo dev

The moderation commands register with Discord on startup.

Run setup

In your Discord server, run:

/mod setup

This opens an interactive panel with channel selectors and feature toggles.

Configure channels

Use the dropdown menus to select existing channels for Moderator Logs and Moderator Mail, or click Create channels to have the plugin create them with restricted permissions.

Moderator Logs receives a record of every moderation action (bans, kicks, warns, timeouts, forgives, setting changes).
Moderator Mail receives user reports submitted via /mod report and the Report Anonymously context menu.

Try a command

Test the setup by auditing a user:

/mod audit user:@someone

You should see an embed with the user's status, infraction count, and a Ban/Unban button.

Before using moderation commands on real members, toggle Test mode in the setup panel. Test mode simulates all actions without executing them — bans, kicks, and warns are logged with a [TEST] prefix but no actual Discord actions occur.

File structure

After installation, the plugin registers its commands and events through Robo's file-based routing. No files are added to your project.

The plugin config file is optional:

moderation.mjs

See Configuration for available options.

Next Steps

Configuration

Plugin options, intents, and permissions.

Commands

Full reference for all moderation commands.

Moderation Channels

Configure logging and report channels.