CleanHomeGUI
CleanHomeGUI 是一个轻量级且可定制的基于 GUI 的家系统,适用于 Paper 服务器。
它提供简洁的 /home 体验,包含传送倒计时、音效、备份以及 MySQL 历史记录功能——毫无多余冗余。
✨ 特性
- ✅
/home GUI 系统(支持 3 个家)
- ✅
/home <1-3> 传送支持
- ✅
/sethome 和 /delhome
- ✅ 在 GUI 中右键点击以重命名家
- ✅ 动作栏传送倒计时
- ✅ 玩家移动时取消传送
- ✅ 可配置的冷却系统
- ✅ 带有动态床颜色的简洁 GUI
- ✅ 每个家下方设有删除按钮
- ✅ 自定义音效(UI 点击声、叮铃声、末影珍珠声)
- ✅ 完全可定制的消息(
messages.yml)
- ✅ YAML 备份系统(
backups.yml)
- ✅ MySQL 坐标历史记录系统
- ✅ 仅限 OP 执行的备份与恢复命令
- ✅ 所有命令均支持 Tab 补全
- ✅ 重载命令(
/home reload)
- ✅ 轻量级且优化良好
- ✅ 支持 Paper 1.21+
? 命令
| 命令 |
描述 |
/home |
打开家 GUI |
/home <1-3> |
传送到指定的家 |
/sethome <1-3> |
设置一个家 |
/delhome <1-3> |
删除一个家 |
/home reload |
重载插件 |
/home backups <player> |
查看 YAML 备份 |
/home history <player> |
查看 MySQL 历史记录 |
/home restore <player> <home> <backup> |
恢复 YAML 备份 |
/home restoredb <player> <home> <id> |
从 MySQL 恢复 |
? 权限
| 权限节点 |
描述 |
默认值 |
cleanhomegui.reload |
允许使用 /home reload |
OP |
cleanhomegui.backup |
允许使用备份与恢复命令 |
OP |
?️ MySQL 历史记录
自动创建的表:
home_history
记录内容:
设置、删除、覆盖、恢复
? 备份系统
CleanHomeGUI 会自动将备份保存至:
plugins/CleanHomeGUI/backups.yml
备份会在以下情况创建:
⚙️ 配置
config.yml → GUI、冷却时间、MySQL、行为设置
messages.yml → 所有消息文本
backups.yml → 存储的坐标数据
⚠️ 如果你更新插件:
请删除插件文件夹一次以重新生成配置文件。
? 注意事项
- MySQL 数据库必须在启动前存在
- 插件会自动创建所需的表
- 即使 MySQL 连接失败也能正常工作(YAML 备份作为后备方案)
- 设计目标是简单、快速且可靠
CleanHomeGUI
CleanHomeGUI is a lightweight and customizable GUI-based home system for Paper servers.
It provides a clean /home experience with teleport countdowns, sounds, backups, and MySQL history — without unnecessary clutter.
✨ Features
- ✅
/home GUI system (3 homes)
- ✅
/home <1-3> teleport support
- ✅
/sethome and /delhome
- ✅ Rename homes via right-click in GUI
- ✅ Action-bar teleport countdown
- ✅ Cancel teleport when player moves
- ✅ Configurable cooldown system
- ✅ Clean GUI with dynamic bed colors
- ✅ Delete buttons under each home
- ✅ Custom sounds (UI click, pling, ender pearl)
- ✅ Fully customizable messages (
messages.yml)
- ✅ YAML backup system (
backups.yml)
- ✅ MySQL coordinate history system
- ✅ OP-only backup & restore commands
- ✅ Tab completion for all commands
- ✅ Reload command (
/home reload)
- ✅ Lightweight & optimized
- ✅ Supports Paper 1.21+
? Commands
| Command |
Description |
/home |
Open home GUI |
/home <1-3> |
Teleport to home |
/sethome <1-3> |
Set a home |
/delhome <1-3> |
Delete a home |
/home reload |
Reload plugin |
/home backups <player> |
View YAML backups |
/home history <player> |
View MySQL history |
/home restore <player> <home> <backup> |
Restore YAML backup |
/home restoredb <player> <home> <id> |
Restore from MySQL |
? Permissions
| Permission |
Description |
Default |
cleanhomegui.reload |
Allows /home reload |
OP |
cleanhomegui.backup |
Allows backup & restore commands |
OP |
?️ MySQL History
Table created automatically:
home_history
Tracks:
set, deleted, overwritten, restored
? Backup System
CleanHomeGUI automatically saves backups in:
plugins/CleanHomeGUI/backups.yml
Backups are created when:
- A home is deleted
- A home is overwritten
⚙️ Configuration
config.yml → GUI, cooldowns, MySQL, behavior
messages.yml → all messages
backups.yml → stored coordinates
⚠️ If you update the plugin:
Delete the plugin folder once to regenerate configs.
? Notes
- MySQL database must exist before startup
- Plugin auto-creates required tables
- Works even if MySQL fails (YAML backup fallback)
- Designed to be simple, fast, and reliable
评论 0
登录后参与评分
还没有评论,来抢沙发吧