Server Announcements

A lightweight server-side Minecraft mod that helps server administrators manage login announcements and rules through simple in-game commands.

Features

Login Announcements (MOTD)

• Display custom messages to players when they join the server
• Players can view announcements anytime with /announcements
• Edit announcements in-game without restarting the server
• Supports full Minecraft color codes and formatting

Server Rules

• Create and manage a list of server rules
• Players can view rules anytime with /rules
• Easy in-game editing for server administrators
• Separate from announcements for better organization

Requirements

• Minecraft: 1.21.X
• NeoForge: 21.X
• Installation: Server-side only (clients don't need the mod)

Installation

1. Download the latest release
2. Place the .jar file in your server's mods folder
3. Start your server - configuration files will be created automatically
4. Customize announcements and rules using in-game commands

Commands

For All Players

• /announcements or /announcement - View the server announcements
• /rules - View the server rules

For Admins

Announcements:

• /announcement list - View all announcements with line numbers
• /announcement add <message> - Add announcement to the end
• /announcement <line> add <message> - Insert at specific line
• /announcement <line> replace <message> - Replace a line
• /announcement <line> remove - Delete a line
• /announcement broadcast - Send announcements to all online players
• /announcement clear - Clear all (requires confirmation)
• /announcement reload - Reload from disk

Rules:

• /rules list - View all rules with line numbers
• /rules add <message> - Add rule to the end
• /rules <line> add <message> - Insert at specific line
• /rules <line> replace <message> - Replace a rule
• /rules <line> remove - Delete a rule
• /rules clear - Clear all (requires confirmation)
• /rules reload - Reload from disk

Configuration

The mod stores data in JSON files located at config/serverannouncements/:

• announcements.json - Login messages (max 10 lines)
• rules.json - Server rules (max 15 rules)

You can edit these files directly or use in-game commands. Changes made in-game are saved automatically.

Examples

Adding a colorful welcome message:

/announcement add §6§l════════════════════════════

/announcement add §a§lWelcome to Our Server!

/announcement add §eType §b/rules§e to get started

/announcement add §6§l════════════════════════════

Setting up server rules:

/rules add §e§lServer Rules:

/rules add §a1. §fBe respectful to all players

/rules add §a2. §fNo griefing or stealing

/rules add §a3. §fNo cheating or hacking

Building from Source

git clone https://github.com/ckoval7/serverannouncements.git

cd serverannouncements

./gradlew build

The compiled mod will be in build/libs/.

License

This project is licensed under GPLv3. See the LICENSE file for details.

Support

For bug reports and feature requests, please use the Issues page on GitHub.

Author: Corey Koval