SuperAPI AI 工具集

player-controller

编程与开发

查看项目

更新于 10-15 22:40

技能介绍

用途:在 Godot 4.3+ 中实现玩家移动,提供 CharacterBody2D/3D 的输入、物理与移动模式参考,示例不含已废弃 API,先给 GDScript 再给 C#。

主要能力:说明 CharacterBody 与 RigidBody 的选取原则;给出移动循环顺序(读输入、施加力、修改 velocity、move_and_slide()、移动后状态检查),并强调放在 _physics_process(delta) 而非 _process。提供 2D 俯视、2D 平台跳跃(含 coyote time、jump buffer、可变跳跃高度)、3D 第一人称控制器示例。

用法:按示例扩展 CharacterBody2D/3D,用 @export 调整速度、加速度、跳跃速度等;重力从 ProjectSettings 的 physics/2d/default_gravity 或 physics/3d/default_gravity 读取;输入动作名需与项目输入映射一致;每帧修改完 velocity 后再调用 move_and_slide()。

常见问题与限制:角色贴墙可设 floor_block_on_wall = false;抖动或帧率相关移动应移入 _physics_process;跳跃高度不一致用可变跳跃;下坡滑动需调 floor_snap_length 与 floor_max_angle;鼠标视角反向需对 yaw/pitch 的 rotation delta 取反。

Dash 与 Wall Jump 在 references/common-movement-recipes.md 中给出完整 GDScript 与 C# 实现,正文未展开。相关技能包括 physics-system、2d-essentials、3d-essentials、state-machine、camera-system、component-system、animation-system、input-handling、ai-navigation。该技能聚焦移动实现,未提供安装命令、定价或平台信息。