FeatherMorph

又一个伪装插件。伪装成怪物和玩家，然后获得独特的技能和能力！

5,11852 years ago

基本信息

我的世界Java版本

平台

运行环境

其他链接

反馈问题查看源码

Modrinth

搬运团队

BBSMC 官方搬运(1)团队

搬运资源声明

对于可进行 JAR 文件搬运的许可证，我们提供站内下载服务；其他资源会跳转到原帖下载。资源更新可能不及时，建议前往资源内提供的原帖链接下载最新版本。

详情信息

许可证 MIT

发布于 2024-11-29

更新于 2026-05-03

2.5.0-rc.4

on 2025 Nov 05

下载

从 2025/11/3（YYYY/MM/DD）起，我们将 1.21.10 分支拆分为 1.21.10/main 和 1.21.10/feature。

如果你在此日期前克隆过仓库，在拉取更新前建议先删除本地存储的 1.21.10 分支！

修复内容

修复玩家伪装总是复制目标玩家皮肤的问题，此前未检查相关条件
修复当玩家语言环境为 "en_US" 而非 "en_us" 时引发的 StackOverflow 异常

其他改进

允许在 FoliaThreadUtils#isTickThreadFor 中 bukkitEntity 为 null
当等待玩家线程超时时，ServerBackend#disguise 和 SpawnPacketHandler#onEntityAddPacket 将软失败：
- 在 beta.6 版本中，部分异常会被转发至玩家的 DisguiseState，包括构建虚拟实体数据包时的等待超时
- 一旦超时，即使仅影响虚拟实体显示，玩家也会在下次 tick 时解除伪装
- 此更改可在服务器卡顿时提升玩家体验

完整更新日志: https://github.com/NiFeather/FeatherMorph/compare/2.5.0-rc.3...2.5.0-rc.4

2.4.5

on 2025 Nov 05

下载

修复内容

技能执行事件未触发问题

完整更新日志: https://github.com/NiFeather/FeatherMorph/compare/2.4.4...2.4.5

2.5.0-rc.2

on 2025 Nov 05

下载

我们正在逐步将 Wiki 迁移至仓库中的 docs/ 目录下。如果你感兴趣，可以前往查看！

新功能

[rc.1] 添加了使用伪装属性的权限：feathermorph.disguise_properties.use
[rc.1] 添加了为 entity/equipment 属性中的物品设置自定义皮肤配置文件的权限：feathermorph.disguise_properties.custom_skin_on_items

修复内容

[rc.2] 伪装成其他实体时也会触发假人（mannequin）的交互镜像（Interaction Mirror）
[rc.2] 修复了假人交互镜像在触发时忽略 NPC 描述差异的问题

其他更新

[rc.1] 将部分伪装验证逻辑移至伪装准备早期阶段
[rc.1] 升级 PacketEvents 至 2.10.0 版本

完整更新日志: https://github.com/NiFeather/FeatherMorph/compare/2.5.0-beta.6...2.5.0-rc.2

2.5.0-beta.6

on 2025 Nov 05

下载

新功能

拥有 feathermorph.mirror.mannequin 权限的玩家现在可以将潜行镜像应用到与其伪装名称相同的假人上
- 对于 BY_NAME 执行器，会选择一定范围内的假人，若将影响距离设为 -1 则会禁用范围限制
- 对于 BY_SIGHT 和 BY_RANGE，将选择视线方向5格范围内的目标假人
将 API 版本提升至 17
- 现在客户端模组可以在 C2S Morph 命令中包含属性输入
现在可通过游戏内命令 /fm option mirror_control_distance 设置交互镜像的影响距离（控制距离）

修复

技能执行事件未触发的问题
slime_magma/size 属性的随机范围错误

其他

我们计划在未来移除 BY_RANGE 镜像执行器，因为它在玩家网络状况较差时会引起混乱
某些异常现在会被转发至 DisguiseState 并导致玩家解除伪装
调整了服务器渲染器重建从服务器发送的实体元数据包的方式

完整更新日志: https://github.com/NiFeather/FeatherMorph/compare/2.5.0-beta.5...2.5.0-beta.6

2.4.4

on 2025 Oct 13

下载

新增功能

初步支持 Ping Wheel
- 目前需要使用自定义插件，可在 https://github.com/MATRIX-feather/pingwheel-plugin-forked 找到

问题修复

从从服务器同步的伪装状态实际上并未应用到主服务器
当 feathermorph.disguise_use_real_uuid 设置为 true 时，玩家在取消伪装时会从其 TAB 视图中被移除

2.5.0-beta.5

on 2025 Oct 13

下载

修复

从附属服务器同步的伪装状态实际上并未应用到主服务器

其他

我们现在升级到了 1.21.10
我们现在基于 PacketEvents 2.10.0-SNAPSHOT 开发版本进行编译
- 这样 CI 又可以正常工作了！

2.4.1

on 2025 Oct 08

下载

此版本可能需要一些手动操作

伪装工具（Disguise Tool）和魔法瓶（Magic Bottle）的合成配方现在通过数据包（datapack）注册。虽然这提供了更高的自定义性，但如果您希望单独禁用其中某个配方，则需要安装一个配方管理插件。

如果您已经使用配方管理插件禁用了相关配方，则无需进行任何操作。（因为该数据包使用的配方 ID 与旧版本一致）

本次更新进行了大量改动，尽管我们已尽力消除漏洞，但仍可能存在尚未发现的问题！

新功能

当输入无效属性值尝试伪装时，现在会向玩家发送错误提示并拒绝伪装，而非使用默认值
属性输入现已包含在 PlayerMorphEarlyEvent 事件中
新增对猫/狼项圈颜色属性的支持
实装守护者（Guardian）伪装技能
- 玩家需更新模组才能在其视野中看到技能目标
海豚和美西螈伪装现在将为玩家提供额外水下呼吸空气
新增 #feathermorph:magic_bottle_collectable 实体标签
- 处于此标签中的生物可被魔法瓶收集伪装形态
现在支持使用数量大于1的空魔法瓶来收集伪装

修复内容

已修复：收集后的魔法瓶无法正常使用的问题
修复了 snow_golem/pumpkin、zoglin/is_baby 和 zombie/is_baby 属性本应有 TAB 补全列表却缺失的问题
修复了 burns_under_sun 属性失效的问题

其他改进

许可证由 MIT 更改为 GPLv3
开源许可证文件现已包含在 Jar 包内
伪装工具和魔法瓶的合成配方现通过数据包注册
重构了技能/能力配置的读写逻辑
重构了技能处理机制
- 如果您遇到技能/能力配置无法正确加载的问题，请及时反馈！
重构了生物AI修改系统，减少对NMS的依赖
移除了生物AI恢复方法
- 配置更改后请重启服务器以生效
服务端伪装选择GUI中的图标现使用雪球+物品模型显示
potion_on_attack 能力现在要求输入药水ID，而非Spigot枚举名称
更新了中文（zh_CN）语言翻译
- 将“伪装”替换为更准确的“变形”或“形态”
现可通过在插件数据文件夹中创建 cmd_debug.txt 文件启用调试命令
- 警告！此功能不适用于生产环境。启用可能导致问题！
夜视能力不再对玩家施加药水粒子效果
entity/custom_name 属性现对用户输入限制为256字符，最终文本限制为50字符
entity/custom_name 不再接受空输入
伪装Boss栏现在会读取已设置的 entity/custom_name 属性文本
玩家伪装形态不再接受 entity/custom_name 输入
- 但末影龙伪装仍保留此功能，目前为有意设计 :D
armor_stand/show_arms 的默认值将再次从配置文件中读取并应用
DisguiseState 实例现在自行更新，而非由 MorphManager 更新
“We are not connected with master server! Refusing to update unlock state...” 消息现记录为错误级别而非警告

API 变更

属性输入现已包含在 PlayerMorphEarlyEvent 中

完整更新日志: https://github.com/NiFeather/FeatherMorph/compare/2.4.0...2.4.1

2.5.0-beta.2

on 2025 Oct 08

下载

这是一个针对 1.21.9 的测试版本。请注意，由于 PacketEvents 尚未更新，此版本可能不支持通过服务端渲染显示假人（Mannequin）和铜傀儡（Copper Golem）的伪装形态。

新功能

API 版本现已升级至 16
- 玩家伪装的皮肤以及任意实体伪装的装备现在作为伪装属性进行管理
- 对不支持伪装属性的客户端的兼容性支持将持续到 2026 年，或 1.22 正式发布时为止
新增对假人（Mannequin）伪装的支持
- 默认情况下，无法使用魔法瓶收集假人伪装
- 假人伪装具有与盔甲架和玩家伪装相同的“假装备”（Fake Equip）技能
- mannequin/skin 属性仅限管理员使用，因为插件会尝试从输入内容获取并缓存皮肤。你可以为玩家授予 feathermorph.custom_skin 权限，以允许他们使用该属性
新增对铜傀儡（Copper Golem）伪装的支持
- 默认情况下，可以使用魔法瓶收集铜傀儡伪装
- 为铜傀儡伪装新增了天气状态（Weather State）属性
初步支持 Ping Wheel
- 当前需要一个自定义插件，可在 https://github.com/MATRIX-feather/pingwheel-plugin-forked 找到

修复内容

修复了当 feathermorph.disguise_use_real_uuid 设置为 true 时，玩家伪装出现的多个问题
- 取消伪装时玩家会从 TAB 列表中消失
- 从远处传送或从旁观模式切换游戏模式时，伪装无法正常显示

其他变更

移除了伪装 NBT 黑名单配置
- 因为该功能已不再使用

完整更新日志: https://github.com/NiFeather/FeatherMorph/compare/2.4.3...2.5.0-beta.2

2.5.0-beta.3

on 2025 Oct 08

下载

新功能

为 entity/custom_name、mannequin/description 和 mannequin/hide_description 属性添加了权限 feathermorph.custom_text，默认对玩家开放
假人和铜傀儡伪装现已支持服务端渲染（Server Renderer）
- 需要使用基于此 PR 构建的 PacketEvents

其他更新

多项伪装属性已变更，玩家需将模组更新至 0.16.0-beta.2！
- 合并 mannequin/skin_internal 和 mannequin/skin 属性。现在 mannequin/skin 用于皮肤输入及属性同步
- 更改了插件向玩家同步 mannequin/skin 的方式
- entity/custom_name 和 mannequin/description 现在支持以 { 开头的 JSON 文本组件
- player/skin 现在支持 GameProfile 复合字符串
- mannequin/skin 现在支持以 { 开头的有效 MorphResolvableProfileStruct 字符串

2.4.3

on 2025 Oct 08

下载

此版本可能需要一些手动操作

伪装工具和魔法瓶的合成配方现在通过数据包注册。虽然这允许你进行更深入的自定义，但如果你想单独禁用其中某个配方，则需要安装一个配方管理插件。

如果你已经使用配方管理插件禁用了相关配方，则无需任何操作。（因为数据包使用的配方 ID 与旧版本行为一致）

如果你是从较早版本更新而来，建议同时查阅 2.4.1 版本的更新日志。

新功能

空魔法瓶的收集结果现在基于战利品表（loot table）
- 默认情况下，插件会处理来自战利品表的所有输出物品
- 你可以为特定物品设置自定义 NBT 数据 feathermorph:skip_magic_bottle_setup 为 true，使插件跳过该物品的处理
- 更多详情请参见：战利品表数据包
- 由于存在限制，并非所有类型的战利品表都受支持。目前仅 empty 和 entity 类型经过测试可正常工作
新增权限节点 feathermorph.acquire_morph，用于控制特定玩家是否可以通过游戏行为解锁伪装形态
新增权限节点 feathermorph.disguise_use_real_uuid，用于控制伪装形态是否应使用玩家的真实 UUID 创建虚拟实体
- 这可能有助于提升与 Simple Voice Chat 等模组的兼容性
- 但请注意，这应被视为一种 变通方案 或 临时修复
玩家现在可以使用 /discard-morph 命令丢弃已解锁的伪装形态

问题修复

当目标为有效实体时，猫和狼的伪装形态未正确应用项圈颜色
/fm make_disguise_tool 命令未正确注册
AI 修改功能在某些配置下注入失败并导致日志刷屏

其他变更

AI 修改功能在新安装实例中默认关闭
我们现在重新使用 NMS 注入目标行为（goal），因为使用 API 会导致问题……

完整更新日志：https://github.com/NiFeather/FeatherMorph/compare/2.4.2...2.4.3

2.4.2

on 2025 Oct 08

下载

此版本可能需要一些手动操作

伪装工具（Disguise Tool）和魔法瓶（Magic Bottle）的合成配方现在通过数据包（datapack）注册。虽然这提供了更高的自定义灵活性，但如果你想单独禁用其中某个配方，则需要安装一个配方管理插件。

如果你已经使用配方管理插件禁用了相关配方，则无需进行任何操作。（因为该数据包使用的配方 ID 与旧版本行为一致）

已知此版本在 Folia 上存在 AI 修改功能的问题。我们建议在 Folia 服务器上尽快禁用此功能

修复内容

某些生物在本应因玩家而恐慌时未触发恐慌
猫和豹猫缺少针对玩家伪装状态的攻击目标
已驯服的生物仍会执行自定义攻击目标

其他更新

移除了 MorphBasicAvoidPlayerGoal 中的调试输出（"ToAvoid is xxxxx"）造成的日志刷屏问题
确保 MorphBasicAvoidPlayerGoal 中目标实体与运行中的生物处于同一线程
- 此前无人报告相关问题，但为防万一做了处理 :D

2.4.0

on 2025 Aug 24

下载

新功能

在 https://github.com/NiFeather/FeatherMorph/pull/46 中，@MATRIX-feather 将伪装中的 NBT 使用替换为伪装属性
- 这会影响伪装的构建和同步
- 此功能允许玩家更自定义他们的伪装，而无需先创建一个实体。
- 玩家需要升级他们的客户端模组。当 1.22 到来或我们到达 2026 年时，计划结束对使用 NBT 同步伪装的遗留 API 实现的客户端的支持
- 目前尚未实现用于自定义属性的权限控制。
- 更多详细信息，请查看 https://github.com/NiFeather/FeatherMorph/pull/46
对于 Residence 集成：
- 在没有 place 权限的住宅内的玩家，在伪装时将不再能够留下雪痕
- 在没有 use 权限的住宅内的玩家，将不再能够激活他们的伪装技能

其他

调整了 CommonEventProcessor 中 PlayerRegisterChannelEvent 的监听优先级
- 为了让某人闭嘴，使他们不再在私信中向我抱怨 HuskSync 再次破坏了模组功能

2.3.5

on 2025 Aug 24

下载

新功能

现在可以通过设置main_hand属性来设置玩家伪装的主手
玩家现在可以消耗任何具有有效组件的物品来解锁新的伪装。
/fm query命令现在接受多个玩家作为参数
/request send命令现在接受多个玩家作为参数

错误修复

修复了一个长期存在的问题，即切换Modify Boundingboxes选项时不会正确通知客户端重新连接
有时服务器的表情 GUI 不会显示表情名称。
离线伪装总是在 UUID 检查中失败
修复了一个潜在的问题，即玩家退出时玩家伪装的航路点不会被删除

其他

我们现在使用addTransientModifier来添加属性修饰符
- 这意味着我们添加的修饰符将不再被游戏保存。
带有morph:fake_equip技能的伪装现在默认总是复制显示有效的目标实体的装备，即使它为空。
使用getListeningPluginChannels来检查玩家注册的插件通道

API

API 级别现在是 5
现在可以通过 API 获取插件的首选和所有支持的插件通道
现在可以监听插件是否恐慌
- 目前，只有在不支持 Minecraft 版本时，此插件才会恐慌
替换了runWhenAPILoaded的使用为getApiFuture，它返回一个CompletableFuture <FeatherMorphAPI>
添加了PlayerConnection，可用于监听玩家客户端登录、获取他们实现的 API 或断开他们的连接。断开客户端现在需要一个Exception作为原因。