🗒️ Discord Rules

Update your server rules from Discord. No restarts. No file editing.

Discord Rules fetches your server's rules directly from a Discord message and displays them in-game when a player types /rules. When you need to update the rules, just edit the Discord message — every player sees the new version on their next /rules command.

✨ Features

/rules command — displays formatted rules in chat
Live from Discord — rules source is a Discord message you control
No restarts needed — edit the Discord message, changes appear automatically
30-minute cache — fast response with periodic refresh (configurable)
Per-player cooldown — prevents spam (default 60s, configurable)
Configurable colors — set header and body colors in TOML config
Discord Markdown support — bold headers and - bullet points render correctly in-game
Supports NeoForge 1.21.1, Forge 1.20.1, Forge 1.18.2, and Forge 1.16.5

⚙️ Setup

1. Create a Discord bot

Go to discord.com/developers → Create an application → add a Bot → Copy the Bot Token → Invite the bot to your server with Read Messages permission in the rules channel

2. Get your message IDs

Enable Developer Mode in Discord (User Settings → Advanced) → Right-click your rules channel → Copy Channel ID → Post your rules message → right-click it → Copy Message ID

3. Configure the mod

After your first server start, find the config file at: world/serverconfig/discordrules-server.toml

⚠️ Note: The config is in world/serverconfig/ — not the config/ folder.

[discord]
bot_token = "YOUR_BOT_TOKEN"
channel_id = "YOUR_CHANNEL_ID"
message_id = "YOUR_MESSAGE_ID"

[performance]
cooldown_seconds = 60
cache_minutes = 30

[display]
header_color = "GOLD"
body_color = "YELLOW"
strip_emojis = true

4. Start your server

Players can now type /rules to see your rules in-game.

📝 Writing Your Rules in Discord

Use Discord Markdown for formatting:

**Server Rules**
**1. Be Respectful**
- Treat all players with kindness
- No harassment or hate speech
**2. No Griefing**
- Protect your builds with /claim
- Respect claimed areas

Lines wrapped in **double asterisks** appear as bold headers. Lines starting with - appear as indented bullet points.

🎨 Color Options

Valid values for header_color and body_color:

BLACK DARK_BLUE DARK_GREEN DARK_AQUA DARK_RED DARK_PURPLE GOLD GRAY DARK_GRAY BLUE GREEN AQUA RED LIGHT_PURPLE YELLOW WHITE

📦 Compatibility

Minecraft Version	Loader	Java
1.21.1	NeoForge	Java 21
1.20.1	Forge	Java 17
1.18.2	Forge	Java 17
1.16.5	Forge	Java 8

Server-side only — players do not need to install this mod.

🔒 License

MIT — free to use, modify, and redistribute.

🐛 Issues & Support

For questions and support, join the Firefrost Gaming Discord.

— Firefrost Gaming