AGENT SKILL

game-smooth-curves-and-motion

Design smooth game motion with splines, Bezier curves, interpolation, derivative continuity, path parameterization, and speed control. Use when implementing camera rails, waypoint paths, vehicle routes, projectile trails, animation curves, roads, rivers, or any motion/path system that must feel smooth.

License 许可
MIT
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
game-smooth-curves-and-motion
license
MIT
metadata
{ "tags": "game-dev,game-geometry,splines,bezier,motion", "version": "0.1.0", "category": "Game Development", "displayName": "Game Smooth Curves And Motion" }
description
Design smooth game motion with splines, Bezier curves, interpolation, derivative continuity, path parameterization, and speed control. Use when implementing camera rails, waypoint paths, vehicle routes, projectile trails, animation curves, roads, rivers, or any motion/path system that must feel smooth.
compatibility
Codex, Claude Code, and other Agent Skills-compatible clients.

03 SKILL.md 正文

Game Smooth Curves And Motion

Use this skill to design path and curve systems where continuity, control, and game feel matter more than exact mathematical purity.

Primary source: Geometry for Programmers by Oleksandr Kaleniuk (https://www.manning.com/books/geometry-for-programmers), transformed and paraphrased, especially chapters 5-7. Additional source: A Primer on Bezier Curves by Pomax (https://pomax.github.io/bezierinfo/).

Core Workflow

  1. Identify what must be smooth: position, tangent direction, speed, curvature, camera orientation, banking, or animation value.
  2. Choose the curve family that gives the needed controls with the least state: linear segments, cubic Hermite, Catmull-Rom, Bezier, B-spline, NURBS, or a custom polynomial piece.
  3. Define continuity targets:
    • C0: pieces meet at positions.
    • C1: tangents match for visually smooth direction.
    • C2: curvature changes smoothly.
  4. Decide parameterization: uniform t, chord length, centripetal, explicit timing, or arc-length lookup.
  5. Separate authoring controls from runtime samples. Designers may edit points and handles; the game may use baked lookup tables.
  6. Test extreme control points, sharp turns, closed loops, repeated points, and speed variation.

Curve Selection

  • Use linear segments for grid motion, debug paths, and intentionally sharp routes.
  • Use cubic Hermite when you know endpoint positions and tangent vectors.
  • Use Bezier curves when control handles are the natural authoring interface.
  • Use Catmull-Rom-style splines when paths should pass through waypoints with minimal handle authoring.
  • Use B-splines or NURBS when many control points, high continuity, or exact conic sections matter.
  • Avoid one high-degree global polynomial through many points. Split into pieces to avoid oscillation and poor local control.

Motion Rules

  • Smooth position does not imply smooth speed. Check derivative length along the path.
  • Constant t increments rarely produce constant world-space speed.
  • For nearly constant speed, precompute an arc-length table and map distance traveled back to curve parameter.
  • Tangent length affects both speed and curve shape in Hermite-like systems.
  • Normalize tangent direction only when speed should be controlled separately.
  • Keep gameplay collision separate from visual smoothing when curves are only a presentation layer.

Implementation Checklist

  • Curve type and continuity target are documented.
  • Parameter range and units are explicit.
  • Closed paths handle first/last continuity deliberately.
  • Runtime evaluation is bounded and allocation-free in hot paths.
  • Baked samples include position, tangent, optional normal/binormal, and cumulative distance when needed.
  • Debug view shows control points, handles, samples, tangents, and speed heat.

Common Mistakes

  • Using interpolation that passes through every point when approximation would be smoother and more stable.
  • Assuming Bezier handles are points on the curve.
  • Letting repeated or near-repeated points create undefined tangents.
  • Moving a camera at constant parameter speed and calling the result constant motion.
  • Adding more control points to fix a curve that needs a different parameterization or continuity target.

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-review-with-annotations

Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-find-and-synthesize-context

Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-update-docs

Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-records

Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-interactive-html

Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-collaborate-threads

Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.

★ 1.6k