create-threenative 0.2.1 → 0.2.3
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/LICENSE +21 -0
- package/README.md +10 -2
- package/agent-docs/asset-mcp-loop.md +33 -0
- package/agent-docs/ctx-surface.md +69 -0
- package/agent-docs/engine-capabilities.md +4 -0
- package/agent-docs/framework-blocks-you.md +60 -0
- package/agent-docs/look-at-it-and-budget-the-look.md +27 -0
- package/agent-docs/performance-default.md +42 -0
- package/agent-docs/pixel-budget.md +20 -0
- package/agent-docs/playtest-fail-closed.md +23 -0
- package/agent-docs/references/assertion-reference.md +652 -0
- package/agent-docs/references/capability-reference.md +3279 -0
- package/agent-docs/references/capture-the-frame.md +53 -0
- package/agent-docs/references/ctx-cookbook.md +51 -0
- package/agent-docs/references/debug-surface.md +63 -0
- package/agent-docs/references/finding-assets.md +147 -0
- package/agent-docs/references/gameplay-recipes.md +54 -0
- package/agent-docs/references/menu-screens.md +69 -0
- package/agent-docs/references/mobile-memory-budget.md +87 -0
- package/agent-docs/references/sculpt-from-a-reference.md +39 -0
- package/agent-docs/references/visual-baseline.md +133 -0
- package/agent-docs/references/webview-ui.md +113 -0
- package/agent-docs/sculpt-loop.md +16 -0
- package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
- package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
- package/agent-files/.claude/agents/threenative-builder.md +7 -0
- package/agent-files/.claude/agents/threenative-verifier.md +7 -0
- package/agent-files/.threenative/agents/builder.md +32 -0
- package/agent-files/.threenative/agents/verifier.md +31 -0
- package/agent-files/AGENT-ROLES.md +26 -0
- package/capabilities.json +3542 -0
- package/dist/index.d.ts +191 -3
- package/dist/index.js +1707 -73
- package/dist/threenative.d.ts +9 -2
- package/dist/threenative.js +1825 -148
- package/package.json +30 -6
- package/template-assets/loading.ts +315 -0
- package/template-assets/patches/three@0.185.1.patch +287 -0
- package/templates/action-rpg/.codex/config.toml +15 -0
- package/templates/action-rpg/.mcp.json +6 -2
- package/templates/action-rpg/AGENTS.md +370 -6
- package/templates/action-rpg/CLAUDE.md +370 -6
- package/templates/action-rpg/index.html +0 -1
- package/templates/action-rpg/package.json +15 -11
- package/templates/action-rpg/playtests/combat.playtest.json +23 -9
- package/templates/action-rpg/playtests/fail.playtest.json +3 -3
- package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
- package/templates/action-rpg/playtests/performance.playtest.json +22 -0
- package/templates/action-rpg/playtests/progress.playtest.json +18 -13
- package/templates/action-rpg/playtests/win.playtest.json +10 -4
- package/templates/action-rpg/public/icon.png +0 -0
- package/templates/action-rpg/src/entities/Enemy.ts +14 -4
- package/templates/action-rpg/src/game.ts +21 -0
- package/templates/action-rpg/src/render/lighting.ts +6 -1
- package/templates/action-rpg/src/render/loading.ts +267 -42
- package/templates/action-rpg/src/render/postprocessing.ts +68 -15
- package/templates/action-rpg/src/render/worldEnvironment.ts +583 -0
- package/templates/action-rpg/src/scenes/Play.ts +49 -19
- package/templates/action-rpg/src/state.ts +4 -0
- package/templates/action-rpg/src/style.css +45 -1
- package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
- package/templates/action-rpg/src/ui/App.tsx +9 -8
- package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
- package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
- package/templates/action-rpg/src/ui/Hud.tsx +10 -8
- package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
- package/templates/action-rpg/src/ui/main.tsx +14 -0
- package/templates/action-rpg/threenative.config.ts +21 -8
- package/templates/action-rpg/vite.config.ts +32 -2
- package/templates/defense/.codex/config.toml +15 -0
- package/templates/defense/.mcp.json +6 -2
- package/templates/defense/AGENTS.md +371 -8
- package/templates/defense/CLAUDE.md +371 -8
- package/templates/defense/README.md +2 -1
- package/templates/defense/index.html +0 -1
- package/templates/defense/package.json +16 -12
- package/templates/defense/playtests/leak.playtest.json +9 -4
- package/templates/defense/playtests/performance.playtest.json +22 -0
- package/templates/defense/playtests/placement.playtest.json +5 -5
- package/templates/defense/playtests/pointer-placement.playtest.json +89 -0
- package/templates/defense/playtests/scan.playtest.json +3 -3
- package/templates/defense/playtests/survive.playtest.json +11 -6
- package/templates/defense/public/icon.png +0 -0
- package/templates/defense/src/attackers/Attacker.ts +28 -12
- package/templates/defense/src/game.ts +24 -2
- package/templates/defense/src/render/lighting.ts +6 -1
- package/templates/defense/src/render/loading.ts +263 -37
- package/templates/defense/src/render/postprocessing.ts +70 -13
- package/templates/defense/src/render/shapes.ts +38 -0
- package/templates/defense/src/render/worldEnvironment.ts +583 -0
- package/templates/defense/src/scenes/Defense.ts +109 -50
- package/templates/defense/src/state.ts +6 -0
- package/templates/defense/src/style.css +45 -1
- package/templates/defense/src/ui/App.tsx +9 -4
- package/templates/defense/src/ui/GameUi.tsx +20 -0
- package/templates/defense/src/ui/Hud.tsx +6 -5
- package/templates/defense/src/ui/main.tsx +14 -0
- package/templates/defense/threenative.config.ts +21 -8
- package/templates/defense/vite.config.ts +34 -1
- package/templates/minimal/.codex/config.toml +15 -0
- package/templates/minimal/.mcp.json +6 -2
- package/templates/minimal/AGENTS.md +360 -255
- package/templates/minimal/CLAUDE.md +360 -255
- package/templates/minimal/index.html +0 -1
- package/templates/minimal/package.json +14 -11
- package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
- package/templates/minimal/playtests/play.playtest.json +17 -5
- package/templates/minimal/public/icon.png +0 -0
- package/templates/minimal/src/game.ts +1 -0
- package/templates/minimal/src/render/camera.ts +1 -1
- package/templates/minimal/src/render/hud.ts +24 -8
- package/templates/minimal/src/render/lighting.ts +23 -2
- package/templates/minimal/src/render/loading.ts +23 -103
- package/templates/minimal/src/render/postprocessing.ts +92 -14
- package/templates/minimal/src/render/sky.ts +37 -32
- package/templates/minimal/src/render/worldEnvironment.ts +583 -0
- package/templates/minimal/src/scenes/Play.ts +91 -13
- package/templates/minimal/src/state.ts +8 -1
- package/templates/minimal/threenative.config.ts +15 -10
- package/templates/minimal/vite.config.ts +28 -1
- package/templates/platformer/.codex/config.toml +15 -0
- package/templates/platformer/.mcp.json +6 -2
- package/templates/platformer/AGENTS.md +385 -130
- package/templates/platformer/CLAUDE.md +385 -130
- package/templates/platformer/index.html +0 -1
- package/templates/platformer/package.json +17 -14
- package/templates/platformer/playtests/avoidance.playtest.json +6 -1
- package/templates/platformer/playtests/branding.playtest.json +29 -0
- package/templates/platformer/playtests/buffer.playtest.json +1 -1
- package/templates/platformer/playtests/collect.playtest.json +1 -1
- package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
- package/templates/platformer/playtests/coyote.playtest.json +42 -8
- package/templates/platformer/playtests/damage.playtest.json +4 -1
- package/templates/platformer/playtests/dash.playtest.json +2 -2
- package/templates/platformer/playtests/jump.playtest.json +2 -3
- package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
- package/templates/platformer/playtests/oneway.playtest.json +1 -1
- package/templates/platformer/playtests/performance.playtest.json +6 -5
- package/templates/platformer/playtests/respawn.playtest.json +2 -2
- package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
- package/templates/platformer/playtests/stomp.playtest.json +11 -3
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +13 -4
- package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
- package/templates/platformer/playtests/touch-controls-web.playtest.json +46 -0
- package/templates/platformer/public/icon.png +0 -0
- package/templates/platformer/src/entities/Character.ts +16 -10
- package/templates/platformer/src/entities/Patrol.ts +5 -0
- package/templates/platformer/src/game.ts +24 -1
- package/templates/platformer/src/render/lighting.ts +6 -1
- package/templates/platformer/src/render/loading.ts +270 -61
- package/templates/platformer/src/render/postprocessing.ts +68 -15
- package/templates/platformer/src/render/touch-controls.ts +54 -36
- package/templates/platformer/src/render/worldEnvironment.ts +583 -0
- package/templates/platformer/src/scenes/Level.ts +47 -22
- package/templates/platformer/src/state.ts +4 -0
- package/templates/platformer/src/style.css +45 -1
- package/templates/platformer/src/ui/App.tsx +9 -4
- package/templates/platformer/src/ui/GameUi.tsx +20 -0
- package/templates/platformer/src/ui/Hud.tsx +6 -5
- package/templates/platformer/src/ui/main.tsx +14 -0
- package/templates/platformer/threenative.config.ts +20 -10
- package/templates/platformer/vite.config.ts +34 -1
- package/templates/racing/.codex/config.toml +15 -0
- package/templates/racing/.mcp.json +6 -2
- package/templates/racing/AGENTS.md +370 -6
- package/templates/racing/CLAUDE.md +370 -6
- package/templates/racing/index.html +0 -1
- package/templates/racing/package.json +16 -12
- package/templates/racing/playtests/boost.playtest.json +5 -5
- package/templates/racing/playtests/outcome.playtest.json +14 -4
- package/templates/racing/playtests/performance.playtest.json +22 -0
- package/templates/racing/playtests/ranking.playtest.json +2 -2
- package/templates/racing/playtests/rescue.playtest.json +12 -6
- package/templates/racing/playtests/reverse.playtest.json +3 -3
- package/templates/racing/playtests/shortcut.playtest.json +3 -3
- package/templates/racing/public/icon.png +0 -0
- package/templates/racing/src/game.ts +24 -1
- package/templates/racing/src/render/camera.ts +10 -6
- package/templates/racing/src/render/lighting.ts +6 -1
- package/templates/racing/src/render/loading.ts +291 -34
- package/templates/racing/src/render/postprocessing.ts +70 -13
- package/templates/racing/src/render/worldEnvironment.ts +583 -0
- package/templates/racing/src/scenes/Race.ts +68 -36
- package/templates/racing/src/state.ts +4 -0
- package/templates/racing/src/style.css +45 -1
- package/templates/racing/src/track/Lap.ts +20 -9
- package/templates/racing/src/track/Ranking.ts +53 -14
- package/templates/racing/src/track/Track.ts +29 -16
- package/templates/racing/src/track/TrackSector.ts +14 -4
- package/templates/racing/src/ui/App.tsx +9 -4
- package/templates/racing/src/ui/GameUi.tsx +20 -0
- package/templates/racing/src/ui/Hud.tsx +6 -5
- package/templates/racing/src/ui/main.tsx +14 -0
- package/templates/racing/threenative.config.ts +21 -8
- package/templates/racing/vite.config.ts +34 -1
- package/templates/sailing/.codex/config.toml +15 -0
- package/templates/sailing/.mcp.json +20 -0
- package/templates/sailing/AGENTS.md +388 -0
- package/templates/sailing/CLAUDE.md +390 -0
- package/templates/sailing/README.md +25 -0
- package/templates/sailing/index.html +12 -0
- package/templates/sailing/kit.json +7 -0
- package/templates/sailing/native-playtests/survives.playtest.json +21 -0
- package/templates/sailing/package.json +52 -0
- package/templates/sailing/playtests/fail.playtest.json +24 -0
- package/templates/sailing/playtests/performance.playtest.json +21 -0
- package/templates/sailing/playtests/survives.playtest.json +38 -0
- package/templates/sailing/playtests/win.playtest.json +31 -0
- package/templates/sailing/public/favicon.svg +5 -0
- package/templates/sailing/public/icon.png +0 -0
- package/templates/sailing/src/entities/Ship.ts +96 -0
- package/templates/sailing/src/game.ts +40 -0
- package/templates/sailing/src/main.ts +15 -0
- package/templates/sailing/src/render/camera.ts +21 -0
- package/templates/sailing/src/render/lighting.ts +36 -0
- package/templates/sailing/src/render/loading.ts +315 -0
- package/templates/sailing/src/render/materials.ts +28 -0
- package/templates/sailing/src/render/palette.ts +24 -0
- package/templates/sailing/src/render/postprocessing.ts +33 -0
- package/templates/sailing/src/render/props.ts +52 -0
- package/templates/sailing/src/render/sky.ts +32 -0
- package/templates/sailing/src/render/water-material.ts +14 -0
- package/templates/sailing/src/render/water-shaders.ts +12 -0
- package/templates/sailing/src/render/wave-nodes.ts +10 -0
- package/templates/sailing/src/render/worldEnvironment.ts +590 -0
- package/templates/sailing/src/scenes/Boot.ts +12 -0
- package/templates/sailing/src/scenes/Sailing.ts +106 -0
- package/templates/sailing/src/state.ts +10 -0
- package/templates/sailing/src/style.css +61 -0
- package/templates/sailing/src/ui/App.tsx +15 -0
- package/templates/sailing/src/ui/GameUi.tsx +12 -0
- package/templates/sailing/src/ui/Hud.tsx +55 -0
- package/templates/sailing/src/ui/Menu.tsx +30 -0
- package/templates/sailing/src/ui/main.tsx +7 -0
- package/templates/sailing/tailwind.config.ts +2 -0
- package/templates/sailing/threenative.config.ts +34 -0
- package/templates/sailing/tsconfig.json +17 -0
- package/templates/sailing/vite.config.ts +34 -0
- package/templates/shooter/.codex/config.toml +15 -0
- package/templates/shooter/.mcp.json +6 -2
- package/templates/shooter/AGENTS.md +373 -7
- package/templates/shooter/CLAUDE.md +373 -7
- package/templates/shooter/index.html +0 -1
- package/templates/shooter/package.json +16 -11
- package/templates/shooter/playtests/fail.playtest.json +5 -4
- package/templates/shooter/playtests/input-control.playtest.json +131 -0
- package/templates/shooter/playtests/per-item.playtest.json +59 -0
- package/templates/shooter/playtests/performance.playtest.json +22 -0
- package/templates/shooter/playtests/shooter.playtest.json +22 -18
- package/templates/shooter/playtests/survives.playtest.json +1 -1
- package/templates/shooter/public/favicon.svg +1 -1
- package/templates/shooter/public/icon.png +0 -0
- package/templates/shooter/src/game.ts +24 -1
- package/templates/shooter/src/main.ts +3 -13
- package/templates/shooter/src/render/camera.ts +62 -12
- package/templates/shooter/src/render/lighting.ts +6 -1
- package/templates/shooter/src/render/loading.ts +262 -33
- package/templates/shooter/src/render/palette.ts +1 -1
- package/templates/shooter/src/render/postprocessing.ts +68 -16
- package/templates/shooter/src/render/shapes.ts +178 -0
- package/templates/shooter/src/render/ui.css +34 -1
- package/templates/shooter/src/render/worldEnvironment.ts +583 -0
- package/templates/shooter/src/scenes/Play.ts +246 -73
- package/templates/shooter/src/state.ts +13 -0
- package/templates/shooter/src/style.css +26 -0
- package/templates/shooter/src/ui/App.tsx +10 -12
- package/templates/shooter/src/ui/GameUi.tsx +20 -0
- package/templates/shooter/src/ui/Hud.tsx +8 -10
- package/templates/shooter/src/ui/Menu.tsx +24 -9
- package/templates/shooter/src/ui/main.tsx +15 -0
- package/templates/shooter/src/weapons/Projectile.ts +21 -10
- package/templates/shooter/threenative.config.ts +21 -8
- package/templates/shooter/vite.config.ts +32 -2
- package/templates/starter/.codex/config.toml +15 -0
- package/templates/starter/.mcp.json +6 -2
- package/templates/starter/AGENTS.md +429 -326
- package/templates/starter/CLAUDE.md +429 -326
- package/templates/starter/assets/pickup.wav +0 -0
- package/templates/starter/gitignore +4 -0
- package/templates/starter/index.html +0 -1
- package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
- package/templates/starter/native-playtests/render-chain.playtest.json +12 -0
- package/templates/starter/package.json +16 -12
- package/templates/starter/playtests/assets.playtest.json +65 -0
- package/templates/starter/playtests/buffer.playtest.json +59 -9
- package/templates/starter/playtests/cloth.playtest.json +113 -0
- package/templates/starter/playtests/coyote.playtest.json +60 -8
- package/templates/starter/playtests/forward.playtest.json +29 -4
- package/templates/starter/playtests/gameover.playtest.json +66 -0
- package/templates/starter/playtests/goal.playtest.json +67 -0
- package/templates/starter/playtests/hot-reload.playtest.json +48 -8
- package/templates/starter/playtests/look.playtest.json +34 -6
- package/templates/starter/playtests/models-baseline.png +0 -0
- package/templates/starter/playtests/models.playtest.json +74 -0
- package/templates/starter/playtests/monitoring.playtest.json +38 -7
- package/templates/starter/playtests/odometer.playtest.json +54 -0
- package/templates/starter/playtests/pause.playtest.json +27 -4
- package/templates/starter/playtests/play.playtest.json +43 -7
- package/templates/starter/playtests/respawn.playtest.json +46 -6
- package/templates/starter/playtests/restart.playtest.json +65 -10
- package/templates/starter/playtests/seed.playtest.json +44 -8
- package/templates/starter/playtests/survives.playtest.json +27 -4
- package/templates/starter/playtests/textures-baseline.png +0 -0
- package/templates/starter/playtests/textures.playtest.json +74 -0
- package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
- package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
- package/templates/starter/public/icon.png +0 -0
- package/templates/starter/src/entities/Goal.ts +122 -0
- package/templates/starter/src/entities/Player.ts +40 -2
- package/templates/starter/src/game.ts +25 -0
- package/templates/starter/src/render/camera.ts +31 -5
- package/templates/starter/src/render/easing.ts +5 -0
- package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
- package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
- package/templates/starter/src/render/effects/sparkle.ts +49 -0
- package/templates/starter/src/render/lighting.ts +6 -1
- package/templates/starter/src/render/loading.ts +315 -0
- package/templates/starter/src/render/materials.ts +17 -1
- package/templates/starter/src/render/pennant.ts +54 -0
- package/templates/starter/src/render/postprocessing.ts +46 -15
- package/templates/starter/src/render/scenery.ts +83 -0
- package/templates/starter/src/render/shapes.ts +9 -21
- package/templates/starter/src/render/worldEnvironment.ts +583 -0
- package/templates/starter/src/scenes/Play.ts +146 -36
- package/templates/starter/src/state.ts +12 -0
- package/templates/starter/src/style.css +45 -1
- package/templates/starter/src/ui/App.tsx +9 -6
- package/templates/starter/src/ui/GameUi.tsx +20 -0
- package/templates/starter/src/ui/Hud.tsx +52 -29
- package/templates/starter/src/ui/Menu.tsx +25 -23
- package/templates/starter/src/ui/main.tsx +14 -0
- package/templates/starter/threenative.config.ts +27 -9
- package/templates/starter/tools/look.mjs +109 -0
- package/templates/starter/vite.config.ts +32 -2
- package/templates/minimal/assets/.gitkeep +0 -0
- package/templates/minimal/public/.gitkeep +0 -0
- package/templates/platformer/assets/.gitkeep +0 -0
- package/templates/platformer/public/.gitkeep +0 -0
- package/templates/starter/assets/.gitkeep +0 -0
- package/templates/starter/public/.gitkeep +0 -0
- package/templates/starter/public/pickup.ogg +0 -0
- /package/templates/starter/{public → assets}/native-proof.glb +0 -0
- /package/templates/starter/{public → assets}/native-proof.png +0 -0
|
@@ -1,32 +1,53 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import {
|
|
2
|
+
AudioBus,
|
|
3
|
+
type ICtx,
|
|
4
|
+
Scene,
|
|
5
|
+
type SceneFrame,
|
|
6
|
+
createRandom,
|
|
7
|
+
isMobile,
|
|
8
|
+
} from "@threenative/core";
|
|
2
9
|
import { Area3D, CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
|
|
3
|
-
import {
|
|
10
|
+
import { BufferAttribute, Group, Mesh, NearestFilter, type PerspectiveCamera } from "three";
|
|
4
11
|
import { Crate } from "../entities/Crate.js";
|
|
12
|
+
import { Goal } from "../entities/Goal.js";
|
|
5
13
|
import { Player } from "../entities/Player.js";
|
|
6
14
|
import { createSpringArm } from "../render/camera.js";
|
|
15
|
+
import { pickupRiseEase } from "../render/easing.js";
|
|
7
16
|
import { setupLighting } from "../render/lighting.js";
|
|
8
|
-
import {
|
|
17
|
+
import { createLoadingScreen } from "../render/loading.js";
|
|
18
|
+
import { createMaterials, createPennantMaterial } from "../render/materials.js";
|
|
9
19
|
import { setupPost } from "../render/postprocessing.js";
|
|
10
|
-
import {
|
|
20
|
+
import { createScenery } from "../render/scenery.js";
|
|
21
|
+
import { ball, block, roundedBox, spike, tube } from "../render/shapes.js";
|
|
11
22
|
import { setupSky } from "../render/sky.js";
|
|
12
23
|
import type { GameState } from "../state.js";
|
|
13
24
|
|
|
14
25
|
export type GameCtx = ICtx<GameState, IPhysicsContext>;
|
|
15
26
|
|
|
16
27
|
const KILL_PLANE = -4;
|
|
28
|
+
const STARTING_LIVES = 3;
|
|
17
29
|
|
|
18
30
|
export class Play extends Scene<GameState, IPhysicsContext> {
|
|
19
|
-
#assetProof:
|
|
31
|
+
#assetProof: Mesh | undefined;
|
|
20
32
|
|
|
21
33
|
static override readonly initialState: GameState = {
|
|
22
34
|
coyoteJumps: 0,
|
|
23
35
|
entityCount: 0,
|
|
36
|
+
flagDisplacement: 0,
|
|
37
|
+
flagGusts: 0,
|
|
38
|
+
flagReadbacks: 0,
|
|
39
|
+
flagSteps: 0,
|
|
24
40
|
jumps: 0,
|
|
25
41
|
levelX: -99,
|
|
42
|
+
lives: STARTING_LIVES,
|
|
43
|
+
odometer: 0,
|
|
44
|
+
paused: false,
|
|
26
45
|
peakRise: 0,
|
|
27
46
|
playerX: -2,
|
|
28
47
|
respawns: 0,
|
|
29
48
|
score: 0,
|
|
49
|
+
status: "playing",
|
|
50
|
+
uiReady: false,
|
|
30
51
|
};
|
|
31
52
|
|
|
32
53
|
override async load(ctx: GameCtx): Promise<void> {
|
|
@@ -34,38 +55,76 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
34
55
|
ctx.assets.texture("native-proof.png"),
|
|
35
56
|
ctx.assets.model<{ scene: Group }>("native-proof.glb"),
|
|
36
57
|
]);
|
|
58
|
+
// A 16-pixel check filtered smoothly is a grey smear at flag size; nearest keeps the
|
|
59
|
+
// squares square, which is the whole reason the finish flag is legible from the ledge.
|
|
60
|
+
texture.magFilter = NearestFilter;
|
|
61
|
+
let pennant: Mesh | undefined;
|
|
37
62
|
model.scene.traverse((object) => {
|
|
38
63
|
if (object instanceof Mesh) {
|
|
39
|
-
|
|
64
|
+
if (pennant !== undefined) throw new Error("Starter proof glTF must contain one mesh.");
|
|
65
|
+
object.material = createPennantMaterial(texture);
|
|
66
|
+
// The packaged proof carries positions and indices only. Without UVs the sampler
|
|
67
|
+
// reads one corner texel for every fragment and the flag renders as flat white —
|
|
68
|
+
// a loaded texture that proves nothing you can see. Plane-project the triangle.
|
|
69
|
+
// Compiled models may be quantized (KHR_mesh_quantization): the attribute then holds
|
|
70
|
+
// normalized integers, so measure each axis range from the array itself instead of
|
|
71
|
+
// assuming float32 metres — the affine projection is identical either way.
|
|
72
|
+
const position = object.geometry.getAttribute("position");
|
|
73
|
+
let minX = Number.POSITIVE_INFINITY;
|
|
74
|
+
let minY = Number.POSITIVE_INFINITY;
|
|
75
|
+
let maxX = Number.NEGATIVE_INFINITY;
|
|
76
|
+
let maxY = Number.NEGATIVE_INFINITY;
|
|
77
|
+
for (let index = 0; index < position.count; index += 1) {
|
|
78
|
+
minX = Math.min(minX, position.getX(index));
|
|
79
|
+
maxX = Math.max(maxX, position.getX(index));
|
|
80
|
+
minY = Math.min(minY, position.getY(index));
|
|
81
|
+
maxY = Math.max(maxY, position.getY(index));
|
|
82
|
+
}
|
|
83
|
+
const spanX = Math.max(maxX - minX, Number.EPSILON);
|
|
84
|
+
const spanY = Math.max(maxY - minY, Number.EPSILON);
|
|
85
|
+
const uv = new Float32Array(position.count * 2);
|
|
86
|
+
for (let index = 0; index < position.count; index += 1) {
|
|
87
|
+
uv[index * 2] = (position.getX(index) - minX) / spanX;
|
|
88
|
+
uv[index * 2 + 1] = (position.getY(index) - minY) / spanY;
|
|
89
|
+
}
|
|
90
|
+
object.geometry.setAttribute("uv", new BufferAttribute(uv, 2));
|
|
91
|
+
pennant = object;
|
|
40
92
|
}
|
|
41
93
|
});
|
|
94
|
+
if (pennant === undefined) throw new Error("Starter proof glTF did not contain a mesh.");
|
|
42
95
|
model.scene.name = "native-proof-assets";
|
|
43
|
-
this.#assetProof =
|
|
96
|
+
this.#assetProof = pennant;
|
|
44
97
|
console.info("TN_NATIVE_STARTER_ASSETS_LOADED:texture,glb");
|
|
45
98
|
}
|
|
46
99
|
|
|
47
100
|
override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
|
|
48
101
|
if (this.#assetProof === undefined) throw new Error("Starter proof assets did not load.");
|
|
49
|
-
this.#assetProof.position.set(0, 1.7, -1.5);
|
|
50
|
-
ctx.add(this.#assetProof);
|
|
51
102
|
const audio = ctx.entities.add("audio", new AudioBus({ camera: ctx.camera }));
|
|
52
|
-
const pickupAudio = ctx.assets.audio("pickup.
|
|
103
|
+
const pickupAudio = ctx.assets.audio("pickup.wav");
|
|
53
104
|
void pickupAudio.catch(() => undefined);
|
|
54
105
|
setupSky(ctx.scene);
|
|
55
|
-
setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
106
|
+
const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
|
|
107
|
+
// isMobile() arrives as an argument because src/render/ imports no framework package:
|
|
108
|
+
// the platform decision is made here, in portable game code, exactly like createRandom.
|
|
109
|
+
setupPost(ctx.renderer, ctx.scene, ctx.camera, {
|
|
110
|
+
godraysLight: sun,
|
|
111
|
+
mobile: isMobile(),
|
|
60
112
|
});
|
|
113
|
+
const loading = createLoadingScreen(ctx);
|
|
114
|
+
ctx.add(ctx.camera);
|
|
115
|
+
// Offset, lead and damping all live in render/camera.ts — framing is a look decision.
|
|
116
|
+
const springArm = createSpringArm(ctx.camera as PerspectiveCamera);
|
|
61
117
|
|
|
62
118
|
const materials = createMaterials();
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
ctx.
|
|
119
|
+
ctx.add(createScenery(materials.rock, materials.ridge, createRandom(20_260_821)));
|
|
120
|
+
// Two sentinels, both read by seed.playtest as an out-of-range value rather than as a
|
|
121
|
+
// transition: state.levelX starts at -99, so a level that never builds stays out of range,
|
|
122
|
+
// and seededLevelX becomes 2 if this draw did not advance ctx.random — which is what happens
|
|
123
|
+
// if someone swaps it for Math.random. Neither depends on WHEN the runner samples.
|
|
124
|
+
const randomStateBeforeLevel = ctx.random.state;
|
|
67
125
|
const levelX = ctx.random.range(-1, 1);
|
|
68
|
-
const
|
|
126
|
+
const seededLevelX = ctx.random.state === randomStateBeforeLevel ? 2 : levelX;
|
|
127
|
+
const pickupX = 1.2 + createRandom(Math.round((levelX + 1) * 1000))() * 0.8;
|
|
69
128
|
const floorMesh = new Mesh(roundedBox(10, 0.2, 4, 0.08), materials.floor);
|
|
70
129
|
floorMesh.position.y = -0.1;
|
|
71
130
|
floorMesh.receiveShadow = true;
|
|
@@ -97,11 +156,22 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
97
156
|
pickupVisual.castShadow = true;
|
|
98
157
|
ctx.add(pickupVisual);
|
|
99
158
|
ctx.entities.add("pickup", pickupVisual);
|
|
100
|
-
void ctx.tween(pickupVisual.position, { y: 0.65 }, 0.4);
|
|
159
|
+
void ctx.tween(pickupVisual.position, { y: 0.65 }, 0.4, { ease: pickupRiseEase });
|
|
101
160
|
springArm.snap(player.mesh.position);
|
|
102
|
-
ctx.state.set({ levelX });
|
|
103
161
|
ctx.entities.add("player", player);
|
|
104
|
-
|
|
162
|
+
// The packaged proof asset earns its place here: it is the pennant on the finish flag,
|
|
163
|
+
// not a debug object parked over the level. The texture and the glTF still load in
|
|
164
|
+
// `load()` above, which is what the native asset gate greps for.
|
|
165
|
+
const goal = ctx.entities.add("goal", new Goal(ctx, materials, this.#assetProof));
|
|
166
|
+
// The area says the character is over the island; the run is only won once it is also
|
|
167
|
+
// standing on it. Ending on the overlap alone freezes the character in mid-air at the
|
|
168
|
+
// lip of the island, half a metre short of a landing, which is what it looks like.
|
|
169
|
+
let overGoal = false;
|
|
170
|
+
goal.area.on("bodyEntered", (body) => {
|
|
171
|
+
if (body === player.body) overGoal = true;
|
|
172
|
+
});
|
|
173
|
+
let entityCount = 4;
|
|
174
|
+
ctx.state.set({ entityCount });
|
|
105
175
|
const pickup = new Area3D({
|
|
106
176
|
physics: ctx.physics,
|
|
107
177
|
position: { x: pickupX, y: 0.5, z: 0 },
|
|
@@ -111,13 +181,14 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
111
181
|
if (body !== player.body) return;
|
|
112
182
|
ctx.state.set((state) => ({ score: state.score + 1 }));
|
|
113
183
|
ctx.entities.remove("pickup");
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
});
|
|
184
|
+
entityCount -= 1;
|
|
185
|
+
ctx.state.set({ entityCount });
|
|
117
186
|
pickup.monitoring = false;
|
|
118
187
|
pickupVisual.visible = false;
|
|
119
188
|
ctx.after(3, () => {
|
|
120
189
|
ctx.entities.add("pickup", pickupVisual);
|
|
190
|
+
entityCount += 1;
|
|
191
|
+
ctx.state.set({ entityCount });
|
|
121
192
|
pickupVisual.visible = true;
|
|
122
193
|
pickup.monitoring = true;
|
|
123
194
|
});
|
|
@@ -125,11 +196,19 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
125
196
|
});
|
|
126
197
|
if (state.score > 0) {
|
|
127
198
|
ctx.entities.remove("pickup");
|
|
199
|
+
entityCount -= 1;
|
|
200
|
+
ctx.state.set({ entityCount });
|
|
128
201
|
pickup.monitoring = false;
|
|
129
202
|
pickupVisual.visible = false;
|
|
130
203
|
}
|
|
131
204
|
|
|
205
|
+
// Set with the level, not 0.25 s later. The delay existed so the playtest could observe the
|
|
206
|
+
// -99 -> seeded transition, which made the assertion a race against boot time: it was sampled
|
|
207
|
+
// at tick 6 on a workstation and tick 47 in CI, and only the slow sample missed the change.
|
|
208
|
+
ctx.state.set({ levelX: seededLevelX });
|
|
209
|
+
const frameState: Partial<GameState> = {};
|
|
132
210
|
return (frameCtx, dt) => {
|
|
211
|
+
loading.update();
|
|
133
212
|
// Restart resets the store before clearing entities and scheduled callbacks.
|
|
134
213
|
if (frameCtx.input.justPressed("restart")) {
|
|
135
214
|
frameCtx.state.set(Play.initialState);
|
|
@@ -137,24 +216,55 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
137
216
|
void frameCtx.goto("play");
|
|
138
217
|
return;
|
|
139
218
|
}
|
|
219
|
+
const previous = frameCtx.state.getState();
|
|
220
|
+
// A finished run stops simulating the character and keeps drawing the world behind
|
|
221
|
+
// the banner. R, or the restart button, rebuilds the scene from `initialState`.
|
|
222
|
+
if (previous.status !== "playing") return;
|
|
223
|
+
if (frameCtx.input.justPressed("flagGust")) {
|
|
224
|
+
goal.pennant.wind.set(0, 0.4, 4.5);
|
|
225
|
+
frameCtx.state.set((state) => ({ flagGusts: state.flagGusts + 1 }));
|
|
226
|
+
}
|
|
140
227
|
player.update(frameCtx, dt);
|
|
141
228
|
let respawned = false;
|
|
229
|
+
let lives = previous.lives;
|
|
142
230
|
if (player.mesh.position.y < KILL_PLANE) {
|
|
231
|
+
lives -= 1;
|
|
143
232
|
player.respawn();
|
|
144
233
|
springArm.snap(player.mesh.position);
|
|
145
234
|
respawned = true;
|
|
146
235
|
}
|
|
236
|
+
springArm.dolly(frameCtx.input.axis("zoom"), dt);
|
|
147
237
|
springArm.follow(player.mesh.position, dt);
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
frameCtx.state.set({
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
238
|
+
// `status` is written only on the frame that ends the run, and never in the bulk
|
|
239
|
+
// write below, which would stamp this frame's stale copy back over it.
|
|
240
|
+
if (lives <= 0) frameCtx.state.set({ status: "lost" });
|
|
241
|
+
else if (overGoal && player.grounded) {
|
|
242
|
+
frameCtx.state.set({ status: "won" });
|
|
243
|
+
frameCtx.state.flush();
|
|
244
|
+
}
|
|
245
|
+
frameState.coyoteJumps = player.coyoteJumps;
|
|
246
|
+
frameState.flagDisplacement = Math.max(previous.flagDisplacement, goal.flagDisplacement());
|
|
247
|
+
frameState.flagReadbacks = goal.readbackLands();
|
|
248
|
+
frameState.flagSteps = goal.pennant.steps;
|
|
249
|
+
frameState.jumps = player.jumps;
|
|
250
|
+
frameState.lives = lives;
|
|
251
|
+
frameState.odometer = player.odometer;
|
|
252
|
+
frameState.peakRise = Math.max(previous.peakRise, player.mesh.position.y - 0.5);
|
|
253
|
+
frameState.playerX = player.mesh.position.x;
|
|
254
|
+
frameState.respawns = previous.respawns + (respawned ? 1 : 0);
|
|
255
|
+
const current = frameCtx.state.getState();
|
|
256
|
+
const changed =
|
|
257
|
+
frameState.coyoteJumps !== current.coyoteJumps ||
|
|
258
|
+
frameState.flagDisplacement !== current.flagDisplacement ||
|
|
259
|
+
frameState.flagReadbacks !== current.flagReadbacks ||
|
|
260
|
+
frameState.flagSteps !== current.flagSteps ||
|
|
261
|
+
frameState.jumps !== current.jumps ||
|
|
262
|
+
frameState.lives !== current.lives ||
|
|
263
|
+
frameState.odometer !== current.odometer ||
|
|
264
|
+
frameState.peakRise !== current.peakRise ||
|
|
265
|
+
frameState.playerX !== current.playerX ||
|
|
266
|
+
frameState.respawns !== current.respawns;
|
|
267
|
+
if (changed) frameCtx.state.set(frameState);
|
|
158
268
|
if (respawned) frameCtx.state.flush();
|
|
159
269
|
};
|
|
160
270
|
}
|
|
@@ -1,10 +1,22 @@
|
|
|
1
1
|
export type GameState = {
|
|
2
2
|
coyoteJumps: number;
|
|
3
3
|
entityCount: number;
|
|
4
|
+
flagDisplacement: number;
|
|
5
|
+
flagGusts: number;
|
|
6
|
+
flagReadbacks: number;
|
|
7
|
+
flagSteps: number;
|
|
4
8
|
jumps: number;
|
|
5
9
|
levelX: number;
|
|
10
|
+
lives: number;
|
|
11
|
+
odometer: number;
|
|
12
|
+
/** Set from the UI's pause and resume intents, and read back by the menu. */
|
|
13
|
+
paused: boolean;
|
|
14
|
+
/** True once the UI layer has rendered and published its interactive rectangles. */
|
|
15
|
+
uiReady: boolean;
|
|
6
16
|
peakRise: number;
|
|
7
17
|
playerX: number;
|
|
8
18
|
respawns: number;
|
|
9
19
|
score: number;
|
|
20
|
+
/** The run: "playing" until the flag is reached ("won") or the last life is gone ("lost"). */
|
|
21
|
+
status: "lost" | "playing" | "won";
|
|
10
22
|
};
|
|
@@ -38,8 +38,52 @@ body,
|
|
|
38
38
|
}
|
|
39
39
|
|
|
40
40
|
body {
|
|
41
|
-
background: var(--color-ink);
|
|
42
41
|
color: var(--color-text);
|
|
43
42
|
font-family: var(--font-mono);
|
|
44
43
|
-webkit-font-smoothing: antialiased;
|
|
45
44
|
}
|
|
45
|
+
|
|
46
|
+
/*
|
|
47
|
+
* The page's backdrop belongs to the web document's own mount point, never to `body`.
|
|
48
|
+
* `src/ui/main.tsx` imports this same stylesheet, and on native that file is what the platform's
|
|
49
|
+
* transparent web view loads over the game: a `body` background there paints an opaque sheet over
|
|
50
|
+
* the frame the game just rendered, and the HUD appears to float on nothing. `#root` exists only
|
|
51
|
+
* in the web page, so the backdrop stays where it belongs and the UI layer stays see-through.
|
|
52
|
+
*/
|
|
53
|
+
|
|
54
|
+
#root {
|
|
55
|
+
background: var(--color-ink);
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/* The debug surface is framework plumbing; its default presentation is yours to change. */
|
|
59
|
+
[data-threenative-debug-overlay="true"] {
|
|
60
|
+
position: fixed;
|
|
61
|
+
top: 1rem;
|
|
62
|
+
right: 1rem;
|
|
63
|
+
z-index: 50;
|
|
64
|
+
max-width: 24rem;
|
|
65
|
+
padding: 0.75rem;
|
|
66
|
+
pointer-events: none;
|
|
67
|
+
background: rgb(2 6 23 / 90%);
|
|
68
|
+
box-shadow: 0 10px 15px -3px rgb(0 0 0 / 30%);
|
|
69
|
+
color: #cffafe;
|
|
70
|
+
font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
|
|
71
|
+
font-size: 12px;
|
|
72
|
+
line-height: 1.5;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
[data-threenative-debug-overlay="true"] table {
|
|
76
|
+
width: 100%;
|
|
77
|
+
table-layout: fixed;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
[data-threenative-debug-overlay="true"] th,
|
|
81
|
+
[data-threenative-debug-overlay="true"] td {
|
|
82
|
+
padding-right: 1rem;
|
|
83
|
+
text-align: left;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
[data-threenative-debug-overlay="true"] td:last-child {
|
|
87
|
+
overflow-wrap: anywhere;
|
|
88
|
+
word-break: break-all;
|
|
89
|
+
}
|
|
@@ -2,17 +2,20 @@ import type { IGame } from "@threenative/core";
|
|
|
2
2
|
import type { IPhysicsContext } from "@threenative/physics";
|
|
3
3
|
import { DebugOverlay, GameCanvas } from "@threenative/ui";
|
|
4
4
|
import type { GameState } from "../state.js";
|
|
5
|
-
import {
|
|
6
|
-
import { Menu } from "./Menu.js";
|
|
5
|
+
import { GameUi } from "./GameUi.js";
|
|
7
6
|
|
|
7
|
+
/**
|
|
8
|
+
* The web target's page: the canvas, then the same UI every other target renders.
|
|
9
|
+
*
|
|
10
|
+
* `GameCanvas` hosts the renderer and everything after it paints on top; keep the canvas first.
|
|
11
|
+
* The UI itself comes from `GameUi`, unchanged — this file exists only because the web build also
|
|
12
|
+
* has to put a canvas on the page.
|
|
13
|
+
*/
|
|
8
14
|
export function App({ game }: { game: IGame<GameState, IPhysicsContext> }) {
|
|
9
15
|
return (
|
|
10
|
-
// GameCanvas hosts the renderer; everything after it in this list paints on
|
|
11
|
-
// top. Keep the canvas first.
|
|
12
16
|
<main className="relative h-screen w-screen overflow-hidden bg-ink">
|
|
13
17
|
<GameCanvas className="absolute inset-0" game={game} />
|
|
14
|
-
<
|
|
15
|
-
<Menu game={game} />
|
|
18
|
+
<GameUi />
|
|
16
19
|
<DebugOverlay />
|
|
17
20
|
</main>
|
|
18
21
|
);
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { UiLayer } from "@threenative/ui";
|
|
2
|
+
import { Hud } from "./Hud.js";
|
|
3
|
+
import { Menu } from "./Menu.js";
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Everything the player sees that is not the scene.
|
|
7
|
+
*
|
|
8
|
+
* One component, mounted twice by two entries that differ only in what else is on the page:
|
|
9
|
+
* `src/main.ts` puts it beside the canvas on the web target, and `src/ui/main.tsx` is the whole
|
|
10
|
+
* page the native web view loads. Keeping both entries pointed at this file is what makes "the
|
|
11
|
+
* same UI on every target" a fact rather than an intention.
|
|
12
|
+
*/
|
|
13
|
+
export function GameUi() {
|
|
14
|
+
return (
|
|
15
|
+
<UiLayer>
|
|
16
|
+
<Hud />
|
|
17
|
+
<Menu />
|
|
18
|
+
</UiLayer>
|
|
19
|
+
);
|
|
20
|
+
}
|
|
@@ -1,37 +1,60 @@
|
|
|
1
|
-
import
|
|
2
|
-
import type { IPhysicsContext } from "@threenative/physics";
|
|
3
|
-
import { useGameState } from "@threenative/ui";
|
|
1
|
+
import { useUiState } from "@threenative/ui";
|
|
4
2
|
import type { GameState } from "../state.js";
|
|
5
3
|
|
|
6
4
|
/**
|
|
7
|
-
*
|
|
8
|
-
*
|
|
5
|
+
* The HUD. Plain Tailwind, plain SVG, plain DOM — and the same file on every target.
|
|
6
|
+
*
|
|
7
|
+
* There is no second renderer to keep in step: on web this mounts beside the canvas, and on a
|
|
8
|
+
* phone or a desktop the same bundle renders in the platform's own web view over the game surface.
|
|
9
|
+
* Style it however you like; nothing here is a vocabulary the framework has to understand.
|
|
10
|
+
*
|
|
11
|
+
* `useUiState` reads the game's *published* state, which moves at about 10 Hz rather than at the
|
|
12
|
+
* frame rate, and is undefined until the game publishes its first snapshot.
|
|
9
13
|
*/
|
|
10
|
-
function
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
<div className="relative mt-1 h-1 overflow-hidden border border-line bg-panel">
|
|
18
|
-
<i
|
|
19
|
-
className="absolute inset-y-0 left-0 bg-lume"
|
|
20
|
-
style={{ width: `${Math.max(0, Math.min(100, value))}%` }}
|
|
21
|
-
/>
|
|
22
|
-
</div>
|
|
23
|
-
</div>
|
|
24
|
-
);
|
|
25
|
-
}
|
|
14
|
+
export function Hud() {
|
|
15
|
+
const state = useUiState<GameState>();
|
|
16
|
+
// Nothing to draw until the game publishes its first snapshot, a few milliseconds in. Rendering
|
|
17
|
+
// zeroes instead would put a wrong score on screen and then correct it.
|
|
18
|
+
if (state === undefined) return null;
|
|
19
|
+
const position = Math.max(0, Math.min(100, Math.abs(state.playerX) * 10));
|
|
20
|
+
const won = state.status === "won";
|
|
26
21
|
|
|
27
|
-
export function Hud({ game }: { game: IGame<GameState, IPhysicsContext> }) {
|
|
28
|
-
const score = useGameState(game, (state) => state.score);
|
|
29
|
-
const playerX = useGameState(game, (state) => state.playerX);
|
|
30
22
|
return (
|
|
31
|
-
|
|
32
|
-
<div className="
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
23
|
+
<>
|
|
24
|
+
<div className="pointer-events-none absolute left-6 top-6 w-32">
|
|
25
|
+
<div className="text-[10px] uppercase tracking-[0.14em] text-dim">score</div>
|
|
26
|
+
<div className="text-4xl leading-none tabular-nums text-lume">{state.score}</div>
|
|
27
|
+
<div className="mt-3 flex items-center gap-2 text-[10px] uppercase tracking-[0.14em] text-dim">
|
|
28
|
+
lives
|
|
29
|
+
{[0, 1, 2].map((slot) => (
|
|
30
|
+
<i
|
|
31
|
+
className={`h-2 w-2 border border-line ${slot < state.lives ? "bg-lume" : "bg-panel"}`}
|
|
32
|
+
key={slot}
|
|
33
|
+
/>
|
|
34
|
+
))}
|
|
35
|
+
</div>
|
|
36
|
+
<div className="mt-3 w-24">
|
|
37
|
+
<div className="flex justify-between gap-2 text-[10px] uppercase tracking-[0.14em] text-dim">
|
|
38
|
+
<span>position</span>
|
|
39
|
+
<b className="font-normal tabular-nums text-text">{Math.round(position)}</b>
|
|
40
|
+
</div>
|
|
41
|
+
<div className="relative mt-1 h-1 overflow-hidden border border-line bg-panel">
|
|
42
|
+
<i className="absolute inset-y-0 left-0 bg-lume" style={{ width: `${position}%` }} />
|
|
43
|
+
</div>
|
|
44
|
+
</div>
|
|
45
|
+
</div>
|
|
46
|
+
{state.status === "playing" ? null : (
|
|
47
|
+
<div className="pointer-events-none absolute inset-x-0 top-1/3 flex flex-col items-center gap-2">
|
|
48
|
+
<output
|
|
49
|
+
className={`text-5xl uppercase tracking-[0.2em] ${won ? "text-lume" : "text-text"}`}
|
|
50
|
+
>
|
|
51
|
+
{won ? "flag reached" : "out of lives"}
|
|
52
|
+
</output>
|
|
53
|
+
<div className="text-[11px] uppercase tracking-[0.14em] text-dim">
|
|
54
|
+
press r to run it again
|
|
55
|
+
</div>
|
|
56
|
+
</div>
|
|
57
|
+
)}
|
|
58
|
+
</>
|
|
36
59
|
);
|
|
37
60
|
}
|
|
@@ -1,39 +1,41 @@
|
|
|
1
|
-
import
|
|
2
|
-
import type { IPhysicsContext } from "@threenative/physics";
|
|
3
|
-
import { type KeyboardEvent, useState } from "react";
|
|
1
|
+
import { useUiIntent, useUiState } from "@threenative/ui";
|
|
4
2
|
import type { GameState } from "../state.js";
|
|
5
3
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
4
|
+
/**
|
|
5
|
+
* The menu, and the one thing a UI has to do differently from a plain web app: say which of its
|
|
6
|
+
* elements the player can touch.
|
|
7
|
+
*
|
|
8
|
+
* `data-tn-interactive` is that mark. The native input host publishes those rectangles and decides,
|
|
9
|
+
* on pointer-down, whether a touch belongs to the UI or to the game underneath. Everything without
|
|
10
|
+
* the mark is scenery, and a touch on it reaches the game — which is what lets a HUD cover the
|
|
11
|
+
* screen without swallowing the controls.
|
|
12
|
+
*
|
|
13
|
+
* `pointer-events` is still worth setting for the web target's own hit-testing; it is not what
|
|
14
|
+
* makes a touch fall through on a phone, and marking a button with it instead is the one mistake
|
|
15
|
+
* this comment exists to prevent.
|
|
16
|
+
*/
|
|
17
|
+
export function Menu() {
|
|
18
|
+
const send = useUiIntent();
|
|
19
|
+
const state = useUiState<GameState>();
|
|
20
|
+
if (state === undefined) return null;
|
|
21
|
+
const paused = state.paused;
|
|
21
22
|
|
|
22
23
|
return (
|
|
23
24
|
<div className="pointer-events-none absolute bottom-6 left-6 flex items-center gap-3 border border-line bg-panel/75 px-4 py-3 text-[11px] uppercase tracking-[0.14em] text-dim">
|
|
24
|
-
<span>WASD / arrows to move ·
|
|
25
|
+
<span>WASD / arrows to move · space to jump the gap · reach the flag</span>
|
|
25
26
|
<button
|
|
26
|
-
className="pointer-events-auto border border-line px-2 py-1 text-text hover:border-lume"
|
|
27
27
|
aria-pressed={paused}
|
|
28
|
-
|
|
29
|
-
|
|
28
|
+
className="pointer-events-auto border border-line px-2 py-1 text-text hover:border-lume"
|
|
29
|
+
data-tn-interactive
|
|
30
|
+
onClick={() => send(paused ? "resume" : "pause")}
|
|
30
31
|
type="button"
|
|
31
32
|
>
|
|
32
33
|
{paused ? "resume" : "pause"}
|
|
33
34
|
</button>
|
|
34
35
|
<button
|
|
35
36
|
className="pointer-events-auto border border-line px-2 py-1 text-text hover:border-lume"
|
|
36
|
-
|
|
37
|
+
data-tn-interactive
|
|
38
|
+
onClick={() => send("restart")}
|
|
37
39
|
type="button"
|
|
38
40
|
>
|
|
39
41
|
restart
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { createRoot } from "react-dom/client";
|
|
2
|
+
import { GameUi } from "./GameUi.js";
|
|
3
|
+
import "../style.css";
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* The UI entry the native web view loads.
|
|
7
|
+
*
|
|
8
|
+
* It mounts the UI and nothing else — no scene, no simulation, no renderer. The game runs beside
|
|
9
|
+
* it in the native runtime and reaches it only through published state and intents, which is why
|
|
10
|
+
* this file imports no game code at all.
|
|
11
|
+
*/
|
|
12
|
+
const root = document.getElementById("tn-ui");
|
|
13
|
+
if (root === null) throw new Error("Missing #tn-ui element.");
|
|
14
|
+
createRoot(root).render(<GameUi />);
|
|
@@ -1,17 +1,19 @@
|
|
|
1
1
|
import type { IThreeNativeConfig } from "@threenative/core";
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
const config: IThreeNativeConfig = {
|
|
4
4
|
app: {
|
|
5
5
|
id: "com.threenative.__PROJECT_ID__",
|
|
6
6
|
name: "__PROJECT_NAME__",
|
|
7
7
|
version: "1.0.0",
|
|
8
8
|
build: 1,
|
|
9
9
|
icon: "public/icon.png",
|
|
10
|
+
icons: { web: { favicon: "public/favicon.svg" } },
|
|
10
11
|
},
|
|
11
12
|
display: {
|
|
12
13
|
orientation: "landscape", // Mobile viewport orientation.
|
|
13
14
|
fullscreen: true, // Keep the game surface edge to edge.
|
|
14
15
|
keepScreenOn: true, // Do not dim during a play session.
|
|
16
|
+
maxFps: 60, // Set 120 to opt into a supported high-refresh display mode.
|
|
15
17
|
},
|
|
16
18
|
window: {
|
|
17
19
|
title: "__PROJECT_NAME__", // Desktop window title.
|
|
@@ -19,13 +21,29 @@ export default {
|
|
|
19
21
|
height: 720,
|
|
20
22
|
resizable: true,
|
|
21
23
|
},
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
trackColor: "#274060",
|
|
25
|
-
progressColor: "#8fd694",
|
|
26
|
-
showProgressBar: true,
|
|
27
|
-
// image: "public/logo.png", // drawn centred above the bar
|
|
24
|
+
bootSplash: {
|
|
25
|
+
backgroundColor: "#0d1b2a",
|
|
28
26
|
},
|
|
29
27
|
nativeEntry: "src/game.ts",
|
|
30
|
-
renderer: {
|
|
31
|
-
|
|
28
|
+
renderer: {
|
|
29
|
+
preferWebGPU: true, // Use WebGPU when the host exposes it.
|
|
30
|
+
// The engine holds the `display.maxFps` budget by scaling the 3D drawing buffer, and reports
|
|
31
|
+
// the scale it settled on in every `TN_FRAME_BUDGET` window. Replace with a number in (0, 1]
|
|
32
|
+
// to pin it — the loop stops and the reporting does not. CSS, UI and camera framing never move.
|
|
33
|
+
resolutionScale: "auto",
|
|
34
|
+
},
|
|
35
|
+
assets: {
|
|
36
|
+
// Mobile has no WebAssembly, so neither Basis-decoded textures nor Meshopt-decoded geometry
|
|
37
|
+
// can ship there — and these demo assets are tiny enough that compression only ever grew
|
|
38
|
+
// them. Ship exactly what is committed.
|
|
39
|
+
models: "none",
|
|
40
|
+
textures: "none",
|
|
41
|
+
},
|
|
42
|
+
// One UI on every target: src/ui/ renders through the platform's own browser-class renderer,
|
|
43
|
+
// so the same React, Tailwind, CSS and SVG run on web, desktop, Android and iOS alike.
|
|
44
|
+
// Switch to "native" for a UI drawn as part of the rendered frame, with no web view and no
|
|
45
|
+
// extra process — and own the appearance difference that comes with it.
|
|
46
|
+
ui: { renderer: "web" },
|
|
47
|
+
};
|
|
48
|
+
|
|
49
|
+
export default config;
|