用途:在 UE5 项目中把权威游戏状态与装饰性表现分离,确保游戏决策只读取权威来源,不读取动画、IK、弹簧、平滑组件、物理视觉体或相机修改器可改动的值。
主要能力:先建立权威契约,列出游戏决策依赖的量(生成与追踪的原点方向、AI 位置、规则距离、预测速度),为每个量指定唯一权威来源;把 Actor 中每个变换分类为权威或装饰性;为移动 Actor 提供游戏专用挂点;坚持表现读取模拟的单向依赖。技能触发时按固定格式返回:权威表、生成与追踪原点、发现的泄漏、已应用解耦、残余耦合、未验证项。
使用方式:加载 references/authority-map.md 建立逐量权威表并分类不确定变换;references/leak-patterns.md 识别六种装饰值泄漏到游戏决策的路径及失败特征;references/decoupling-recipes.md 在保留视觉效果的同时把决策移回权威来源。验证采用振幅测试:把动画、摆动、悬挂行程、相机抖动、插值偏移等装饰运动放大后运行固定种子场景,权威结果必须逐位一致;再缩放到零,结果仍须一致。可结合 ue5-deterministic-sim-tests 在无头批处理中运行。静态场景检查:场景静止时消失的 bug 应优先视为权威泄漏。
限制:不覆盖查询配置(ue5-collision-and-trace-contract)、读取帧与继承(ue5-spawn-frame-and-inheritance)、权威状态归属类(ue5-gameplay-state-ownership),也不涉及网络权威。若装饰值必须跨入权威,需作为有书面幅度界限的设计决策。