原创 开源 娱乐 [FriendsWinePlugin]- "朋友的酒"插件版，在服务器开启一场meme蹦迪吧！支持Folia 1.1.0

「朋友的酒」原本是客户端模组。现在它有了服务端插件版：玩家不用装任何模组，只要接受服务器资源包，就能看到立体的 3D 玩偶、听到原曲循环，并把整片区域的生物拉进一场蹦迪。
当前版本：1.1.0
服务端：Paper / Folia 1.21.x ～ 26.3
客户端：原版即可，无需安装模组
前置：CraftEngine、BetterModel

这个版本能做什么​

• 一只会放歌的玩偶：四向放置，右键开始／停止。原曲约 56.294 秒循环，20 格可听范围，播放状态随玩偶存档。
• 四档遥控器：右键玩偶绑定，对空气右键依次切换「回弹 → 加自转 → 加绕圈 → 停止」。切档不打断音乐，不重置相位。
• 范围蹦迪：播放中的玩偶吸引 50 格内的生物靠近，10 格内平滑牵引，再在周围约 5 格分散站位或绕圈。生物不会被传送、不会被改尺寸、不会被改碰撞箱。
• 和平区域：玩偶 50 格内，攻击者或受击者任一在范围内，就抑制生物发起的战斗——包括弹射物和药水的真实伤害来源。
• 一键通透：「通透模式」物品让任意非玩家实体做一次约 0.92 秒的果冻回弹、变宽与自转，适合整活、拍照、活动暖场。
• 原版交易：成年傻子村民用原版交易窗口出售玩偶和遥控器，

三件物品​

遥控顺序：停止 → 回弹 → 回弹＋自转 → 回弹＋自转＋绕圈 → 停止。切档不重置正在播放的音乐和回弹相位；从回弹进入自转时单独开始旋转计时。

遥控限同一维度、距离不限，只能操作已加载的玩偶，不会为了操作去加载区块。绑定记录包含世界、位置和稳定实例 ID，目标区域再次复核实体与状态；移除旧玩偶后在同一位置放新玩偶，不会继承原来的绑定。

玩法​

玩偶与音乐​

玩偶本体是一个 3D 家具（碰撞箱 0.85 × 1.5），放下就能用。右键开始／停止，停止时模型回到默认姿态，不会卡在压扁或旋转的最后一帧——这是 1.1.0 修掉的旧问题。
音乐是原曲循环，20 格可听范围，声音类别 RECORDS，播放 volume 1.5（不是振幅固定加 50%，客户端近处仍受原版上限和玩家声音设置限制）。每个玩家最多同时听到 4 个玩偶，各自独立声音槽，停掉一个不会把其他音轨一起停掉。
原版声音协议不能任意 seek，所以插件内置了 56 段无损 OGG 页边界尾段：中途走过来时按约 1 秒精度续播，再接入共同循环。不承诺采样级同步或完全无缝；离线时间不计入播放进度。

范围蹦迪​

• 播放中的玩偶吸引 50 格内的 Mob；10 格内叠加回弹显示与近距离平滑牵引；在玩偶周围约 5 格分散站位。
• 六角站位会考虑实体尺寸、间距、地形碰撞、危险方块、区块加载与线程归属。没有安全槽位的水生／飞行生物，不会被强拉到一个无效落点。
• 绕圈默认约 20 秒一圈，受阻时尝试跳跃／绕行，实在找不到安全可达路径才暂停；可用 party.orbit-speed 调倍率。
• 多玩偶重叠时按三维距离选最近的来源，同距离稳定决胜；切换来源只更新同一个持续动画的快照，不反复拆建模型。
• 不传送生物，不改变真实尺寸、碰撞、隐身状态或 AI 总开关。范围内确实会接管寻路／速度，退出后立即停止本插件的控制，也不去恢复已经过期的攻击目标。

和平区域​

活动玩偶 50 格内，攻击者或受击者任一在范围内，就抑制 Mob 发起的战斗，包括正确识别弹射物、药水等真正的伤害来源。
玩家可以受到保护，但不阻止玩家主动攻击、环境伤害和苦力怕爆炸；苦力怕的锁敌也保持原样。目标事件、所属生物线程的目标／Brain 清理、伤害事件三者共同生效；跨区域只交换短时位置快照，不跨线程读远端生物的坐标或 Brain。

通透模式​

主手拿「通透模式」，潜行右击任意非玩家实体：一次约 0.91667 秒的回弹、变宽、自转，作用距离 6 格，250ms 冷却，同时最多 128 个会话。玩家不受影响，生物的真实状态、AI 和碰撞都不会被改动——它只是演一下，演完就恢复。

成年傻子村民交易​

普通右击成年、存活、清醒且未被其他买家占用的傻子村民（NITWIT），走原版交易窗口，保留真实职业和其他插件的报价：
库存由村民共享（不是每玩家单独一份），按主世界 fullTime / 24000 的游戏日补货，睡觉跨日有效。两项报价 XP 为 0、价格倍率为 0、忽略折扣；没有酒交易。开窗跨日会刷新报价和结果槽；玩家与村民暂不同属当前线程时延后同步，不跨区发包。

安装​

前置（必需，不会自动下载）​

• CraftEngine 26.9.2
• BetterModel

步骤​

1. 停服，放入 FriendsWinePlugin-1.1.0-Paper-Folia.jar。
2. 正常启动。插件在 onLoad 释放资源，BetterModel 加载模型，随后自动把生成包合入 CE 并执行 CE 现有的资源包工作流。
3. 玩家接受新资源包。
4. 通过 CE 物品菜单的「通透模式」分类、管理命令或村民交易取得物品。

「单 JAR」包含：822 个原版外观模型、1 个玩偶模型及嵌入 PNG、手持模型与贴图、56 段页边界偏移音乐、声音定义、CE 三物品／家具／分类配置、目录与完整性清单。不包括前置插件本体，也不包括 Minecraft 客户端／服务端代码。

资源统一来自 26.3 官方客户端，没有分别导出历史版本皮肤。启动时按服务器的实体注册表过滤：低版本不存在的实体不交给 BetterModel 加载；旧版没有的猪／牛／鸡气候属性归一到 26.3 的 temperate 基础外观；已有的变种、装备和姿态仍做精确保护。

• 1.21 ～ 1.21.3：世界模型会把不合法的旧格式 Cube 旋转移到骨骼，保留源几何、PNG 和逐面 UV；可能增加展示骨骼与包量，实际负载待运行验收。
• 旧版手持：背包、手持和掉落物是 51 个纹理 Cube 构成的 3D 物品，允许与原模型有几何细节差异；放置模型不使用这个简化表示。
• 早期 1.21 没有 consumable 组件时改用长时间使用组件，绑定、切档、防连发和不消耗的语义保留，实际按键表现待验收。

命令与权限​

配置​

plugins/FriendsWinePlugin/config.yml 常用项：

范围控制与一次性通透会话分开计数。迁移后的 config.yml 不会被强行覆盖，新增项缺省时才用本版默认值。改完用 /tongtou reload 生效。

点击展开...

常见问题​

• 玩家要装模组吗？ 不用。原版客户端 + 接受服务器资源包即可。
• 玩偶没声音？ 确认在 20 格内、玩偶处于播放状态、玩家没有关掉「唱片机」音量；同一玩家最多同时听 4 个玩偶，超出的不会再开新音源。
• 生物不跟着走？ 玩偶必须是播放状态，且生物在 50 格内。水生／飞行生物找不到安全落点不会被强拉；绕圈时找不到安全可达路径会暂停，而不是穿墙硬挤。
• 怪物看起来有点不一样？ 插件为了让原版客户端也能看到回弹，用 BetterModel 重建了 79 类实体的外观。它是基础姿态的替身，装备和特殊姿态会有差异。
• 改完配置没反应？ /tongtou reload 只重载动画与范围配置；物品 ID 和会话上限必须重启。
• 资源包没下发成功怎么办？ 检查 CE 的托管与下发设置，或用 /tongtou resources 重新生成并合包；公网可达性和玩家拒绝资源包不在插件控制范围内。
• 换插件版，旧玩偶还在吗？ 在。PDC 沿用 tongtoumode 命名空间，旧目录首次启动自动复制，物品、绑定和补货日都不变。
• 会和别的模型插件打架吗？ 范围显示优先于手动通透；已有其他插件的模型时只叠加动画，撤销时只移除本插件自己创建、且身份仍相符的临时 tracker。

署名与授权​

• 原模组「朋友的酒」创作者：jiaotan_、你个人机cc。
• 本插件为服务端移植版，动画计算复用原工程的 JellyAnimation，玩偶、遥控器与音乐沿用原工程素材及其许可约束（All Rights Reserved）。本作品已得到原作者授权。
• 原版模型与贴图来自经校验的 Minecraft 26.3 客户端，分发与使用须遵守对应条款。
• 前置插件（CraftEngine、BetterModel）本体不随本插件分发，请自行前往各自发布页获取并遵守其许可。