HuskHomes 插件介绍

HuskHomes 插件介绍
概述

HuskHomes 是一款面向 Minecraft: Java Edition 服务端的强大、直观且灵活的传送插件。它提供了一套"丰富但不臃肿"的玩家传送功能，帮助服务器以轻量、现代的方式管理玩家移动与家的系统。借助 MySQL 数据库，HuskHomes 还支持跨服运行，允许玩家在 BungeeCord 或 Velocity 代理网络中无缝穿梭并设置家。
插件名称：HuskHomes
创建者 / 维护者：WiIIiam278（创建者）、QarthO、TrueWinter（维护者）
许可协议：Apache-2.0（开源）
项目地址：https://modrinth.com/project/J6U9o3JG
源码：https://github.com/WiIIiam278/HuskHomes
兼容性

| 项目 | 说明 |
|---|---|
| 游戏版本 | Minecraft: Java Edition 1.16.5 / 1.17.x / 1.18.x / 1.19.x / 1.20.x / 1.21–1.21.8 / 1.21.11 / 26.1.1–26.1.2 / 26.2 |
| 服务端平台 | Spigot、Paper、Purpur、Folia、Sponge、Fabric |
| Java 版本 | 17+（跨服支持需 MySQL 8.0+） |
核心特性
跨服传送：借助 MySQL 数据库，玩家可在代理网络中的多个服务器之间无缝传送并设置家；跨服 /rtp 还需将消息代理配置为 Redis。
零学习成本：/sethome、/home、/tpa、/rtp 等常用指令开箱即用，玩家无需学习新指令。
快捷美观的菜单：采用健壮且美观的交互式聊天菜单，而非笨重的箱子 GUI。
完善的管理员功能：内置 /tp、/warp 等经典管理指令，并提供管理其他玩家家的完备工具。
Plan 与地图插件钩子：可通过 Plan 插件查看家的使用分析，并在 Dynmap 或 BlueMap 上展示家的位置。
可扩展 API 与开源：提供 HuskHomes API 供开发者扩展，项目基于 Apache-2.0 协议开源。
主要功能
家（Home）系统：设置、删除、编辑、列表查看个人家；支持公共家（Public Home）。
传送点（Warp）系统：管理员设置公共传送点，玩家自由使用。
出生点（Spawn）：设置并传送到服务器出生点。
传送请求：/tpa、/tpahere 等请求式传送，需对方确认。
玩家传送：/tp、/tphere、/tpall、/tpoffline 等。
返回与随机传送：/back 返回上一位置、/rtp 随机传送（支持跨服）。
冷却系统：可对 /rtp、/home、/warp、/back、发送传送请求等动作设置冷却时间。
权限限制传送点：可将指定 Warp 绑定到权限节点 huskhomes.warp.<名称>。
传送预热（Warmup）：传送前需站立不动且不受伤害，支持动作栏 / 标题显示倒计时，传送后可设置无敌时间。
安装方法
单服务端
从 Modrinth 下载对应服务端的 jar 文件（Spigot/Paper 下载 HuskHomes-Paper，Fabric 下载 HuskHomes-Fabric）。
将 jar 文件放入服务端 plugins/（Spigot/Paper）或 mods/（Fabric）目录。
启动服务器，待其生成配置文件后关闭服务器。
按需编辑 config.yml 与语言文件。
重新启动服务器即可使用。
跨服网络
在每个 Spigot/Fabric 服务端重复上述第 1–2 步。
确保每个服务端都配置同一个 MySQL/MariaDB/PostgreSQL 数据库。
在每个服务端 config.yml 中开启 cross_server.enabled: true，可选配置 Redis 作为消息代理。
重启每个服务端，在生成的 server.yml 中将 name 设为该服务器在代理（Velocity/BungeeCord）配置中对应的 ID。
再次重启所有服务端，跨服网络即搭建完成。
适用场景
需要现代、轻量、开源传送系统的 Spigot/Paper 服务器。
BungeeCord/Velocity 跨服网络的统一家与传送点管理。
希望通过 Plan、Dynmap、BlueMap 等插件增强社区互动的服务器。
需要精细权限控制（如按权限开放特定 Warp）的管理员。
相关链接
Modrinth 项目页：https://modrinth.com/project/J6U9o3JG
GitHub 源码：https://github.com/WiIIiam278/HuskHomes
官方文档：https://william278.net/docs/huskhomes/
Discord 支持：https://discord.com/invite/william278