游戏客户端架构 / 系统课时
哪些参数应该开放给设计师调
哪些参数应该开放给设计师调
角色手感需要反复迭代,但并不是所有控制器内部变量都适合开放给设计师。本课以 Unity 角色移动为例,区分可调运动参数、固定执行规则与引擎碰撞配置,建立具备范围约束、数据校验和运行验证能力的控制器调参方案。
学习目标
- 判断速度、加速度、跳跃和坡度参数的合理开放边界。
- 使用独立配置资源管理运动手感,避免设计参数散落在代码中。
- 为参数设置有效范围,并建立可复现的调参与验收流程。
先区分游戏手感和控制规则
设计师调整的是角色的运动体验,程序负责确保移动逻辑稳定、一致且符合物理约束。二者如果混在一起,很容易出现改一个数值却破坏控制器行为的问题。
适合开放的参数通常具有三个特征:改变后能够直接观察到手感差异、能够设定合理的安全区间、不需要修改底层执行顺序。
| 参数 | 建议开放方式 | 主要影响 |
|---|---|---|
| 最大水平速度 | 开放并限制范围 | 跑动快慢 |
| 地面加速度 | 开放并限制范围 | 起步响应速度 |
| 地面减速度 | 开放并限制范围 | 松开输入后的停步距离 |
| 空中控制系数 | 开放 0~1 | 空中调整方向的能力 |
| 跳跃高度 | 开放正数范围 | 跳跃顶点高度 |
| 重力强度 | 有约束地开放 | 上升、下落节奏 |
| 最大可行走坡度 | 结合关卡约束开放 | 角色能够行走的坡面范围 |
| 状态机迁移条件 | 默认由程序维护 | 状态合法性和控制权 |
| 位移与碰撞执行顺序 | 不开放 | 运行正确性和稳定性 |
例如,设计师可以把移动速度从每秒 4 米调整为 6 米,但不应该通过普通调参面板改变碰撞查询发生在移动之前还是之后。
用配置资源集中管理运动参数
Unity 的 ScriptableObject 适合保存一组可复用的运动参数,使不同角色或不同角色职业可以使用独立配置,而不必复制完整控制脚本。
下面建立最小可用的运动配置。将代码保存为 CharacterMovementSettings.cs。
using UnityEngine;
[CreateAssetMenu(menuName = "Game/Character Movement Settings")]
public class CharacterMovementSettings : ScriptableObject
{
[Header("Horizontal Movement")]
[Min(0f)] public float maxSpeed = 5f;
[Min(0f)] public float acceleration = 18f;
[Min(0f)] public float deceleration = 24f;
[Range(0f, 1f)] public float airControl = 0.35f;
[Header("Jump And Gravity")]
[Min(0.01f)] public float jumpHeight = 1.5f;
[Min(0.01f)] public float gravity = 20f;
[Header("Ground")]
[Range(0f, 89f)] public float maxWalkableSlope = 45f;
private void OnValidate()
{
// Inspector 的限制并不能替代数据校验,脚本也可能写入非法值。
maxSpeed = Mathf.Max(0f, maxSpeed);
acceleration = Mathf.Max(0f, acceleration);
deceleration = Mathf.Max(0f, deceleration);
airControl = Mathf.Clamp01(airControl);
jumpHeight = Mathf.Max(0.01f, jumpHeight);
gravity = Mathf.Max(0.01f, gravity);
maxWalkableSlope = Mathf.Clamp(maxWalkableSlope, 0f, 89f);
}
}这段代码是完整的配置资源定义,不是独立的运动控制器。保存并等待 Unity 编译后,在 Project 窗口使用 Assets > Create > Game > Character Movement Settings 创建配置资源,再由移动脚本引用。
预期结果:Inspector 中会出现水平速度、加速度、减速度、空中控制、跳跃高度、重力和最大坡度字段。设计师可以修改数值,OnValidate 会在编辑器校验时将超出限定范围的值修正。
需要注意,OnValidate 主要用于编辑阶段的数据校验。生产环境读取配置时,仍应确保配置来源可信且运行时的计算不会依赖非法数据。
让移动代码消费配置而不是复制数值
配置仅负责描述运动参数,控制器负责根据输入、状态和帧时间执行运动。下面给出一个可运行的水平移动示例,演示速度、加速度、减速度以及空中控制系数如何生效。
将脚本保存为 ConfigurableCharacterMovement.cs,并挂载到具有 CharacterController 的角色对象上。项目需启用经典 Input Manager 或 Both,并在 Inspector 中引用刚刚创建的配置资源。
using UnityEngine;
[RequireComponent(typeof(CharacterController))]
public class ConfigurableCharacterMovement : MonoBehaviour
{
[SerializeField] private CharacterMovementSettings settings;
private CharacterController controller;
private Vector3 horizontalVelocity;
private float verticalVelocity;
private void Awake()
{
controller = GetComponent<CharacterController>();
}
private void Update()
{
if (settings == null) return;
Vector2 input = new Vector2(
Input.GetAxisRaw("Horizontal"),
Input.GetAxisRaw("Vertical")
);
input = Vector2.ClampMagnitude(input, 1f);
Vector3 target = new Vector3(input.x, 0f, input.y)
* settings.maxSpeed;
// 减速与加速使用不同配置,避免松开按键后仍持续滑行。
float rate = input.sqrMagnitude > 0f
? settings.acceleration
: settings.deceleration;
if (!controller.isGrounded)
rate *= settings.airControl;
horizontalVelocity = Vector3.MoveTowards(
horizontalVelocity, target, rate * Time.deltaTime);
// 保持基础贴地速度,重力取正值,由计算过程施加向下方向。
if (controller.isGrounded && verticalVelocity < 0f)
verticalVelocity = -2f;
verticalVelocity -= settings.gravity * Time.deltaTime;
Vector3 velocity = horizontalVelocity
+ Vector3.up * verticalVelocity;
controller.Move(velocity * Time.deltaTime);
}
}预期结果:按住方向键时角色逐渐加速到 maxSpeed,松开后按照 deceleration 减速。离开地面后,airControl 会降低水平速度变化率。
该示例只演示水平运动与基础重力处理,不包含跳跃触发逻辑。配置中的 jumpHeight 为后续跳跃功能预留,其典型起跳速度计算为:
其中 为正的重力强度, 为目标跳跃高度, 为竖直起跳速度。完整跳跃实现还需要处理接地判定、跳跃输入和起跳时机。
同样,maxWalkableSlope 在本示例中尚未参与移动判断;如果使用 Unity 的 CharacterController,可在控制器初始化或配置应用阶段将经过验证的坡度值赋给 controller.slopeLimit。不能因为配置资源存在对应字段,就认为引擎组件会自动同步。
用参数之间的关系确定安全边界
参数不是互相独立的。移动速度提高以后,同样的加速度会使角色花费更长时间达到最高速度;提高跳跃高度也会影响角色越过障碍物的能力。
对于从静止开始、使用恒定加速度的理想水平运动,到达最高速度所需时间为:
例如最大速度为 6 米每秒、加速度为 12 米每二次方秒,理论加速时间约为 0.5 秒。若希望起步更灵敏,应同时考虑最高速度与加速度,而不是只增加速度。

最大坡度与胶囊体高度、台阶尺寸、地面碰撞形状密切相关。设计师可以调坡度值,但必须在实际关卡中验证通行性。对于特定动作游戏,甚至需要按角色类别分别设置参数范围,而不是共用统一上限。
另外,配置文件的数值变化只影响真正读取它们的逻辑。没有参与运动计算的字段,不应标记为已经支持实时调节。
建立可靠的调参与验收流程
建议将每套角色运动配置作为独立资源,并为修改建立清晰的测试条件。
- 固定测试场景、角色胶囊体尺寸、输入方式和初始位置。
- 每次只调整一组相关参数,例如速度与加速度,记录修改前后的表现。
- 验证起步时间、停止距离、空中转向、跳跃高度以及坡面通行情况。
- 在低帧率和高帧率下重复测试,检查是否存在明显的帧率相关差异。
- 通过版本管理保存配置变更,确认哪些值已经通过关卡设计验收。
使用共享的 ScriptableObject 资源时还应注意:多个角色引用同一个配置资源,修改资源可能同时影响所有引用者。如果需要战斗期间临时改变移动速度,应优先由运行时状态计算修正系数,不要直接修改共享资源中的原始数值。
设计师应当拥有调整运动目标与手感曲线的能力,但状态正确性、碰撞处理顺序和数据安全边界仍应由程序保证。将参数集中管理、限制取值范围,并配合固定场景验收,才能让控制器既方便迭代又容易维护。