动态玩家模块
由能力来源驱动的玩家状态、弓术执行与共用表现层。
DynamicPlayerComponent以isekaiexpansion:dynamic_player承载可选的内部模块。宿主负责持久化与仅发给本人的同步;模块的存在取决于实时资格与来源身份。这些实现类型属于内部代码,不是公开集成门面。
它做什么
PlayerModules注册带类型的工厂、资格判定与身份函数。恶魔循环依附上位魔血,精灵共鸣依附精灵之谐,弓术依附激活的Origins授予项或手持物品代理。所有权由当前状态推导,因此命令、重选、选择物品与可学习能力变化都会进入同一协调流程。
运行时模型
服务端读取与逐刻更新都会协调模块。资格失效或身份改变时,先卸载旧实例,再创建新实例。恶魔与精灵身份使用种族层;弓术组合种族、职业与专业层。死亡后不将模块复制给新玩家实例。客户端只读取最新的本人快照,不运行游戏状态协调。
| 宿主字段 | 类型 | 缺失行为 | 含义 |
|---|---|---|---|
| 模块标识 | compound | 无已保存模块 | 宿主NBT映射中的条目。 |
identity | string | 空字符串,不能匹配正常拥有的模块 | 恢复前必须一致的来源身份。 |
state | compound | 空模块载荷 | 模块自己的序列化内容。 |
待恢复NBT保留到首个服务端刻,以处理组件的初始读取顺序;同一保存条目最多消费一次。脏快照每4刻(0.2秒)仅同步给本人。旧恶魔组件键不再读取。
ArcheryModule 保存可用技法 ID,当前准备的技法只在本次会话有效。客户端在同步手持栏位后、弓离弦或用弩前,再次发送栏中选定的技法。连续技、捕获的武器引用及射击计时均不持久化。连续技定义持有箭数、准备时间、间隔、手部占用时间、动画与逐次施放的序列工厂;箭数限制为1–32,最后一箭须在200刻(10秒)内释放。取消只清除该连续技拥有的行动锁来源,共用冷却留在模块之外。
每次施放生成独立序列,由start、tick、fire与close管理其临时表现。星坠箭雨在支付前检查发射圆盘,完成或中断时关闭自己持有的法阵;垂直速度与固定区域独立于ProjectilePatternAPI.rain。
CCA除了要求在ComponentsInitializer注册宿主键,还要求在fabric.mod.json中声明该键。verifyComponentMetadata核对中央注册表与元数据声明,在processResources之前及check期间执行;缺失、过期或重复的键都会使构建失败。
约定
ArcheryRuntime受理请求前验证实时授予项、行动限制、星能与冷却。模式产生的追加箭不会递归触发模式释放。原生弩的多重射击在每个玩家刻只受理一次付费强化。触发技与回响箭只派发一次远程缩放,禁止拾取,并携带同批伤害的无敌帧绕过标记。碰撞筛选与实际扣血前都会检查保护规则,额外魔法伤害仅在基础命中成功后结算。
成功的普通释放使用cast.common_3,已强化的穿透与蓄力释放使用cast.common_2。弓术的释放与元素命中音效通过EffectSoundAPI,共用法术音效限制器。同一世界刻内,相同音效与分类在8方块内只播放最先到达的一次;后续刻及更远的来源仍可发声。连续技成功生成箭矢后,在箭的起点播放释放音效,箭雨因此从上方法阵发声。原生弩的发射音与同批箭的原生命中音也使用该限制器。普通弓每次射击本就只播放一次发射音,静音的同批箭仍不播放原生命中音。
ArcheryRuntime.energyCost同时供支付与查看面板使用,只有精灵的临时风引增益免除弓术星能。共鸣的移速与技能急速采用模块持有的临时属性修正,在风引生效或卸载时移除。
客户端将弓术项前置到现有法术选择与栏位快照中,不决定星能或授予资格。快照在已启用的弓术名称旁附上菱形标记。两侧技能栏共用AbilityInspection管理的一条带键字幕(ClientCaptionAPI.inspect)。选项停稳后才读取详情。主动技能读取玩家持有能力的本地化文本、习得等级和已同步的施放阶段,查看时无需发包。名称、消耗与说明保留文字样式,固定在普通字幕下方,测量高度受屏幕范围约束。关闭时只清除自身的键。ModuleHudSnapshot把恶魔和精灵资源投影为现有辅助量表渲染器的输入。
EntityEffekAPI.registerConditional(type, predicate, profile)注册由条件决定是否存在的客户端实体特效绑定。条件转为假时,发送配置的释放触发器并等待有限粒子消散。Profile.withLocator(locator)只改变表现原点。弓术定位器采样动画后的手持物品位置,忽略Iris阴影通道,并在箭的前2个客户端刻(0.1秒)过渡到实际位置;碰撞仍归服务端所有。表现绑定在客户端初始化时注册一次;条件与定位器在客户端线程运行,不得修改游戏状态。
公开同步的瞄准姿态与仅本人可见的资源状态分开,使旁观者也能看到弓弩握姿。触发动画控制手臂与腿部,头部旋转仍由游戏瞄准控制。公开的开始时间与拉弦周期驱动所有观察者看到的弓弩模型,不伪造物品使用。猎隼连射在第8、14、20、26刻释放,并跟随视角俯仰;星坠箭雨在第12刻向上60°释放无伤害引导箭。左惯用手玩家会镜像播放。附魔箭保留投射物模型,外覆纤细的材质光层与短促的轴向尾迹。箭矢用 ise_arrow_art 保存表现类型,用 ise_archery_element 保存离弦时的元素。没有元素共鸣的弓手施放物理箭技时,箭身会泛起银白细光,命中时短暂闪白。此飞行特效只读取输入1来缩放模型,普通射击不附加特效。箭雨与回响箭跳过手持物品的出射衔接,始终使用实际的世界生成位置。
| 原生输入 | 数值 | 含义 |
|---|---|---|
| 0 | RGB24整数 | 元素飞行特效使用的离弦配色。 |
| 1 | 投射物宽度 / 实体类型宽度,限制为0.1–8 | 整个附魔特效随模型实时缩放。 |
| 2 | 速度 / 3,限制为0.65–1.35 | 只拉伸轴向尾迹,不拉伸箭矢模型。 |
元素飞行特效以触发器0释放,客户端消散上限为4刻(0.2秒)。特效自身在9原生帧(0.15秒)内完成消散。短尾迹采用随箭移动的闭合渐尖体;原生材质流动、反向旋转的风压表面与有界呼吸起伏共用4秒的无缝周期,无需重新生成发射器。特效朝向投射物速度,出射衔接结束后跟随投射物的插值位置。
ArcheryFlight随箭同步并持久化弹道类型。穿透箭使用×1.5出射速度、0.997阻力系数与0.018重力;蓄力箭分别为×1.75、0.995与0.03。加速最多提升至每刻6格,不降低原本更快的箭速;武器伤害会抵消这次速度变化带来的额外倍率。水中沿用原版阻力。ArrowTrajectory 会检查通往目标可见部位的弹道。目标在平地上匀速直行时,瞄点会沿水平方向略微前移。若找不到通往预瞄点的畅通弹道,则改试该部位当前的位置。两条弹道都不可用时,箭保留原始出射速度。
贯幕穿透箭和破晓蓄力箭在服务端以 ise_archery_draw_rank 保存离弦时的阶位。命中且未被屏障完全吸收时,按该阶位结算效果;退还技能点或箭矢随区块重载都不会改变它。只复用弹道的箭不会触发这两种效果。长按说明从同一份 ArcheryDraw 阶位数据取得本地化参数。
CombatAimPacket只携带目标实体提示,每5个客户端刻刷新;服务端在12刻后令其失效,并重新检查保护、可见性、朝向与48格射程。共用瞄准使用combat_targeting,不保留旧组件键别名。
元素箭由 ArcheryPresentation 选择分别编译的风、火、冰、雷、水、土六套命中配色,粒子、程序化表面与材质边缘保持一致。相对于原作1.8格的尺寸,普通命中缩放为1.25,穿透为1.55,蓄力为1.85。这些一次性命中特效不使用飞行特效的RGB动态输入。
七曜坠星在箭矢样式同步后选用独立的特效配置,沿用箭模定位与动态输入0。封闭箭衣采用普通混合,明亮天空下也保留紫色轮廓。原生材质随时间扭动火焰遮罩,青碧色焰锋沿箭身游走;三道渐尖焰尾衬出明亮的箭尖。专属命中特效以输入1控制大小,复用流星术的命中音效;一至三阶的箭衣与命中特效分别为×1/1.27/1.55,收尾坠星命中时再放大至×1.65。
扩展
在玩家开始逐刻更新前,于公共初始化阶段注册模块类型,重复标识会失败。模块实现序列化、tick与detach;卸载只移除自己拥有的效果与锁。身份函数应包含所有需要在变化时清空状态的来源层。资源表现加入ModuleHudSnapshot,不要写入渲染器。
在数据加载前注册不可变的ArcheryTechnique,再通过弓术数据授予其ID。模式提供释放回调,触发技提供有界连续技定义;重复ID和类型/回调不一致都会失败。Player Animator标识集中在IsekaiPlayerAnimations,物品代理授予定义,不复制战斗逻辑。
验证
运行./gradlew.bat compileJava verifyComponentMetadata assembleLanguageFiles与动画绑定审计。游戏内检查直接切换种族/职业/专业的命令、选择物品重选、能力移除与重新授予、死亡、重连、代理重载及连续技期间换武器。确认换装不能重置冷却,卸载模块不会留下状态标记。
检查原生箭与自定义箭、弩多重射击、受伤无敌帧、受保护目标、屋顶和受阻的生成位置。在Player Animator、Punchy与Iris下检查两种视角,包括释放、提前取消、后加入的观察者和粒子消散。编译与原生浏览器预览不能证明这些游戏集成已经通过。
相关页面
参阅弓术与精灵、恶魔循环与Effekseer粒子。