
? 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-versionto 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
.jarfor your Minecraft server version from Modrinth. - Place it inside your server's
/pluginsfolder. - Start or restart the server.
- Edit
config.ymlif you want to customize rules, messages, or GUI items. - Run
/rules reloadafter 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
- Website: rulesplugin.netlify.app
- Modrinth: modrinth.com/plugin/rulesplugin
下载 Rules Plugin
下载 Rules Plugin
下载 Rules Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rules Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rules Plugin
下载 Rules Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rules Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rules Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rules Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Rules Plugin
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
? RulesPlugin v1.3.3 - 紧急热修复
本次紧急稳定性更新修复了社区报告的两个回归问题。
? 已修复
- 修复了在离开第一条规则页面后接受按钮失效的问题。
- 玩家现在可以从任何 GUI 页面正确接受规则。
- 修复了更新通知错误地显示为 v1.3.1,而实际安装的是 v1.3.2 的问题。
- 移除了过时的通过
latest.txt进行的静态版本检查。 - 从更新通知中移除了已停用的 SpigotMC 链接。
? 更新检查器
更新检查器现使用官方 Modrinth API,并直接读取 version_number 字段。
版本号采用数值比较方式,防止旧版本被错误地报告为更新。
如果无法连接 Modrinth,RulesPlugin 会显示清晰的警告,同时继续正常工作。
✅ 兼容性
提供以下版本的专用 v1.3.3 构建:
- Minecraft 1.21.x
- Minecraft 26.1.x
- Minecraft 26.2.x
- Minecraft 26.3.x
请下载与你的 Minecraft 服务器版本匹配的 JAR 文件。
❤️ 特别感谢
感谢 Joëlle Tiehuis、Metsh 和 Zack 报告并复现这些问题。
? 文档: rulesplugin.netlify.app
⬇️ 下载: 用正确的 v1.3.3 构建替换之前的 RulesPlugin JAR 文件,然后重启服务器。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧