create-threenative 0.2.6 → 0.2.7
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/README.md +2 -2
- package/agent-docs/references/build-profiles.md +126 -0
- package/agent-docs/references/capability-reference.md +431 -20
- package/agent-docs/references/performance-basics.md +8 -5
- package/agent-docs/references/sculpt-from-a-reference.md +1 -1
- package/agent-docs/references/trace-a-slow-frame.md +1 -1
- package/agent-docs/references/visual-baseline.md +8 -4
- package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
- package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
- package/capabilities.json +555 -21
- package/dist/index.d.ts +30 -1
- package/dist/index.js +294 -55
- package/dist/threenative.js +714 -154
- package/package.json +6 -6
- package/template-assets/assets/mannequin-combat.glb +0 -0
- package/template-assets/assets/mannequin.glb +0 -0
- package/template-assets/assets/player-viewmodel.glb +0 -0
- package/template-assets/assets/sky.jpg +0 -0
- package/template-assets/clearwater/README.md +141 -0
- package/template-assets/clearwater/install.mjs +50 -0
- package/template-assets/clearwater/src/clearwater.ts +180 -0
- package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
- package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
- package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
- package/template-assets/clearwater/src/render/clearwater.ts +278 -0
- package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
- package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
- package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
- package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
- package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
- package/template-assets/patches/three@0.185.1.patch +2101 -138
- package/template-assets/worldEnvironment.ts +52 -1
- package/templates/action-rpg/AGENTS.md +42 -42
- package/templates/action-rpg/CLAUDE.md +42 -42
- package/templates/action-rpg/kit.json +1 -1
- package/templates/action-rpg/package.json +13 -7
- package/templates/action-rpg/playtests/combat.playtest.json +162 -23
- package/templates/action-rpg/playtests/performance.playtest.json +4 -3
- package/templates/action-rpg/playtests/survives.playtest.json +25 -8
- package/templates/action-rpg/src/conventions.ts +24 -18
- package/templates/action-rpg/src/entities/Enemy.ts +74 -24
- package/templates/action-rpg/src/entities/Fighter.ts +127 -0
- package/templates/action-rpg/src/entities/Player.ts +102 -32
- package/templates/action-rpg/src/game.ts +3 -3
- package/templates/action-rpg/src/render/camera.ts +18 -16
- package/templates/action-rpg/src/render/dungeon.ts +192 -0
- package/templates/action-rpg/src/render/lighting.ts +45 -28
- package/templates/action-rpg/src/render/loading.ts +4 -4
- package/templates/action-rpg/src/render/materials.ts +191 -47
- package/templates/action-rpg/src/render/palette.ts +14 -13
- package/templates/action-rpg/src/render/postprocessing.ts +12 -2
- package/templates/action-rpg/src/render/props.ts +117 -0
- package/templates/action-rpg/src/render/quality.ts +40 -82
- package/templates/action-rpg/src/render/sky.ts +36 -13
- package/templates/action-rpg/src/render/touch-controls.ts +1 -1
- package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
- package/templates/action-rpg/src/scenes/Play.ts +61 -39
- package/templates/action-rpg/src/style.css +9 -7
- package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
- package/templates/action-rpg/src/ui/Hud.tsx +3 -3
- package/templates/action-rpg/threenative.config.ts +14 -1
- package/templates/action-rpg/vite.config.ts +4 -1
- package/templates/minimal/AGENTS.md +10 -10
- package/templates/minimal/CLAUDE.md +10 -10
- package/templates/minimal/package.json +12 -6
- package/templates/minimal/playtests/play.playtest.json +6 -5
- package/templates/minimal/playtests/sky.playtest.json +27 -0
- package/templates/minimal/src/conventions.ts +6 -3
- package/templates/minimal/src/entities/Player.ts +73 -27
- package/templates/minimal/src/main.ts +2 -3
- package/templates/minimal/src/render/camera.ts +22 -4
- package/templates/minimal/src/render/lighting.ts +24 -48
- package/templates/minimal/src/render/materials.ts +158 -13
- package/templates/minimal/src/render/palette.ts +10 -7
- package/templates/minimal/src/render/postprocessing.ts +12 -25
- package/templates/minimal/src/render/quality.ts +35 -69
- package/templates/minimal/src/render/sky.ts +35 -54
- package/templates/minimal/src/render/touch-controls.ts +1 -1
- package/templates/minimal/src/render/worldEnvironment.ts +52 -1
- package/templates/minimal/src/scenes/Play.ts +121 -111
- package/templates/minimal/src/state.ts +0 -4
- package/templates/minimal/src/style.css +0 -10
- package/templates/minimal/threenative.config.ts +14 -1
- package/templates/minimal/vite.config.ts +4 -1
- package/templates/platformer/AGENTS.md +18 -56
- package/templates/platformer/CLAUDE.md +18 -56
- package/templates/platformer/kit.json +2 -2
- package/templates/platformer/package.json +13 -9
- package/templates/platformer/playtests/buffer.playtest.json +15 -5
- package/templates/platformer/playtests/collect.playtest.json +8 -34
- package/templates/platformer/playtests/coyote.playtest.json +12 -34
- package/templates/platformer/playtests/damage.playtest.json +40 -15
- package/templates/platformer/playtests/hud.playtest.json +34 -0
- package/templates/platformer/playtests/move.playtest.json +24 -0
- package/templates/platformer/playtests/performance.playtest.json +24 -7
- package/templates/platformer/playtests/respawn.playtest.json +46 -11
- package/templates/platformer/playtests/stomp.playtest.json +49 -12
- package/templates/platformer/playtests/survives.playtest.json +3 -19
- package/templates/platformer/playtests/world.playtest.json +26 -0
- package/templates/platformer/src/entities/Fox.ts +273 -0
- package/templates/platformer/src/entities/Pickup.ts +43 -60
- package/templates/platformer/src/entities/Walker.ts +88 -0
- package/templates/platformer/src/game.ts +11 -8
- package/templates/platformer/src/level/Checkpoints.ts +29 -16
- package/templates/platformer/src/level/Stage.ts +469 -0
- package/templates/platformer/src/render/blocks.ts +94 -0
- package/templates/platformer/src/render/camera.ts +28 -3
- package/templates/platformer/src/render/fox.ts +196 -0
- package/templates/platformer/src/render/lighting.ts +42 -33
- package/templates/platformer/src/render/materials.ts +115 -5
- package/templates/platformer/src/render/palette.ts +68 -53
- package/templates/platformer/src/render/pickups.ts +142 -0
- package/templates/platformer/src/render/postprocessing.ts +12 -2
- package/templates/platformer/src/render/props.ts +147 -0
- package/templates/platformer/src/render/quality.ts +47 -99
- package/templates/platformer/src/render/scenery.ts +172 -0
- package/templates/platformer/src/render/sky.ts +120 -31
- package/templates/platformer/src/render/touch-controls.ts +5 -2
- package/templates/platformer/src/render/walkers.ts +96 -0
- package/templates/platformer/src/render/waterfall.ts +85 -0
- package/templates/platformer/src/render/worldEnvironment.ts +52 -1
- package/templates/platformer/src/scenes/Boot.ts +3 -4
- package/templates/platformer/src/scenes/Play.ts +362 -0
- package/templates/platformer/src/state.ts +16 -14
- package/templates/platformer/src/style.css +9 -8
- package/templates/platformer/src/ui/Hud.tsx +62 -29
- package/templates/platformer/src/ui/Menu.tsx +2 -2
- package/templates/platformer/threenative.config.ts +14 -1
- package/templates/platformer/vite.config.ts +4 -1
- package/templates/puzzle/AGENTS.md +19 -20
- package/templates/puzzle/CLAUDE.md +19 -20
- package/templates/puzzle/assets/native-proof.glb +0 -0
- package/templates/puzzle/assets/native-proof.png +0 -0
- package/templates/puzzle/kit.json +1 -1
- package/templates/puzzle/package.json +13 -7
- package/templates/puzzle/playtests/axis.playtest.json +20 -0
- package/templates/puzzle/playtests/blocked.playtest.json +73 -0
- package/templates/puzzle/playtests/caused.playtest.json +65 -0
- package/templates/puzzle/playtests/lit.playtest.json +74 -0
- package/templates/puzzle/playtests/performance.playtest.json +24 -7
- package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
- package/templates/puzzle/playtests/replay.playtest.json +81 -0
- package/templates/puzzle/playtests/restart.playtest.json +108 -0
- package/templates/puzzle/playtests/seal.playtest.json +98 -0
- package/templates/puzzle/playtests/settle.playtest.json +100 -0
- package/templates/puzzle/playtests/survives.playtest.json +6 -29
- package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
- package/templates/puzzle/src/entities/Crate.ts +99 -42
- package/templates/puzzle/src/entities/Seal.ts +69 -0
- package/templates/puzzle/src/entities/Warden.ts +135 -0
- package/templates/puzzle/src/game.ts +15 -11
- package/templates/puzzle/src/render/camera.ts +66 -31
- package/templates/puzzle/src/render/crateShape.ts +70 -0
- package/templates/puzzle/src/render/lighting.ts +41 -41
- package/templates/puzzle/src/render/loading.ts +4 -4
- package/templates/puzzle/src/render/materials.ts +131 -27
- package/templates/puzzle/src/render/palette.ts +19 -29
- package/templates/puzzle/src/render/postprocessing.ts +15 -3
- package/templates/puzzle/src/render/quality.ts +71 -80
- package/templates/puzzle/src/render/shapes.ts +109 -108
- package/templates/puzzle/src/render/sky.ts +18 -10
- package/templates/puzzle/src/render/touch-controls.ts +8 -51
- package/templates/puzzle/src/render/vault.ts +315 -0
- package/templates/puzzle/src/render/warden.ts +46 -0
- package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
- package/templates/puzzle/src/scenes/Play.ts +793 -0
- package/templates/puzzle/src/state.ts +55 -24
- package/templates/puzzle/src/style.css +7 -8
- package/templates/puzzle/src/ui/App.tsx +2 -2
- package/templates/puzzle/src/ui/Hud.tsx +92 -40
- package/templates/puzzle/src/ui/Menu.tsx +40 -2
- package/templates/puzzle/threenative.config.ts +14 -1
- package/templates/puzzle/vite.config.ts +4 -1
- package/templates/racing/AGENTS.md +19 -20
- package/templates/racing/CLAUDE.md +19 -20
- package/templates/racing/package.json +13 -7
- package/templates/racing/playtests/boost.playtest.json +33 -12
- package/templates/racing/playtests/outcome.playtest.json +32 -50
- package/templates/racing/playtests/performance.playtest.json +2 -1
- package/templates/racing/playtests/ranking.playtest.json +5 -14
- package/templates/racing/playtests/rescue.playtest.json +2 -2
- package/templates/racing/playtests/reverse.playtest.json +30 -8
- package/templates/racing/playtests/shortcut.playtest.json +54 -9
- package/templates/racing/playtests/touch-controls.playtest.json +32 -5
- package/templates/racing/src/entities/CarBody.ts +327 -0
- package/templates/racing/src/entities/LineDriver.ts +220 -0
- package/templates/racing/src/entities/RacingCar.ts +150 -89
- package/templates/racing/src/entities/Rival.ts +61 -24
- package/templates/racing/src/game.ts +5 -0
- package/templates/racing/src/render/camera.ts +49 -7
- package/templates/racing/src/render/lighting.ts +36 -37
- package/templates/racing/src/render/materials.ts +239 -19
- package/templates/racing/src/render/palette.ts +19 -21
- package/templates/racing/src/render/postprocessing.ts +12 -2
- package/templates/racing/src/render/quality.ts +43 -82
- package/templates/racing/src/render/shapes.ts +20 -6
- package/templates/racing/src/render/sky.ts +47 -39
- package/templates/racing/src/render/touch-controls.ts +1 -1
- package/templates/racing/src/render/worldEnvironment.ts +52 -1
- package/templates/racing/src/scenes/Race.ts +107 -54
- package/templates/racing/src/state.ts +2 -0
- package/templates/racing/src/track/Checkline.ts +22 -7
- package/templates/racing/src/track/Lap.ts +64 -36
- package/templates/racing/src/track/Ranking.ts +20 -11
- package/templates/racing/src/track/Track.ts +809 -361
- package/templates/racing/src/track/TrackSector.ts +40 -11
- package/templates/racing/src/track/circuit.ts +477 -0
- package/templates/racing/src/track/rescue.ts +16 -4
- package/templates/racing/threenative.config.ts +14 -1
- package/templates/racing/vite.config.ts +4 -1
- package/templates/rts/AGENTS.md +96 -0
- package/templates/rts/CLAUDE.md +98 -0
- package/templates/rts/kit.json +7 -0
- package/templates/{defense → rts}/package.json +13 -7
- package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
- package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
- package/templates/rts/playtests/rts-attack.playtest.json +75 -0
- package/templates/rts/playtests/rts-build.playtest.json +68 -0
- package/templates/rts/playtests/rts-orders.playtest.json +150 -0
- package/templates/rts/playtests/rts-train.playtest.json +62 -0
- package/templates/rts/playtests/survives.playtest.json +58 -0
- package/templates/rts/public/favicon.svg +4 -0
- package/templates/rts/src/game.ts +64 -0
- package/templates/rts/src/orders.ts +22 -0
- package/templates/rts/src/render/army.ts +346 -0
- package/templates/rts/src/render/camera.ts +123 -0
- package/templates/rts/src/render/lighting.ts +61 -0
- package/templates/rts/src/render/loading.ts +33 -0
- package/templates/rts/src/render/materials.ts +152 -0
- package/templates/rts/src/render/models.ts +705 -0
- package/templates/rts/src/render/palette.ts +17 -0
- package/templates/rts/src/render/picking.ts +93 -0
- package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
- package/templates/rts/src/render/quality.ts +128 -0
- package/templates/rts/src/render/resources.ts +141 -0
- package/templates/rts/src/render/sky.ts +44 -0
- package/templates/rts/src/render/terrain.ts +116 -0
- package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
- package/templates/rts/src/scenes/Play.ts +650 -0
- package/templates/rts/src/sim/ai.ts +1140 -0
- package/templates/rts/src/sim/combat.ts +416 -0
- package/templates/rts/src/sim/construction.ts +374 -0
- package/templates/rts/src/sim/economy.ts +167 -0
- package/templates/rts/src/sim/game.ts +1082 -0
- package/templates/rts/src/sim/movement.ts +371 -0
- package/templates/rts/src/sim/nav.ts +276 -0
- package/templates/rts/src/sim/production.ts +180 -0
- package/templates/rts/src/sim/terrain.ts +170 -0
- package/templates/rts/src/sim/types.ts +647 -0
- package/templates/rts/src/sim/vision.ts +46 -0
- package/templates/rts/src/state.ts +100 -0
- package/templates/{defense → rts}/src/style.css +21 -8
- package/templates/rts/src/ui/App.tsx +21 -0
- package/templates/rts/src/ui/Commands.tsx +129 -0
- package/templates/rts/src/ui/GameUi.tsx +22 -0
- package/templates/rts/src/ui/Hud.tsx +165 -0
- package/templates/rts/src/ui/Minimap.tsx +84 -0
- package/templates/rts/tailwind.config.ts +2 -0
- package/templates/rts/threenative.config.ts +56 -0
- package/templates/rts/tsconfig.json +17 -0
- package/templates/{defense → rts}/vite.config.ts +4 -1
- package/templates/runner/AGENTS.md +6 -10
- package/templates/runner/CLAUDE.md +6 -10
- package/templates/runner/README.md +3 -3
- package/templates/runner/package.json +13 -7
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +4 -3
- package/templates/runner/src/entities/Runner.ts +54 -7
- package/templates/runner/src/game.ts +2 -0
- package/templates/runner/src/render/camera.ts +4 -2
- package/templates/runner/src/render/dust.ts +5 -2
- package/templates/runner/src/render/lighting.ts +41 -45
- package/templates/runner/src/render/loading.ts +2 -2
- package/templates/runner/src/render/materials.ts +165 -25
- package/templates/runner/src/render/palette.ts +17 -28
- package/templates/runner/src/render/postprocessing.ts +12 -2
- package/templates/runner/src/render/quality.ts +42 -96
- package/templates/runner/src/render/shapes.ts +59 -37
- package/templates/runner/src/render/sky.ts +32 -41
- package/templates/runner/src/render/touch-controls.ts +1 -1
- package/templates/runner/src/render/worldEnvironment.ts +52 -1
- package/templates/runner/src/scenes/Run.ts +26 -6
- package/templates/runner/src/track.ts +6 -1
- package/templates/runner/threenative.config.ts +14 -1
- package/templates/runner/vite.config.ts +4 -1
- package/templates/sailing/AGENTS.md +12 -12
- package/templates/sailing/CLAUDE.md +12 -12
- package/templates/sailing/assets/ship.glb +0 -0
- package/templates/sailing/package.json +13 -7
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
- package/templates/sailing/playtests/sails.playtest.json +33 -0
- package/templates/sailing/playtests/win.playtest.json +156 -8
- package/templates/sailing/src/conventions.ts +29 -2
- package/templates/sailing/src/entities/Ship.ts +381 -57
- package/templates/sailing/src/game.ts +14 -0
- package/templates/sailing/src/render/camera.ts +63 -9
- package/templates/sailing/src/render/lighting.ts +49 -27
- package/templates/sailing/src/render/materials.ts +50 -15
- package/templates/sailing/src/render/ocean.ts +647 -60
- package/templates/sailing/src/render/palette.ts +16 -12
- package/templates/sailing/src/render/postprocessing.ts +12 -2
- package/templates/sailing/src/render/props.ts +316 -442
- package/templates/sailing/src/render/quality.ts +14 -4
- package/templates/sailing/src/render/sky.ts +116 -23
- package/templates/sailing/src/render/worldEnvironment.ts +52 -1
- package/templates/sailing/src/scenes/Boot.ts +21 -0
- package/templates/sailing/src/scenes/Sailing.ts +173 -39
- package/templates/sailing/src/state.ts +6 -0
- package/templates/sailing/src/ui/Hud.tsx +41 -9
- package/templates/sailing/threenative.config.ts +14 -1
- package/templates/sailing/vite.config.ts +4 -1
- package/templates/shooter/AGENTS.md +27 -42
- package/templates/shooter/CLAUDE.md +27 -42
- package/templates/shooter/index.html +1 -0
- package/templates/shooter/package.json +13 -7
- package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
- package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
- package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
- package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
- package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
- package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
- package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
- package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
- package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
- package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
- package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
- package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
- package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
- package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
- package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
- package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
- package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
- package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
- package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
- package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
- package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
- package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
- package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
- package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
- package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
- package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
- package/templates/shooter/playtests/input-control.playtest.json +43 -98
- package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
- package/templates/shooter/playtests/performance.playtest.json +62 -26
- package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
- package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
- package/templates/shooter/playtests/survives.playtest.json +36 -30
- package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
- package/templates/shooter/src/entities/Breakables.ts +412 -0
- package/templates/shooter/src/entities/Enemy.ts +2095 -0
- package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
- package/templates/shooter/src/entities/Rifle.ts +442 -0
- package/templates/shooter/src/entities/Target.ts +199 -83
- package/templates/shooter/src/entities/TouchControls.ts +276 -0
- package/templates/shooter/src/game.ts +75 -41
- package/templates/shooter/src/main.ts +0 -1
- package/templates/shooter/src/postPhysics.ts +36 -0
- package/templates/shooter/src/render/camera.ts +78 -74
- package/templates/shooter/src/render/decals.ts +142 -82
- package/templates/shooter/src/render/facade.ts +1373 -0
- package/templates/shooter/src/render/gunfx.ts +704 -0
- package/templates/shooter/src/render/lighting.ts +52 -38
- package/templates/shooter/src/render/loading.ts +2 -2
- package/templates/shooter/src/render/materials.ts +100 -88
- package/templates/shooter/src/render/occlusion.ts +108 -0
- package/templates/shooter/src/render/palette.ts +10 -10
- package/templates/shooter/src/render/palm.ts +455 -0
- package/templates/shooter/src/render/pooled-billboards.ts +144 -0
- package/templates/shooter/src/render/postprocessing.ts +15 -3
- package/templates/shooter/src/render/quality.ts +40 -82
- package/templates/shooter/src/render/scale.ts +148 -15
- package/templates/shooter/src/render/shapes.ts +138 -613
- package/templates/shooter/src/render/sky.ts +35 -35
- package/templates/shooter/src/render/town-schematic.ts +120 -0
- package/templates/shooter/src/render/town.ts +986 -0
- package/templates/shooter/src/render/townMaterials.ts +160 -0
- package/templates/shooter/src/render/vehicles.ts +741 -0
- package/templates/shooter/src/render/worldEnvironment.ts +52 -1
- package/templates/shooter/src/scenes/Play.ts +727 -650
- package/templates/shooter/src/state.ts +26 -41
- package/templates/shooter/src/style.css +207 -11
- package/templates/shooter/src/surfaces.ts +131 -0
- package/templates/shooter/src/ui/App.tsx +9 -10
- package/templates/shooter/src/ui/Crosshair.tsx +25 -18
- package/templates/shooter/src/ui/GameUi.tsx +6 -9
- package/templates/shooter/src/ui/Hud.tsx +428 -39
- package/templates/shooter/src/ui/Minimap.tsx +164 -0
- package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
- package/templates/shooter/src/ui/main.tsx +2 -3
- package/templates/shooter/threenative.config.ts +14 -1
- package/templates/shooter/vite.config.ts +4 -1
- package/templates/starter/AGENTS.md +17 -17
- package/templates/starter/CLAUDE.md +17 -17
- package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
- package/templates/starter/package.json +13 -7
- package/templates/starter/playtests/play.playtest.json +2 -1
- package/templates/starter/playtests/survives.playtest.json +1 -1
- package/templates/starter/src/conventions.ts +6 -3
- package/templates/starter/src/entities/Goal.ts +35 -42
- package/templates/starter/src/entities/Player.ts +99 -16
- package/templates/starter/src/render/arena.ts +131 -0
- package/templates/starter/src/render/lighting.ts +27 -44
- package/templates/starter/src/render/materials.ts +164 -35
- package/templates/starter/src/render/palette.ts +16 -16
- package/templates/starter/src/render/postprocessing.ts +6 -7
- package/templates/starter/src/render/quality.ts +43 -101
- package/templates/starter/src/render/shapes.ts +1 -1
- package/templates/starter/src/render/sky.ts +39 -45
- package/templates/starter/src/render/touch-controls.ts +3 -1
- package/templates/starter/src/render/worldEnvironment.ts +52 -1
- package/templates/starter/src/scenes/Play.ts +82 -81
- package/templates/starter/threenative.config.ts +14 -1
- package/templates/starter/vite.config.ts +4 -1
- package/templates/tower-defense/.codex/config.toml +19 -0
- package/templates/tower-defense/.cursor/mcp.json +32 -0
- package/templates/tower-defense/.gemini/settings.json +32 -0
- package/templates/tower-defense/.mcp.json +32 -0
- package/templates/tower-defense/.vscode/mcp.json +36 -0
- package/templates/tower-defense/.zed/settings.json +36 -0
- package/templates/{defense → tower-defense}/AGENTS.md +14 -12
- package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
- package/templates/tower-defense/README.md +16 -0
- package/templates/tower-defense/index.html +12 -0
- package/templates/tower-defense/kit.json +7 -0
- package/templates/tower-defense/opencode.json +41 -0
- package/templates/tower-defense/package.json +56 -0
- package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
- package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
- package/templates/tower-defense/playtests/look.playtest.json +130 -0
- package/templates/tower-defense/playtests/performance.playtest.json +77 -0
- package/templates/tower-defense/playtests/placement.playtest.json +115 -0
- package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
- package/templates/tower-defense/playtests/strike.playtest.json +98 -0
- package/templates/tower-defense/playtests/survives.playtest.json +85 -0
- package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
- package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
- package/templates/tower-defense/playtests/victory.playtest.json +810 -0
- package/templates/tower-defense/src/balance.ts +187 -0
- package/templates/tower-defense/src/board/Board.ts +100 -0
- package/templates/tower-defense/src/board/Route.ts +84 -0
- package/templates/tower-defense/src/camera-rig.ts +62 -0
- package/templates/tower-defense/src/economy.ts +64 -0
- package/templates/tower-defense/src/effects/Effects.ts +284 -0
- package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
- package/templates/tower-defense/src/game.ts +72 -0
- package/templates/tower-defense/src/intents.ts +21 -0
- package/templates/tower-defense/src/main.ts +15 -0
- package/templates/tower-defense/src/physics.ts +6 -0
- package/templates/tower-defense/src/render/camera.ts +38 -0
- package/templates/tower-defense/src/render/lighting.ts +42 -0
- package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
- package/templates/tower-defense/src/render/materials.ts +103 -0
- package/templates/tower-defense/src/render/palette.ts +58 -0
- package/templates/tower-defense/src/render/postprocessing.ts +46 -0
- package/templates/tower-defense/src/render/quality.ts +128 -0
- package/templates/tower-defense/src/render/shapes.ts +550 -0
- package/templates/tower-defense/src/render/sky.ts +27 -0
- package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
- package/templates/tower-defense/src/scenes/Battle.ts +539 -0
- package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
- package/templates/tower-defense/src/state.ts +88 -0
- package/templates/tower-defense/src/style.css +137 -0
- package/templates/tower-defense/src/towers/Tower.ts +230 -0
- package/templates/tower-defense/src/towers/targeting.ts +97 -0
- package/templates/tower-defense/src/ui/Hud.tsx +270 -0
- package/templates/tower-defense/src/ui/Menu.tsx +134 -0
- package/templates/tower-defense/src/ui/icons.tsx +54 -0
- package/templates/tower-defense/src/ui/main.tsx +14 -0
- package/templates/tower-defense/src/waves.ts +90 -0
- package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
- package/templates/tower-defense/vite.config.ts +41 -0
- package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
- package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
- package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
- package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
- package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
- package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
- package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
- package/agent-files/AGENT-ROLES.md +0 -26
- package/templates/action-rpg/src/render/shapes.ts +0 -269
- package/templates/action-rpg/src/render/types.ts +0 -3
- package/templates/action-rpg/src/scenes/Boot.ts +0 -12
- package/templates/defense/README.md +0 -10
- package/templates/defense/kit.json +0 -7
- package/templates/defense/playtests/leak.playtest.json +0 -23
- package/templates/defense/playtests/placement.playtest.json +0 -40
- package/templates/defense/playtests/scan.playtest.json +0 -20
- package/templates/defense/playtests/survive.playtest.json +0 -45
- package/templates/defense/playtests/survives.playtest.json +0 -36
- package/templates/defense/src/attackers/Attacker.ts +0 -120
- package/templates/defense/src/board/Route.ts +0 -94
- package/templates/defense/src/conventions.ts +0 -18
- package/templates/defense/src/economy.ts +0 -36
- package/templates/defense/src/entities/Player.ts +0 -52
- package/templates/defense/src/game.ts +0 -51
- package/templates/defense/src/physics.ts +0 -13
- package/templates/defense/src/placement/Buildable.ts +0 -49
- package/templates/defense/src/render/camera.ts +0 -16
- package/templates/defense/src/render/lighting.ts +0 -37
- package/templates/defense/src/render/materials.ts +0 -22
- package/templates/defense/src/render/palette.ts +0 -28
- package/templates/defense/src/render/quality.ts +0 -170
- package/templates/defense/src/render/shapes.ts +0 -246
- package/templates/defense/src/render/sky.ts +0 -45
- package/templates/defense/src/scenes/Boot.ts +0 -12
- package/templates/defense/src/scenes/Defense.ts +0 -231
- package/templates/defense/src/state.ts +0 -56
- package/templates/defense/src/towers/Tower.ts +0 -95
- package/templates/defense/src/towers/targeting.ts +0 -53
- package/templates/defense/src/ui/Hud.tsx +0 -62
- package/templates/defense/src/ui/Menu.tsx +0 -7
- package/templates/defense/src/waves.ts +0 -40
- package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
- package/templates/minimal/src/render/hud.ts +0 -69
- package/templates/platformer/playtests/avoidance.playtest.json +0 -28
- package/templates/platformer/playtests/chase.playtest.json +0 -21
- package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
- package/templates/platformer/playtests/oneway.playtest.json +0 -44
- package/templates/platformer/playtests/patrol.playtest.json +0 -13
- package/templates/platformer/playtests/physics.playtest.json +0 -14
- package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
- package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
- package/templates/platformer/src/conventions.ts +0 -18
- package/templates/platformer/src/entities/Character.ts +0 -286
- package/templates/platformer/src/entities/Chaser.ts +0 -118
- package/templates/platformer/src/entities/Patrol.ts +0 -93
- package/templates/platformer/src/level/Platform.ts +0 -46
- package/templates/platformer/src/render/rig.ts +0 -60
- package/templates/platformer/src/render/terrain.ts +0 -31
- package/templates/platformer/src/scenes/Level.ts +0 -241
- package/templates/puzzle/README.md +0 -43
- package/templates/puzzle/playtests/carry.playtest.json +0 -71
- package/templates/puzzle/playtests/swing.playtest.json +0 -38
- package/templates/puzzle/src/conventions.ts +0 -25
- package/templates/puzzle/src/entities/Ball.ts +0 -70
- package/templates/puzzle/src/entities/Gripper.ts +0 -69
- package/templates/puzzle/src/entities/Pendulum.ts +0 -89
- package/templates/puzzle/src/physics.ts +0 -19
- package/templates/puzzle/src/room.ts +0 -83
- package/templates/puzzle/src/scenes/Boot.ts +0 -12
- package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
- package/templates/shooter/playtests/combat.playtest.json +0 -48
- package/templates/shooter/playtests/fail.playtest.json +0 -31
- package/templates/shooter/playtests/per-item.playtest.json +0 -59
- package/templates/shooter/playtests/shooter.playtest.json +0 -99
- package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
- package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
- package/templates/shooter/src/combat/damage.ts +0 -40
- package/templates/shooter/src/conventions.ts +0 -51
- package/templates/shooter/src/entities/Pickup.ts +0 -70
- package/templates/shooter/src/entities/Player.ts +0 -310
- package/templates/shooter/src/level/SpawnPoints.ts +0 -28
- package/templates/shooter/src/playtest-events.ts +0 -15
- package/templates/shooter/src/render/touch-controls.ts +0 -305
- package/templates/shooter/src/render/types.ts +0 -3
- package/templates/shooter/src/render/ui.css +0 -330
- package/templates/shooter/src/render/ui.ts +0 -75
- package/templates/shooter/src/render/vfx.ts +0 -215
- package/templates/shooter/src/ui/Menu.tsx +0 -41
- package/templates/shooter/src/waves.ts +0 -50
- package/templates/shooter/src/weapons/Hitscan.ts +0 -42
- package/templates/shooter/src/weapons/Projectile.ts +0 -92
- package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
- package/templates/starter/playtests/assets.playtest.json +0 -65
- package/templates/starter/playtests/buffer.playtest.json +0 -79
- package/templates/starter/playtests/cloth.playtest.json +0 -113
- package/templates/starter/playtests/coyote.playtest.json +0 -87
- package/templates/starter/playtests/gameover.playtest.json +0 -66
- package/templates/starter/playtests/goal.playtest.json +0 -67
- package/templates/starter/playtests/look.playtest.json +0 -175
- package/templates/starter/playtests/models-baseline.png +0 -0
- package/templates/starter/playtests/models.playtest.json +0 -74
- package/templates/starter/playtests/monitoring.playtest.json +0 -72
- package/templates/starter/playtests/odometer.playtest.json +0 -54
- package/templates/starter/playtests/restart.playtest.json +0 -91
- package/templates/starter/playtests/seed.playtest.json +0 -54
- package/templates/starter/playtests/textures-baseline.png +0 -0
- package/templates/starter/playtests/textures.playtest.json +0 -74
- package/templates/starter/playtests/touch-controls.playtest.json +0 -42
- package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
- package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
- package/templates/starter/src/render/coast.ts +0 -199
- package/templates/starter/src/render/hero.ts +0 -88
- package/templates/starter/src/render/implicitSurface.ts +0 -199
- package/templates/starter/src/render/kuwahara.ts +0 -174
- package/templates/starter/src/render/outline.ts +0 -141
- package/templates/starter/src/render/painterly.ts +0 -86
- package/templates/starter/src/render/rockRidge.ts +0 -198
- package/templates/starter/src/render/rockRidge.worker.ts +0 -77
- package/templates/starter/src/render/scenery.ts +0 -40
- package/templates/starter/src/render/textureLifetime.ts +0 -53
- package/templates/starter/src/render/water.ts +0 -38
- package/templates/starter/src/render/watercolor.ts +0 -85
- /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
- /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
- /package/templates/{defense → rts}/.codex/config.toml +0 -0
- /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
- /package/templates/{defense → rts}/.gemini/settings.json +0 -0
- /package/templates/{defense → rts}/.mcp.json +0 -0
- /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
- /package/templates/{defense → rts}/.zed/settings.json +0 -0
- /package/templates/{defense → rts}/index.html +0 -0
- /package/templates/{defense → rts}/opencode.json +0 -0
- /package/templates/{defense → rts}/src/main.ts +0 -0
- /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
- /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
- /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
- /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
- /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
- /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
- /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Everything the HUD reads, and nothing it can derive for itself.
|
|
3
|
+
*
|
|
4
|
+
* The simulation owns the rules; the UI is a mirror. Two rules follow. First, the *rules table*
|
|
5
|
+
* (`TYPES` in `src/sim/types.ts`) is not published: the panel imports it and reads a unit's name,
|
|
6
|
+
* role and cost from the same source the pathfinder does, so a rebalance cannot leave the HUD
|
|
7
|
+
* quoting last season's numbers. Second, a value that changes every frame is counted or rounded
|
|
8
|
+
* here rather than sent raw, because the store is cloned whole for every playtest observation and
|
|
9
|
+
* a per-frame vector of sixty positions would cost more than the game it measures.
|
|
10
|
+
*/
|
|
11
|
+
export type GameState = {
|
|
12
|
+
/** Ore, gas, and the supply the built structures grant. */
|
|
13
|
+
gas: number;
|
|
14
|
+
ore: number;
|
|
15
|
+
supplyCap: number;
|
|
16
|
+
supplyUsed: number;
|
|
17
|
+
/** What the commander has spent and banked. */
|
|
18
|
+
gathered: number;
|
|
19
|
+
kills: number;
|
|
20
|
+
/** Whole 0.05 s steps since the match started. */
|
|
21
|
+
simTime: number;
|
|
22
|
+
/** "victory", "defeat", or "" while the match runs. */
|
|
23
|
+
result: string;
|
|
24
|
+
/** The last thing the simulation reported, for the toast. */
|
|
25
|
+
notice: string;
|
|
26
|
+
/**
|
|
27
|
+
* The selection. `primaryType` is a key of the rules table and "" for an empty selection; the
|
|
28
|
+
* panel reads the rest of the unit's card out of that table rather than being told twice.
|
|
29
|
+
*/
|
|
30
|
+
primaryType: string;
|
|
31
|
+
primaryTeam: number;
|
|
32
|
+
primaryHp: number;
|
|
33
|
+
primaryMaxHp: number;
|
|
34
|
+
primaryBuilt: boolean;
|
|
35
|
+
primaryProgress: number;
|
|
36
|
+
/** How many are selected, and how many distinct factions they belong to. */
|
|
37
|
+
selection: number;
|
|
38
|
+
selectionTeams: number;
|
|
39
|
+
/** Distinct order kinds across the selection, comma-joined, so the panel can say "3 mining". */
|
|
40
|
+
selectionOrder: string;
|
|
41
|
+
/** The primary selected entity's position, for the panel's readout and for a scenario. */
|
|
42
|
+
selectionX: number;
|
|
43
|
+
selectionZ: number;
|
|
44
|
+
/** The selected producer's queue, as `"<type>:<progress 0..1>"` strings. */
|
|
45
|
+
queue: string[];
|
|
46
|
+
/** The pending order mode: "", "build:<type>", "move", "attack", "garrison", "repair", "rally". */
|
|
47
|
+
mode: string;
|
|
48
|
+
/** Camera focus and zoom, so the minimap can draw the view rectangle. */
|
|
49
|
+
cameraX: number;
|
|
50
|
+
cameraZoom: number;
|
|
51
|
+
cameraZ: number;
|
|
52
|
+
/**
|
|
53
|
+
* The tactical overview, as one coarse raster plus one flat run of quads.
|
|
54
|
+
*
|
|
55
|
+
* `minimapFog` is `minimapSize²` characters, row-major: `.` never seen, `,` remembered, `#` in
|
|
56
|
+
* sight. `minimapDots` is `[x, z, team, kind, …]` in minimap pixels. Strings and numbers rather
|
|
57
|
+
* than an object per entity, because this is the one part of the state big enough to notice.
|
|
58
|
+
*/
|
|
59
|
+
minimapDots: number[];
|
|
60
|
+
minimapFog: string;
|
|
61
|
+
/** The rubber band, in client pixels, or null. Drawn by the UI, not the scene. */
|
|
62
|
+
dragBox: number[] | null;
|
|
63
|
+
/** Set from the UI's pause and resume intents, and read back by the menu. */
|
|
64
|
+
paused: boolean;
|
|
65
|
+
/** True once the UI layer has rendered and published its interactive rectangles. */
|
|
66
|
+
uiReady: boolean;
|
|
67
|
+
};
|
|
68
|
+
|
|
69
|
+
export const INITIAL_STATE: GameState = {
|
|
70
|
+
cameraX: 0,
|
|
71
|
+
cameraZoom: 30,
|
|
72
|
+
cameraZ: 0,
|
|
73
|
+
dragBox: null,
|
|
74
|
+
gathered: 0,
|
|
75
|
+
gas: 0,
|
|
76
|
+
kills: 0,
|
|
77
|
+
minimapDots: [],
|
|
78
|
+
minimapFog: "",
|
|
79
|
+
mode: "",
|
|
80
|
+
notice: "",
|
|
81
|
+
ore: 0,
|
|
82
|
+
paused: false,
|
|
83
|
+
primaryBuilt: true,
|
|
84
|
+
primaryHp: 0,
|
|
85
|
+
primaryMaxHp: 0,
|
|
86
|
+
primaryProgress: 0,
|
|
87
|
+
primaryTeam: 0,
|
|
88
|
+
primaryType: "",
|
|
89
|
+
queue: [],
|
|
90
|
+
result: "",
|
|
91
|
+
selection: 0,
|
|
92
|
+
selectionOrder: "",
|
|
93
|
+
selectionTeams: 0,
|
|
94
|
+
selectionX: 0,
|
|
95
|
+
selectionZ: 0,
|
|
96
|
+
simTime: 0,
|
|
97
|
+
supplyCap: 0,
|
|
98
|
+
supplyUsed: 0,
|
|
99
|
+
uiReady: false,
|
|
100
|
+
};
|
|
@@ -1,17 +1,30 @@
|
|
|
1
1
|
@import "tailwindcss";
|
|
2
2
|
|
|
3
|
+
/*
|
|
4
|
+
* Sources declared explicitly rather than left to automatic detection. When
|
|
5
|
+
* Tailwind finds no sources it still builds successfully — it emits the @theme
|
|
6
|
+
* variables and zero utilities, so every class name in src/ui/ becomes an inert
|
|
7
|
+
* string with no error anywhere to explain it. Being explicit makes that
|
|
8
|
+
* failure impossible rather than merely unlikely.
|
|
9
|
+
*/
|
|
3
10
|
@source "../index.html";
|
|
4
11
|
@source "./";
|
|
5
12
|
|
|
13
|
+
/*
|
|
14
|
+
* Your palette. Every name here becomes a real Tailwind utility — `bg-ink`,
|
|
15
|
+
* `text-lume`, `border-line` — so the HUD reads in game terms instead of
|
|
16
|
+
* `bg-slate-950`. Rename them, add to them, or delete the block and use
|
|
17
|
+
* Tailwind's defaults. Nothing in @threenative/* reads this.
|
|
18
|
+
*/
|
|
6
19
|
@theme {
|
|
7
|
-
--color-ink: #
|
|
8
|
-
--color-panel: #
|
|
9
|
-
--color-line: #
|
|
10
|
-
--color-lume: #
|
|
11
|
-
--color-
|
|
12
|
-
--color-
|
|
13
|
-
--color-
|
|
14
|
-
|
|
20
|
+
--color-ink: #17384a;
|
|
21
|
+
--color-panel: #24566a;
|
|
22
|
+
--color-line: #55929a;
|
|
23
|
+
--color-lume: #c2f2d6;
|
|
24
|
+
--color-warn: #ffdda1;
|
|
25
|
+
--color-text: #eff6dc;
|
|
26
|
+
--color-dim: #b1d2c7;
|
|
27
|
+
|
|
15
28
|
--font-mono: ui-monospace, SFMono-Regular, Menlo, monospace;
|
|
16
29
|
}
|
|
17
30
|
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { IGame } from "@threenative/core";
|
|
2
|
+
import { DebugOverlay, GameCanvas } from "@threenative/ui";
|
|
3
|
+
import type { GameState } from "../state.js";
|
|
4
|
+
import { GameUi } from "./GameUi.js";
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* The web target's page: the canvas, then the same UI every other target renders.
|
|
8
|
+
*
|
|
9
|
+
* `GameCanvas` hosts the renderer and everything after it paints on top; keep the canvas first. The
|
|
10
|
+
* UI itself comes from `GameUi`, unchanged — this file exists only because the web build also has
|
|
11
|
+
* to put a canvas on the page.
|
|
12
|
+
*/
|
|
13
|
+
export function App({ game }: { game: IGame<GameState, undefined> }) {
|
|
14
|
+
return (
|
|
15
|
+
<main className="relative h-screen w-screen overflow-hidden bg-ink">
|
|
16
|
+
<GameCanvas className="absolute inset-0" game={game} />
|
|
17
|
+
<GameUi />
|
|
18
|
+
<DebugOverlay />
|
|
19
|
+
</main>
|
|
20
|
+
);
|
|
21
|
+
}
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
import { useUiIntent, useUiState } from "@threenative/ui";
|
|
2
|
+
import { type BuildingType, type EntityType, TYPES } from "../sim/types.js";
|
|
3
|
+
import type { GameState } from "../state.js";
|
|
4
|
+
|
|
5
|
+
/** Every structure the rules table knows how to place, in the table's own order. */
|
|
6
|
+
const STRUCTURES = (Object.keys(TYPES) as EntityType[]).filter(
|
|
7
|
+
(type) => TYPES[type].building === true,
|
|
8
|
+
) as BuildingType[];
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* The command panel: orders for what is selected, and the build menu.
|
|
12
|
+
*
|
|
13
|
+
* The panel never decides anything. Each button names an intent — `order`, `place`, `train` — and
|
|
14
|
+
* the scene decides what it means, which is why the same rules table the pathfinder reads is also
|
|
15
|
+
* the one that prices these buttons: a structure the player cannot afford is greyed out here
|
|
16
|
+
* because `canAfford` is the same arithmetic the simulation charges them with.
|
|
17
|
+
*/
|
|
18
|
+
export function Commands() {
|
|
19
|
+
const state = useUiState<GameState>();
|
|
20
|
+
const send = useUiIntent();
|
|
21
|
+
if (state === undefined) return null;
|
|
22
|
+
const card = state.primaryType === "" ? undefined : TYPES[state.primaryType as EntityType];
|
|
23
|
+
const producer = card?.building === true ? (state.primaryType as EntityType) : undefined;
|
|
24
|
+
const placing = state.mode.startsWith("build:") ? state.mode.slice(6) : "";
|
|
25
|
+
|
|
26
|
+
return (
|
|
27
|
+
<section className="pointer-events-none absolute right-4 bottom-14 flex max-w-80 flex-col gap-2">
|
|
28
|
+
{producer === undefined ? null : (
|
|
29
|
+
<div className="flex flex-wrap justify-end gap-1">
|
|
30
|
+
{(card?.trains ?? []).map((type) => {
|
|
31
|
+
const cost = TYPES[type];
|
|
32
|
+
const afford = state.ore >= cost.ore && state.gas >= cost.gas;
|
|
33
|
+
return (
|
|
34
|
+
<Button
|
|
35
|
+
afford={afford}
|
|
36
|
+
key={type}
|
|
37
|
+
label={cost.name}
|
|
38
|
+
onClick={() => send("train", type)}
|
|
39
|
+
testid={`train-${type}`}
|
|
40
|
+
/>
|
|
41
|
+
);
|
|
42
|
+
})}
|
|
43
|
+
</div>
|
|
44
|
+
)}
|
|
45
|
+
<div className="flex flex-wrap justify-end gap-1">
|
|
46
|
+
{state.selection === 0 ? null : (
|
|
47
|
+
<>
|
|
48
|
+
<Button
|
|
49
|
+
label="attack-move"
|
|
50
|
+
onClick={() => send("order", "attack")}
|
|
51
|
+
testid="order-attack"
|
|
52
|
+
/>
|
|
53
|
+
<Button label="move" onClick={() => send("order", "move")} testid="order-move" />
|
|
54
|
+
<Button
|
|
55
|
+
label="garrison"
|
|
56
|
+
onClick={() => send("order", "garrison")}
|
|
57
|
+
testid="order-garrison"
|
|
58
|
+
/>
|
|
59
|
+
<Button label="repair" onClick={() => send("order", "repair")} testid="order-repair" />
|
|
60
|
+
<Button label="retreat" onClick={() => send("retreat")} testid="order-retreat" />
|
|
61
|
+
</>
|
|
62
|
+
)}
|
|
63
|
+
<Button label="all army" onClick={() => send("army")} testid="order-army" />
|
|
64
|
+
<Button label="base" onClick={() => send("base")} testid="order-base" />
|
|
65
|
+
</div>
|
|
66
|
+
<div className="flex flex-wrap justify-end gap-1">
|
|
67
|
+
{STRUCTURES.map((type) => {
|
|
68
|
+
const cost = TYPES[type];
|
|
69
|
+
// Greying an unaffordable structure is the same arithmetic the simulation charges with.
|
|
70
|
+
// A structure whose prerequisite is missing is left enabled: the scene refuses it with a
|
|
71
|
+
// reason, which is more useful than a button that silently does nothing.
|
|
72
|
+
const afford = state.ore >= cost.ore && state.gas >= cost.gas;
|
|
73
|
+
return (
|
|
74
|
+
<Button
|
|
75
|
+
afford={afford}
|
|
76
|
+
key={type}
|
|
77
|
+
label={cost.name}
|
|
78
|
+
onClick={() => send("place", type)}
|
|
79
|
+
testid={`build-${type}`}
|
|
80
|
+
active={placing === type}
|
|
81
|
+
title={`${cost.name} — ${cost.ore} ore${cost.gas > 0 ? `, ${cost.gas} gas` : ""}`}
|
|
82
|
+
/>
|
|
83
|
+
);
|
|
84
|
+
})}
|
|
85
|
+
</div>
|
|
86
|
+
<p className="text-right text-[10px] uppercase tracking-[0.14em] text-dim" id="command-hint">
|
|
87
|
+
{placing === ""
|
|
88
|
+
? "drag to select · right-click to order · wheel to zoom"
|
|
89
|
+
: `placing ${TYPES[placing as BuildingType].name} — click the ground, esc to cancel`}
|
|
90
|
+
</p>
|
|
91
|
+
</section>
|
|
92
|
+
);
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
function Button({
|
|
96
|
+
active = false,
|
|
97
|
+
afford = true,
|
|
98
|
+
label,
|
|
99
|
+
onClick,
|
|
100
|
+
testid,
|
|
101
|
+
title,
|
|
102
|
+
}: {
|
|
103
|
+
readonly active?: boolean;
|
|
104
|
+
readonly afford?: boolean;
|
|
105
|
+
readonly label: string;
|
|
106
|
+
readonly onClick: () => void;
|
|
107
|
+
readonly testid: string;
|
|
108
|
+
readonly title?: string;
|
|
109
|
+
}) {
|
|
110
|
+
return (
|
|
111
|
+
<button
|
|
112
|
+
// The panel is `pointer-events-none` so its empty space hands the click to the battlefield
|
|
113
|
+
// underneath, which is what a strategy game needs: the only pixels that take a gesture are
|
|
114
|
+
// the buttons. A button inside a `none` island is inert until it opts back in, so this
|
|
115
|
+
// class is load-bearing rather than decoration — without it every order in this panel is
|
|
116
|
+
// dead to a mouse and only the keyboard can issue one.
|
|
117
|
+
className={`pointer-events-auto border px-2 py-1 text-[10px] uppercase tracking-[0.12em] ${
|
|
118
|
+
active ? "border-lume bg-lume/20 text-lume" : "border-line bg-panel/80 text-text"
|
|
119
|
+
} ${afford ? "" : "text-dim/60 line-through"}`}
|
|
120
|
+
data-tn-interactive
|
|
121
|
+
data-testid={testid}
|
|
122
|
+
onClick={onClick}
|
|
123
|
+
title={title}
|
|
124
|
+
type="button"
|
|
125
|
+
>
|
|
126
|
+
{label}
|
|
127
|
+
</button>
|
|
128
|
+
);
|
|
129
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { UiLayer } from "@threenative/ui";
|
|
2
|
+
import { Commands } from "./Commands.js";
|
|
3
|
+
import { Hud } from "./Hud.js";
|
|
4
|
+
import { Minimap } from "./Minimap.js";
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Everything the player sees that is not the battlefield.
|
|
8
|
+
*
|
|
9
|
+
* One component, mounted twice by two entries that differ only in what else is on the page:
|
|
10
|
+
* `src/main.ts` puts it beside the canvas on the web target, and `src/ui/main.tsx` is the whole
|
|
11
|
+
* page the native web view loads. Keeping both entries pointed at this file is what makes "the
|
|
12
|
+
* same UI on every target" a fact rather than an intention.
|
|
13
|
+
*/
|
|
14
|
+
export function GameUi() {
|
|
15
|
+
return (
|
|
16
|
+
<UiLayer>
|
|
17
|
+
<Hud />
|
|
18
|
+
<Minimap />
|
|
19
|
+
<Commands />
|
|
20
|
+
</UiLayer>
|
|
21
|
+
);
|
|
22
|
+
}
|
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
import { useUiIntent, useUiState } from "@threenative/ui";
|
|
2
|
+
import { type EntityType, TYPES } from "../sim/types.js";
|
|
3
|
+
import type { GameState } from "../state.js";
|
|
4
|
+
|
|
5
|
+
/** Read a `"<type>:<progress 0..1>"` pair back apart. */
|
|
6
|
+
function readQueueItem(entry: string): { progress: number; type: EntityType } | undefined {
|
|
7
|
+
const at = entry.lastIndexOf(":");
|
|
8
|
+
if (at < 1) return undefined;
|
|
9
|
+
const type = entry.slice(0, at) as EntityType;
|
|
10
|
+
const progress = Number(entry.slice(at + 1));
|
|
11
|
+
return TYPES[type] === undefined || !Number.isFinite(progress) ? undefined : { progress, type };
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
function clock(seconds: number): string {
|
|
15
|
+
const whole = Math.max(0, Math.floor(seconds));
|
|
16
|
+
return `${String(Math.floor(whole / 60)).padStart(2, "0")}:${String(whole % 60).padStart(2, "0")}`;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* The top bar and the selection panel: what is banked, what is selected, what it is doing.
|
|
21
|
+
*
|
|
22
|
+
* Plain Tailwind, plain DOM, and the same file on every target. The unit's *name*, role and cost
|
|
23
|
+
* are not published by the game — they come out of the same rules table the pathfinder reads, so a
|
|
24
|
+
* rebalance cannot leave this panel quoting last season's numbers.
|
|
25
|
+
*/
|
|
26
|
+
export function Hud() {
|
|
27
|
+
const state = useUiState<GameState>();
|
|
28
|
+
const send = useUiIntent();
|
|
29
|
+
// Nothing to draw until the game publishes its first snapshot. Rendering zeros instead would put
|
|
30
|
+
// a wrong supply figure on screen and then correct it.
|
|
31
|
+
if (state === undefined) return null;
|
|
32
|
+
const card = state.primaryType === "" ? undefined : TYPES[state.primaryType as EntityType];
|
|
33
|
+
const queue = state.queue
|
|
34
|
+
.map(readQueueItem)
|
|
35
|
+
.filter((item): item is { progress: number; type: EntityType } => item !== undefined);
|
|
36
|
+
const supplyBlocked = state.supplyUsed >= state.supplyCap;
|
|
37
|
+
|
|
38
|
+
return (
|
|
39
|
+
<>
|
|
40
|
+
<header className="pointer-events-none absolute inset-x-0 top-0 flex items-start justify-between gap-4 p-4">
|
|
41
|
+
<div className="flex items-center gap-5 bg-panel/80 px-4 py-2 text-lume">
|
|
42
|
+
<Stat label="ore" value={state.ore.toLocaleString()} id="ore" />
|
|
43
|
+
<Stat label="gas" value={state.gas.toLocaleString()} id="gas" />
|
|
44
|
+
<Stat
|
|
45
|
+
label="supply"
|
|
46
|
+
value={`${state.supplyUsed} / ${state.supplyCap}`}
|
|
47
|
+
id="supply"
|
|
48
|
+
warn={supplyBlocked}
|
|
49
|
+
/>
|
|
50
|
+
<Stat label="clock" value={clock(state.simTime / 20)} id="clock" />
|
|
51
|
+
</div>
|
|
52
|
+
{state.notice === "" ? null : (
|
|
53
|
+
<output className="max-w-sm bg-panel/80 px-3 py-2 text-xs uppercase tracking-[0.14em] text-warn">
|
|
54
|
+
{state.notice}
|
|
55
|
+
</output>
|
|
56
|
+
)}
|
|
57
|
+
</header>
|
|
58
|
+
|
|
59
|
+
<section className="pointer-events-none absolute bottom-4 left-4 w-72 bg-panel/80 p-3">
|
|
60
|
+
<div className="flex items-baseline justify-between text-[10px] uppercase tracking-[0.14em] text-dim">
|
|
61
|
+
<span>{state.selection === 0 ? "no selection" : "strike group"}</span>
|
|
62
|
+
<span id="selection-count">{state.selection} selected</span>
|
|
63
|
+
</div>
|
|
64
|
+
<h2 className="mt-1 text-xl leading-none text-text">{card?.name ?? "Awaiting orders"}</h2>
|
|
65
|
+
<p className="mt-1 text-xs text-dim">{card?.role ?? "Select a unit or a structure."}</p>
|
|
66
|
+
<div className="relative mt-2 h-1.5 overflow-hidden border border-line bg-ink">
|
|
67
|
+
<i
|
|
68
|
+
className="absolute inset-y-0 left-0 bg-lume"
|
|
69
|
+
style={{
|
|
70
|
+
width: `${state.primaryMaxHp > 0 ? (state.primaryHp / state.primaryMaxHp) * 100 : 0}%`,
|
|
71
|
+
}}
|
|
72
|
+
/>
|
|
73
|
+
</div>
|
|
74
|
+
<div className="mt-1 flex justify-between text-[10px] uppercase tracking-[0.14em] text-dim">
|
|
75
|
+
<span id="health">
|
|
76
|
+
{state.primaryMaxHp} / {state.primaryMaxHp}
|
|
77
|
+
</span>
|
|
78
|
+
<span id="selection-position">
|
|
79
|
+
{state.selectionX.toFixed(0)} · {state.selectionZ.toFixed(0)}
|
|
80
|
+
</span>
|
|
81
|
+
</div>
|
|
82
|
+
{state.primaryType === "" || state.primaryBuilt ? null : (
|
|
83
|
+
<p className="mt-2 text-[10px] uppercase tracking-[0.14em] text-lume">
|
|
84
|
+
site {Math.round(state.primaryProgress * 100)}%
|
|
85
|
+
</p>
|
|
86
|
+
)}
|
|
87
|
+
{queue.length === 0 ? null : (
|
|
88
|
+
<ul className="mt-2 flex flex-wrap gap-1">
|
|
89
|
+
{queue.map((item, index) => (
|
|
90
|
+
<li
|
|
91
|
+
className="relative h-6 w-12 overflow-hidden border border-line bg-ink text-[9px] uppercase tracking-[0.1em] text-text"
|
|
92
|
+
key={`${item.type}-${index}`}
|
|
93
|
+
>
|
|
94
|
+
<i
|
|
95
|
+
className="absolute inset-y-0 left-0 bg-panel"
|
|
96
|
+
style={{ width: `${item.progress * 100}%` }}
|
|
97
|
+
/>
|
|
98
|
+
<span className="relative">{TYPES[item.type].name}</span>
|
|
99
|
+
</li>
|
|
100
|
+
))}
|
|
101
|
+
</ul>
|
|
102
|
+
)}
|
|
103
|
+
{state.selectionOrder === "" ? null : (
|
|
104
|
+
<p className="mt-2 text-[10px] uppercase tracking-[0.14em] text-dim" id="selection-order">
|
|
105
|
+
{state.selectionOrder}
|
|
106
|
+
</p>
|
|
107
|
+
)}
|
|
108
|
+
</section>
|
|
109
|
+
|
|
110
|
+
{state.dragBox === null ? null : (
|
|
111
|
+
<div
|
|
112
|
+
className="pointer-events-none absolute border border-lume/80 bg-lume/10"
|
|
113
|
+
style={{
|
|
114
|
+
left: `${state.dragBox[0]}px`,
|
|
115
|
+
top: `${state.dragBox[1]}px`,
|
|
116
|
+
width: `${state.dragBox[2]}px`,
|
|
117
|
+
height: `${state.dragBox[3]}px`,
|
|
118
|
+
}}
|
|
119
|
+
/>
|
|
120
|
+
)}
|
|
121
|
+
<p className="sr-only" id="selection-live">
|
|
122
|
+
{`${state.selection} selected, orders ${state.selectionOrder}`}
|
|
123
|
+
</p>
|
|
124
|
+
<div className="pointer-events-none absolute right-4 bottom-4 flex flex-col items-end gap-1">
|
|
125
|
+
{state.result === "" ? null : (
|
|
126
|
+
<span className="bg-panel/80 px-3 py-1 text-xs uppercase tracking-[0.2em] text-warn">
|
|
127
|
+
{state.result}
|
|
128
|
+
</span>
|
|
129
|
+
)}
|
|
130
|
+
<button
|
|
131
|
+
className="pointer-events-auto border border-line bg-panel/80 px-3 py-1 text-[10px] uppercase tracking-[0.14em] text-text"
|
|
132
|
+
data-tn-interactive
|
|
133
|
+
onClick={() => send(state.paused ? "resume" : "pause")}
|
|
134
|
+
type="button"
|
|
135
|
+
>
|
|
136
|
+
{state.paused ? "resume" : "pause"}
|
|
137
|
+
</button>
|
|
138
|
+
</div>
|
|
139
|
+
</>
|
|
140
|
+
);
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
function Stat({
|
|
144
|
+
id,
|
|
145
|
+
label,
|
|
146
|
+
value,
|
|
147
|
+
warn = false,
|
|
148
|
+
}: {
|
|
149
|
+
readonly id: string;
|
|
150
|
+
readonly label: string;
|
|
151
|
+
readonly value: string;
|
|
152
|
+
readonly warn?: boolean;
|
|
153
|
+
}) {
|
|
154
|
+
return (
|
|
155
|
+
<div>
|
|
156
|
+
<div className="text-[9px] uppercase tracking-[0.18em] text-dim">{label}</div>
|
|
157
|
+
<div
|
|
158
|
+
className={`text-lg leading-none tabular-nums ${warn ? "text-warn" : "text-text"}`}
|
|
159
|
+
id={id}
|
|
160
|
+
>
|
|
161
|
+
{value}
|
|
162
|
+
</div>
|
|
163
|
+
</div>
|
|
164
|
+
);
|
|
165
|
+
}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
import { useUiState } from "@threenative/ui";
|
|
2
|
+
import { useEffect, useRef } from "react";
|
|
3
|
+
import { STARTS } from "../sim/terrain.js";
|
|
4
|
+
import type { GameState } from "../state.js";
|
|
5
|
+
|
|
6
|
+
const SIZE = 28;
|
|
7
|
+
/** Side of the minimap canvas in device pixels; the coarse raster is upscaled into it. */
|
|
8
|
+
const EDGE = "#d4f8ec";
|
|
9
|
+
const UNSEEN = "#0b1a20";
|
|
10
|
+
const EXPLORED = "#1b2f33";
|
|
11
|
+
const VISIBLE = "#33585a";
|
|
12
|
+
const ORE = "#76d3e7";
|
|
13
|
+
const GAS = "#b7dd77";
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* The tactical overview.
|
|
17
|
+
*
|
|
18
|
+
* A 28×28 character raster of the fog and a flat run of quads for everything on it, both
|
|
19
|
+
* published by the scene. Deliberately a canvas in the *UI* layer: this is a map, drawn in the
|
|
20
|
+
* layer that is allowed to be a document, and it is rebuilt only when the game replaces the
|
|
21
|
+
* payload, so the HUD and the map never disagree about a frame.
|
|
22
|
+
*/
|
|
23
|
+
export function Minimap() {
|
|
24
|
+
const state = useUiState<GameState>();
|
|
25
|
+
const canvas = useRef<HTMLCanvasElement>(null);
|
|
26
|
+
// The two payloads are replaced only on the simulation's clock, so their identity is the
|
|
27
|
+
// redraw signal: this map repaints twenty times a second, not once per published frame.
|
|
28
|
+
const fog = state?.minimapFog;
|
|
29
|
+
const dots = state?.minimapDots;
|
|
30
|
+
const cameraX = state?.cameraX ?? 0;
|
|
31
|
+
const cameraZ = state?.cameraZ ?? 0;
|
|
32
|
+
const cameraZoom = state?.cameraZoom ?? 30;
|
|
33
|
+
useEffect(() => {
|
|
34
|
+
const host = canvas.current;
|
|
35
|
+
if (host === null || fog === undefined || fog === "") return;
|
|
36
|
+
const size = host.width;
|
|
37
|
+
const context = host.getContext("2d");
|
|
38
|
+
if (context === null) return;
|
|
39
|
+
const cell = size / SIZE;
|
|
40
|
+
for (let row = 0; row < SIZE; row += 1)
|
|
41
|
+
for (let column = 0; column < SIZE; column += 1) {
|
|
42
|
+
const mark = fog.charAt(row * SIZE + column);
|
|
43
|
+
context.fillStyle = mark === "#" ? VISIBLE : mark === "," ? EXPLORED : UNSEEN;
|
|
44
|
+
context.fillRect(column * cell, row * cell, cell + 0.5, cell + 0.5);
|
|
45
|
+
}
|
|
46
|
+
const contacts = dots ?? [];
|
|
47
|
+
for (let index = 0; index < contacts.length; index += 4) {
|
|
48
|
+
const x = (contacts[index] ?? 0) / 10;
|
|
49
|
+
const z = (contacts[index + 1] ?? 0) / 10;
|
|
50
|
+
const team = contacts[index + 2] ?? 0;
|
|
51
|
+
const kind = contacts[index + 3] ?? 0;
|
|
52
|
+
if (team === 9) {
|
|
53
|
+
context.fillStyle = kind === 2 ? ORE : GAS;
|
|
54
|
+
context.fillRect(x - 1, z - 1, 2.5, 2.5);
|
|
55
|
+
continue;
|
|
56
|
+
}
|
|
57
|
+
context.fillStyle = STARTS[team]?.css ?? EDGE;
|
|
58
|
+
if (kind === 1) context.fillRect(x - 2.5, z - 2.5, 5, 5);
|
|
59
|
+
else context.fillRect(x - 1.5, z - 1.5, 3, 3);
|
|
60
|
+
}
|
|
61
|
+
// The view rectangle: what the camera is actually looking at, at the map's own scale.
|
|
62
|
+
const span = cameraZoom;
|
|
63
|
+
const half = (span / SIZE) * (size / 2);
|
|
64
|
+
const cx = cameraX / 2 + size / 2;
|
|
65
|
+
const cz = cameraZ / 2 + size / 2;
|
|
66
|
+
context.strokeStyle = EDGE;
|
|
67
|
+
context.lineWidth = 1;
|
|
68
|
+
context.strokeRect(cx - half, cz - half, half * 2, half * 2);
|
|
69
|
+
}, [fog, dots, cameraX, cameraZ, cameraZoom]);
|
|
70
|
+
|
|
71
|
+
return (
|
|
72
|
+
<section className="pointer-events-none absolute right-4 bottom-56 bg-panel/80 p-2">
|
|
73
|
+
<div className="mb-1 text-[9px] uppercase tracking-[0.18em] text-dim">tactical overview</div>
|
|
74
|
+
<canvas
|
|
75
|
+
aria-label="Tactical overview"
|
|
76
|
+
className="block h-40 w-40 border border-line"
|
|
77
|
+
height={SIZE * 5}
|
|
78
|
+
ref={canvas}
|
|
79
|
+
role="img"
|
|
80
|
+
width={SIZE * 5}
|
|
81
|
+
/>
|
|
82
|
+
</section>
|
|
83
|
+
);
|
|
84
|
+
}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import type { IThreeNativeConfig } from "@threenative/core";
|
|
2
|
+
|
|
3
|
+
const config: IThreeNativeConfig = {
|
|
4
|
+
app: {
|
|
5
|
+
id: "com.threenative.__PROJECT_ID__",
|
|
6
|
+
name: "__PROJECT_NAME__",
|
|
7
|
+
version: "1.0.0",
|
|
8
|
+
build: 1,
|
|
9
|
+
icon: "public/icon.png",
|
|
10
|
+
icons: { web: { favicon: "public/favicon.svg" } },
|
|
11
|
+
},
|
|
12
|
+
display: {
|
|
13
|
+
orientation: "landscape", // Mobile viewport orientation.
|
|
14
|
+
fullscreen: true, // Keep the game surface edge to edge.
|
|
15
|
+
keepScreenOn: true, // Do not dim during a play session.
|
|
16
|
+
maxFps: 60, // Set 120 to opt into a supported high-refresh display mode.
|
|
17
|
+
},
|
|
18
|
+
window: {
|
|
19
|
+
title: "__PROJECT_NAME__", // Desktop window title.
|
|
20
|
+
width: 1280,
|
|
21
|
+
height: 720,
|
|
22
|
+
maximized: false,
|
|
23
|
+
resizable: true,
|
|
24
|
+
},
|
|
25
|
+
bootSplash: {
|
|
26
|
+
backgroundColor: "#0d1b2a",
|
|
27
|
+
},
|
|
28
|
+
nativeEntry: "src/game.ts",
|
|
29
|
+
ui: { renderer: "native" }, // src/ui/ is the HUD on every target; this selects the native web view.
|
|
30
|
+
// One asset tree, one compiler, one representation per artifact. Uncomment, then cook:
|
|
31
|
+
// threenative build --target android # cooks defaults.android; --profile <name> beats it
|
|
32
|
+
// buildProfiles: {
|
|
33
|
+
// defaults: { android: "compact" },
|
|
34
|
+
// profiles: {
|
|
35
|
+
// compact: {
|
|
36
|
+
// assets: { textures: { maxSize: 1024 }, models: { textures: { maxSize: 1024 } } },
|
|
37
|
+
// } },
|
|
38
|
+
// },
|
|
39
|
+
// Contract, byte definitions, the build report:
|
|
40
|
+
// node_modules/create-threenative/agent-docs/references/build-profiles.md
|
|
41
|
+
renderer: {
|
|
42
|
+
preferWebGPU: true, // Use WebGPU when the host exposes it.
|
|
43
|
+
// The engine holds the `display.maxFps` budget by scaling the 3D drawing buffer, and reports
|
|
44
|
+
// the scale it settled on in every `TN_FRAME_BUDGET` window. Replace with a number in (0, 1]
|
|
45
|
+
// to pin it — the loop stops and the reporting does not. CSS, UI and camera framing never move.
|
|
46
|
+
resolutionScale: "auto",
|
|
47
|
+
// Multisampling resolves triangle edges. A cutout silhouette — foliage, a fence, hair — is
|
|
48
|
+
// carved inside the triangle by an alpha test, so it resolves through the coverage mask or
|
|
49
|
+
// not at all, which is what this spends the samples above on. It costs no target and no
|
|
50
|
+
// extra pass; set it false for a deliberately hard-edged look. `TN_ALPHA_ANTIALIASING`
|
|
51
|
+
// reports what it did, and says so when a single-sampled surface leaves it nothing to do.
|
|
52
|
+
alphaAntialiasing: true,
|
|
53
|
+
},
|
|
54
|
+
};
|
|
55
|
+
|
|
56
|
+
export default config;
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"compilerOptions": {
|
|
3
|
+
"target": "ES2022",
|
|
4
|
+
"lib": ["ES2022", "DOM", "DOM.Iterable"],
|
|
5
|
+
"module": "ESNext",
|
|
6
|
+
"moduleResolution": "bundler",
|
|
7
|
+
"jsx": "react-jsx",
|
|
8
|
+
"types": ["vite/client"],
|
|
9
|
+
"strict": true,
|
|
10
|
+
"noUncheckedIndexedAccess": true,
|
|
11
|
+
"noEmit": true,
|
|
12
|
+
"skipLibCheck": true,
|
|
13
|
+
"verbatimModuleSyntax": true,
|
|
14
|
+
"isolatedModules": true
|
|
15
|
+
},
|
|
16
|
+
"include": ["src/**/*.ts", "src/**/*.tsx", "tests/**/*.ts", "*.ts"]
|
|
17
|
+
}
|
|
@@ -14,9 +14,12 @@ function assetsWatchPlugin(): Plugin {
|
|
|
14
14
|
return {
|
|
15
15
|
name: "threenative-assets-watch",
|
|
16
16
|
apply: "serve",
|
|
17
|
-
configureServer(server) {
|
|
17
|
+
async configureServer(server) {
|
|
18
18
|
const handle = watchAssets({ config: config.assets, cwd: server.config.root });
|
|
19
19
|
server.httpServer?.once("close", () => handle.close());
|
|
20
|
+
// Nothing is served before the first cook settles: until it does, `public/` has no
|
|
21
|
+
// `assets.manifest.json` and every asset answers from its source fallback.
|
|
22
|
+
await handle.ready;
|
|
20
23
|
},
|
|
21
24
|
};
|
|
22
25
|
}
|