Back to Home

Setup Guide

Complete step-by-step guide to configure RippleRealm for your Discord server.

Quick Navigation

Initial Setup Quick Start Command Permissions Server Management Moderation Logging Auto-Moderation Utilities Fun & Games Feature Details

Initial Setup

Essential first steps to get RippleRealm working properly in your Discord server.

1. Invite the Bot

Use the bot's invite link to add it to your Discord server.

2. Grant Administrator Permissions

For the bot to function fully, it needs Administrator permissions. This is the simplest way to ensure all features work as intended.

Alternative: Create a dedicated "Admin" or "Bot" role with extensive permissions

3. Configure Role Hierarchy

In your Server Settings > Roles, ensure the bot's role is positioned near the top of the role list.

Position: Below server owner/admin roles, above all user roles

4. Verify Channel Permissions

Make sure the bot has permission to View Channel, Send Messages, and Embed Links in all relevant channels.

Additional: Manage Messages, Kick Members, Ban Members for moderation

Quick Start: First Steps

Core features to configure immediately after inviting the bot for maximum benefit.

1. Set Up Logging

Create a private channel (e.g., #mod-logs) and configure logging for server activity.

message deletes enable
joins enable

2. Configure Welcome Messages

Create a public channel (e.g., #welcome) to greet new members.

→ Welcome Setup

3. Enable Auto-Moderation

Start protecting your server from spam and unwanted content.

system
punishment

Command Permissions

Control which commands are available, who can use them, and in which channels they can be used.

Configure Command Access

  1. Go to Server Settings > Integrations
  2. Find RippleRealm in the list and click Manage
  3. Select individual commands and configure their permissions
  4. Restrict commands to certain roles or channels as needed
Security Note

Restrict powerful commands (/management, /moderation, /modpanel, /log, /antispam, /censor, /automod) to trusted staff roles. These commands can significantly impact your server and should not be available to everyone.

Command Reference

Server Setup & Management

Essential commands for configuring the bot's core behavior in your server.

/management

Opens an interactive panel to manage all server-related settings, including welcome messages, logging, and more.

/server info

Displays detailed information about the server.

/role create

Creates a new role with custom settings.

/togglerole

Allows users to self-assign or remove a role from a predefined list.

Moderation Tools

Powerful tools for server moderators to manage users and maintain order.

/modpanel user

Opens an interactive control panel for moderating a specific user.

/moderation kick

Kicks a single member from the server.

/moderation ban

Bans a member from the server.

/moderation timeout

Temporarily restricts a member's ability to communicate.

/moderation warn

Issues a warning to a member.

Logging Configuration

Configure the bot to log various server events to specific channels for effective moderation.

/log settings

Shows the current settings for all logging commands.

/log joins

Sets the channel for logging member joins.

/log message edits

Sets the channel for logging edited messages.

/log message deletes

Sets the channel for logging deleted messages.

Auto-Moderation

Automated systems to help manage spam and unwanted content automatically.

/antispam system

Enables, disables, or views settings for the anti-spam system.

/censor system

Enables, disables, or views settings for the censor system.

/automod create-rule

Creates a new Discord AutoMod rule.

Detailed Feature Explanations

In-depth information and setup examples for the bot's key features

Welcome Messages

Create custom, embedded welcome messages instead of Discord's default system.

  1. Use /management and select "Welcome Setup"
  2. Set a Welcome Channel where messages will be sent
  3. Set a Welcome Title for the embed
  4. Set a Welcome Message with placeholders like @user@ and #guild#

Forms & Tickets

Professional support system creating private channels for staff-member interaction.

  1. Use /forms management or /tickets management
  2. Set Category: Choose where new channels will be created
  3. Set Roles: Assign staff roles that should have access
  4. Create Types: Different types like "Support", "Bug Report"
  5. Launch: Use /forms launch in a public channel

Sticky Notes

Create messages that always stay at the bottom of a channel.

/sticky create channel:#channel-name

The bot automatically deletes the old sticky message and posts a new one whenever someone sends a message.

Suggestions System

Structured way for members to submit ideas with community voting.

/suggestions suggestions_channel:#suggestions review_channel:#suggestion-review

Messages in suggestions channel are automatically moved to review with upvote/downvote buttons.

Setup Complete!

Your RippleRealm bot is now configured. Explore these additional resources:

All Features
Browse complete command reference
Latest Updates
See what's new and changelog