1.1.20. 跨服基础指令同步
群组服环境下，玩家在不同分区（如生存区、地皮区等）之间需要实现跨服传送（tp）、家（home）等基础指令同步。默认 EssentialsX 仅支持分区内操作，推荐使用 HuskHomes 插件实现跨服 tp、home、warp 等功能。
1.1.20.1. 插件简介
支持跨分区 tp、home、warp、spawn 等基础指令
支持 MySQL/MariaDB 数据库后端，性能优异
支持 Proxy/多分区环境，自动同步数据
提供命令冲突解决方案，兼容 EssentialsX
开源，文档完善
1.1.20.2. 关键链接
1.1.20.3. 创建数据库
CREATE DATABASE d_huskhomes CHARACTER SET utf8 COLLATE utf8_general_ci;
1.1.20.4. 安装步骤
下载 HuskHomes.jar，放到所有 Paper 分区的 plugins 目录
修改 config.yml，推荐使用 MariaDB/MySQL 后端，配置数据库连接信息
修改 server.yml，确保每个分区 server 名称唯一（如 dl1、sc1、dp1 等）
重启所有分区服务端
10c10
< language: zh-cn
---
> language: en-gb
16c16
< type: MARIADB
---
> type: SQLITE
19c19
< host: 127.0.0.1
---
> host: localhost
21,23c21,23
< database: d_huskhomes
< username: mc
< password: mc_panda_142857
---
> database: huskhomes
> username: root
> password: pa55w0rd
28,29c28,29
< size: 120
< idle: 120
---
> size: 12
> idle: 12
114c114
< enabled: true
---
> enabled: false
122c122
< host: 127.0.0.1
---
> host: localhost
125c125
< password: mc_panda_142857
---
> password: ''
# 复制 jar 包和配置文件到其他分区，修改 server.yml 文件，确保 server 名称唯一
# 生存一区：sc1，地皮一区：dp1，依次类推
# 重启所有分区
1.1.20.5. 解决命令冲突问题
EssentialsX 默认的 home、tp 等命令仅支持分区内操作，会与 HuskHomes 冲突。需禁用 EssentialsX 的相关命令，确保 HuskHomes 接管所有跨服基础指令。
# EssentialsX config.yml 找到 disabled-commands，设置如下内容
disabled-commands:
- home
- homes
- sethome
- homelist
- delhome
- warp
- setwarp
- createwarp
- warplist
- delwarp
- tp
- tphere
- tpa
- tpahere
- tpaccept
- tpdeny
- tpno
- rtp
- tpignore
- tpoffline
- tpall
- tpaall
- spawn
- setspawn
- back
如有其他冲突问题，参考官方文档： 冲突问题
1.1.20.6. 权限配置
HuskHomes 默认权限已适配大多数场景，无需额外配置。 如需自定义权限，可通过 LuckPerms 授权，参考官方命令文档：
# https://william278.net/docs/huskhomes/commands
# 示例：授权玩家使用 tp、home、warp 等命令
# HuskHomes 默认权限已适配大多数场景，无需额外配置
1.1.20.7. 常见问题 QA
- Q1:
跨服 tp/home 无效？
- A1:
检查所有分区是否都安装 HuskHomes，server.yml 名称是否唯一，EssentialsX 是否已禁用相关命令。
- Q2:
命令提示无权限？
- A2:
检查 LuckPerms 权限配置，确认已授权 huskhomes.command.* 相关权限。
- Q3:
数据库连接失败？
- A3:
检查数据库地址、用户名、密码、端口等配置，查看服务端日志。
- Q4:
玩家家/传送点丢失？
- A4:
检查数据库同步状态，定期备份数据库，必要时恢复数据。