MermodSync 让安装了 Mermod 客户端模组的玩家在你的服务器上查看并使用海项链,即使你的服务器本身是 100% 原版的 Paper。无需 Mixin,无需 Forge / NeoForge / Fabric 加载器,也无需任何混合服务器黑客手段——仅使用原版的 Synchronize Tags 数据包。
工作原理
Mermod 通过检查穿戴在胸部槽位的物品是否属于 #mermod:sea_necklace 物品标签来识别项链。MermodSync 在服务端注册了该标签,并将其指向一个特殊的“深海之心”变体——在原版中通常无法作为胸甲穿戴的物品,仅针对此插件生成的特定堆叠使其可穿戴。这意味着你服务器上的普通物品永远不会被误认为是项链。
功能
- 零客户端-服务器耦合 —— 未安装 Mermod 的玩家看到的是一个普通的(尽管不寻常的)饰品;安装了 Mermod 的玩家则能看到完整的尾巴特效。
- 服务端权威的游泳加速 —— 不再依赖客户端预测(如果没有服务端模组支持会导致不同步/橡皮筋效应),MermodSync 会在游泳时赋予原版“海豚的恩惠”,确保所有人的移动完全同步。
- 水下呼吸与夜视 —— 佩戴项链潜入水中时生效,模拟模组自身的效果行为。
/necklace give <player> [hex color] —— 随时发放带有自定义染料颜色的项链。
- 即时配置重载 —— 编辑
config.yml 后更改立即生效,无需重启。
- 兼容 Folia —— 所有调度均通过正确的区域/实体调度器进行。
要求
- Paper(或其分支如 Purpur)1.21.3+
- 想要看到尾巴效果的玩家需要在客户端安装 Mermod 模组 —— 此插件仅处理服务端检测与效果,不负责渲染(那是模组的工作)。
已知限制
Mermod 的装饰性修饰符(尾巴样式、辫子、颜色渐变、闪烁、“永久尾巴”)存储在自定义数据组件中,而该组件仅在模组自身加载时才存在,因此原版服务器目前无法设置它们。基础项链检测、游泳加速以及环境效果均已可用;完整的支持需等待 Mermod 上游更新以暴露兼容原版的回退机制。
致谢
衷心感谢 ThatPreston(Mermod 的开发者)添加了 #mermod:sea_necklace 标签检查,使得整个项目得以实现。
MermodSync lets players with the Mermod client mod see and use the sea necklace on your server, even though your server itself is 100% vanilla Paper. No Mixin, no Forge / NeoForge / Fabric loader, no hybrid server hacks — just the vanilla Synchronize Tags packet.
How it works
Mermod detects the necklace by checking whether the item worn in the chest slot belongs to the #mermod:sea_necklace item tag. MermodSync registers that tag on the server side, pointing it at a special Heart of the Sea variant — an item that's normally impossible to wear as chest armor in vanilla, made wearable only for the specific stacks this plugin issues. That means regular items on your server are never accidentally mistaken for the necklace.
Features
- Zero client-server coupling — players without Mermod see a normal (if unusual) piece of jewelry; players with Mermod see the full tail effect.
- Server-authoritative swim boost — instead of relying on client-side prediction (which would desync/rubber-band without the mod on the server), MermodSync grants vanilla Dolphin's Grace while swimming, so movement stays perfectly in sync for everyone.
- Water Breathing & Night Vision while submerged with the necklace equipped, mirroring the mod's own effect behavior.
/necklace give <player> [hex color] — hand out necklaces with custom dye colors on the fly.
- Instant config reload — edit
config.yml and changes apply immediately, no restart needed.
- Folia-ready — all scheduling goes through the correct region/entity schedulers.
Requirements
- Paper (or a Paper fork such as Purpur) 1.21.3+
- Players who want to see the tail effect need the Mermod mod installed client-side — this plugin only handles server-side detection and effects, it doesn't add rendering (that's the mod's job).
Known limitations
Mermod's cosmetic modifiers (tail style, bra, color gradient, glint, "permanent tail") are stored in a custom data component that only exists when the mod itself is loaded, so a vanilla server currently cannot set them. Base necklace detection, the swim boost, and the ambient effects all work today; full modifier support is pending upstream changes in Mermod to expose a vanilla-compatible fallback.
Credits
Huge thanks to ThatPreston, the developer of Mermod, for adding the #mermod:sea_necklace tag check that makes this whole project possible.
评论 0
登录后参与评分
还没有评论,来抢沙发吧