melonjs-physics SKILL.md skillA

melonjs-physics from melonjs/melonjs is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add melonjs/melonjs/melonjs-physics@git:20261106.62cc59f

Pins git:20261106.62cc59f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
melonjs/melonjs
Path
packages/melonjs/skills/melonjs-physics/SKILL.md
Versions recorded
7
Latest version
git:20261106.62cc59f, committed Nov 6, 2026
First version recorded
Sep 22, 2026
Size
47,053 bytes
Repository stars
6,441
License
MIT

Use this skill for collision, physics bodies, movement, and spatial queries in melonJS — the built-in SAT world and the planck/matter adapters. Covers bodyDef vs Body, collision types and masks, the collision callback family and their firing rules, raycast/queryAABB/querySphere, the behaviour differences between adapters, and which one to pick for a given game. Triggers on: which physics engine, choosing an adapter, rotation collision, rotating body, torque, joints, stacking, Body, bodyDef…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Physics and collision

> melonJS has a built-in SAT collision world and two optional rigid-body
> adapters. Movement, collision callbacks and spatial queries all behave
> differently depending on which is active — and several of the differences fail
> silently.

## Choosing a world

| | when |
|---|---|
| **built-in** (default) | Arcade-style: platformers, top-down games. Fast, position-based, not Newtonian. |
| **`@melonjs/planck-adapter`** | Full rigid-body dynamics — stacking, joints, realistic restitution. |
| **`@melonjs/matter-adapter`** | Same class of thing, backed by matter-js. |

### Picking one

Start with the built-in. It is the default for a reason: no dependency, the
smallest bundle, and its position-based model is what most 2D games actually
want — a platformer's jump arc is a designed curve, not a simulated one, and
tuning gravity against a solver you are fighting is a bad afternoon.

**Move to an adapter when the game needs something the builtin cannot express**,
and these are the usual triggers:

- **Rotation that collides.** The clearest signal. The builtin's SAT never reads
  `body.angle`, so a spinning shape collides as though it never turned. See
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add melonjs/melonjs/melonjs-physics@sha256:b92cd4c2e5d12d3f

The line at the top of this page pins the label git:20261106.62cc59f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_v5eh63cmfzw6ugfp.svg)](https://markdownregistry.com/a/art_v5eh63cmfzw6ugfp)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 7 versions of this file, between Sep 22, 2026 and Nov 6, 2026, about one every 8 days.

versioncommittedcommitsizeaudit
git:20261106.62cc59f latest2026-11-06 62cc59f 47,053 BA view · diff
git:20261105.7570a252026-11-05 7570a25 43,227 BA view · diff
git:20261011.ea100902026-10-11 ea10090 42,524 BA view · diff
git:20260929.f3f1e762026-09-29 f3f1e76 42,498 BA view · diff
git:20260927.be310d32026-09-27 be310d3 40,381 BA view · diff
git:20260922.b53c8d02026-09-22 b53c8d0 38,621 BA view · diff
git:20260922.676314b2026-09-22 676314b 38,007 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (47053 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

melonjs/melonjs · 6,441 stars · license MIT · pushed 2026-11-06 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_v5eh63cmfzw6ugfp
GET https://markdownregistry.com/api/v1/resolve?ref=melonjs/melonjs/melonjs-physics
GET https://markdownregistry.com/api/v1/blob/b92cd4c2e5d12d3fec670b3ef5b59681cdff1695b925d8c9ceab7081977debef

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from melonjs/melonjs

AGENTS.md AGENTS.md file
melonjs/melonjs · AGENTS.md
git:20261102.0ab2067 · audit A · 6,441 stars
CLAUDE.md CLAUDE.md file
melonjs/melonjs · CLAUDE.md
git:20261102.0ab2067 · audit A · 6,441 stars
AGENTS.md@packages/melonjs/skills AGENTS.md file
melonjs/melonjs · packages/melonjs/skills/AGENTS.md
git:20261030.33bfc96 · audit A · 6,441 stars
melonjs-20-migration SKILL.md skill
melonjs/melonjs · packages/melonjs/skills/melonjs-20-migration/SKILL.md · Use this skill when writing melonJS code that may be based on pre-20.x knowledge, when migrating a game from melonJS…
git:20260831.8e2f9be · audit A · 6,441 stars
melonjs-3d-assets SKILL.md skill
melonjs/melonjs · packages/melonjs/skills/melonjs-3d-assets/SKILL.md · Use this skill when loading 3D models into melonJS — glTF and GLB scenes, OBJ/MTL models, materials, imported lights…
git:20261012.baaf32c · audit A · 6,441 stars
melonjs-3d SKILL.md skill
melonjs/melonjs · packages/melonjs/skills/melonjs-3d/SKILL.md · Use this skill for anything 3D or 2.5D in melonJS — Camera3d, Mesh, InstancedMesh, Sprite3d billboards, Light3d, ground…
git:20261016.2f86055 · audit A · 6,441 stars
melonjs-audio SKILL.md skill
melonjs/melonjs · packages/melonjs/skills/melonjs-audio/SKILL.md · Use this skill for sound and music in melonJS — loading audio, playing effects, background tracks, audio sprites…
git:20261102.8d1fb28 · audit A · 6,441 stars
melonjs-camera-and-drawing SKILL.md skill
melonjs/melonjs · packages/melonjs/skills/melonjs-camera-and-drawing/SKILL.md · Use this skill for camera control and immediate-mode drawing in melonJS — following a target, viewport bounds, shake…
git:20261105.7570a25 · audit A · 6,441 stars
melonjs-deployment SKILL.md skill
melonjs/melonjs · packages/melonjs/skills/melonjs-deployment/SKILL.md · Use this skill when packaging, shipping or scaffolding a melonJS game — starting a project with create-melonjs…
git:20260831.8e2f9be · audit B · 6,441 stars
melonjs-display-and-scaling SKILL.md skill
melonjs/melonjs · packages/melonjs/skills/melonjs-display-and-scaling/SKILL.md · Use this skill when a melonJS game looks blurry, soft, shimmering or cropped, or when choosing how the canvas fills its…
git:20261028.0587c57 · audit A · 6,441 stars
melonjs-effects-and-shaders SKILL.md skill
melonjs/melonjs · packages/melonjs/skills/melonjs-effects-and-shaders/SKILL.md · Use this skill for post-processing effects, custom shaders, blend modes and colour grading in melonJS. Covers the…
git:20261102.a41d6a3 · audit A · 6,441 stars
melonjs-events SKILL.md skill
melonjs/melonjs · packages/melonjs/skills/melonjs-events/SKILL.md · Use this skill for the melonJS event bus and lifecycle hooks — subscribing to engine events, the per-frame and…
git:20261105.7570a25 · audit A · 6,441 stars

Every file in melonjs/melonjs

Browse by kind, by grade A, or by owner.