用途:处理 Roblox 玩家角色生命周期、Humanoid 状态与移动、骨架(R6/R15)、动画、工具、配件、自定义角色、死亡与复活缺陷。凡代码将 Character/Humanoid/根部件引用保存超过一次生成时均适用。不适用于通用物理查询与约束、远程信任、相机逻辑。
主要能力与工作流:先检查角色契约(头像设置、StarterCharacter、StarterCharacterScripts、CharacterAutoLoads、R6/R15 支持、现有 Animate/控制器脚本、标签、碰撞组、服务端/客户端所有权);区分 Player 域(跨复活保留)与 Character 域(不保留),把角色连接、轨道、资源放入单一清理作用域并在移除时销毁;同时绑定已存在和未来的角色(连接 CharacterAdded,若 player.Character 已存在再绑定,订阅本身不能保证看到已生成角色);防御性解析 Humanoid、根部件、Animator,并用超时等待与代际/当前检查避免过期异步修改错误骨架;选择移动所有权:标准头像用 Humanoid 移动,物理机制用 AssemblyLinearVelocity、BasePart:ApplyImpulse() 或 LinearVelocity/AlignPosition 约束;用骨架的 Animator 加载动画,保存轨道与连接,动画标记仅用于表现与计时,判定须服务端校验,清理时停止并断开。
必要用法:示例代码展示可替换角色作用域——clearCharacter 递增 generation 并断开全部连接、清空表与 currentCharacter;bindCharacter 先判断 player.Character 是否等于当前角色再清理,WaitForChild 后再次校验代际;CharacterRemoving 匹配时清理;CharacterAdded 绑定时,若已有角色用 task.defer(bindCharacter, player.Character)。动画通过 animator:LoadAnimation(animation)、GetMarkerReachedSignal 连接、track:Play(0.1) 启动,清理时 markerConnection:Disconnect()、track:Stop(0.1)、animation:Destroy()。无 Humanoid 的骨架使用 AnimationController 配合 Animator。不要硬编码 R15 肢体名;HumanoidRootPart 只是通常的装配根;重绑定移动/跳跃或新增疾跑等动作优先用输入动作系统(InputContext/InputAction/InputBinding,编辑期定义、跨设备),默认控制脚本在 Workspace.PlayerScriptsUseInputActionSystem 启用时运行于此系统,自有 InputContext 需更高 Priority 并 Sink。不要因客户端拥有角色物理就授予伤害或移动权限。工具在 Backpack 与 Character 间移动,应监听状态而非假定固定父级。
常见失败:复活后失效(缓存引用,需按 CharacterAdded 重建并在移除时清理)、死亡后回调触发两次(旧连接残留,需角色作用域清理与代际检查)、延迟加载修改错误骨架(异步存活超过生成,需每次 yield 后比对当前角色/代际)、动画仅本地可见(Animator/上下文/资源所有权错误)、标记被当作权威判定(应仅用于计时表现)、R6/自定义骨架报错(假定 R15 名称,需定义骨架契约并测试)、工具消失(假定固定父级)、自定义力与 Humanoid 争夺运动控制(每个状态只保留一个移动权威)。
参考:references/lifecycle-and-animation.md 涵盖服务端绑定、死亡与移除区别、骨架与动画验证、自定义角色及生命周期压力矩阵;相关技能有 roblox-physics、roblox-networking、input-systems、camera-systems。官方参考见 create.roblox.com 的 characters、animation/using、characters/appearance 文档。缺失信息:未提供收费、价格、平台与效果数据。