《Cocos 游戏开发实战》7.3 手感调优与参数化

// assets/scripts/core/feel-config.ts
export interface FeelConfig {
  /** 起跳初速度，像素/秒。 */
  jumpVelocity: number;
  /** 松手时的速度保留比例，0–1。 */
  jumpCut: number;
  /** 土狼时间，秒。 */
  coyoteTime: number;
  /** 跳跃缓冲时间，秒。 */
  bufferTime: number;
  /** 关卡滚动速度，像素/秒。 */
  runSpeed: number;
  /** 摄像机前视量，像素。 */
  lookAhead: number;
  /** 重力加速度的绝对值，像素/秒²。 */
  gravity: number;
}

export const DEFAULT_FEEL: FeelConfig = {
  jumpVelocity: 900,
  jumpCut: 0.45,
  coyoteTime: 0.10,
  bufferTime: 0.12,
  runSpeed: 320,
  lookAhead: 120,
  gravity: 1800,
};

/** 用远端配置覆盖默认值，未提供的字段保持原样。 */
export function mergeFeel(base: FeelConfig, patch: Partial<FeelConfig>): FeelConfig {
  return { ...base, ...patch };
}

// assets/scripts/game/feel-tuner.ts
import { _decorator, Component, JsonAsset, resources, sys } from 'cc';
const { ccclass, property, menu, executeInEditMode } = _decorator;

@ccclass('FeelTuner')
@menu('block-dash/FeelTuner')
@executeInEditMode
export class FeelTuner extends Component {
  @property({ range: [400, 1600], slide: true, tooltip: '起跳初速度（像素/秒）' })
  jumpVelocity = 900;

  @property({ range: [0.05, 0.95], slide: true, step: 0.05, tooltip: '松手保留比例' })
  jumpCut = 0.45;

  @property({ range: [0, 0.3], slide: true, step: 0.01, tooltip: '土狼时间（秒）' })
  coyoteTime = 0.10;

  @property({ range: [0, 0.3], slide: true, step: 0.01, tooltip: '跳跃缓冲（秒）' })
  bufferTime = 0.12;

  @property({ range: [200, 900], slide: true, tooltip: '关卡滚动速度（像素/秒）' })
  runSpeed = 320;

  @property({ range: [0, 320], slide: true, tooltip: '摄像机前视量（像素）' })
  lookAhead = 120;

  /** 从 configs/feel.json 覆盖当前面板值，方便策划直接改文件。 */
  loadFromJson(): void {
    resources.load('configs/feel', JsonAsset, (err: Error | null, asset: JsonAsset) => {
      if (err || !asset.json) return;
      const data = asset.json as Record<string, number>;
      this.jumpVelocity = data.jumpVelocity ?? this.jumpVelocity;
      this.jumpCut = data.jumpCut ?? this.jumpCut;
      this.runSpeed = data.runSpeed ?? this.runSpeed;
    });
  }

  /** 把当前面板值写进本地存档，下次启动接着用。 */
  saveToLocal(): void {
    sys.localStorage.setItem('bd.feel', JSON.stringify({
      jumpVelocity: this.jumpVelocity,
      jumpCut: this.jumpCut,
      runSpeed: this.runSpeed,
    }));
  }
}

// assets/scripts/core/jump-arc.ts
/** 已知初速度与重力（都取正数），求跳跃峰高。 */
export function apexHeight(v0: number, gravity: number): number {
  return (v0 * v0) / (2 * gravity);
}

/** 求完整滞空时间（起跳到落回同高度）。 */
export function airTime(v0: number, gravity: number): number {
  return (2 * v0) / gravity;
}

// assets/scripts/game/camera-follow.ts
import { _decorator, Component, Node, math } from 'cc';
const { ccclass, property } = _decorator;

@ccclass('CameraFollow')
export class CameraFollow extends Component {
  @property({ type: Node, tooltip: '要跟随的目标节点' })
  target: Node | null = null;

  @property({ range: [0, 320], slide: true, tooltip: '前视量（像素）' })
  lookAhead = 120;

  @property({ range: [1, 20], slide: true, tooltip: '跟随阻尼，越大越跟手' })
  damping = 8;

  lateUpdate(dt: number): void {
    if (!this.target) return;
    const t = math.clamp01(this.damping * dt);
    const cur = this.node.position;
    const tx = this.target.position.x + this.lookAhead;
    const ty = this.target.position.y;
    this.node.setPosition(cur.x + (tx - cur.x) * t, cur.y + (ty - cur.y) * t, 0);
  }
}

{
  "jumpVelocity": 900,
  "jumpCut": 0.45,
  "coyoteTime": 0.10,
  "bufferTime": 0.12,
  "runSpeed": 320,
  "lookAhead": 120,
  "gravity": 3000
}

{
  "ver": "1.1.0",
  "importer": "json",
  "imported": true,
  "uuid": "3c1a0f6e-8b2d-4a71-9f30-5d2c7b4e1a88",
  "files": [ ".json" ],
  "subMetas": {},
  "userData": {}
}