授权转载 ResidenceBridge 跨服领地传送插件 1.2.3

ResidenceBridge 是一个面向Residence插件用户的跨服tp插件，用来解决 Residence 在多子服环境下无法共享领地信息、无法跨服传送、无法统一限制领地数量的问题。

原版 Residence 本质上是单服务器插件。每个子服只认识自己服务器里的领地，因此在多服网络中会出现一些明显问题：
不同子服可以创建同名领地，玩家 <span>/res tp</span> 只能传送到当前子服的领地，管理员无法直接查看玩家在全服的领地数量，领地数量限制也只能按单服计算。
这会导致服务器规模扩大后，领地管理混乱、玩家体验割裂、权限体系不统一。

ResidenceBridge 的作用，就是在各个子服之间建立一个统一的 MySQL 全局领地索引。
每个子服会把本服 Residence 领地同步到数据库中，Velocity 端负责处理跨服切换和消息转发，从而让整个服务器网络表现得像一个统一的 Residence 系统

这样玩家执行/res tp 就可以跨服tp了

解决的问题​

1. 跨服领地重名问题​

在多子服网络中，玩家可能在 survival-1 创建一个叫 <span>home</span> 的领地，另一个玩家也可能在 survival-2 创建同名领地。这样一旦做跨服传送、全服列表或统一管理，就会出现冲突。

ResidenceBridge 会在 <span>/res create</span> 和 <span>/res rename</span> 时检查 MySQL 全局索引，确保全服领地名唯一。这样无论玩家在哪个子服创建领地，都不会和其他子服已有领地重名。

2. 跨服传送问题​

普通 Residence 只能传送当前子服里的领地。玩家在 s1 执行 <span>/res tp xxx</span>，如果这个领地实际在 s2，原版 Residence 是找不到的。

ResidenceBridge 会先查询全局索引，判断目标领地在哪个子服。如果领地在其他子服，插件会自动让玩家切换到目标服务器，并在目标服执行 Residence 传送。玩家使用的仍然是熟悉的 <span>/res tp &lt;领地名&gt;</span>，不需要额外记住服务器名。

3. 全服领地列表问题​

原版 <span>/res list</span> 只能看到当前子服的领地，玩家不知道自己在其他子服还有哪些领地，管理员也很难统计一个玩家全区拥有多少领地。

ResidenceBridge 重写和扩展了领地列表逻辑，可以让 <span>/res list</span> 显示玩家在所有子服的领地。管理员还可以使用 <span>/res list &lt;玩家名&gt;</span> 查看其他玩家的全服领地情况，方便管理和排查问题。

4. 全区领地数量限制问题​

单服 Residence 的领地数量限制只看当前服务器。玩家可以在每个子服都创建满额领地，最终实际拥有数量远超服务器设定。

ResidenceBridge 支持全区领地总数限制。创建领地时，插件会统计玩家在所有子服拥有的领地数量，再根据权限组判断是否允许继续创建。例如普通玩家全区最多 3 个，VIP 全区最多 10 个，管理员可以拥有无限数量。

这套限制可以直接配合 LuckPerms 使用，适合大型服务器网络统一做权限分层。

5. 跨服管理操作问题​

在多服环境下，玩家或管理员经常会遇到“领地不在当前服务器，所以无法删除、改名、转让”的问题。

ResidenceBridge 支持对外服领地执行常用操作，例如 <span>/res rename</span>、<span>/res give</span>、<span>/res remove</span>、<span>/res delete</span>。当目标领地在其他子服时，插件会自动切换到对应服务器，并在那里执行原 Residence 指令，减少玩家和管理员手动切服的麻烦。

6. 传送等待与权限分层问题​

很多服务器希望普通玩家传送需要等待几秒，VIP 等待更短，管理员可以直接传送。同时还需要支持移动取消、受伤取消，避免传送被滥用。

ResidenceBridge 内置了跨服传送等待系统，可以按权限配置不同等待时间。例如普通玩家等待 3 秒，VIP 等待 1 秒，拥有 bypass 权限的玩家无需等待。插件也支持移动取消和受伤取消，行为更接近常见的服务器传送插件。

7. 已开服服务器初始化问题​

很多服务器不是一开始就安装桥接插件，而是已经有大量 Residence 领地后才需要跨服同步。

ResidenceBridge 支持自动同步和手动同步。安装后，各子服会定时把本服 Residence 领地快照写入 MySQL，也可以通过 <span>rb sync</span> 立即同步已有领地。这样老服务器不需要手动导入 SQL，也不需要重建领地数据。

8. 菜单、计分板和变量显示问题​

服务器常常需要在菜单、计分板、信息面板中显示玩家拥有多少领地，或者列出玩家的前几个领地。

ResidenceBridge 提供 PlaceholderAPI 变量，例如 <span>%reslink_ressize%</span>、<span>%reslink_reslist_1%</span>、<span>%reslink_reslist_2%</span>，方便接入菜单、TAB、计分板、NPC、GUI 等系统。

插件适合什么服务器​

ResidenceBridge 适合已经使用 Residence，并且有多个子服的 Minecraft 服务器网络，尤其适合：

• 生存服、红石服、资源服、建筑服分开的网络；
• 多个生存分区共享玩家体系的服务器；
• 使用 Velocity / BungeeCord 做统一入口的服务器；
• 想要统一领地数量、统一权限、统一传送体验的服务器；
• 已经开服但后来需要把 Residence 做跨服整合的服务器。