菜单
How FRB's platformer entity movement/physics works — MovementType state machine, ground/air value sets, collision-driven terrain switching. Triggers: PlatformerValues, MovementType, GroundMovement, AirMovement, AfterDoubleJump, CurrentMovement, GroundCollidedAgainst, IsOnGround, PlatformerPlugin.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/vchelaru/FlatRedBall --skill platformer-physics命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Use when adding, modifying, or reasoning about Gluj/Glux file format versions, the GluxVersions enum, FileVersion checks, or anything that gates behavior on the version of a loaded Glue project.
TaskManager's task-scheduling model — priority tiers, not FIFO, and why AddOrMoveToEnd coalescing can silently miss. Triggers: TaskExecutionPreference, AddOrMoveToEnd, TaskManager.Self.Add/AddAsync, GenerateElementCode, AddOrRunIfTasked, EffectiveId, out-of-order regeneration.
Gate checklist before fixing any FlatRedBall1 (engine + Glue) issue. Triggers: new bug report, "fix this issue", TDD, testability, before editing production code.
正在显示 SKILL.md
| name | platformer-physics |
| description | How FRB's platformer entity movement/physics works — MovementType state machine, ground/air value sets, collision-driven terrain switching. Triggers: PlatformerValues, MovementType, GroundMovement, AirMovement, AfterDoubleJump, CurrentMovement, GroundCollidedAgainst, IsOnGround, PlatformerPlugin. |
Platformer entities are generated code, not engine classes: FRBDK/Glue/PlatformerPlugin (the Glue plugin) reads Models/PlatformerValues.cs field values from the Glue project and emits the actual movement logic into the user's project via CodeGenerators/EntityCodeGenerator.cs. To change runtime platformer behavior, edit the templates in EntityCodeGenerator.cs; to change what values a user can configure, edit Models/PlatformerValues.cs + the plugin's ViewModels/Views.
A platformer entity holds up to three PlatformerValues sets — GroundMovement, AirMovement, AfterDoubleJump — plus an enum MovementType {Ground, Air, AfterDoubleJump}. CurrentMovementType setter calls UpdateCurrentMovement() (EntityCodeGenerator.cs:337) which resolves CurrentMovement to the matching set (falls back to AirMovement if AfterDoubleJump is unset) and applies Gravity→YAcceleration. DetermineMovementValues() (EntityCodeGenerator.cs:666) drives the Ground/Air/AfterDoubleJump transitions each frame off mIsOnGround and mHasDoubleJumped.
mIsOnGround is set only inside CollideAgainst(...) during solid-collision resolution (EntityCodeGenerator.cs:882), not by any standalone "am I touching the floor" check — it's a side effect of that frame's collision pass.
Swapping GroundMovement/AirMovement per terrain type is user code, not plugin-generated: check GroundCollidedAgainst/ItemsCollidedAgainst (populated after all of that frame's collision resolves) against named TileShapeCollection relationships in CustomActivity, then reassign e.g. this.GroundMovement = PlatformerValuesStatic[...IceGround]. Full pattern: FlatRedBallDocs/tutorials/platformer-plugin/groundcollidedagainst-for-movement-values.md.
Full explanations (with tuning guidance and video examples) live in FlatRedBallDocs/tutorials/platformer-plugin/platformer-basics/04-control-values.md. Field reference: Models/PlatformerValues.cs. Key gotcha: AccelerationTimeX/DecelerationTimeX of 0 means Immediate movement (no easing); JumpApplyByButtonHold implements variable jump height by turning gravity off while held, not by delaying the jump.
FlatRedBallDocs/tutorials/platformer-plugin/ has the full tutorial tree (basics, animations, ladders, moving platforms, multiplayer, etc.) — check there before re-deriving behavior from code.
