NS_unknown_game/game/docs/modules/actor_player.md

Actor and Player

职责

Actor 模块负责游戏对象。当前已实现玩家，敌人、道具、投射物和特效后续按同样方式扩展。

主要源码：

• game/src/actor/player_actor.*
• game/src/actor/player_animation_assets.*
• game/src/combat/hitbox.h

PlayerActor

当前能力：

• 左右移动。
• 跳跃。
• 普通攻击触发。
• idle/run/punch 三个临时状态。
• 朝向翻转。
• 基础平台碰撞。
• 跳跃/攻击音效 cue。

动画资源

玩家动画加载顺序：

PVF .ani
  -> NPK IMG
  -> PNG spritesheet fallback

如果使用 PVF .ani，由引擎 Animation 播放；如果回退 PNG，当前仍保留少量手写帧切换。

当前限制

• 还没有完整 ACT 状态机。
• 攻击还没有命中判定。
• 受击、击退、血量、硬直未接入。
• PNG fallback 的帧数和帧时长仍在 C++ 中。

下一步

• 把 idle/move/jump/attack/hit/dead 做成互斥状态机。
• 从 Animation::GetCurrentFrameInfo() 接入 attack box / damage box。
• 新增 EnemyActor 时复用 Actor、PlatformWorld 和动画资源加载链路。