# ModTrick

> Everything is a mod.
> Law: if it ships in the game, it is a mod; if it is a mod, it has ASEC
> (META · GENESIS · SHADOW · MGS); if it has ASEC, ModRuntime can load it;
> if ModRuntime can load it, this site can teach it.
>
> Primary domain: https://modtrick.com
> Fallback: https://modtrick.pages.dev

## Agent entry (read first)

- https://modtrick.com/agents/bootstrap.json
- https://modtrick.com/docs/EVERYTHING-IS-A-MOD.md
- https://modtrick.com/docs/HOW-TO-BUILD-A-MOD.md
- https://modtrick.com/docs/agents/ADD-MODDING-TO-GAME.md
- https://modtrick.com/docs/agents/ONBOARD.md
- https://modtrick.com/game/outpost/
- https://modtrick.com/AGENTS.md
- https://modtrick.com/llms.txt

## Architecture

- Everything Is a Mod (law): /docs/EVERYTHING-IS-A-MOD.md
- How to build a mod: /docs/HOW-TO-BUILD-A-MOD.md
- Mod configuration: /docs/MOD-CONFIG.md
- Mod catalog (JSON): /agents/mod-catalog.json
- Shared kit: /mods/_shared/mod-kit.js
- Add modding to a game (agents): /docs/agents/ADD-MODDING-TO-GAME.md
- Docs hub: /docs/
- Host integration: /docs/agents/host-integration.md
- Harness matrix: /docs/agents/harness-matrix.md
- Skill package: /pkg/modtrick/SKILL.md
- Proof game: /game/outpost/

## Live modules (three.js)

### Seascape
- Ocean: /mods/threejs-ocean/ (mod.json, ocean-mod.js, demo)
- Sky: /mods/threejs-sky/ (mod.json, sky-mod.js, demo)

### Core Gameplay Kit
- Playground: /studio/playground.html
- Orbit camera: /mods/threejs-orbit-camera/
- FPS controller: /mods/threejs-fps-controller/
- Post FX: /mods/threejs-post-fx/
- Particles: /mods/threejs-particles/
- Interact: /mods/threejs-interact/
- GLTF kit: /mods/threejs-gltf-kit/
- Grid floor: /mods/threejs-grid-floor/
- HUD: /mods/threejs-hud/
- Collectibles: /mods/threejs-collectibles/
- Minimap: /mods/threejs-minimap/
- Simple character: /mods/threejs-simple-character/
- Third person: /mods/threejs-third-person/
- Outpost test game: /game/outpost/
- Health: /mods/threejs-health/
- Timer: /mods/threejs-timer/
- NPCs: /mods/threejs-npc/
- Weather rain: /mods/threejs-weather-rain/
- Inventory: /mods/threejs-inventory/
- Checkpoints: /mods/threejs-checkpoint/
- Audio bus: /mods/threejs-audio-bus/
- Billboards: /mods/threejs-billboards/
- Quest: /mods/threejs-quest/
- Portal: /mods/threejs-portal/
- Day cycle: /mods/threejs-day-cycle/
- Toast: /mods/threejs-toast/
- Debug stats: /mods/threejs-debug-stats/
- Currency: /mods/threejs-currency/
- Dialogue box: /mods/threejs-dialogue-box/
- Light rig: /mods/threejs-light-rig/

## Catalog

- Home: /
- Browse assets: /assets/
- Packs: /packs/
- Studio: /studio/
- Pricing: /pricing.html
- License: /license.html

## Reference host

- ModRuntime: /host/mod-runtime.js
- Example frame context: /host/frame-context.js
- Example game bootstrap: /host/README.md

## Optional

- Blog: /blog/
- Install script (repo): /pkg/install.py