Skip to main content

@robojs/moderation

Tailored for Discord server management, this plugin includes a suite of commands essential for moderation. With enhanced features like anonymous warnings, attachment inclusion in reports, and comprehensive mod channel logs, it takes moderation to the next level.

➞ 📚 Documentation: Getting started

➞ 🚀 Community: Join our Discord server

Installation​

To add this plugin to your Robo.js project:

Terminal
npx robo add @robojs/moderation

New to Robo.js? Start your project with this plugin pre-installed:

Terminal
npx create-robo <project-name> -p @robojs/moderation

Slash Commands​

Utilize these commands for efficient moderation:

CommandDescription
/mod auditDelve into a member's server interactions and activities.
/mod banEffectively ban members who violate server rules.
/mod forgiveClear strikes or infractions, offering members a fresh start.
/mod kickTemporarily remove disruptive members from your server.
/mod reportFacilitate community-driven reporting of issues.
/mod setupInitiate and configure your moderation setup.
/mod timeoutImpose timeouts on members for cooling-off periods.
/mod warnIssue warnings to members, adding to their strike count.
/mod rules-msg set-rulesbrings up a modal to add in the embed title, rules(description) and an image url.
/mod rules-msg set-member-roleset the role of members in the guild, they cant send messages with out this role but they earn this role from the rules accept button.
/mod rules-msg sendsends the rules message with the i accept button to the channel where used.

Context Commands​

Enhance user experience with context-specific commands:

CommandDescription
Report Anonymously (Message)Enable members to report issues anonymously.
Audit (User)Quickly access a user's activity log with a click.

Moderation Channels​

Moderation channels are dedicated spaces for tracking and managing server activities:

  • Moderator Logs: Detailed logs of every moderation action taken.
  • Moderator Mail: Central hub for receiving and managing user reports.

Seamless Setup​

Once you add the plugin, run the /mod setup command as a moderator to configure your moderation tools:

  • Moderation Channels: Set up your moderation channels for logging and reporting.
  • Confirmation Mode: Require explicit confirmation for each action, avoiding accidental moderation.
  • Lockdown Mode: Allow only moderators to use this Robo.
  • Test Mode: Safely simulate moderation actions for training purposes.

AI Integration​

"@SageBot please ban @Baguette for spamming bread"

Integrate with @robojs/ai to experience the next level of moderation. Use natural language for commands and watch your Robo execute them with AI's understanding.

Terminal
npx robo add @robojs/ai

Automatic Poll Deletion​

Don't like poll spam? Enable automatic poll deletion to keep your server clean and organized.

// config/plugins/robojs/moderation.mjs
export default {
	deletePolls: true
}

Starting Your Robo.js Journey​

If you're new to Robo.js:

Terminal
npx create-robo <name>

Enjoy your enhanced moderation experience! 🚀

More on GitHub​