原创 工具 世界管理 反作弊 SmartHelp 自定义help列表 1.2

SmartHelp 插件​

SmartHelp 是一个适用于 Minecraft Paper 和 Folia 服务器的自定义帮助信息插件，允许服务器管理员灵活管理游戏内帮助信息。​

功能特性​

• 自定义游戏内帮助信息
• 动态管理帮助内容，无需重启服务器
• 支持使用 & 符号的颜色代码（基于 Adventure API）
• 简单易用的命令系统
• 基于权限的管理控制
• 点击命令自动输入到聊天框
• 鼠标悬浮显示详细提示信息
• 帮助页面翻页功能，支持自定义每页显示条数
• 支持点击打开 URL 链接
• 基于 Adventure 5.x API，高性能组件渲染

安装方法​

1. 从 Releases 下载最新版本的 SmartHelp.jar
2. 将下载的 JAR 文件放入服务器的 plugins 目录
3. 重启服务器或使用 /reload 命令加载插件
4. 插件将自动生成配置文件

配置说明​

插件的配置文件位于 plugins/SmartHelp/config.yml，采用新的配置格式，每个帮助条目包含以下字段：​

YAML：

help-messages:[/HEADING]
[HEADING=2]  - display: '&6==== &l服务器帮助 &6===='[/HEADING]
[HEADING=2]  - display: '&a/shop &7- 打开商店'[/HEADING]
[HEADING=2]    command: '/shop'[/HEADING]
[HEADING=2]    hover: '&e点击打开商店界面'[/HEADING]
[HEADING=2]  - display: '&a/tpa &7- 请求传送'[/HEADING]
[HEADING=2]    command: '/tpa '[/HEADING]
[HEADING=2]    hover: '&e点击使用传送请求功能\n&7用法: /tpa <玩家名>'[/HEADING]
[HEADING=2]  - display: '&a/warp &7- 传送点列表'[/HEADING]
[HEADING=2]    command: '/warp'[/HEADING]
[HEADING=2]    hover: '&e点击查看可用传送点'[/HEADING]
[HEADING=2]  - display: '&6======================='

​

你可以直接编辑此文件添加或修改帮助信息，然后使用 /sh reload 命令重载配置。​

​

命令说明​

玩家命令​

/help	显示自定义帮助信息

管理命令​

/smarthelp reload 或 /sh reload	重载配置文件	smarthelp.admin
/smarthelp add <显示文本> [点击命令] [悬浮提示] 或 /sh add <显示文本> [点击命令] [悬浮提示]	添加帮助信息	smarthelp.admin
/smarthelp del <行号1> [行号2] ... 或 /sh del <行号1> [行号2] ...	删除指定行的帮助信息	smarthelp.admin
/smarthelp page <页码> 或 /sh page <页码>	跳转到指定页码	无

权限说明​

smarthelp.admin	允许使用所有管理命令（包含所有子权限）	op
smarthelp.reload	允许重载配置文件	op
smarthelp.add	允许添加帮助信息	op
smarthelp.del	允许删除帮助信息	op

smarthelp.admin 权限包含了 smarthelp.reload、smarthelp.add 和 smarthelp.del 三个子权限，授予该权限即可使用所有管理命令。​

使用示例​

添加帮助信息​

代码：

# 添加普通命令帮助[/HEADING]
[HEADING=2]/sh add &a/shop &7- 打开商店 /shop "&e点击打开商店界面"[/HEADING]
[HEADING=2][/HEADING]
[HEADING=2]# 添加URL链接帮助[/HEADING]
[HEADING=2]/sh add &a服务器官网 https://example.com "&e点击访问服务器官网"

查看帮助信息​

/help​

删除帮助信息​

/sh del 2 3​

重载配置​

/sh reload​

支持的 Minecraft 版本​

• Paper 1.21.11 及以上
• Paper 26.2 及以上（需 Java 25+）
• Folia 1.21.11 及以上

作者​

• 作者：[A2whatever33]
• 版本：1.2

许可证​

MIT License​

更新日志​

v1.2​

• 升级到 Adventure 5.x API，使用新的点击事件和悬浮事件构造方法
• 优化组件渲染性能
• 支持 Paper 26.2 及以上版本
• 修复与新版 Adventure API 的兼容性问题
• 规范化版本号，移除 SNAPSHOT 版本

v1.1​

• 添加了可点击命令功能，点击后自动输入到聊天框
• 添加了鼠标悬浮提示功能，显示详细信息
• 优化了配置文件格式，支持更丰富的帮助信息配置
• 添加了旧格式配置文件的自动转换功能
• 修复了未使用的方法，优化了代码结构
• 添加了Folia服务器支持
• 添加了URL点击功能，支持点击打开网页
• 添加了帮助页面翻页功能，支持自定义每页显示条数
• 支持页码状态显示和翻页控制选项

v1.0​

• 初始版本发布
• 实现自定义帮助信息功能
• 添加管理命令支持
• 支持颜色代码
• 权限系统集成

贡献​

欢迎提交 Issue 和 Pull Request！​

问题反馈​

如果遇到问题，请在 GitHub Issues 提交报告，或联系服务器管理员。​