create-threenative 0.2.15 → 0.2.18
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agent-docs/kit-mcp.md +10 -0
- package/agent-docs/kit-router.md +14 -0
- package/agent-docs/kit-stuck.md +7 -0
- package/agent-docs/references/assertion-reference.md +54 -110
- package/agent-docs/references/capability-reference.md +1740 -254
- package/agent-docs/references/conventions.md +299 -0
- package/agent-docs/references/kit-action-rpg.md +40 -0
- package/agent-docs/references/kit-adventure.md +40 -0
- package/agent-docs/references/kit-collectathon.md +38 -0
- package/agent-docs/references/kit-kart.md +31 -0
- package/agent-docs/references/kit-minimal.md +29 -0
- package/agent-docs/references/kit-platformer.md +34 -0
- package/agent-docs/references/kit-puzzle.md +22 -0
- package/agent-docs/references/kit-racing.md +26 -0
- package/agent-docs/references/kit-rain.md +31 -0
- package/agent-docs/references/kit-rts.md +34 -0
- package/agent-docs/references/kit-runner.md +32 -0
- package/agent-docs/references/kit-sailing.md +41 -0
- package/agent-docs/references/kit-shooter.md +33 -0
- package/agent-docs/references/kit-snow.md +33 -0
- package/agent-docs/references/kit-starter.md +55 -0
- package/agent-docs/references/kit-tower-defense.md +27 -0
- package/agent-docs/references/performance-basics.md +8 -4
- package/agent-docs/references/terrain-authoring.md +2 -1
- package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
- package/agent-files/.agents/skills/prd-creator/SKILL.md +3 -2
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +84 -59
- package/agent-files/.claude/hooks/discovery-gate.mjs +125 -0
- package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
- package/agent-files/.claude/settings.json +25 -0
- package/agent-files/.codex/hooks.json +18 -1
- package/dist/index.d.ts +97 -6
- package/dist/index.js +899 -271
- package/dist/terrain-kit.d.ts +7 -0
- package/dist/terrain-kit.js +82 -0
- package/dist/threenative.js +114 -16
- package/dist/web-engine-ccd-ik-solver.js +127 -0
- package/dist/web-engine-gltf-loader.js +71 -20
- package/dist/web-engine-post-effects.js +39 -14
- package/dist/web-engine-runtime.js +10011 -4101
- package/package.json +15 -9
- package/template-assets/clearwater/README.md +1 -1
- package/template-assets/patches/manifest.json +18 -0
- package/template-assets/patches/three@0.187.0.patch +2004 -407
- package/template-assets/terrain/alpine/assets.json +12 -0
- package/template-assets/terrain/alpine/bake.mjs +6 -0
- package/template-assets/terrain/alpine/credits.json +164 -0
- package/template-assets/terrain/alpine/heightmap.r16 +0 -0
- package/template-assets/terrain/alpine/recipe.json +119 -0
- package/template-assets/terrain/alpine/surface.json +53 -0
- package/template-assets/terrain/coastal/assets.json +11 -0
- package/template-assets/terrain/coastal/bake.mjs +6 -0
- package/template-assets/terrain/coastal/credits.json +117 -0
- package/template-assets/terrain/coastal/heightmap.r16 +0 -0
- package/template-assets/terrain/coastal/recipe.json +113 -0
- package/template-assets/terrain/coastal/surface.json +41 -0
- package/template-assets/terrain/desert/assets.json +12 -0
- package/template-assets/terrain/desert/bake.mjs +6 -0
- package/template-assets/terrain/desert/credits.json +164 -0
- package/template-assets/terrain/desert/heightmap.r16 +0 -0
- package/template-assets/terrain/desert/recipe.json +108 -0
- package/template-assets/terrain/desert/surface.json +54 -0
- package/template-assets/terrain/forest/assets.json +65 -0
- package/template-assets/terrain/forest/bake.mjs +8 -0
- package/template-assets/terrain/forest/credits.json +225 -0
- package/template-assets/terrain/forest/heightmap.r16 +0 -0
- package/template-assets/terrain/forest/recipe.json +350 -0
- package/template-assets/terrain/forest/surface.json +79 -0
- package/template-assets/terrain/tundra/assets.json +12 -0
- package/template-assets/terrain/tundra/bake.mjs +6 -0
- package/template-assets/terrain/tundra/credits.json +164 -0
- package/template-assets/terrain/tundra/heightmap.r16 +0 -0
- package/template-assets/terrain/tundra/recipe.json +277 -0
- package/template-assets/terrain/tundra/surface.json +54 -0
- package/templates/action-rpg/AGENTS.md +103 -84
- package/templates/action-rpg/CLAUDE.md +103 -84
- package/templates/action-rpg/kit.json +1 -0
- package/templates/action-rpg/package.json +7 -7
- package/templates/action-rpg/playtests/spells.playtest.json +20 -0
- package/templates/action-rpg/src/game.ts +2 -1
- package/templates/action-rpg/src/render/atmosphere.ts +11 -16
- package/templates/action-rpg/src/render/backlightControls.ts +10 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +4 -4
- package/templates/action-rpg/src/render/clouds.ts +13 -0
- package/templates/action-rpg/src/render/gpuSky.ts +4 -7
- package/templates/action-rpg/src/render/materialLighting.ts +5 -5
- package/templates/action-rpg/src/render/quality.ts +10 -33
- package/templates/action-rpg/src/scenes/Play.ts +30 -1
- package/templates/action-rpg/src/style.css +4 -0
- package/templates/action-rpg/src/ui/AbilityBar.tsx +1 -1
- package/templates/action-rpg/threenative.config.ts +0 -3
- package/templates/action-rpg/vite.config.ts +2 -0
- package/templates/adventure/AGENTS.md +92 -44
- package/templates/adventure/CLAUDE.md +92 -44
- package/templates/adventure/kit.json +5 -1
- package/templates/adventure/package.json +7 -7
- package/templates/adventure/src/game.ts +1 -1
- package/templates/adventure/src/style.css +4 -0
- package/templates/adventure/tsconfig.json +1 -1
- package/templates/adventure/vite.config.ts +2 -0
- package/templates/collectathon/AGENTS.md +93 -42
- package/templates/collectathon/CLAUDE.md +93 -42
- package/templates/collectathon/package.json +7 -7
- package/templates/collectathon/src/game.ts +1 -1
- package/templates/collectathon/src/level/Course.ts +55 -9
- package/templates/collectathon/src/level/terrain.ts +27 -6
- package/templates/collectathon/src/main.ts +1 -0
- package/templates/collectathon/src/render/foliage.ts +359 -98
- package/templates/collectathon/src/render/sky.ts +76 -12
- package/templates/collectathon/src/render/water.ts +32 -10
- package/templates/collectathon/src/scenes/Play.ts +18 -5
- package/templates/collectathon/src/style.css +4 -0
- package/templates/collectathon/tsconfig.json +1 -1
- package/templates/collectathon/vite.config.ts +2 -0
- package/templates/kart/AGENTS.md +87 -42
- package/templates/kart/CLAUDE.md +87 -42
- package/templates/kart/package.json +6 -6
- package/templates/kart/src/game.ts +1 -1
- package/templates/kart/src/main.ts +1 -0
- package/templates/kart/src/style.css +4 -0
- package/templates/kart/tsconfig.json +1 -1
- package/templates/kart/vite.config.ts +2 -0
- package/templates/minimal/AGENTS.md +105 -84
- package/templates/minimal/CLAUDE.md +105 -84
- package/templates/minimal/package.json +6 -6
- package/templates/minimal/playtests/stands-still.playtest.json +30 -0
- package/templates/minimal/src/game.ts +1 -1
- package/templates/minimal/src/render/atmosphere.ts +11 -16
- package/templates/minimal/src/render/backlightControls.ts +10 -0
- package/templates/minimal/src/render/backlightMaterial.ts +4 -4
- package/templates/minimal/src/render/camera.ts +13 -2
- package/templates/minimal/src/render/clouds.ts +13 -0
- package/templates/minimal/src/render/gpuSky.ts +4 -7
- package/templates/minimal/src/render/lighting.ts +4 -2
- package/templates/minimal/src/render/materialLighting.ts +5 -5
- package/templates/minimal/src/render/materials.ts +10 -0
- package/templates/minimal/src/render/quality.ts +7 -32
- package/templates/minimal/src/scenes/Play.ts +4 -1
- package/templates/minimal/vite.config.ts +7 -1
- package/templates/platformer/AGENTS.md +95 -46
- package/templates/platformer/CLAUDE.md +95 -46
- package/templates/platformer/index.html +1 -1
- package/templates/platformer/main.html +12 -0
- package/templates/platformer/package.json +7 -7
- package/templates/platformer/playtests/gamepad-idle.playtest.json +21 -0
- package/templates/platformer/playtests/gamepad.playtest.json +30 -0
- package/templates/platformer/src/entities/Fox.ts +21 -6
- package/templates/platformer/src/game.ts +1 -1
- package/templates/platformer/src/main.ts +1 -0
- package/templates/platformer/src/render/backlightControls.ts +10 -0
- package/templates/platformer/src/render/backlightMaterial.ts +4 -4
- package/templates/platformer/src/render/materialLighting.ts +5 -5
- package/templates/platformer/src/render/quality.ts +7 -32
- package/templates/platformer/src/scenes/Play.ts +2 -1
- package/templates/platformer/src/style.css +4 -0
- package/templates/platformer/src/worker-page.ts +29 -0
- package/templates/platformer/src/worker.ts +5 -0
- package/templates/platformer/tsconfig.json +1 -1
- package/templates/platformer/vite.config.ts +4 -0
- package/templates/puzzle/AGENTS.md +97 -80
- package/templates/puzzle/CLAUDE.md +97 -80
- package/templates/puzzle/package.json +7 -7
- package/templates/puzzle/src/game.ts +1 -1
- package/templates/puzzle/src/render/backlightControls.ts +10 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +4 -4
- package/templates/puzzle/src/render/materialLighting.ts +5 -5
- package/templates/puzzle/src/render/quality.ts +7 -32
- package/templates/puzzle/src/scenes/Play.ts +1 -1
- package/templates/puzzle/src/style.css +4 -0
- package/templates/puzzle/tsconfig.json +1 -1
- package/templates/puzzle/vite.config.ts +2 -0
- package/templates/racing/AGENTS.md +100 -82
- package/templates/racing/CLAUDE.md +100 -82
- package/templates/racing/package.json +7 -7
- package/templates/racing/src/game.ts +1 -1
- package/templates/racing/src/render/atmosphere.ts +11 -16
- package/templates/racing/src/render/backlightControls.ts +10 -0
- package/templates/racing/src/render/backlightMaterial.ts +4 -4
- package/templates/racing/src/render/clouds.ts +13 -0
- package/templates/racing/src/render/gpuSky.ts +4 -7
- package/templates/racing/src/render/materialLighting.ts +5 -5
- package/templates/racing/src/render/quality.ts +7 -32
- package/templates/racing/src/scenes/Race.ts +4 -1
- package/templates/racing/src/style.css +4 -0
- package/templates/racing/tsconfig.json +1 -1
- package/templates/racing/vite.config.ts +2 -0
- package/templates/rain/AGENTS.md +96 -84
- package/templates/rain/CLAUDE.md +96 -84
- package/templates/rain/native-playtests/lightning.playtest.json +85 -10
- package/templates/rain/package.json +6 -6
- package/templates/rain/playtests/reduced-motion.playtest.json +6 -0
- package/templates/rain/src/game.ts +1 -1
- package/templates/rain/src/scenes/Boot.ts +1 -0
- package/templates/rain/src/state.ts +7 -0
- package/templates/rain/src/ui/GameUi.tsx +7 -1
- package/templates/rain/vite.config.ts +6 -0
- package/templates/rts/AGENTS.md +100 -85
- package/templates/rts/CLAUDE.md +100 -85
- package/templates/rts/package.json +6 -6
- package/templates/rts/src/game.ts +1 -1
- package/templates/rts/src/render/backlightControls.ts +10 -0
- package/templates/rts/src/render/backlightMaterial.ts +4 -4
- package/templates/rts/src/render/materialLighting.ts +5 -5
- package/templates/rts/src/render/quality.ts +7 -31
- package/templates/rts/src/scenes/Play.ts +1 -1
- package/templates/rts/src/style.css +4 -0
- package/templates/rts/vite.config.ts +2 -0
- package/templates/runner/AGENTS.md +97 -80
- package/templates/runner/CLAUDE.md +97 -80
- package/templates/runner/package.json +7 -7
- package/templates/runner/playtests/performance.playtest.json +1 -1
- package/templates/runner/src/game.ts +1 -1
- package/templates/runner/src/render/atmosphere.ts +11 -16
- package/templates/runner/src/render/backlightControls.ts +10 -0
- package/templates/runner/src/render/backlightMaterial.ts +4 -4
- package/templates/runner/src/render/clouds.ts +13 -0
- package/templates/runner/src/render/gpuSky.ts +4 -7
- package/templates/runner/src/render/lighting.ts +53 -11
- package/templates/runner/src/render/materialLighting.ts +5 -5
- package/templates/runner/src/render/quality.ts +7 -32
- package/templates/runner/src/scenes/Run.ts +8 -4
- package/templates/runner/src/style.css +4 -0
- package/templates/runner/threenative.config.ts +0 -3
- package/templates/runner/tsconfig.json +1 -1
- package/templates/runner/vite.config.ts +2 -0
- package/templates/sailing/AGENTS.md +96 -79
- package/templates/sailing/CLAUDE.md +96 -79
- package/templates/sailing/package.json +7 -7
- package/templates/sailing/playtests/sails.playtest.json +1 -0
- package/templates/sailing/src/game.ts +1 -1
- package/templates/sailing/src/render/backlightControls.ts +10 -0
- package/templates/sailing/src/render/backlightMaterial.ts +4 -4
- package/templates/sailing/src/render/environmentSetup.ts +1 -1
- package/templates/sailing/src/render/materialLighting.ts +5 -5
- package/templates/sailing/src/render/quality.ts +7 -32
- package/templates/sailing/src/render/sky.ts +4 -0
- package/templates/sailing/src/style.css +5 -0
- package/templates/sailing/threenative.config.ts +0 -3
- package/templates/sailing/vite.config.ts +6 -0
- package/templates/shooter/AGENTS.md +97 -68
- package/templates/shooter/CLAUDE.md +97 -68
- package/templates/shooter/package.json +7 -7
- package/templates/shooter/src/game.ts +3 -2
- package/templates/shooter/src/render/atmosphere.ts +11 -16
- package/templates/shooter/src/render/backlightControls.ts +10 -0
- package/templates/shooter/src/render/backlightMaterial.ts +4 -4
- package/templates/shooter/src/render/clouds.ts +13 -0
- package/templates/shooter/src/render/gpuSky.ts +4 -7
- package/templates/shooter/src/render/materialLighting.ts +5 -5
- package/templates/shooter/src/render/quality.ts +10 -33
- package/templates/shooter/src/scenes/Play.ts +4 -1
- package/templates/shooter/src/style.css +4 -0
- package/templates/shooter/vite.config.ts +2 -0
- package/templates/snow/AGENTS.md +95 -76
- package/templates/snow/CLAUDE.md +95 -76
- package/templates/snow/package.json +7 -7
- package/templates/snow/src/game.ts +1 -1
- package/templates/snow/src/render/backlightControls.ts +10 -0
- package/templates/snow/src/render/backlightMaterial.ts +4 -4
- package/templates/snow/src/render/materialLighting.ts +5 -5
- package/templates/snow/src/render/quality.ts +7 -32
- package/templates/snow/src/style.css +5 -0
- package/templates/snow/threenative.config.ts +0 -3
- package/templates/snow/vite.config.ts +6 -0
- package/templates/starter/AGENTS.md +109 -88
- package/templates/starter/CLAUDE.md +109 -88
- package/templates/starter/native-playtests/render-chain.playtest.json +24 -24
- package/templates/starter/native-playtests/smooth-motion.playtest.json +3 -3
- package/templates/starter/package.json +7 -7
- package/templates/starter/src/entities/Crate.ts +5 -2
- package/templates/starter/src/entities/Player.ts +10 -22
- package/templates/starter/src/game.ts +4 -3
- package/templates/starter/src/render/adaptiveQuality.ts +17 -0
- package/templates/starter/src/render/atmosphere.ts +11 -16
- package/templates/starter/src/render/backlightControls.ts +10 -0
- package/templates/starter/src/render/backlightMaterial.ts +4 -4
- package/templates/starter/src/render/clouds.ts +13 -0
- package/templates/starter/src/render/contactShadow.ts +1 -1
- package/templates/starter/src/render/gpuSky.ts +4 -7
- package/templates/starter/src/render/lighting.ts +54 -4
- package/templates/starter/src/render/materialLighting.ts +5 -5
- package/templates/starter/src/render/postprocessing.ts +11 -10
- package/templates/starter/src/render/quality.ts +14 -1
- package/templates/starter/src/render/temporalAA.ts +8 -7
- package/templates/starter/src/render/temporalAAFrame.ts +30 -9
- package/templates/starter/src/render/temporalAAResolve.ts +15 -1
- package/templates/starter/src/render/temporalClampRelease.ts +183 -0
- package/templates/starter/src/render/temporalHistoryResolve.ts +90 -0
- package/templates/starter/src/render/temporalMoire.ts +190 -0
- package/templates/starter/src/render/temporalResolve.ts +75 -16
- package/templates/starter/src/render/temporalResolveDepth.ts +2 -0
- package/templates/starter/src/scenes/Play.ts +53 -32
- package/templates/starter/src/state.ts +2 -0
- package/templates/starter/src/style.css +4 -0
- package/templates/starter/src/ui/Menu.tsx +5 -1
- package/templates/starter/vite.config.ts +2 -0
- package/templates/tower-defense/AGENTS.md +97 -81
- package/templates/tower-defense/CLAUDE.md +97 -81
- package/templates/tower-defense/package.json +7 -7
- package/templates/tower-defense/src/game.ts +1 -1
- package/templates/tower-defense/src/render/backlightControls.ts +10 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +4 -4
- package/templates/tower-defense/src/render/materialLighting.ts +5 -5
- package/templates/tower-defense/src/render/quality.ts +7 -32
- package/templates/tower-defense/src/scenes/Battle.ts +1 -1
- package/templates/tower-defense/src/style.css +4 -0
- package/templates/tower-defense/tsconfig.json +1 -1
- package/templates/tower-defense/vite.config.ts +2 -0
- package/capabilities.json +0 -9197
- package/templates/AGENTS.md +0 -21
- package/templates/CLAUDE.md +0 -23
- package/templates/action-rpg/.codex/config.toml +0 -23
- package/templates/action-rpg/.cursor/mcp.json +0 -38
- package/templates/action-rpg/.gemini/settings.json +0 -38
- package/templates/action-rpg/.mcp.json +0 -38
- package/templates/action-rpg/.vscode/mcp.json +0 -43
- package/templates/action-rpg/.zed/settings.json +0 -43
- package/templates/action-rpg/opencode.json +0 -49
- package/templates/action-rpg/src/render/environmentContribution.ts +0 -188
- package/templates/action-rpg/src/render/environmentRadiance.ts +0 -36
- package/templates/action-rpg/src/render/environmentSampleCache.ts +0 -43
- package/templates/action-rpg/src/render/environmentSampling.ts +0 -193
- package/templates/action-rpg/src/render/environmentSnapshot.ts +0 -53
- package/templates/adventure/.codex/config.toml +0 -23
- package/templates/adventure/.cursor/mcp.json +0 -38
- package/templates/adventure/.gemini/settings.json +0 -38
- package/templates/adventure/.mcp.json +0 -38
- package/templates/adventure/.vscode/mcp.json +0 -43
- package/templates/adventure/.zed/settings.json +0 -43
- package/templates/adventure/opencode.json +0 -49
- package/templates/collectathon/.codex/config.toml +0 -23
- package/templates/collectathon/.cursor/mcp.json +0 -38
- package/templates/collectathon/.gemini/settings.json +0 -38
- package/templates/collectathon/.mcp.json +0 -38
- package/templates/collectathon/.vscode/mcp.json +0 -43
- package/templates/collectathon/.zed/settings.json +0 -43
- package/templates/collectathon/opencode.json +0 -49
- package/templates/kart/.codex/config.toml +0 -23
- package/templates/kart/.cursor/mcp.json +0 -38
- package/templates/kart/.gemini/settings.json +0 -38
- package/templates/kart/.mcp.json +0 -38
- package/templates/kart/.vscode/mcp.json +0 -43
- package/templates/kart/.zed/settings.json +0 -43
- package/templates/kart/opencode.json +0 -49
- package/templates/minimal/.codex/config.toml +0 -23
- package/templates/minimal/.cursor/mcp.json +0 -38
- package/templates/minimal/.gemini/settings.json +0 -38
- package/templates/minimal/.mcp.json +0 -38
- package/templates/minimal/.vscode/mcp.json +0 -43
- package/templates/minimal/.zed/settings.json +0 -43
- package/templates/minimal/opencode.json +0 -49
- package/templates/minimal/src/render/environmentContribution.ts +0 -188
- package/templates/minimal/src/render/environmentRadiance.ts +0 -36
- package/templates/minimal/src/render/environmentSampleCache.ts +0 -43
- package/templates/minimal/src/render/environmentSampling.ts +0 -193
- package/templates/minimal/src/render/environmentSnapshot.ts +0 -53
- package/templates/platformer/.codex/config.toml +0 -23
- package/templates/platformer/.cursor/mcp.json +0 -38
- package/templates/platformer/.gemini/settings.json +0 -38
- package/templates/platformer/.mcp.json +0 -38
- package/templates/platformer/.vscode/mcp.json +0 -43
- package/templates/platformer/.zed/settings.json +0 -43
- package/templates/platformer/opencode.json +0 -49
- package/templates/platformer/src/render/environmentContribution.ts +0 -188
- package/templates/platformer/src/render/environmentRadiance.ts +0 -36
- package/templates/platformer/src/render/environmentSampleCache.ts +0 -43
- package/templates/platformer/src/render/environmentSampling.ts +0 -193
- package/templates/platformer/src/render/environmentSnapshot.ts +0 -53
- package/templates/puzzle/.codex/config.toml +0 -23
- package/templates/puzzle/.cursor/mcp.json +0 -38
- package/templates/puzzle/.gemini/settings.json +0 -38
- package/templates/puzzle/.mcp.json +0 -38
- package/templates/puzzle/.vscode/mcp.json +0 -43
- package/templates/puzzle/.zed/settings.json +0 -43
- package/templates/puzzle/opencode.json +0 -49
- package/templates/puzzle/src/render/environmentContribution.ts +0 -188
- package/templates/puzzle/src/render/environmentRadiance.ts +0 -36
- package/templates/puzzle/src/render/environmentSampleCache.ts +0 -43
- package/templates/puzzle/src/render/environmentSampling.ts +0 -193
- package/templates/puzzle/src/render/environmentSnapshot.ts +0 -53
- package/templates/racing/.codex/config.toml +0 -23
- package/templates/racing/.cursor/mcp.json +0 -38
- package/templates/racing/.gemini/settings.json +0 -38
- package/templates/racing/.mcp.json +0 -38
- package/templates/racing/.vscode/mcp.json +0 -43
- package/templates/racing/.zed/settings.json +0 -43
- package/templates/racing/opencode.json +0 -49
- package/templates/racing/src/render/environmentContribution.ts +0 -188
- package/templates/racing/src/render/environmentRadiance.ts +0 -36
- package/templates/racing/src/render/environmentSampleCache.ts +0 -43
- package/templates/racing/src/render/environmentSampling.ts +0 -193
- package/templates/racing/src/render/environmentSnapshot.ts +0 -53
- package/templates/rain/.codex/config.toml +0 -23
- package/templates/rain/.cursor/mcp.json +0 -38
- package/templates/rain/.gemini/settings.json +0 -38
- package/templates/rain/.mcp.json +0 -38
- package/templates/rain/.vscode/mcp.json +0 -43
- package/templates/rain/.zed/settings.json +0 -43
- package/templates/rain/opencode.json +0 -49
- package/templates/rts/.codex/config.toml +0 -23
- package/templates/rts/.cursor/mcp.json +0 -38
- package/templates/rts/.gemini/settings.json +0 -38
- package/templates/rts/.mcp.json +0 -38
- package/templates/rts/.vscode/mcp.json +0 -43
- package/templates/rts/.zed/settings.json +0 -43
- package/templates/rts/opencode.json +0 -49
- package/templates/rts/src/render/environmentContribution.ts +0 -188
- package/templates/rts/src/render/environmentRadiance.ts +0 -36
- package/templates/rts/src/render/environmentSampleCache.ts +0 -43
- package/templates/rts/src/render/environmentSampling.ts +0 -193
- package/templates/rts/src/render/environmentSnapshot.ts +0 -53
- package/templates/runner/.codex/config.toml +0 -23
- package/templates/runner/.cursor/mcp.json +0 -38
- package/templates/runner/.gemini/settings.json +0 -38
- package/templates/runner/.mcp.json +0 -38
- package/templates/runner/.vscode/mcp.json +0 -43
- package/templates/runner/.zed/settings.json +0 -43
- package/templates/runner/README.md +0 -43
- package/templates/runner/opencode.json +0 -49
- package/templates/runner/src/render/environmentContribution.ts +0 -188
- package/templates/runner/src/render/environmentRadiance.ts +0 -36
- package/templates/runner/src/render/environmentSampleCache.ts +0 -43
- package/templates/runner/src/render/environmentSampling.ts +0 -193
- package/templates/runner/src/render/environmentSnapshot.ts +0 -53
- package/templates/sailing/.codex/config.toml +0 -23
- package/templates/sailing/.cursor/mcp.json +0 -38
- package/templates/sailing/.gemini/settings.json +0 -38
- package/templates/sailing/.mcp.json +0 -38
- package/templates/sailing/.vscode/mcp.json +0 -43
- package/templates/sailing/.zed/settings.json +0 -43
- package/templates/sailing/README.md +0 -28
- package/templates/sailing/opencode.json +0 -49
- package/templates/sailing/src/render/environmentContribution.ts +0 -188
- package/templates/sailing/src/render/environmentRadiance.ts +0 -36
- package/templates/sailing/src/render/environmentSampleCache.ts +0 -43
- package/templates/sailing/src/render/environmentSampling.ts +0 -193
- package/templates/sailing/src/render/environmentSnapshot.ts +0 -53
- package/templates/shooter/.codex/config.toml +0 -23
- package/templates/shooter/.cursor/mcp.json +0 -38
- package/templates/shooter/.gemini/settings.json +0 -38
- package/templates/shooter/.mcp.json +0 -38
- package/templates/shooter/.vscode/mcp.json +0 -43
- package/templates/shooter/.zed/settings.json +0 -43
- package/templates/shooter/opencode.json +0 -49
- package/templates/shooter/src/render/environmentContribution.ts +0 -188
- package/templates/shooter/src/render/environmentRadiance.ts +0 -36
- package/templates/shooter/src/render/environmentSampleCache.ts +0 -43
- package/templates/shooter/src/render/environmentSampling.ts +0 -193
- package/templates/shooter/src/render/environmentSnapshot.ts +0 -53
- package/templates/snow/.codex/config.toml +0 -23
- package/templates/snow/.cursor/mcp.json +0 -38
- package/templates/snow/.gemini/settings.json +0 -38
- package/templates/snow/.mcp.json +0 -38
- package/templates/snow/.vscode/mcp.json +0 -43
- package/templates/snow/.zed/settings.json +0 -43
- package/templates/snow/README.md +0 -26
- package/templates/snow/opencode.json +0 -49
- package/templates/snow/src/render/environmentContribution.ts +0 -188
- package/templates/snow/src/render/environmentRadiance.ts +0 -36
- package/templates/snow/src/render/environmentSampleCache.ts +0 -43
- package/templates/snow/src/render/environmentSampling.ts +0 -193
- package/templates/snow/src/render/environmentSnapshot.ts +0 -53
- package/templates/starter/.codex/config.toml +0 -23
- package/templates/starter/.cursor/mcp.json +0 -38
- package/templates/starter/.gemini/settings.json +0 -38
- package/templates/starter/.mcp.json +0 -38
- package/templates/starter/.vscode/mcp.json +0 -43
- package/templates/starter/.zed/settings.json +0 -43
- package/templates/starter/opencode.json +0 -49
- package/templates/starter/src/render/environmentContribution.ts +0 -188
- package/templates/starter/src/render/environmentRadiance.ts +0 -36
- package/templates/starter/src/render/environmentSampleCache.ts +0 -43
- package/templates/starter/src/render/environmentSampling.ts +0 -193
- package/templates/starter/src/render/environmentSnapshot.ts +0 -53
- package/templates/starter/src/render/rendererGate.ts +0 -36
- package/templates/tower-defense/.codex/config.toml +0 -23
- package/templates/tower-defense/.cursor/mcp.json +0 -38
- package/templates/tower-defense/.gemini/settings.json +0 -38
- package/templates/tower-defense/.mcp.json +0 -38
- package/templates/tower-defense/.vscode/mcp.json +0 -43
- package/templates/tower-defense/.zed/settings.json +0 -43
- package/templates/tower-defense/README.md +0 -16
- package/templates/tower-defense/opencode.json +0 -49
- package/templates/tower-defense/src/render/environmentContribution.ts +0 -188
- package/templates/tower-defense/src/render/environmentRadiance.ts +0 -36
- package/templates/tower-defense/src/render/environmentSampleCache.ts +0 -43
- package/templates/tower-defense/src/render/environmentSampling.ts +0 -193
- package/templates/tower-defense/src/render/environmentSnapshot.ts +0 -53
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
## MCP servers
|
|
2
|
+
|
|
3
|
+
`.mcp.json` wires six servers, and a session started in this folder loads them. Their tools can show as deferred: load them with `ToolSearch` `select:` plus the exact names, for example `select:mcp__threenative-engine__engine_search_capabilities,mcp__threenative-engine__engine_capability_detail,mcp__threenative-engine__engine_search_references,mcp__threenative-engine__engine_reference_detail,mcp__threenative-engine__engine_watch_reference`. A session started outside this folder runs `node node_modules/@threenative/core/mcp/call.mjs <server> <tool> '<json>'`; `call.mjs <server>` lists that server's tools.
|
|
4
|
+
|
|
5
|
+
- `threenative-engine`: before any new mechanic, helper or render stage, and on a slow frame or a wrong image. `engine_search_capabilities`, `engine_capability_detail`, `engine_search_references`, `engine_reference_detail`, `engine_watch_reference`.
|
|
6
|
+
- `threenative-assets`: a texture, HDRI, sound or model. `asset_search_sources`, `asset_download_file`, `audio_search_assets`, `mesh_optimize`.
|
|
7
|
+
- `threenative-sculpt`: a bespoke mesh or character from a reference image. `sculpt_plan`, `sculpt_spec_gate`, `sculpt_compare`, `sculpt_pass_gate`.
|
|
8
|
+
- `threenative-animation`: a rigged GLB with a held prop, foot slide or loop seam. `animation_inspect`, `animation_attach`, `animation_verify`.
|
|
9
|
+
- `threenative-terrain`: any terrain, from words. `terrain_generate`.
|
|
10
|
+
- `threenative-devtools`: after `npx @threenative/playtest trace` names no cause. `performance_start_trace`, `performance_analyze_insight`.
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
## Authoring flow
|
|
2
|
+
|
|
3
|
+
Detail for each step: `threenative-capabilities` skill. Do the steps in order. A step with no result records `none: <reason>`. A blank step blocks the next. A hook blocks the first new file under `src/` until step 3 ran for the current prompt (`TN_DISCOVERY_GATE=off` opts out; Codex needs `/hooks` trust).
|
|
4
|
+
|
|
5
|
+
1. **Kit** (new game only): `engine_search_capabilities {situation: "<the whole request>", scope: "request"}` returns the matching starter kit first. This folder is already a kit.
|
|
6
|
+
2. **Mechanics**: per mechanic, `engine_search_references {situation}`, then `engine_reference_detail` on each hit for pinned constants and feel. To see a mechanic move, `engine_watch_reference {query: "<game> <mechanic>"}` returns a contact sheet of real gameplay. Borrow mechanics only: no code, level layouts, character names or art. Cite `file:line`.
|
|
7
|
+
3. **Built-ins**: per mechanic, system or symptom, `engine_search_capabilities {situation, scope: "mechanic"}`; rows answer; `engine_capability_detail` only for omitted symbols. Constraints are binding. `verdict: "none"` means the game writes it in `src/`.
|
|
8
|
+
4. **Plan** (new game, or a change to several systems): `prd-creator` with the kit, references and built-ins. With a user, wait for explicit approval, then implement. With no user (`claude -p`, a script), record the plan and assumptions, then continue.
|
|
9
|
+
5. **Assets**: `asset_search_sources`, the source's search tool, then `asset_download_file`; record source and licence in `CREDITS.md`. Nothing fits: `sculpt_plan`. A rigged GLB: `animation_inspect` (`threenative-assets` skill).
|
|
10
|
+
6. **Build**: gameplay in `src/`, look in `src/render/` (`threenative-context` and `threenative-ui` skills). For parallel work, give each subagent one area and its files, then integrate.
|
|
11
|
+
7. **Prove**: one fail-closed playtest per mechanic, then `pnpm test` (`threenative-playtest` skill). A fresh judge compares a `--browser-recipe webgpu --headed` capture to the reference image (`threenative-visuals` skill; `node_modules/create-threenative/agent-docs/references/dream-loop.md`).
|
|
12
|
+
8. **Report**: the `pnpm dev` URL, `TN_FRAME_BUDGET`, `TN_SCENE_WARNING`, `TN_RENDER_PROJECTION`, and each skipped step with its reason.
|
|
13
|
+
|
|
14
|
+
A change to an existing game repeats steps 2-3 for that change, then steps 5-8.
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
## When the framework blocks you, write plain Three.js
|
|
2
|
+
|
|
3
|
+
When an `@threenative/*` API is broken, missing, or does not do what you need, replace only that piece with portable Three.js/plain code. Keep the loop, scenes, input, registry, and playtest bridge; avoid DOM globals, dynamic `import()`, and raw physics handles. **Report what blocked you** (API, expectation, result, replacement); do not stall the game.
|
|
4
|
+
|
|
5
|
+
## Stuck
|
|
6
|
+
|
|
7
|
+
`npx threenative doctor`, then `npx @threenative/playtest doctor`; a missing observation is not zero. A confirmed engine bug: `file-engine-bug` skill. Smallest correct change: `ponytail` skill. Slow frame: `threenative-performance` skill.
|
|
@@ -12,7 +12,7 @@ trivially fails `TN_PLAYTEST_SCENARIO_ASSERTS_NOTHING`.
|
|
|
12
12
|
|
|
13
13
|
Bounds display-referred luminance from a captured PNG frame, using a shared 256-bin histogram. **Use when** that is the thing the scenario must prove.
|
|
14
14
|
|
|
15
|
-
- **Supported on:**
|
|
15
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** browser.screenshot
|
|
16
16
|
|
|
17
17
|
| Field | Type | Required |
|
|
18
18
|
| --- | --- | --- |
|
|
@@ -48,7 +48,7 @@ Bounds display-referred luminance from a captured PNG frame, using a shared 256-
|
|
|
48
48
|
|
|
49
49
|
Reports the device's thermal, power and battery state around the run and judges whether the run is comparable with a cool one. **Use when** that is the thing the scenario must prove.
|
|
50
50
|
|
|
51
|
-
- **Supported on:**
|
|
51
|
+
- **Supported on:** android · **Requires:** device.metrics
|
|
52
52
|
|
|
53
53
|
| Field | Type | Required |
|
|
54
54
|
| --- | --- | --- |
|
|
@@ -70,7 +70,7 @@ Reports the device's thermal, power and battery state around the run and judges
|
|
|
70
70
|
|
|
71
71
|
Samples the framebuffer on every render frame inside a labeled loading window and requires every coarse-grid RGB sample to match the declared backdrop. **Use when** that is the thing the scenario must prove.
|
|
72
72
|
|
|
73
|
-
- **Supported on:**
|
|
73
|
+
- **Supported on:** browser, android · **Requires:** browser.screenshot
|
|
74
74
|
|
|
75
75
|
| Field | Type | Required |
|
|
76
76
|
| --- | --- | --- |
|
|
@@ -101,35 +101,11 @@ Samples the framebuffer on every render frame inside a labeled loading window an
|
|
|
101
101
|
}
|
|
102
102
|
```
|
|
103
103
|
|
|
104
|
-
### `reachability`
|
|
105
|
-
|
|
106
|
-
Checks every consecutive platform against a measured static movement-envelope fit; it does not simulate traversal, walls, ceilings, run-up, or air control. **Use when** that is the thing the scenario must prove.
|
|
107
|
-
|
|
108
|
-
- **Supported on:** web, desktop, bevy · **Requires:** entity.observe
|
|
109
|
-
|
|
110
|
-
| Field | Type | Required |
|
|
111
|
-
| --- | --- | --- |
|
|
112
|
-
| `artifact` | string | yes |
|
|
113
|
-
| `entities` | string[] (minimum 2) | yes |
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
```json
|
|
117
|
-
{
|
|
118
|
-
"reachability": {
|
|
119
|
-
"artifact": "artifacts/character-envelope/player.json",
|
|
120
|
-
"entities": [
|
|
121
|
-
"platform.a",
|
|
122
|
-
"platform.b"
|
|
123
|
-
]
|
|
124
|
-
}
|
|
125
|
-
}
|
|
126
|
-
```
|
|
127
|
-
|
|
128
104
|
### `aerodynamics`
|
|
129
105
|
|
|
130
106
|
Proves aerodynamic force telemetry and signed control-surface delivery for a flight entity. **Use when** that is the thing the scenario must prove.
|
|
131
107
|
|
|
132
|
-
- **Supported on:**
|
|
108
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.fixedStep, runtime.physics
|
|
133
109
|
|
|
134
110
|
| Field | Type | Required |
|
|
135
111
|
| --- | --- | --- |
|
|
@@ -160,7 +136,7 @@ Proves aerodynamic force telemetry and signed control-surface delivery for a fli
|
|
|
160
136
|
|
|
161
137
|
Proves screenshot change, populated coordinate or DOM element-bound regions, dark-pixel bounds, and sustained projected entity visibility. **Use when** that is the thing the scenario must prove.
|
|
162
138
|
|
|
163
|
-
- **Supported on:**
|
|
139
|
+
- **Supported on:** browser · **Requires:** browser.screenshot
|
|
164
140
|
|
|
165
141
|
| Field | Type | Required |
|
|
166
142
|
| --- | --- | --- |
|
|
@@ -197,7 +173,7 @@ Proves screenshot change, populated coordinate or DOM element-bound regions, dar
|
|
|
197
173
|
|
|
198
174
|
Proves the subject moved, reached a minimum velocity, or changed rotation during held input. **Use when** that is the thing the scenario must prove.
|
|
199
175
|
|
|
200
|
-
- **Supported on:**
|
|
176
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** entity.observe
|
|
201
177
|
|
|
202
178
|
| Field | Type | Required |
|
|
203
179
|
| --- | --- | --- |
|
|
@@ -233,7 +209,7 @@ Proves the subject moved, reached a minimum velocity, or changed rotation during
|
|
|
233
209
|
|
|
234
210
|
Proves a camera follows an entity or keeps a target in view. **Use when** that is the thing the scenario must prove.
|
|
235
211
|
|
|
236
|
-
- **Supported on:**
|
|
212
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** camera.observe, entity.observe
|
|
237
213
|
|
|
238
214
|
| Field | Type | Required |
|
|
239
215
|
| --- | --- | --- |
|
|
@@ -258,7 +234,7 @@ Proves a camera follows an entity or keeps a target in view. **Use when** that i
|
|
|
258
234
|
|
|
259
235
|
Proves a live entity component value after the scenario or at named steps. **Use when** that is the thing the scenario must prove.
|
|
260
236
|
|
|
261
|
-
- **Supported on:**
|
|
237
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.components
|
|
262
238
|
|
|
263
239
|
| Field | Type | Required |
|
|
264
240
|
| --- | --- | --- |
|
|
@@ -291,7 +267,7 @@ Proves a live entity component value after the scenario or at named steps. **Use
|
|
|
291
267
|
|
|
292
268
|
Proves resource state after the scenario through equals, gte, lte, textIncludes, or changed checks. **Use when** that is the thing the scenario must prove.
|
|
293
269
|
|
|
294
|
-
- **Supported on:**
|
|
270
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.resources
|
|
295
271
|
|
|
296
272
|
| Field | Type | Required |
|
|
297
273
|
| --- | --- | --- |
|
|
@@ -325,7 +301,7 @@ Proves resource state after the scenario through equals, gte, lte, textIncludes,
|
|
|
325
301
|
|
|
326
302
|
Proves the final count of entities carrying a bounded runtime tag. **Use when** that is the thing the scenario must prove.
|
|
327
303
|
|
|
328
|
-
- **Supported on:**
|
|
304
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.tags
|
|
329
305
|
|
|
330
306
|
| Field | Type | Required |
|
|
331
307
|
| --- | --- | --- |
|
|
@@ -351,7 +327,7 @@ Proves the final count of entities carrying a bounded runtime tag. **Use when**
|
|
|
351
327
|
|
|
352
328
|
Proves a named Godot signal was emitted by the application during the run or at a labeled step. **Use when** that is the thing the scenario must prove.
|
|
353
329
|
|
|
354
|
-
- **Supported on:**
|
|
330
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.events
|
|
355
331
|
|
|
356
332
|
| Field | Type | Required |
|
|
357
333
|
| --- | --- | --- |
|
|
@@ -379,7 +355,7 @@ Proves a named Godot signal was emitted by the application during the run or at
|
|
|
379
355
|
|
|
380
356
|
Proves an observed entity's final runtime-owned state-machine state. **Use when** that is the thing the scenario must prove.
|
|
381
357
|
|
|
382
|
-
- **Supported on:**
|
|
358
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.state
|
|
383
359
|
|
|
384
360
|
| Field | Type | Required |
|
|
385
361
|
| --- | --- | --- |
|
|
@@ -402,7 +378,7 @@ Proves an observed entity's final runtime-owned state-machine state. **Use when*
|
|
|
402
378
|
|
|
403
379
|
Proves retained UI/HUD text or values after the scenario. **Use when** that is the thing the scenario must prove.
|
|
404
380
|
|
|
405
|
-
- **Supported on:**
|
|
381
|
+
- **Supported on:** browser · **Requires:** browser.dom
|
|
406
382
|
|
|
407
383
|
| Field | Type | Required |
|
|
408
384
|
| --- | --- | --- |
|
|
@@ -428,41 +404,11 @@ Proves retained UI/HUD text or values after the scenario. **Use when** that is t
|
|
|
428
404
|
}
|
|
429
405
|
```
|
|
430
406
|
|
|
431
|
-
### `overlayNodes`
|
|
432
|
-
|
|
433
|
-
Proves DOM state inside a same-origin webview overlay iframe. **Use when** that is the thing the scenario must prove.
|
|
434
|
-
|
|
435
|
-
- **Supported on:** web · **Requires:** browser.dom
|
|
436
|
-
|
|
437
|
-
| Field | Type | Required |
|
|
438
|
-
| --- | --- | --- |
|
|
439
|
-
| `overlayId` | string | yes |
|
|
440
|
-
| `selector` | string | yes |
|
|
441
|
-
| `attribute` | string | no |
|
|
442
|
-
| `equals` | json | no |
|
|
443
|
-
| `textIncludes` | string | no |
|
|
444
|
-
| `visible` | boolean | no |
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
```json
|
|
448
|
-
{
|
|
449
|
-
"overlayNodes": [
|
|
450
|
-
{
|
|
451
|
-
"attribute": "data-aiming",
|
|
452
|
-
"equals": "true",
|
|
453
|
-
"overlayId": "game-ui",
|
|
454
|
-
"selector": "[data-testid=fps-crosshair]",
|
|
455
|
-
"visible": false
|
|
456
|
-
}
|
|
457
|
-
]
|
|
458
|
-
}
|
|
459
|
-
```
|
|
460
|
-
|
|
461
407
|
### `diagnostics`
|
|
462
408
|
|
|
463
409
|
Proves console, network, runtime, and readiness diagnostics stayed clean. **Use when** that is the thing the scenario must prove.
|
|
464
410
|
|
|
465
|
-
- **Supported on:**
|
|
411
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** browser.console, browser.network, runtime.diagnostics
|
|
466
412
|
|
|
467
413
|
| Field | Type | Required |
|
|
468
414
|
| --- | --- | --- |
|
|
@@ -490,7 +436,7 @@ Proves console, network, runtime, and readiness diagnostics stayed clean. **Use
|
|
|
490
436
|
|
|
491
437
|
Proves a live render sample exists and optionally bounds frame time, an fps floor, per-phase frame budget, whole-frame or per-pass draw calls and triangles. **Use when** that is the thing the scenario must prove.
|
|
492
438
|
|
|
493
|
-
- **Supported on:**
|
|
439
|
+
- **Supported on:** browser, desktop · **Requires:** runtime.performance
|
|
494
440
|
|
|
495
441
|
| Field | Type | Required |
|
|
496
442
|
| --- | --- | --- |
|
|
@@ -522,7 +468,7 @@ Proves a live render sample exists and optionally bounds frame time, an fps floo
|
|
|
522
468
|
|
|
523
469
|
PRD-222 Tier 2: proves the fps ratio of a parity pair — the same scene on the same device, once in the browser and once native. Lives in the second run and names the first run's saved report; refuses a pair whose halves ran on different devices, a thermally confounded half, or a missing series on either side. **Use when** that is the thing the scenario must prove.
|
|
524
470
|
|
|
525
|
-
- **Supported on:**
|
|
471
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.performance
|
|
526
472
|
|
|
527
473
|
| Field | Type | Required |
|
|
528
474
|
| --- | --- | --- |
|
|
@@ -547,7 +493,7 @@ PRD-222 Tier 2: proves the fps ratio of a parity pair — the same scene on the
|
|
|
547
493
|
|
|
548
494
|
Proves projected entity visibility in the viewport. **Use when** that is the thing the scenario must prove.
|
|
549
495
|
|
|
550
|
-
- **Supported on:**
|
|
496
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** entity.bounds
|
|
551
497
|
|
|
552
498
|
| Field | Type | Required |
|
|
553
499
|
| --- | --- | --- |
|
|
@@ -574,7 +520,7 @@ Proves projected entity visibility in the viewport. **Use when** that is the thi
|
|
|
574
520
|
|
|
575
521
|
Proves which labelled audio cues the game actually played, and how often. **Use when** that is the thing the scenario must prove.
|
|
576
522
|
|
|
577
|
-
- **Supported on:**
|
|
523
|
+
- **Supported on:** browser, desktop · **Requires:** runtime.audio
|
|
578
524
|
|
|
579
525
|
| Field | Type | Required |
|
|
580
526
|
| --- | --- | --- |
|
|
@@ -599,7 +545,7 @@ Proves which labelled audio cues the game actually played, and how often. **Use
|
|
|
599
545
|
|
|
600
546
|
Proves runtime world metadata exposed by the application bridge. **Use when** that is the thing the scenario must prove.
|
|
601
547
|
|
|
602
|
-
- **Supported on:**
|
|
548
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.world
|
|
603
549
|
|
|
604
550
|
| Field | Type | Required |
|
|
605
551
|
| --- | --- | --- |
|
|
@@ -619,7 +565,7 @@ Proves runtime world metadata exposed by the application bridge. **Use when** th
|
|
|
619
565
|
|
|
620
566
|
Proves contact or trigger evidence appeared in the effect log. **Use when** that is the thing the scenario must prove.
|
|
621
567
|
|
|
622
|
-
- **Supported on:**
|
|
568
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.contacts
|
|
623
569
|
|
|
624
570
|
| Field | Type | Required |
|
|
625
571
|
| --- | --- | --- |
|
|
@@ -649,7 +595,7 @@ Proves contact or trigger evidence appeared in the effect log. **Use when** that
|
|
|
649
595
|
|
|
650
596
|
Proves an observed cohort of matching physics bodies is asleep in a retained physics-debug sample. **Use when** that is the thing the scenario must prove.
|
|
651
597
|
|
|
652
|
-
- **Supported on:**
|
|
598
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.physics
|
|
653
599
|
|
|
654
600
|
| Field | Type | Required |
|
|
655
601
|
| --- | --- | --- |
|
|
@@ -673,35 +619,11 @@ Proves an observed cohort of matching physics bodies is asleep in a retained phy
|
|
|
673
619
|
}
|
|
674
620
|
```
|
|
675
621
|
|
|
676
|
-
### `occluded`
|
|
677
|
-
|
|
678
|
-
Proves rendered scene geometry occludes the segment between an origin entity and target. **Use when** that is the thing the scenario must prove.
|
|
679
|
-
|
|
680
|
-
- **Supported on:** web, desktop, bevy · **Requires:** runtime.physics
|
|
681
|
-
|
|
682
|
-
| Field | Type | Required |
|
|
683
|
-
| --- | --- | --- |
|
|
684
|
-
| `entity` | string | no |
|
|
685
|
-
| `target` | string | no |
|
|
686
|
-
| `allowTrivial` | triviality reason | no |
|
|
687
|
-
|
|
688
|
-
|
|
689
|
-
```json
|
|
690
|
-
{
|
|
691
|
-
"occluded": [
|
|
692
|
-
{
|
|
693
|
-
"entity": "listener",
|
|
694
|
-
"target": "emitter"
|
|
695
|
-
}
|
|
696
|
-
]
|
|
697
|
-
}
|
|
698
|
-
```
|
|
699
|
-
|
|
700
622
|
### `animation`
|
|
701
623
|
|
|
702
624
|
Proves animation evidence appeared in the effect log or runtime observation. **Use when** that is the thing the scenario must prove.
|
|
703
625
|
|
|
704
|
-
- **Supported on:**
|
|
626
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.animation
|
|
705
627
|
|
|
706
628
|
| Field | Type | Required |
|
|
707
629
|
| --- | --- | --- |
|
|
@@ -734,7 +656,7 @@ Proves animation evidence appeared in the effect log or runtime observation. **U
|
|
|
734
656
|
|
|
735
657
|
Bounds the room the game is played in — the lights, materials, fog and camera framing the renderer was handed. Fails closed on a bridge that does not report the scene. **Use when** that is the thing the scenario must prove.
|
|
736
658
|
|
|
737
|
-
- **Supported on:**
|
|
659
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** scene.observe
|
|
738
660
|
|
|
739
661
|
| Field | Type | Required |
|
|
740
662
|
| --- | --- | --- |
|
|
@@ -758,7 +680,7 @@ Bounds the room the game is played in — the lights, materials, fog and camera
|
|
|
758
680
|
|
|
759
681
|
Bounds on named nodes of the scene graph — where an object is, whether it is on screen, whether its textures loaded. **Use when** that is the thing the scenario must prove.
|
|
760
682
|
|
|
761
|
-
- **Supported on:**
|
|
683
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** scene.nodes
|
|
762
684
|
|
|
763
685
|
| Field | Type | Required |
|
|
764
686
|
| --- | --- | --- |
|
|
@@ -791,7 +713,7 @@ Bounds on named nodes of the scene graph — where an object is, whether it is o
|
|
|
791
713
|
|
|
792
714
|
Bounds how far a planted foot slides while the subject moves, measured every tick from named foot nodes' world positions, so it holds a procedural rig to the feet-meet-the-floor convention as well as a clip. Browser target only; another target fails it as unobserved. **Use when** that is the thing the scenario must prove.
|
|
793
715
|
|
|
794
|
-
- **Supported on:**
|
|
716
|
+
- **Supported on:** browser · **Requires:** entity.observe, scene.nodes
|
|
795
717
|
|
|
796
718
|
| Field | Type | Required |
|
|
797
719
|
| --- | --- | --- |
|
|
@@ -822,7 +744,7 @@ Bounds how far a planted foot slides while the subject moves, measured every tic
|
|
|
822
744
|
|
|
823
745
|
Bounds the share of the run in which solid geometry stood between the camera and the subject's world bounds centre, so a camera that clips through a pillar or a wall that eats the framing fails. Browser target only; another target fails it as unobserved. **Use when** that is the thing the scenario must prove.
|
|
824
746
|
|
|
825
|
-
- **Supported on:**
|
|
747
|
+
- **Supported on:** browser · **Requires:** camera.observe, entity.observe
|
|
826
748
|
|
|
827
749
|
| Field | Type | Required |
|
|
828
750
|
| --- | --- | --- |
|
|
@@ -842,7 +764,7 @@ Bounds the share of the run in which solid geometry stood between the camera and
|
|
|
842
764
|
|
|
843
765
|
Bounds the engine's own work counters, read off each TN_FRAME_BUDGET window's counters.engine (and counters.bridgeCrossings): JS-to-Wasm crossings, children reads, scene-walk visits, hierarchy moves, matrix composes, handle shares, content classification, GPU allocations, physics crossings and any counter an engine module adds to globalThis.__tnEngineCost. Each window must hold every bound; a run with fewer windows than minWindows, or a window missing a bounded counter, fails closed. A failure names the counter, the window and the top caller of the TN_BRIDGE_CENSUS before it. **Use when** that is the thing the scenario must prove.
|
|
844
766
|
|
|
845
|
-
- **Supported on:**
|
|
767
|
+
- **Supported on:** browser · **Requires:** browser.console
|
|
846
768
|
|
|
847
769
|
| Field | Type | Required |
|
|
848
770
|
| --- | --- | --- |
|
|
@@ -872,7 +794,7 @@ Bounds the engine's own work counters, read off each TN_FRAME_BUDGET window's co
|
|
|
872
794
|
|
|
873
795
|
Audits the text the page draws for the player: developer left-overs such as debug, TODO, placeholder or an unresolved undefined, and text whose colour is too close to its backing colour. Browser target only; another target fails it as unobserved. **Use when** that is the thing the scenario must prove.
|
|
874
796
|
|
|
875
|
-
- **Supported on:**
|
|
797
|
+
- **Supported on:** browser · **Requires:** browser.dom
|
|
876
798
|
|
|
877
799
|
| Field | Type | Required |
|
|
878
800
|
| --- | --- | --- |
|
|
@@ -893,7 +815,7 @@ Audits the text the page draws for the player: developer left-overs such as debu
|
|
|
893
815
|
|
|
894
816
|
Relates a tick-stamped effect to the tick-stamped cause that must precede it — the 'because' a terminal state needs. **Use when** that is the thing the scenario must prove.
|
|
895
817
|
|
|
896
|
-
- **Supported on:**
|
|
818
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.transitions
|
|
897
819
|
|
|
898
820
|
| Field | Type | Required |
|
|
899
821
|
| --- | --- | --- |
|
|
@@ -929,7 +851,7 @@ Relates a tick-stamped effect to the tick-stamped cause that must precede it —
|
|
|
929
851
|
|
|
930
852
|
Bounds when the application's startup milestones happened: the world entered, first-use compilation settled, readiness reached — in milliseconds since navigation, from the runtime's own startup timeline. **Use when** that is the thing the scenario must prove.
|
|
931
853
|
|
|
932
|
-
- **Supported on:**
|
|
854
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.startup
|
|
933
855
|
|
|
934
856
|
| Field | Type | Required |
|
|
935
857
|
| --- | --- | --- |
|
|
@@ -953,7 +875,7 @@ Bounds when the application's startup milestones happened: the world entered, fi
|
|
|
953
875
|
|
|
954
876
|
Bounds node-builder state builds and render-pipeline creations after a complete runtime capture proves that explicit shader warm-up settled; a named streamed scope must also prove its target-bound first visible world frame, and missing, incomplete, or malformed census evidence fails closed. **Use when** that is the thing the scenario must prove.
|
|
955
877
|
|
|
956
|
-
- **Supported on:**
|
|
878
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.pipelineCensus
|
|
957
879
|
|
|
958
880
|
| Field | Type | Required |
|
|
959
881
|
| --- | --- | --- |
|
|
@@ -977,7 +899,7 @@ Bounds node-builder state builds and render-pipeline creations after a complete
|
|
|
977
899
|
|
|
978
900
|
Proves the render chain reports its quality tier, authored stage ids/order, graph-output changes for named stages, and, when asserted, a bounded temporal-history rejection fraction. **Use when** that is the thing the scenario must prove.
|
|
979
901
|
|
|
980
|
-
- **Supported on:**
|
|
902
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.renderChain
|
|
981
903
|
|
|
982
904
|
| Field | Type | Required |
|
|
983
905
|
| --- | --- | --- |
|
|
@@ -1014,3 +936,25 @@ Proves the render chain reports its quality tier, authored stage ids/order, grap
|
|
|
1014
936
|
}
|
|
1015
937
|
}
|
|
1016
938
|
```
|
|
939
|
+
|
|
940
|
+
### `geometry`
|
|
941
|
+
|
|
942
|
+
Arms a per-object geometry capture (triangles, draws, projected size) and requires the bridge to report a captured frame; the request carries no bounds of its own. **Use when** that is the thing the scenario must prove.
|
|
943
|
+
|
|
944
|
+
- **Supported on:** browser, android, desktop, ios · **Requires:** runtime.geometry
|
|
945
|
+
|
|
946
|
+
| Field | Type | Required |
|
|
947
|
+
| --- | --- | --- |
|
|
948
|
+
| `limit` | number | no |
|
|
949
|
+
| `sort` | string | no |
|
|
950
|
+
| `timeoutMs` | positive number | no |
|
|
951
|
+
|
|
952
|
+
|
|
953
|
+
```json
|
|
954
|
+
{
|
|
955
|
+
"geometry": {
|
|
956
|
+
"limit": 20,
|
|
957
|
+
"sort": "triangles"
|
|
958
|
+
}
|
|
959
|
+
}
|
|
960
|
+
```
|