
? RulesPlugin - 自定义 GUI 规则接受
RulesPlugin 是一个轻量级的 Minecraft 服务器插件,它通过简洁的图形用户界面(GUI)展示服务器规则,并要求玩家在开始游戏前接受这些规则。
它专为希望拥有可自定义的规则菜单、接受记录追踪、可重载配置以及更安全 GUI 处理的服务器管理员设计,无需从零开始构建自定义系统。
? 最新更新
v1.3.3 - 紧急热修复 修复了两个影响规则接受和更新通知的用户反馈回归问题。
- 修复了从第 1 页导航离开后接受按钮失效的问题。
- 修复了虚假更新通知:在安装 v1.3.2 的情况下仍报告 v1.3.1。
- 使用官方 Modrinth API 替换了旧版网站版本文件。
- 添加了正确的数字版本号比较功能,确保旧版本不会被误报为更新。
- 从更新通知中移除了已停用的 SpigotMC 下载链接。
✨ 功能特性
- 完全可通过
config.yml 进行自定义。
- 支持无限数量的规则,并具备自动 GUI 分页功能。
- 自定义规则标题、描述、处罚措施及物品图标。
- 自定义接受按钮的物品及其显示名称。
- 自定义上一页/下一页翻页按钮。
- 在玩家接受规则之前阻止其进行操作。
- 在
data.yml 中追踪已接受的玩家。
- 可选的接受日志记录于
acceptance-log.yml。
- 支持带分页功能的近期日志和特定版本日志查看。
- 规则版本控制:增加
rules-version 值可强制玩家重新接受更新后的规则。
- 内置带有 YAML 验证的重载命令。
- 可为单个玩家或所有在线玩家强制打开规则 GUI。
- 支持管理命令的权限控制。
- RulesPlugin 命令支持 Tab 补全。
- 内置更新检查器并提供官方下载链接。
- 强大的 GUI 物品泄漏与复制保护机制。
? 命令列表
| 命令 |
描述 |
权限节点 |
/rules |
打开规则 GUI。如果规则已接受,则以只读模式打开。 |
rulespl.rules |
/rules reload |
重载并验证配置文件。 |
rulespl.reload |
/rules logs |
显示最近的规则接受记录。 |
rulespl.seelogs |
/rules logs v<version> [page] |
显示特定规则版本的接受记录,支持分页。 |
rulespl.seelogs |
/rules show <player> |
为指定玩家强制打开首次加入时的规则 GUI。 |
rulespl.show |
/rules show everyone |
为所有在线玩家强制打开首次加入时的规则 GUI。 |
rulespl.show |
? 配置预览
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
请使用 Bukkit 材质名称作为图标,例如 STICKY_PISTON、DIAMOND_SWORD、PAPER 或 EMERALD_BLOCK。
完整配置指南:RulesPlugin Config
? 安装步骤
- 从 Modrinth 下载适用于您 Minecraft 服务器版本的正确
.jar 文件。
- 将其放入服务器的
/plugins 文件夹中。
- 启动或重启服务器。
- 如需自定义规则、消息或 GUI 物品,请编辑
config.yml。
- 修改配置后运行
/rules reload。
官方下载:
? 兼容性
RulesPlugin 目前提供以下独立构建版本:
- Minecraft 1.21.x
- Minecraft 26.1.x
- Minecraft 26.2.x
- Minecraft 26.3.x
该插件基于 Spigot API 构建,并在预期兼容 Spigot 的情况下避免使用不必要的 Paper 专属调用。
RulesPlugin 还声明了对 GeyserMC 和 Floodgate 的被动兼容性。如果安装了 Geyser-Spigot 或 floodgate,RulesPlugin 将在它们之后加载,并记录检测到的兼容状态。
?️ 安全说明
RulesPlugin 的内部 GUI 物品均由插件打上内部标签。如果客户端不同步、延迟 spike、创造模式交互、拖拽操作或合成栏边缘情况导致 GUI 物品移出菜单范围,RulesPlugin 会检测到该标签并自动移除该物品。
此保护机制在库存事件期间运行,并通过针对在线玩家的周期性清理任务执行。
? 许可证
RulesPlugin 根据 RulesPlugin 自定义许可协议 (RPCLA) 分发。
除非获得 Blix3r_ 的明确授权,否则禁止重新分发、重新上传、出售、再授权或分发修改后的构建版本。
许可证页面:RulesPlugin License
? 相关链接

? 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.3 - Emergency Hotfix fixes two community-reported regressions affecting rule acceptance and update notifications.
- Fixed the accept button becoming invalid after navigating away from page 1.
- Fixed false update notifications that reported v1.3.1 while v1.3.2 was installed.
- Replaced the legacy website version file with the official Modrinth API.
- Added proper numeric version comparison so older releases are never reported as updates.
- Removed the discontinued SpigotMC download link from update notifications.
✨ 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
acceptance-log.yml.
- 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.
- Strong GUI item leak and duplication protection.
? Commands
| Command |
Description |
Permission |
/rules |
Opens the rules GUI. If already accepted, opens it in view-only mode. |
rulespl.rules |
/rules reload |
Reloads and validates the configuration. |
rulespl.reload |
/rules logs |
Shows recent rule acceptances. |
rulespl.seelogs |
/rules logs v<version> [page] |
Shows acceptances for a specific rules version with pagination. |
rulespl.seelogs |
/rules show <player> |
Force-opens the first-join rules GUI for one player. |
rulespl.show |
/rules show everyone |
Force-opens the first-join rules GUI for everyone online. |
rulespl.show |
? 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
- Download the correct
.jar for your Minecraft server version from Modrinth.
- Place it inside your server's
/plugins folder.
- Start or restart the server.
- Edit
config.yml if you want to customize rules, messages, or GUI items.
- Run
/rules reload after changing the config.
Official download:
? Compatibility
RulesPlugin currently provides separate builds for:
- Minecraft 1.21.x
- Minecraft 26.1.x
- Minecraft 26.2.x
- Minecraft 26.3.x
The plugin is built against the Spigot API and avoids unnecessary Paper-only calls where Spigot compatibility is expected.
RulesPlugin also declares passive compatibility with GeyserMC and Floodgate. If Geyser-Spigot or floodgate are installed, RulesPlugin loads after them and logs the detected compatibility state.
?️ 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 Blix3r_.
License page: RulesPlugin License
? Links
评论 0
登录后参与评分
还没有评论,来抢沙发吧