basegames/zeling_v2
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
389 Commits 1 Branch 0 Tags
877d2f5fef442bc20c9e8d93e0261bd3462c4d16
Commit Graph
21 Commits
Author SHA1 Message Date
joywayerandClaude Opus 5 877d2f5fef feat(enemy): 嘲风迁移到新轨——能力资产 + 对象树 + 开战触发 
删 5 个空 BossSkillSO，用向导重建 6 个 EnemyAbilitySO（含入场演出）。
预制体经放置工具重新产出：EnemyAiBrain(_definitionId=ChaoFeng) +
BossPhaseAbilityGate + 6 个能力组件，不再有 BossSkillExecutor。
TestRoomA 加开战触发区。三件自检 0 error，EditMode 260/260。

首次真正跑通两条脚手架，暴露并修掉三个它们的缺陷：

1. 放置工具漏挂 EnemyLocomotion（PlaceChaoFeng 及其余 7 个敌人放置入口）。
   EnemyBase.Awake 找不到它即报错且 Locomotion 为 null，
   AiStateFragments.ApplyLocomotion 直接 NRE、AiRuntime 构造失败——
   Boss 建不出决策层，完全不动。已在所有敌人放置入口补齐。
2. 向导把空中阶段的 wind_stone 建成 requiresGrounded=true（SO 默认值）。
   Boss 浮空后 IsGrounded 恒 false，选招器把它滤掉，空中阶段站着不打。
   能力定义表加 grounded 列，阶段 1 的招显式置 false。
3. BossPhaseAbilityGate.ApplyPhase 只在 EnterPhase 与 OnSpawn 调用，
   直接摆场景里的 Boss 两条路径都不走，开局后续阶段的招仍在候选池里。
   BossBase.Start 补一次初始阶段应用。

另：Phase1_Tornado_HitBox 确认零消费者（龙卷判定随弹体走），
从放置工具删除其创建与伤害源绑定；
EnemyBrainContext.UseAbility 对解析不到的能力 id 改为 LogError，
不再静默返回 false（CLAUDE.md 第 6 条）；
新增 PlaceBossFightTrigger 脚手架（此前无对应创建入口，属裸建）。

播放模式实测状态序列（TestRoomA，玩家走进触发区）：
Wait →(Engaged) Intro → Ground⇄GroundAttack →(hp<50%) PhaseTransition
→ Air⇄AirAttack，浮空生效，阶段门按阶段换池，全程 0 报错。
动画 Clip 未接入，PlayClipAbility 空 clip 立即完成，故只验证了状态流转，
判定时序待美术接入后再校。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-07-30 16:02:14 +08:00
joywayer 878e2c12cc chore(enemy): Boss 预制体移除随寻路库失效的 3 个导航组件(Boss 本就不使用导航) 2026-07-28 13:02:52 +08:00
joywayerandClaude Opus 4.8 a94348d64c chore(enemy): 移除 E001-E006 小怪预制体(延后至功能定稿再用脚手架产出) 
敌人框架改动期间不再维护预制体,待所有敌人功能定稿后用 SceneObjectPlacerTool 统一重建。
ChaoFeng Boss 预制体保留。
- 删除 6 个 ENM_*.prefab 及 .meta
- Enemies.asset(Addressables 组)同步移除条目
- TestRoomA.unity 移除失效敌人实例引用

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-21 16:31:44 +08:00
joywayerandClaude Opus 4.8 6f519ec9a9 refactor(enemy): 身体接触伤害改为常驻开启并与能力解耦 
所有敌人默认常驻身体接触伤害:存活即开、死亡时经 PerformDeath 统一关碰撞体停止。
- ContactChaseAbility/AnimatedCeilingDropAbility 移除对 BodyContactDamage 的开关引用
- BodyContactDamage 语义改为常驻(更新注释)
- 脚手架 SetupHurtAndContactBoxes 去掉 contactEnabled 参数恒为 true,并把
  ContactDamageZone 的 HitBox._targetLayers 限定为 PlayerHurtBox(避免常驻后敌人互相误伤)
- 7 个敌人预制体:E001 启用 BodyContactDamage;E002/E004/E005/ChaoFeng 补齐
  ContactDamageZone(镜像 HurtBox 身体碰撞体);全部 _targetLayers 收敛为 PlayerHurtBox
- 更新 Docs/Guides/02 敌人搭建指南

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-21 16:18:07 +08:00
joywayer a7307a5a07 调整文档 2026-07-21 10:22:43 +08:00
joywayer 61ca84365d @ 
feat(scaffold): ChaoFeng(Boss) 撞墙检测层默认 Platform+Wall

补齐 Boss——脚手架 PlaceChaoFeng 加 _wallMask=Platform+Wall；prefab 同步直接设值
(原 Nothing，_wallCheckDist=0.2>0 会触发 Awake 撞墙未配报错)。至此 E001-E006+
ChaoFeng 全部配好 _wallMask。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@
 2026-07-20 10:49:39 +08:00
joywayer ba4a07e96d @ 
feat(scaffold): E002-E006 撞墙检测层默认 Platform+Wall

把 E001 已有的 _wallMask 默认铺到 E002-E006 脚手架 PlaceExxx(AssignLayerMask
movement _wallMask = Platform+Wall)；现有 5 个 prefab 的 EnemyMovement._wallMask
同步直接设值(原 Nothing，且 _wallCheckDist=0.2>0 会触发 Awake 撞墙未配报错)。

ChaoFeng(Boss)按用户范围未含，其 _wallMask 仍需单独配置(否则 Awake 报错提醒)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@
 2026-07-20 10:44:41 +08:00
joywayer 88fca8f9b0 @ 
fix(enemy): 撞墙检测层默认 Platform+Wall(策划可配) + 修 Physics2D 层矩阵落盘

- EnemyMovement._wallMask：本就 [SerializeField] 暴露在 Inspector，补 Tooltip
  说明为策划可配的撞墙检测层(巡逻翻边/追击冲刺共用，按碰撞体前缘)；脚手架
  PlaceE001 默认赋 Platform+Wall，prefab 同步。原先 Nothing→回退 groundMask，
  漏检 Wall 层墙；现显式含 Wall。回退逻辑保留作未配置兜底。
- Physics2DLayerReport.SavePhysicsSettings：原实现(AssetDatabase.SaveAssets+
  改 defaultContactOffset)不落盘层矩阵——实测 Physics2D.IgnoreLayerCollision 的
  改动 SaveToSerializedFileAndForget(单例) 也捕获不到；改用 File/Save Project
  (实测 hash 变化确认落盘，且不触动打开场景)。Auto Fix 的矩阵修正现能立即持久化。

(说明：Enemy×Player 碰撞矩阵与报告 ExpectedPairs 此前已正确=忽略，无需改动；
地图障碍物层管理/冲刺可穿透障碍另行整体规划。)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@
 2026-07-20 10:32:07 +08:00
joywayer db55889088 @ 
feat(enemy): 追击起手前先转身朝玩家(播 Flip) + 冲刺速度可配置

- ContactChaseAbility：进入追击先 FaceDirection 朝玩家，若背对则播 Flip 转身、
  等 IsTurning 结束后再 Skill_Start(张口)→冲刺；已朝向玩家则跳过转身直接张口。
- 新增 _dashSpeed 字段(<=0 回退 Stats.RunSpeed)，冲刺速度可在能力 Inspector 配置。
- E001 EnemyMovement._enableTurnAnimation=true(prefab+脚手架)，转向播 AnimConfig.Turn
  (Flip)，用于巡逻翻边与追击起手前转身；脚手架 PlaceE001 同步。

PlayMode 验证(brain 关隔离)：背对玩家→触发追击→clip=Flip(IsTurning)→转向完成
facing 朝玩家→Skill_Start→冲刺→Skill_End，"先转身再张口"成立。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@
 2026-07-10 16:57:41 +08:00
joywayer 36aa2006e4 @ 
feat(enemy): E001 追击动画 Skill_Start/Loop/End 完整化，符合设计文档

依据 Docs/Game/Design/小怪设计-程序开发文档-01.md：感知→Skill_Start(张口,单次)
→Skill_Loop(快速爬行追击,循环)→丢失目标→Skill_End(收招,单次)→Move_Patrol，
E001 无警觉态。

原问题：ContactChaseAbility 的 loop/end clip 都空、无 start clip，追击全程无
动画；Approach 步态还错播 Move；有多余警觉态(Alert clip 也空)。

- ContactChaseAbility：加 _startClip；协程 Skill_Start(锁动画+等时长,不伤人)→
  开伤害+Approach+Skill_Loop(循环)→退出播 Skill_End。丢失目标(ExternalRequest
  中断)播 Skill_End；受击/死亡硬打断不播。
- EnemyBase：加动画锁 LockAnim/IsAnimLocked——一次性招式动画期间步态不覆盖；
  PlayLocomotionClip 的 Approach 改为不驱动步态(追击动画归能力)。
- EnemyLocomotion：锁定期不算"已应用"，解锁后重同步步态(避免卡在 Skill_End)。
- ENM_E001_Stats：HasAlertState=false(设计无警觉态)。
- prefab + 脚手架：ContactChaseAbility 接线 Skill_Start/Loop/End；新增
  AssignClipTransition 助手(按名+路径定位同名 clip)。

PlayMode 验证：Skill_Start(locked/不伤人)→Skill_Loop(伤害开)→Skill_End
(locked)→步态恢复 Move，全链符合设计。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@
 2026-07-10 16:27:02 +08:00
joywayerandClaude Opus 4.8 95e562943b refactor(scaffold): 重生成 E001 prefab(去三协程能力节点，仅留 ContactChase+Locomotion) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-10 13:23:09 +08:00
joywayerandClaude Opus 4.8 f143efe4a3 feat(scaffold): PlaceE001 挂载 EnemyLocomotion，重生成 prefab 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-10 12:10:29 +08:00
joywayerandClaude Opus 4.8 2e2df2b5dd refactor(ai): E001 贯彻"AI只决策"——每状态=一能力(Model A) 
AI 决策层(E001CaoZhiAi + PerceptionStateMachine)彻底移除所有 actuation：
不再有 Mover.Stop/FacePlayer/UseChaseSpeed/WalkRandom、也不再 SetPhase。
每个 AI 状态只声明触发哪个能力 id，行为(移动/朝向/停/速度/动画/伤害/
阶段声明)全部下沉到对应能力里。

- 新增 IdleAbility/PatrolAbility/AlertAbility：待机静止、巡逻游走、
  警觉朝向玩家，各自 SetAiPhase 驱动阶段动画。
- ContactChaseAbility 追击进入时自设 RunSpeed + Chase 阶段(原在 AI)。
- PerceptionStateMachine 改为 AddAbilityState：进入/每帧 EnsureAbility
  (被打断/受击后自动重触发)、离开 InterruptAbilities；转换规则不变。
- IEnemyActor/EnemyBrainContext 移除已无用的 SetPhase，保留 HasAlertState。
- 新增 SO：ABL_E001_Idle(e001_idle)、ABL_E001_Patrol(e001_patrol)。
- 脚手架 PlaceE001 与 ENM_CaoZhi 预制体同步为四能力结构；TestRoomA
  实例替换为规范预制体实例。

PlayMode 验证：Chase→ContactChaseAbility、脱离感知→Move_Patrol→
PatrolAbility，阶段由能力设置，无报错。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-10 10:05:14 +08:00
joywayerandClaude Opus 4.8 643f63c737 fix(nav): 修复 nav 寻路核心用法——重寻路防抖 + allowCloseEnoughPath 
根因1: PathBerserker2d NavAgent.UpdatePath 明确禁止每帧调用(路径计算跨帧,每帧重启则永不完成、
agent永不移动),而追击每帧 MoveTo→RequestMoveTo→UpdatePath。修: EnemyNavAgent.RequestMoveTo
加防抖(目标位移阈值0.5m + 最小间隔0.25s),让路径算完并跟随;StopNavigation 复位。
根因2: NavAgent.allowCloseEnoughPath 默认false→追击玩家(常不在导航段上)寻路直接失败。
修: 脚手架(4个PlaceExxx)+E001 prefab 设为 true(寻路到最近可达点)。
验证: 敌人 nav 巡逻/追击已能真正跟随路径移动(following=True)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-09 16:43:52 +08:00
joywayerandClaude Opus 4.8 790595d8de fix(scaffold): 碰撞体底部对齐 y=0(原点=脚底) 修正 NavAgent 有效位置 + 追击改回nav 
根因: NavAgent 用 transform 原点(0,0)判定是否在导航段上,而脚手架 CreateBodyCollider
未设 offset(碰撞体居中,底部在-size.y/2),站到地面时原点悬在导航线上方→HasValidPosition=False。
修复: AlignColliderBottomToPivot 让所有身体/HurtBox/HitBox 碰撞体底部对齐 y=0(通用规则,
角色/敌人/Boss 同理);同步修 E001 prefab 碰撞体 offset。验证: 敌人落地后 navValid=True(自动)。
追击能力改回 nav 寻路(MoveTo),不再直接移动。

注: 导航路径"跟随"仍有既有集成问题(UpdatePath 后 agent 不跟随可达路径),需另行排查。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-09 16:22:54 +08:00
joywayerandClaude Opus 4.8 d0f69b0599 fix(ai): E001 追击真正移动+攻击——直接水平爬行 + prefab 补挂 EnemyAiBrain 
追击移动从 A* 寻路(MoveTo)改为直接朝玩家水平爬行(MoveInDirectionWithSpeed)：
地面爬行怪不需寻路,且不依赖场景 NavGraph 烘焙(PathBerserker2d 在测试场景失效)。
ENM_CaoZhi prefab 补挂 EnemyAiBrain(_definitionId=E001),使对象池/prefab 生成的敌人也有AI
(此前只有脚手架场景实例有brain)。PlayMode 验证:敌人爬向玩家并接触伤害击杀。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-09 15:48:50 +08:00
joywayerandClaude Opus 4.8 150fadb72e fix(content): E001 能力/prefab 对齐设计——技能无CD、伪装期不伤人 
ABL_E001_Chase/Alert cooldown 1.5→0(设计:E001无主动技能CD,再入感知立即追击);
ENM_CaoZhi prefab 与脚手架 PlaceE001 的 BodyContactDamage 初始禁用(伪装期不伤人,
追击期由 e001_chase 能力开启)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-03 16:52:03 +08:00
joywayerandClaude Opus 4.8 ef7ff63b67 feat(combat): HitBox 新增 _targetLayers 实例级伤害目标过滤 
Physics2D 碰撞矩阵只决定哪些层之间产生 Trigger 事件（全局门），无法表达单个判定盒的伤害目标差异。新增 _targetLayers 掩码：事件发生后仅对配置层结算伤害，拼刀检测独立于该过滤；Enter 入口同步过滤，非目标不进入命中/占用跟踪。默认 Everything，存量资产行为不变。

ENM_CaoZhi 接触伤害盒按规范配置 _targetLayers=PlayerHurtBox（不误伤友军），并清掉误配为 Player 层的 _rivalHitBoxMask（身体接触不参与拼刀）。已实机验证收紧后接触伤害正常。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-12 10:15:27 +08:00
joywayer ebf0c97320 refactor(enemy): 敌人专属子类改为零代码配置型行为组件 2026-06-09 15:56:44 +08:00
joywayer 247de307c6 UI 系统 2026-06-08 16:05:00 +08:00
joywayer f264329751 摄像机区域的架构改动 2026-05-15 14:47:24 +08:00