LogoRobo.js

@robojs/moderation

Equip your bot with essential tools to manage and maintain your server.

MIT215.4 kB Package Size351 B Bundle Size
Install @robojs/moderation with:

A moderation suite for Discord servers built on Robo.js. Ban, kick, warn, timeout, audit, and report members through slash commands and context menus — with dedicated logging channels, a rules acceptance system, lockdown mode, and AI-powered natural language moderation.

Features

Slash Commands

Ban, kick, warn, timeout, forgive, audit, report, and setup

Context Menus

Right-click to audit a user or report a message

Rules System

Post rules with an accept button, auto-delete unverified messages

Mod Channels

Dedicated channels for action logs and user reports

Test Mode

Simulate moderation actions without executing them

Lockdown

Restrict all bot commands to moderators only

Anonymous Mode

Execute moderation actions without revealing the moderator

Infraction Tracking

Persistent strike counts and ban records per user

AI Integration

Pair with @robojs/ai for natural language moderation

Installation

Add the plugin to your Robo:

npx robo add @robojs/moderation@next

Or create a new project with it pre-installed:

npx create-robo@next my-bot -p @robojs/moderation@next

The plugin automatically registers required Discord intents and bot permissions when installed.

How it works

Run /mod setup after installing the plugin. This opens an interactive panel where you configure moderation log channels and toggle features like test mode, confirmation mode, and lockdown.

Once configured, moderators use /mod commands to take action. Every action is logged to your moderator logs channel. Users can submit reports via /mod report or the right-click context menu, which land in your moderator mail channel.

The plugin persists infraction counts, ban records, and server settings across restarts using Robo's built-in storage.

  1. Quick Start — Install and configure in under 5 minutes
  2. Configuration — Plugin options, intents, and permissions
  3. Commands — Full reference for all slash and context menu commands
  4. Rules System — Set up rules acceptance and enforcement
  5. Moderation Channels — Configure logging and reports
  6. Lockdown Mode — Emergency command restriction with the getLockdown API
  7. AI Integration — Natural language moderation with @robojs/ai

Next Steps

Quick Start

Install and configure moderation in under 5 minutes.

Commands

Full reference for all moderation commands.

Configuration

Plugin options, intents, and permissions.

Rules System

Set up rules acceptance and enforcement.

Quick Start

Install and configure moderation in under 5 minutes

On this page

Features
Installation
How it works
Recommended learning path
Next Steps