threejs-gameplay-systems
Skill0 starsChanged 5 months agoMITView on GitHub
Build and iterate playable Three.js game systems. Combines starter scaffold creation, architecture, gameplay implementation, and game-feel tuning. Use for first playable slices, new Vite/TypeScript/Three.js game setup, game loops, entity systems, input, collision/physics, scoring, objectives, audio hooks, camera, controls, difficulty, feedback, and maintainable structure.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- majidmanzarpour/threejs-game-skillstheir own version, first seen Sep 28, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- majidmanzarpour/threejs-game-skills★ 2.2ksame name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository9 other files it gives its agents.
- AGENTS.mdAGENTS.md
- threejs-3d-generatorSkill
- threejs-aaa-graphics-builderSkill
- threejs-audio-generatorSkill
- threejs-debug-profilerSkill
- threejs-game-directorSkill
- threejs-game-ui-designerSkill
- threejs-image-generatorSkill
- threejs-qa-releaseSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 5 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 10
Create or evolve a playable browser game loop with clear ownership, responsive controls, deterministic update order, and verified …
- Distinctive: line 35
Keep hot paths allocation-light and update order explicit.
- Distinctive: line 36
Verify with build, browser, screenshot, canvas pixels, console/page errors, and one real input path.
- Distinctive: line 40
Use the bundled scaffold when starting a new project or when the user asks for a starter game:
- Very specific: line 50
Use TypeScript, Vite, Three.js modules.
- Very specific: line 53
Use cannon-es only as a lightweight JS fallback for small/simple rigid-body scenes.
- Distinctive: line 54
Use custom collision when authored arcade feel is more important than simulation.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Three.js Gameplay Systems
Purpose
Create or evolve a playable browser game loop with clear ownership, responsive controls, deterministic update order, and verified player-facing behavior.
Use When
Starting a new game, repairing a weak prototype, adding mechanics/entities, designing architecture, tuning camera/controls, implementing rules/objectives, or improving game feel.
Workflow
Load references/gameplay-workflows.md as the first action when the task includes first playable setup, architecture, mechanics, entities, input, camera, collision/physics, scoring, objectives, feedback, or feel tuning.
Load references/physics-engine-selection.md before adding or changing physics, collision-heavy gameplay, vehicle movement, rolling balls, mini-golf, pool/snooker, pinball, rigid-body puzzles, character controllers, sensors, high-speed projectiles, moving platforms, or physics QA. Track both references in a reference ledger with yes/no, path, and failure reason. Do not mark the gameplay phase complete while a required reference is skipped.
Load references/checklists/new-game-definition-of-done.md before claiming a new game or first playable slice is complete.
Load references/checklists/endless-runner-premium-quality.md for endless runner work.
Load references/prompt-templates.md only when the user asks for reusable prompts, starter prompts, or a task template.
Load threejs-audio-generator when implementing real SFX, ambience, UI sounds, voice/TTS, or audio cleanup beyond simple placeholder hooks. Gameplay code should emit audio events; the audio skill should generate or process the actual assets and define the runtime audio matrix.
- Inspect project structure, scripts, dependencies, current loop, input, camera, entities, state, UI, and diagnostics.
- Define the one-sentence playable loop: verb, objective, feedback, fail/retry.
- Choose small architecture boundaries:
core,game,entities,systems,assets,ui,tests. - Implement mechanics in playable increments: input, state, entity, collision/physics, feedback, HUD/audio hook, diagnostics.
- Tune feel: movement, acceleration, camera follow/FOV/shake, impact, cooldowns, difficulty, restart loop.
- Keep hot paths allocation-light and update order explicit.
- Verify with build, browser, screenshot, canvas pixels, console/page errors, and one real input path.
Packaged Scaffold
Use the bundled scaffold when starting a new project or when the user asks for a starter game:
python3 <this-skill-dir>/scripts/create_threejs_game.py ./my-gameThe script copies assets/threejs-vite-game/, rewrites the project name in package.json and package-lock.json, and keeps generated games self-contained with their own visual test and canvas-inspection script. Use --force only when the target directory may be overwritten.
Library Guidance
- Use TypeScript, Vite, Three.js modules.
- Custom collision for simple arcade triggers and pickups.
- Rapier is the default robust physics engine for serious Three.js browser games with rigid bodies, sensors, balls, ramps, many contacts, or high-speed collisions.
- Use
cannon-esonly as a lightweight JS fallback for small/simple rigid-body scenes. - Use custom collision when authored arcade feel is more important than simulation.
lil-guifor live-tuned constants when useful.- Web Audio for runtime playback and procedural feedback;
threejs-audio-generatorfor generated game audio assets.
Common Failure Modes
- Static demo instead of playable loop.
- Mechanic compiles but cannot be triggered by real input.
- Camera/controls feel delayed or hide the next decision.
- State changes do not drive UI/audio/VFX.
- Architecture abstractions appear before mechanics need them.
Final Response
Report the reference ledger, gameplay checklist outcome, behavior, controls, changed files, architecture choices, tuned values, verification evidence, artifacts, and remaining edge cases.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

