Home 回家系统

轻量级回家/传送点插件：多家园、吟唱传送（移动/受伤打断）、主家系统、公共家、邀请参观、经济联动收费、MySQL 存储、PlaceholderAPI 占位符。零硬依赖，开箱即用。

功能特性

• 多家园：每玩家可设多个家（默认 3 个），名字支持中文；权限组可扩（vip=5 / svip=10），管理员不设上限
• 5 秒吟唱传送：屏幕中央倒计时，移动/受伤自动打断（转头不算移动）；时长可配（0=立即传）
• 主家系统：/家 回 不带名直接回主家，第一个家自动成为主家，可随时切换
• 公共家：OP 创建全服可传送的公共点（出生点/商店街场景），GUI 绿床图标区分
• 邀请参观：邀请在线玩家参观你的家，30 秒内接受即吟唱前往
• 安全落点：目标点被埋/在岩浆里时自动向上找安全位置
• 经济联动：检测到 TinyAII Economy 插件后跨世界传送收费（可配价格，OP 免费，未装 Economy 免费）
• GUI 家列表：红床=自己家、绿床=公共家，Lore 显示世界坐标，点击即传
• 双存储后端：YAML（默认）/ MySQL 一键切换（多服共享数据），MySQL 失败自动回退 YAML
• PlaceholderAPI：%home_count% 家数量 / %home_main% 主家名 / %home_limit% 上限
• 中文命令：全套 /家 中文子命令 + Tab 补全

命令

命令	说明	权限
/家	打开家列表 GUI	home.use
/家 设置 <名字>	把当前位置存为家	home.use
/家 回 [名字]	回主家（不带名）或指定家/公共家	home.use
/家 移动 <名字>	把该家改到当前位置	home.use
/家 主 [名字]	查看/设定主家	home.use
/家 删除 <名字>	删除家	home.use
/家 列表	聊天栏列出全部家（含主家标记）	home.use
/家 邀请 <玩家> <家名>	邀请参观（30秒有效）	home.use
/家 接受	接受邀请	home.use
/家 导出	导出全部家坐标文本	home.use
/家 公共 设置|删除 <名字>	公共家管理	home.admin
/家 列表 <玩家>	查看他人家园	home.admin
/家 重载	重载配置	home.admin

权限默认值：home.use 所有人、home.public.tp 所有人（传公共家）、home.admin OP。 家数量上限：settings.limits 配置组（default/vip/svip），玩家持 home.limit.<组> 取最高档，home.admin 无上限。

配置示例

settings:
  limits: { default: 3, vip: 5, svip: 10 }
  warmup-seconds: 5        # 吟唱秒数，0=立即
  interrupt-on-move: true
  interrupt-on-damage: true
  banned-worlds: []        # 禁设家世界列表
economy:
  enabled: true            # 需安装 Economy 插件
  cross-world-cost: 10.0   # 跨世界传送费
storage:
  type: yaml               # yaml / mysql

兼容性

• 支持核心：Spigot / Paper / Purpur / Leaves
• API 版本：1.16+（spigot-api 1.16.5 编译）
• Java：17+
• 前置依赖：无（Economy/Vault/PlaceholderAPI 均为可选软依赖）

开源协议

MIT License

---

Home (English)

Lightweight home/waypoint plugin: multiple homes, warmup teleport with move/damage interruption, main home, public homes, visit invitations, economy integration, MySQL storage, and PlaceholderAPI support. Zero hard dependencies.

Features

• Multiple homes: default limit 3 per player (permission groups up to unlimited for admins), Chinese names supported
• 5s warmup teleport: on-screen countdown, interrupted by movement or damage; configurable duration (0 = instant)
• Main home: /家 回 without args teleports to your main home automatically set to your first home
• Public homes: OP-managed server-wide waypoints with green bed icons in GUI
• Visit invitations: invite online players to visit your home within 30 seconds
• Safe landing: auto-searches upward when the target is buried or in lava
• Economy integration: cross-world teleport cost when TinyAII Economy is installed (configurable)
• Dual storage backends: YAML (default) or MySQL with automatic fallback
• PlaceholderAPI: %home_count%, %home_main%, %home_limit%
• Chinese commands: full /家 subcommands with tab completion

Compatibility

• Server: Spigot / Paper / Purpur / Leaves
• API version: 1.16+
• Java 17+
• Dependencies: none (optional Economy / PlaceholderAPI)

License

MIT License

Author

TinyAII