📜 RulesPlugin - Custom GUI Rules Acceptance

RulesPlugin is a lightweight Minecraft server plugin that shows your server rules in a clean GUI and requires players to accept them before playing.

It is designed for server owners who want a customizable rules menu, acceptance tracking, reloadable configuration, and safer GUI handling without building a custom system from scratch.

🚨 Latest Update

v1.3.1 - "The" RulesPlugin Update is focused on stability, safer GUI handling, config reload reliability, and Minecraft 26.1.x compatibility.

• 🛡️ Stronger GUI protection against item leaks and duplication attempts.
• 🔄 Safer /rules reload with YAML validation.
• 🧩 Better Spigot compatibility by avoiding unnecessary Paper-only calls.
• 📡 Clearer update-check messages for offline or no-network servers.

See more on the Blog post

✨ Features

• 🧩 Fully customizable through config.yml.
• 📄 Unlimited rules with automatic GUI pagination.
• 🎨 Custom rule titles, descriptions, punishments, and item icons.
• 🧱 Custom accept button item and display name.
• ↔️ Custom previous/next page buttons.
• 🚫 Blocks player actions until the rules are accepted.
• 💾 Tracks accepted players in data.yml.
• 🗂️ Optional acceptance log in rules.log.
• 🔎 Recent logs and version-specific logs with pagination.
• 🔁 Rule versioning: increase rules-version to force players to re-accept updated rules.
• ⚙️ In-game reload command with YAML validation.
• 📣 Force-open the rules GUI for one player or everyone online.
• 🔐 Permission support for admin commands.
• 🧠 Tab completion for RulesPlugin commands.
• 📦 Update checker with official download links.
• 🧭 Targets Minecraft 26.1.x servers.

🧰 Commands

📁 Configuration Preview

rules-version: 1
gui-title: "📜 Server Rules"

accept-button:
  name: "§aClick here to accept the rules"
  item: EMERALD_BLOCK

previous-page:
  name: "§a< Previous Page"
  item: ARROW

next-page:
  name: "§aNext Page >"
  item: ARROW

accepted-message: "§aYou've accepted the server rules!"
error-message: "§cYou must accept the rules before doing anything!"
rules-updated-message: "§cThe rules have been updated. Please review and accept them again."
update-check-failed-message: "§e[RulesPlugin] Could not reach the update API. Offline servers can ignore this; the plugin will keep working."

rules:
  - title: "§e1. Be respectful"
    description: "§7Treat all players with kindness."
    punishment: "§cPunishment: 1h mute"
    item: PAPER

  - title: "§e2. No hacking"
    description: "§7Mods and hacks are not allowed."
    punishment: "§cPunishment: Permanent ban"
    item: BARRIER

Use Bukkit material names for icons, such as STICKY_PISTON, DIAMOND_SWORD, PAPER, or EMERALD_BLOCK.

Full configuration guide: RulesPlugin Config

📥 Installation

1. Download the latest .jar from the official RulesPlugin pages.
2. Place it inside your server's /plugins folder.
3. Start or restart the server.
4. Edit config.yml if you want to customize rules, messages, or GUI items.
5. Run /rules reload after changing the config.

Official downloads:

• Modrinth
• SpigotMC

🧩 Compatibility

RulesPlugin v1.3.1 targets Minecraft 26.1.x servers.

The plugin is built against the Spigot API and avoids unnecessary Paper-only calls where Spigot compatibility is expected.

🛡️ Security Notes

RulesPlugin GUI items are internally tagged by the plugin. If a client desync, lag spike, creative interaction, drag action, or crafting-slot edge case moves a GUI item outside the menu, RulesPlugin detects the tag and removes the item automatically.

This protection runs during inventory events and through a periodic cleanup task for online players.

📜 License

RulesPlugin is distributed under the RulesPlugin Custom License Agreement (RPCLA).

Redistribution, re-uploading, selling, sublicensing, or distributing modified builds is not allowed unless explicitly authorized by CorruptedWindows.

License page: RulesPlugin License

🔗 Links

• Website: rulesplugin.netlify.app
• Modrinth: modrinth.com/plugin/rulesplugin
• SpigotMC: RulesPlugin on SpigotMC