FJmode 是一个基于 Fabric 的 Minecraft 1.21.11 模组项目，当前方向是附魔效果扩展。现阶段已实现两个剑类附魔：御剑飞行 与 万剑归宗。
- Minecraft
1.21.11 - Fabric Loader
0.18.2 - Fabric API
0.139.4+1.21.11 - Fabric Loom
1.14-SNAPSHOT - Java
21 - Mojang Official Mappings
项目配置见 gradle.properties。
- 可附加在剑上
- 持有附魔剑时可进入自定义飞行
- 飞行基础速度公式对齐原版鞘翅滑翔
- 飞行时保持站立姿态
- 飞行时隐藏玩家手中的剑，并在脚下居中渲染同款剑模型
- 飞行中按
Ctrl可触发接近原版烟花的持续助推 - 助推会额外消耗饱食度
- 飞行过程会持续消耗剑耐久
- 可附加在剑上
- 附魔台最高
1级，附魔权重为10，属于中等偏稀有的普通附魔 - 右键长按时使用原版三叉戟式蓄力动作，松手后发射飞剑
- 发射时会把主手中的真实剑取走，飞行阶段由服务端维护虚拟飞剑对象池
- 可同时存在多把飞剑
- 虚拟飞剑会在玩家上方更大的立体范围内环绕飞行，水平半径、高度层次与上下活动幅度都经过放大，并保留带俯仰的群飞轨迹
- 玩家在已有飞剑存在时，近战命中或远程投射物命中实体后，可将该实体设为当前追踪目标
- 同一轮追击中，命中回弹后的飞剑只要已有至少一把重新回到可用盘旋状态，就允许再次锁定新目标
- 追踪目标时会选取一把样本飞剑计算必中冲刺解，其余飞剑直接复用该结果同步扑向目标
- 飞剑命中目标时，按飞剑池内所有参与攻击的剑伤害总和结算一次伤害
- 单把剑伤害会尽量带上剑本体攻击力和附魔伤害修正
- 命中后会触发附魔后攻击效果结算，随后先沿当前突进方向继续穿出，带少量上扬惯性，再回到活动范围并恢复原有集群飞行
- 在追踪、命中回弹、回群等特殊阶段会暂停寿命计时，避免过渡过程中意外进入掉落/消失路径
- 未附
忠诚时，飞行满60秒后会转为可插地的飞剑实体，保留少量惯性飞出；命中方块后会正式插入方块并长期保留，等待玩家自行回收 - 已附
忠诚时，飞行满60秒后不会落地，而是直接返主；接近玩家后优先回到背包，背包已满则在玩家脚下转为可插地飞剑并插地保留 - 玩家退出世界、断线或服务端关闭时，仍在天上的虚拟飞剑会立即实体化并保留在世界中，随后按实体物理自然下落；命中方块后会插地保留，避免直接丢失
- 持有带
御剑飞行的剑时，实体近战攻击被禁用 - 客户端不会发起实体攻击，避免残留攻击表现
- 蓄力横扫被禁用
主要源码目录：
- src/main/java/com/fjmode
- src/client/java/com/fjmode
- src/main/resources
- src/client/resources
核心模块：
-
FJModeMod.java 通用入口，负责注册附魔、网络、御剑飞行与万剑归宗控制器。
-
FJModeModClient.java 客户端入口，负责注册飞行输入监听和万剑归宗客户端渲染/同步接收。
-
ModEnchantments.java 附魔资源键定义，当前包含
sword_flight与myriad_swords_return。 -
SwordFlightController.java 服务端飞行控制核心，负责飞行判定、滑翔速度更新、助推、耐久和饱食度消耗。
-
MyriadSwordsController.java 万剑归宗服务端核心，负责蓄力发射、飞剑池管理、Boids 运动、近战/远程目标锁定、追踪攻击、命中后返航、伤害结算，以及寿命结束或玩家离场时的返主/实体化保留。
-
SwordFlightClient.java 客户端每 tick 监听冲刺键，并在飞行时发送助推包。
-
MyriadSwordsClient.java 客户端接收飞剑快照并在世界中渲染虚拟飞剑。
-
ModNetworking.java 自定义 Payload 注册与服务端接收器绑定。
-
SwordFlightBoostPayload.java 御剑飞行助推的 C2S 数据包。
-
MyriadSwordsSyncPayload.java 万剑归宗飞剑状态同步的 S2C 数据包。
附魔定义：
- data/fjmode/enchantment/sword_flight.json
- data/fjmode/enchantment/myriad_swords_return.json
附魔适用物品标签：
- data/fjmode/tags/item/enchantable/sword_flight.json
- data/fjmode/tags/item/enchantable/myriad_swords_return.json
- data/minecraft/tags/item/enchantable/trident.json
附魔可见性标签：
- data/minecraft/tags/enchantment/non_treasure.json
- data/minecraft/tags/enchantment/on_random_loot.json
语言文件：
- zh_cn.json
- en_us.json
客户端表现由渲染 mixin 和自定义渲染层组成：
- AvatarRendererMixin.java
- PlayerModelMixin.java
- SwordFlightSwordLayer.java
- AvatarRenderStateMixin.java
- MinecraftAttackMixin.java
- MyriadSwordsClient.java
当前渲染行为：
- 飞行时玩家改为站立姿态
- 飞行时隐藏主手显示，避免手里和脚下同时出现同一把剑
- 在玩家脚部中线附近渲染主手物品同款剑模型
- 剑模型会跟随飞行朝向旋转，并按视角俯仰同步上扬或下压
- 万剑归宗的虚拟飞剑通过世界渲染事件直接绘制，不创建客户端实体
- 客户端根据服务端同步的位置和速度快照做平滑跟随，并直接根据速度向量生成四元数朝向，减轻模型抖动与阶段性翻面
- 万剑归宗飞剑在客户端额外做了较轻的位移与朝向插值，视觉上比服务端原始轨迹更顺滑
- 万剑归宗飞剑会按飞行方向调整姿态，并保留一个顺时针
45度的模型补偿，让剑尖正确对齐运动方向
通用 mixin：
- fjmode.mixins.json
客户端 mixin：
- fjmode.client.mixins.json
用途：
- 禁止附魔剑近战攻击与蓄力横扫
- 客户端拦截不应触发的附魔剑实体攻击发起，并保留万剑归宗的目标指定
- 给带
万剑归宗的剑补充原版三叉戟式蓄力/释放行为 - 在投射物命中实体时补充万剑归宗目标锁定
- 向渲染状态挂接御剑飞行数据
- 给玩家渲染器添加御剑模型层
- 强制飞行姿态为站立
项目使用 Mojang Official Mappings，而不是 Yarn。
直接影响：
- 常见 Fabric 教程中的类名不一定可直接复制
- 方法名、字段名和导入路径要以当前项目和编译器结果为准
当前已确认的典型差异：
ServerPlayerEntity对应ServerPlayerText对应ComponentIdentifier.of(...)应使用Identifier.fromNamespaceAndPath(...)
- 数据定义放
resources/data - 资源文本放
resources/assets - 运行时控制逻辑放
flight/network/enchantment - 侵入式改动放
mixin - 客户端专用渲染逻辑放
src/client/java
- 虚拟飞剑存在于服务端内存，不是原版实体，因此默认不参与方块碰撞，也不会自行触发原版投掷物命中流程
- 飞剑追踪目标和伤害结算都在服务端完成，客户端只负责表现
- 目标指定入口同时覆盖近战命中与玩家投射物命中，锁定状态保存在玩家对应的飞剑池中
- 追踪与群飞速度都在服务端按池统一调度；追踪阶段只取一把样本飞剑求解，其余飞剑复用结果，群飞阶段会共享同池的目标与持有者上下文，减少重复查询
- 盘旋锚点采用按半径分层、按高度分层再叠加垂直波动的方式，形成更高更宽的立体盘旋范围
- 命中后飞剑不会消耗，而是回弹、回群并在重新进入可用盘旋状态后参与下一轮锁敌
- 在锁定追踪、命中回弹和回群阶段会暂停寿命计时
- 未附
忠诚的飞剑在寿命结束或玩家离场时，会把仍在空中的虚拟飞剑转换为可插地的飞剑实体；实体命中方块后会正式插地、长期保留，并可被玩家拾取 - 已附
忠诚的飞剑在寿命结束时会进入返主状态并飞向玩家；接近玩家后优先尝试回到背包，若背包已满则在玩家脚下转为可插地飞剑并插地保留 - 通过覆盖
data/minecraft/tags/item/enchantable/trident.json，忠诚现在也可附加到支持万剑归宗的剑上
构建：
.\gradlew.bat build启动客户端开发环境：
.\gradlew.bat runClient建议：
- 改了 Java 代码后至少执行一次
build - 改了资源、附魔 JSON、mixin、渲染逻辑后，最好执行一次
runClient