create-threenative 0.2.7 → 0.2.8
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 +3 -1
- package/agent-docs/references/capability-reference.md +177 -7
- package/capabilities.json +247 -4
- package/dist/index.js +6 -1
- package/dist/threenative.js +3 -2
- package/package.json +4 -4
- package/templates/action-rpg/package.json +1 -1
- package/templates/minimal/package.json +1 -1
- package/templates/platformer/package.json +1 -1
- package/templates/puzzle/package.json +1 -1
- package/templates/racing/package.json +1 -1
- package/templates/rain/.codex/config.toml +19 -0
- package/templates/rain/.cursor/mcp.json +32 -0
- package/templates/rain/.gemini/settings.json +32 -0
- package/templates/rain/.mcp.json +32 -0
- package/templates/rain/.vscode/mcp.json +36 -0
- package/templates/rain/.zed/settings.json +36 -0
- package/templates/rain/AGENTS.md +96 -0
- package/templates/rain/CLAUDE.md +98 -0
- package/templates/rain/assets/rain-loop.wav +0 -0
- package/templates/rain/assets/thunder.wav +0 -0
- package/templates/rain/assets/wind-loop.wav +0 -0
- package/templates/rain/index.html +18 -0
- package/templates/rain/kit.json +7 -0
- package/templates/rain/native-playtests/boot.playtest.json +13 -0
- package/templates/rain/native-playtests/lightning.playtest.json +173 -0
- package/templates/rain/opencode.json +41 -0
- package/templates/rain/package.json +56 -0
- package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
- package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
- package/templates/rain/playtests/automation.playtest.json +133 -0
- package/templates/rain/playtests/cinematic.playtest.json +59 -0
- package/templates/rain/playtests/flash.playtest.json +27 -0
- package/templates/rain/playtests/fly.playtest.json +54 -0
- package/templates/rain/playtests/lightning.playtest.json +220 -0
- package/templates/rain/playtests/loading.playtest.json +57 -0
- package/templates/rain/playtests/paused.playtest.json +59 -0
- package/templates/rain/playtests/performance.playtest.json +22 -0
- package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
- package/templates/rain/playtests/simulation.playtest.json +20 -0
- package/templates/rain/playtests/storm.playtest.json +150 -0
- package/templates/rain/playtests/survives.playtest.json +58 -0
- package/templates/rain/playtests/tiers.playtest.json +179 -0
- package/templates/rain/playtests/weather.playtest.json +77 -0
- package/templates/rain/public/favicon.svg +5 -0
- package/templates/rain/src/audio/storm.ts +314 -0
- package/templates/rain/src/game.ts +114 -0
- package/templates/rain/src/main.ts +15 -0
- package/templates/rain/src/render/bloom-shader.ts +65 -0
- package/templates/rain/src/render/camera.ts +160 -0
- package/templates/rain/src/render/clouds-shader.ts +242 -0
- package/templates/rain/src/render/clouds.ts +142 -0
- package/templates/rain/src/render/lighting.ts +39 -0
- package/templates/rain/src/render/lightning.ts +360 -0
- package/templates/rain/src/render/loading.ts +327 -0
- package/templates/rain/src/render/materials.ts +19 -0
- package/templates/rain/src/render/noise-volume.ts +159 -0
- package/templates/rain/src/render/palette.ts +18 -0
- package/templates/rain/src/render/post-shader.ts +178 -0
- package/templates/rain/src/render/postprocessing.ts +226 -0
- package/templates/rain/src/render/quality.ts +135 -0
- package/templates/rain/src/render/rain.ts +299 -0
- package/templates/rain/src/render/sky.ts +28 -0
- package/templates/rain/src/render/world-shader.ts +680 -0
- package/templates/rain/src/render/world.ts +146 -0
- package/templates/rain/src/render/worldEnvironment.ts +809 -0
- package/templates/rain/src/scenes/Boot.ts +334 -0
- package/templates/rain/src/state.ts +257 -0
- package/templates/rain/src/style.css +1160 -0
- package/templates/rain/src/ui/App.tsx +29 -0
- package/templates/rain/src/ui/GameUi.tsx +187 -0
- package/templates/rain/src/ui/Hud.tsx +327 -0
- package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
- package/templates/rain/src/ui/Menu.tsx +370 -0
- package/templates/rain/src/ui/automation.ts +60 -0
- package/templates/rain/src/ui/main.tsx +7 -0
- package/templates/rain/src/ui/tempest.ts +149 -0
- package/templates/rain/tailwind.config.ts +2 -0
- package/templates/rain/threenative.config.ts +66 -0
- package/templates/rain/tools/generate-shaders.mjs +656 -0
- package/templates/rain/tools/make-storm-audio.mjs +387 -0
- package/templates/rain/tools/storm-dsp.mjs +177 -0
- package/templates/rain/tools/tempest-bloom.frag +10 -0
- package/templates/rain/tools/tempest-clouds.frag +86 -0
- package/templates/rain/tools/tempest-post.frag +47 -0
- package/templates/rain/tools/tempest-world.frag +210 -0
- package/templates/rain/tools/verify-noise-volume.mjs +61 -0
- package/templates/rain/tsconfig.json +17 -0
- package/templates/rain/vite.config.ts +37 -0
- package/templates/rts/package.json +1 -1
- package/templates/runner/package.json +1 -1
- package/templates/sailing/package.json +1 -1
- package/templates/shooter/package.json +1 -1
- package/templates/snow/.codex/config.toml +19 -0
- package/templates/snow/.cursor/mcp.json +32 -0
- package/templates/snow/.gemini/settings.json +32 -0
- package/templates/snow/.mcp.json +32 -0
- package/templates/snow/.vscode/mcp.json +36 -0
- package/templates/snow/.zed/settings.json +36 -0
- package/templates/snow/AGENTS.md +88 -0
- package/templates/snow/CLAUDE.md +90 -0
- package/templates/snow/README.md +26 -0
- package/templates/snow/assets/crunch.wav +0 -0
- package/templates/snow/assets/wind.wav +0 -0
- package/templates/snow/index.html +12 -0
- package/templates/snow/kit.json +7 -0
- package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
- package/templates/snow/native-playtests/survives.playtest.json +47 -0
- package/templates/snow/opencode.json +41 -0
- package/templates/snow/package.json +58 -0
- package/templates/snow/playtests/footsteps.playtest.json +95 -0
- package/templates/snow/playtests/performance.playtest.json +36 -0
- package/templates/snow/playtests/snow-physics.playtest.json +154 -0
- package/templates/snow/playtests/survives.playtest.json +56 -0
- package/templates/snow/playtests/touch-controls.playtest.json +71 -0
- package/templates/snow/playtests/weather.playtest.json +119 -0
- package/templates/snow/public/favicon.svg +5 -0
- package/templates/snow/src/audio.ts +58 -0
- package/templates/snow/src/commands.ts +8 -0
- package/templates/snow/src/entities/Explorer.ts +279 -0
- package/templates/snow/src/game.ts +69 -0
- package/templates/snow/src/main.ts +15 -0
- package/templates/snow/src/render/bootPrint.ts +50 -0
- package/templates/snow/src/render/camera.ts +84 -0
- package/templates/snow/src/render/explorer.ts +321 -0
- package/templates/snow/src/render/lighting.ts +50 -0
- package/templates/snow/src/render/loading.ts +325 -0
- package/templates/snow/src/render/materials.ts +36 -0
- package/templates/snow/src/render/palette.ts +17 -0
- package/templates/snow/src/render/postprocessing.ts +44 -0
- package/templates/snow/src/render/props.ts +42 -0
- package/templates/snow/src/render/quality.ts +135 -0
- package/templates/snow/src/render/scenery.ts +244 -0
- package/templates/snow/src/render/sky.ts +57 -0
- package/templates/snow/src/render/snowSurface.ts +259 -0
- package/templates/snow/src/render/touch-controls.ts +143 -0
- package/templates/snow/src/render/weather.ts +279 -0
- package/templates/snow/src/render/worldEnvironment.ts +809 -0
- package/templates/snow/src/scenes/Boot.ts +12 -0
- package/templates/snow/src/scenes/Snow.ts +635 -0
- package/templates/snow/src/state.ts +46 -0
- package/templates/snow/src/style.css +143 -0
- package/templates/snow/src/terrain.ts +64 -0
- package/templates/snow/src/ui/App.tsx +15 -0
- package/templates/snow/src/ui/Controls.tsx +322 -0
- package/templates/snow/src/ui/GameUi.tsx +354 -0
- package/templates/snow/src/ui/icons.tsx +54 -0
- package/templates/snow/src/ui/main.tsx +7 -0
- package/templates/snow/tailwind.config.ts +2 -0
- package/templates/snow/threenative.config.ts +51 -0
- package/templates/snow/tsconfig.json +17 -0
- package/templates/snow/vite.config.ts +37 -0
- package/templates/starter/package.json +1 -1
- package/templates/tower-defense/package.json +1 -1
|
@@ -0,0 +1,279 @@
|
|
|
1
|
+
import type { SnowField } from "@threenative/core/world";
|
|
2
|
+
import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
|
|
3
|
+
import { Object3D } from "three";
|
|
4
|
+
import { BOOT_AREA, bootPrint } from "../render/bootPrint.js";
|
|
5
|
+
import { ExplorerModel, type IFootPose } from "../render/explorer.js";
|
|
6
|
+
import type { SnowMaterials } from "../render/materials.js";
|
|
7
|
+
import { EXPLORER_LAYER, SNOW_LAYER, terrainHeight } from "../terrain.js";
|
|
8
|
+
|
|
9
|
+
/** One planted boot: where, how it was turned, and how far it sank. */
|
|
10
|
+
export interface IFootstep {
|
|
11
|
+
readonly x: number;
|
|
12
|
+
readonly y: number;
|
|
13
|
+
readonly z: number;
|
|
14
|
+
readonly angle: number;
|
|
15
|
+
readonly penetration: number;
|
|
16
|
+
readonly speed: number;
|
|
17
|
+
readonly side: number;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
interface IFoot extends IFootPose {
|
|
21
|
+
side: number;
|
|
22
|
+
x: number;
|
|
23
|
+
y: number;
|
|
24
|
+
z: number;
|
|
25
|
+
angle: number;
|
|
26
|
+
swing: boolean;
|
|
27
|
+
progress: number;
|
|
28
|
+
stop: number;
|
|
29
|
+
from: { x: number; z: number };
|
|
30
|
+
to: { x: number; z: number };
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** The explorer's weight, which every planted boot presses into the snow. */
|
|
34
|
+
const MASS = 80;
|
|
35
|
+
const GRAVITY = 9.81;
|
|
36
|
+
/** Capsule straight half-length and radius: 1.7 m tall, origin at the waist. */
|
|
37
|
+
const HALF_HEIGHT = 0.55;
|
|
38
|
+
const RADIUS = 0.3;
|
|
39
|
+
const WAIST = HALF_HEIGHT + RADIUS;
|
|
40
|
+
/**
|
|
41
|
+
* How far each boot lands from the line of travel. Wide enough that the left and right prints
|
|
42
|
+
* stay two rows with snow between them rather than merging into one trench.
|
|
43
|
+
*/
|
|
44
|
+
export const STANCE = 0.2;
|
|
45
|
+
|
|
46
|
+
const clamp = (value: number, low: number, high: number) => Math.max(low, Math.min(high, value));
|
|
47
|
+
const lerp = (a: number, b: number, t: number) => a + (b - a) * t;
|
|
48
|
+
const damp = (a: number, b: number, rate: number, dt: number) =>
|
|
49
|
+
lerp(a, b, 1 - Math.exp(-rate * Math.max(0, dt)));
|
|
50
|
+
const smoothstep = (edge0: number, edge1: number, value: number) => {
|
|
51
|
+
const t = clamp((value - edge0) / (edge1 - edge0), 0, 1);
|
|
52
|
+
return t * t * (3 - 2 * t);
|
|
53
|
+
};
|
|
54
|
+
|
|
55
|
+
/** Walking pace through powder: deeper, softer snow is slower; packed snow is faster. */
|
|
56
|
+
function paceThrough(depth: number, compaction: number, running: boolean): number {
|
|
57
|
+
const resistance = clamp(depth, 0, 0.6) * (1 - clamp(compaction, 0, 1) * 0.75);
|
|
58
|
+
return (running ? 3.25 : 1.65) / (1 + resistance * 3.5);
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* The procedural explorer. Movement goes through a `CharacterBody3D`, so trees, rocks and the
|
|
63
|
+
* ball stop or get pushed by real collision; each boot is planted by the walk cycle, and only a
|
|
64
|
+
* grounded body plants one. A planted boot presses `bootPrint` into the snow with the explorer's
|
|
65
|
+
* own weight over the sole's area — the snow decides how deep that goes.
|
|
66
|
+
*/
|
|
67
|
+
export class Explorer {
|
|
68
|
+
readonly body: CharacterBody3D;
|
|
69
|
+
readonly model: ExplorerModel;
|
|
70
|
+
/** What a playtest or camera tracks: the drawn explorer, not the collision capsule. */
|
|
71
|
+
readonly object: Object3D;
|
|
72
|
+
readonly position = { x: 0, y: 0, z: 0 };
|
|
73
|
+
heading = Math.PI;
|
|
74
|
+
speed = 0;
|
|
75
|
+
steps = 0;
|
|
76
|
+
#velocity = { x: 0, z: 0 };
|
|
77
|
+
#cycle = 0.1;
|
|
78
|
+
#elapsed = 0;
|
|
79
|
+
#last = { x: 0, z: 0 };
|
|
80
|
+
readonly #feet: IFoot[] = [];
|
|
81
|
+
readonly #snow: SnowField;
|
|
82
|
+
readonly #onStep: (step: IFootstep) => void;
|
|
83
|
+
|
|
84
|
+
constructor(
|
|
85
|
+
physics: IPhysicsContext,
|
|
86
|
+
snow: SnowField,
|
|
87
|
+
materials: SnowMaterials,
|
|
88
|
+
start: { x: number; z: number },
|
|
89
|
+
onStep: (step: IFootstep) => void,
|
|
90
|
+
) {
|
|
91
|
+
this.#snow = snow;
|
|
92
|
+
this.#onStep = onStep;
|
|
93
|
+
const anchor = new Object3D();
|
|
94
|
+
anchor.position.set(start.x, snow.heightAt(start.x, start.z) + WAIST + 0.05, start.z);
|
|
95
|
+
this.body = new CharacterBody3D({
|
|
96
|
+
autostep: { maxHeight: 0.25, minWidth: 0.1 },
|
|
97
|
+
maxSlopeClimbAngle: 0.8,
|
|
98
|
+
object: anchor,
|
|
99
|
+
physics,
|
|
100
|
+
// Stands on the coarse walk surface, never the 6 cm snow collider (see `WALK_SAMPLES`).
|
|
101
|
+
collisionLayer: EXPLORER_LAYER,
|
|
102
|
+
collisionMask: 0xffff & ~SNOW_LAYER,
|
|
103
|
+
pushesDynamicBodies: true,
|
|
104
|
+
shape: CollisionShape3D.capsule(HALF_HEIGHT, RADIUS),
|
|
105
|
+
snapToGround: 0.3,
|
|
106
|
+
});
|
|
107
|
+
this.model = new ExplorerModel(materials);
|
|
108
|
+
this.object = this.model.root;
|
|
109
|
+
this.position.x = start.x;
|
|
110
|
+
this.position.z = start.z;
|
|
111
|
+
this.position.y = snow.heightAt(start.x, start.z) - 0.07;
|
|
112
|
+
this.#last = { x: start.x, z: start.z };
|
|
113
|
+
for (const side of [-1, 1]) {
|
|
114
|
+
const x = start.x + side * STANCE * Math.cos(this.heading);
|
|
115
|
+
const z = start.z - side * STANCE * Math.sin(this.heading);
|
|
116
|
+
this.#feet.push({
|
|
117
|
+
angle: this.heading,
|
|
118
|
+
from: { x, z },
|
|
119
|
+
progress: 0,
|
|
120
|
+
side,
|
|
121
|
+
stop: 0,
|
|
122
|
+
swing: false,
|
|
123
|
+
to: { x, z },
|
|
124
|
+
x,
|
|
125
|
+
y: snow.heightAt(x, z) + 0.14,
|
|
126
|
+
z,
|
|
127
|
+
});
|
|
128
|
+
}
|
|
129
|
+
this.model.pose(this.position, this.heading, this.#feet, this.#cycle, 0, 0);
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/** Steer towards `move` (a world-space direction, length up to 1) for one fixed step. */
|
|
133
|
+
update(dt: number, move: { x: number; z: number }, running: boolean, hardness: number): void {
|
|
134
|
+
this.#elapsed += dt;
|
|
135
|
+
const snow = this.#snow;
|
|
136
|
+
const anchor = this.body.object.position;
|
|
137
|
+
// The walk cycle advances by the ground the body actually covered, so a blocked explorer
|
|
138
|
+
// treads in place instead of skating.
|
|
139
|
+
const travelled = Math.hypot(anchor.x - this.#last.x, anchor.z - this.#last.z);
|
|
140
|
+
this.speed = travelled / Math.max(1e-4, dt);
|
|
141
|
+
this.#last = { x: anchor.x, z: anchor.z };
|
|
142
|
+
this.position.x = anchor.x;
|
|
143
|
+
this.position.z = anchor.z;
|
|
144
|
+
|
|
145
|
+
const pace = paceThrough(snow.depth, snow.sample(anchor.x, anchor.z).compaction, running);
|
|
146
|
+
const length = Math.hypot(move.x, move.z);
|
|
147
|
+
const scale = length > 1 ? 1 / length : 1;
|
|
148
|
+
const moving = length > 0.01;
|
|
149
|
+
this.#velocity.x = damp(this.#velocity.x, move.x * scale * pace, moving ? 5 : 8, dt);
|
|
150
|
+
this.#velocity.z = damp(this.#velocity.z, move.z * scale * pace, moving ? 5 : 8, dt);
|
|
151
|
+
if (!moving && Math.hypot(this.#velocity.x, this.#velocity.z) < 0.025) {
|
|
152
|
+
this.#velocity.x = 0;
|
|
153
|
+
this.#velocity.z = 0;
|
|
154
|
+
}
|
|
155
|
+
this.body.velocity.x = this.#velocity.x;
|
|
156
|
+
this.body.velocity.z = this.#velocity.z;
|
|
157
|
+
this.body.moveAndSlide(dt);
|
|
158
|
+
|
|
159
|
+
if (this.speed > 0.05) {
|
|
160
|
+
const desired = Math.atan2(this.#velocity.x, this.#velocity.z);
|
|
161
|
+
const turn = Math.atan2(Math.sin(desired - this.heading), Math.cos(desired - this.heading));
|
|
162
|
+
this.heading += turn * (1 - Math.exp(-7 * dt));
|
|
163
|
+
}
|
|
164
|
+
this.#cycle += travelled / (running ? 1.22 : 1.04);
|
|
165
|
+
this.#stepFeet(dt, running, hardness);
|
|
166
|
+
|
|
167
|
+
const sink = this.#sinkDepth(hardness) * 0.6;
|
|
168
|
+
const bob =
|
|
169
|
+
this.speed > 0.02
|
|
170
|
+
? Math.cos(this.#cycle * Math.PI * 4) * 0.016
|
|
171
|
+
: Math.sin(this.#elapsed * 1.8) * 0.003;
|
|
172
|
+
this.position.y = damp(
|
|
173
|
+
this.position.y,
|
|
174
|
+
terrainHeight(anchor.x, anchor.z) + snow.depth - sink + bob,
|
|
175
|
+
14,
|
|
176
|
+
dt,
|
|
177
|
+
);
|
|
178
|
+
this.model.pose(
|
|
179
|
+
this.position,
|
|
180
|
+
this.heading,
|
|
181
|
+
this.#feet,
|
|
182
|
+
this.#cycle,
|
|
183
|
+
this.speed,
|
|
184
|
+
this.#elapsed,
|
|
185
|
+
);
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
/** How far an 80 kg boot sinks in this snow, for the body's visual height. */
|
|
189
|
+
#sinkDepth(hardness: number): number {
|
|
190
|
+
const pressure = (MASS * GRAVITY) / BOOT_AREA;
|
|
191
|
+
const resistance = 18_000 + clamp(hardness, 0, 1) ** 1.5 * 140_000;
|
|
192
|
+
return clamp(this.#snow.depth * (0.16 + pressure / resistance), 0, this.#snow.depth * 0.82);
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
#stepFeet(dt: number, running: boolean, hardness: number): void {
|
|
196
|
+
const snow = this.#snow;
|
|
197
|
+
const forward = { x: Math.sin(this.heading), z: Math.cos(this.heading) };
|
|
198
|
+
const right = { x: Math.cos(this.heading), z: -Math.sin(this.heading) };
|
|
199
|
+
for (const foot of this.#feet) {
|
|
200
|
+
const phase = (this.#cycle + (foot.side > 0 ? 0.5 : 0)) % 1;
|
|
201
|
+
if (!foot.swing && phase >= 0.58 && this.speed > 0.08) {
|
|
202
|
+
foot.swing = true;
|
|
203
|
+
foot.progress = 0;
|
|
204
|
+
foot.stop = 0;
|
|
205
|
+
foot.from = { x: foot.x, z: foot.z };
|
|
206
|
+
foot.angle = this.heading;
|
|
207
|
+
const reach = running ? 0.64 : 0.49;
|
|
208
|
+
foot.to = {
|
|
209
|
+
x: this.position.x + forward.x * reach + right.x * foot.side * STANCE,
|
|
210
|
+
z: this.position.z + forward.z * reach + right.z * foot.side * STANCE,
|
|
211
|
+
};
|
|
212
|
+
}
|
|
213
|
+
if (foot.swing) {
|
|
214
|
+
if (phase < 0.58 && this.speed > 0.08) {
|
|
215
|
+
this.#plant(foot, running, hardness);
|
|
216
|
+
continue;
|
|
217
|
+
}
|
|
218
|
+
let progress = clamp((phase - 0.58) / 0.42, 0, 1);
|
|
219
|
+
if (this.speed < 0.08) {
|
|
220
|
+
foot.stop += dt * 3.2;
|
|
221
|
+
progress = Math.max(foot.progress, clamp(foot.progress + foot.stop, 0, 1));
|
|
222
|
+
}
|
|
223
|
+
foot.progress = progress;
|
|
224
|
+
const eased = smoothstep(0, 1, progress);
|
|
225
|
+
foot.x = lerp(foot.from.x, foot.to.x, eased);
|
|
226
|
+
foot.z = lerp(foot.from.z, foot.to.z, eased);
|
|
227
|
+
const lift =
|
|
228
|
+
Math.sin(progress * Math.PI) * (0.15 + snow.depth * 0.3 + (running ? 0.07 : 0));
|
|
229
|
+
foot.y = this.#surface(foot.x, foot.z) + 0.14 + lift;
|
|
230
|
+
if (progress >= 0.999) this.#plant(foot, running, hardness);
|
|
231
|
+
} else foot.y = this.#surface(foot.x, foot.z) + 0.14;
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
#surface(x: number, z: number): number {
|
|
236
|
+
const half = this.#snow.field.width / 2 - 1e-3;
|
|
237
|
+
return this.#snow.heightAt(clamp(x, -half, half), clamp(z, -half, half));
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
#plant(foot: IFoot, running: boolean, hardness: number): void {
|
|
241
|
+
foot.x = foot.to.x;
|
|
242
|
+
foot.z = foot.to.z;
|
|
243
|
+
foot.swing = false;
|
|
244
|
+
foot.stop = 0;
|
|
245
|
+
// A boot only presses snow when the body is standing on it: a jump or a fall plants nothing.
|
|
246
|
+
const penetration = this.body.grounded
|
|
247
|
+
? this.#snow.stamp({
|
|
248
|
+
area: BOOT_AREA,
|
|
249
|
+
footprint: bootPrint,
|
|
250
|
+
hardness,
|
|
251
|
+
load: MASS * GRAVITY * (running ? 1.2 : 1),
|
|
252
|
+
rotation: foot.angle,
|
|
253
|
+
x: foot.x,
|
|
254
|
+
z: foot.z,
|
|
255
|
+
})
|
|
256
|
+
: 0;
|
|
257
|
+
if (penetration > 0) this.steps += 1;
|
|
258
|
+
foot.y = this.#surface(foot.x, foot.z) + 0.14;
|
|
259
|
+
this.#onStep({
|
|
260
|
+
angle: foot.angle,
|
|
261
|
+
penetration,
|
|
262
|
+
side: foot.side,
|
|
263
|
+
speed: this.speed,
|
|
264
|
+
x: foot.x,
|
|
265
|
+
y: foot.y - 0.12,
|
|
266
|
+
z: foot.z,
|
|
267
|
+
});
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
debug(): Record<string, unknown> {
|
|
271
|
+
return {
|
|
272
|
+
grounded: this.body.grounded,
|
|
273
|
+
heading: this.heading,
|
|
274
|
+
position: [this.position.x, this.position.y, this.position.z],
|
|
275
|
+
speed: this.speed,
|
|
276
|
+
steps: this.steps,
|
|
277
|
+
};
|
|
278
|
+
}
|
|
279
|
+
}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { defineGame } from "@threenative/core";
|
|
2
|
+
import { playtest } from "@threenative/core/playtest";
|
|
3
|
+
import type { IPhysicsContext } from "@threenative/physics";
|
|
4
|
+
import { rapier } from "@threenative/physics";
|
|
5
|
+
import config from "../threenative.config.js";
|
|
6
|
+
import { type Command, commands } from "./commands.js";
|
|
7
|
+
import { Boot } from "./scenes/Boot.js";
|
|
8
|
+
import { Snow } from "./scenes/Snow.js";
|
|
9
|
+
import type { GameState } from "./state.js";
|
|
10
|
+
|
|
11
|
+
const game = defineGame<GameState, IPhysicsContext>({
|
|
12
|
+
input: {
|
|
13
|
+
move: {
|
|
14
|
+
down: ["ArrowDown", "KeyS"],
|
|
15
|
+
left: ["ArrowLeft", "KeyA"],
|
|
16
|
+
right: ["ArrowRight", "KeyD"],
|
|
17
|
+
up: ["ArrowUp", "KeyW"],
|
|
18
|
+
},
|
|
19
|
+
run: { keys: ["ShiftLeft", "ShiftRight"] },
|
|
20
|
+
auto: { keys: ["KeyP"] },
|
|
21
|
+
blizzard: { keys: ["KeyB"] },
|
|
22
|
+
compaction: { keys: ["KeyV"] },
|
|
23
|
+
drop: { keys: ["KeyF"] },
|
|
24
|
+
kick: { keys: ["KeyG"] },
|
|
25
|
+
mute: { keys: ["KeyM"] },
|
|
26
|
+
reset: { keys: ["KeyR"] },
|
|
27
|
+
view: { keys: ["KeyC"] },
|
|
28
|
+
zoom: { pinch: true, scroll: true },
|
|
29
|
+
},
|
|
30
|
+
plugins: [rapier({ gravity: { x: 0, y: -9.81, z: 0 } }), playtest()],
|
|
31
|
+
display: config.display,
|
|
32
|
+
render: config.renderer,
|
|
33
|
+
scenes: { boot: Boot, snow: Snow },
|
|
34
|
+
seed: 2_024,
|
|
35
|
+
start: "boot",
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
export default game;
|
|
39
|
+
|
|
40
|
+
/** Settings the panel may change directly. Anything else in a `set` intent is ignored. */
|
|
41
|
+
const SETTINGS = new Set<keyof GameState>([
|
|
42
|
+
"snowfall",
|
|
43
|
+
"depth",
|
|
44
|
+
"fallSpeed",
|
|
45
|
+
"hardness",
|
|
46
|
+
"wind",
|
|
47
|
+
"recovery",
|
|
48
|
+
"compaction",
|
|
49
|
+
]);
|
|
50
|
+
const COMMANDS = new Set<Command>(["reset", "drop", "kick", "view", "auto", "blizzard", "mute"]);
|
|
51
|
+
|
|
52
|
+
game.ui.onIntent((intent, payload) => {
|
|
53
|
+
if (intent === "pause") game.pause();
|
|
54
|
+
if (intent === "resume") game.resume();
|
|
55
|
+
if (intent === "set" && typeof payload === "object" && payload !== null) {
|
|
56
|
+
const { key, value } = payload as { key?: string; value?: unknown };
|
|
57
|
+
if (
|
|
58
|
+
SETTINGS.has(key as keyof GameState) &&
|
|
59
|
+
(typeof value === "number" || typeof value === "boolean")
|
|
60
|
+
)
|
|
61
|
+
game.state.set({ [key as string]: value } as Partial<GameState>);
|
|
62
|
+
}
|
|
63
|
+
if (COMMANDS.has(intent as Command)) commands.push(intent as Command);
|
|
64
|
+
game.state.set({
|
|
65
|
+
uiReady: game.ui.connected,
|
|
66
|
+
...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
|
|
67
|
+
} as Partial<GameState>);
|
|
68
|
+
game.state.flush();
|
|
69
|
+
});
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { acceptHotUpdate } from "@threenative/core/hot";
|
|
2
|
+
import { createElement } from "react";
|
|
3
|
+
import { createRoot } from "react-dom/client";
|
|
4
|
+
import game from "./game.js";
|
|
5
|
+
import { App } from "./ui/App.js";
|
|
6
|
+
import "./style.css";
|
|
7
|
+
|
|
8
|
+
import.meta.hot?.accept();
|
|
9
|
+
acceptHotUpdate(game, import.meta.hot);
|
|
10
|
+
const root = document.getElementById("root");
|
|
11
|
+
if (root === null) throw new Error("Missing #root element.");
|
|
12
|
+
const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
|
|
13
|
+
const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
|
|
14
|
+
appRoot.__threenativeRoot = reactRoot;
|
|
15
|
+
reactRoot.render(createElement(App, { game }));
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
// Generated for you. The boot is a look decision: this profile is what a footprint looks like.
|
|
2
|
+
// Change the sole, the tread or the rim here; `SnowField` only presses whatever shape it is given.
|
|
3
|
+
|
|
4
|
+
/** One sample of a contact profile, in the shape `SnowField.stamp` reads. */
|
|
5
|
+
interface IPrintSample {
|
|
6
|
+
readonly bank: number;
|
|
7
|
+
readonly coverage: number;
|
|
8
|
+
readonly disturbance: number;
|
|
9
|
+
readonly relief: number;
|
|
10
|
+
readonly shape: number;
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
const NOTHING: IPrintSample = { bank: 0, coverage: 0, disturbance: 0, relief: 0, shape: 0 };
|
|
14
|
+
|
|
15
|
+
function smoothstep(edge0: number, edge1: number, value: number): number {
|
|
16
|
+
const t = Math.max(0, Math.min(1, (value - edge0) / (edge1 - edge0)));
|
|
17
|
+
return t * t * (3 - 2 * t);
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/** The sole's area, m². Load over this is the pressure a planted boot puts on the snow. */
|
|
21
|
+
export const BOOT_AREA = 0.074;
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* A rounded boot sole — a slightly wider toe than heel — with raised chevrons, a centre groove,
|
|
25
|
+
* and a rim of displaced snow around it. Local z runs heel to toe.
|
|
26
|
+
*/
|
|
27
|
+
export const bootPrint: {
|
|
28
|
+
readonly extent: number;
|
|
29
|
+
readonly sample: (x: number, z: number) => IPrintSample;
|
|
30
|
+
} = {
|
|
31
|
+
extent: 0.48,
|
|
32
|
+
sample: (x, z) => {
|
|
33
|
+
const width = 0.13 + smoothstep(-0.22, 0.15, z) * 0.013;
|
|
34
|
+
const qx = Math.abs(x) - (width - 0.052);
|
|
35
|
+
const qz = Math.abs(z) - (0.255 - 0.052);
|
|
36
|
+
const sdf =
|
|
37
|
+
Math.hypot(Math.max(qx, 0), Math.max(qz, 0)) + Math.min(Math.max(qx, qz), 0) - 0.052;
|
|
38
|
+
if (sdf > 0.105) return NOTHING;
|
|
39
|
+
const tread = Math.max(0, Math.cos(z * 83 + Math.abs(x) * 30)) ** 8;
|
|
40
|
+
const groove = (1 - smoothstep(0.009, 0.023, Math.abs(x))) * 0.004;
|
|
41
|
+
const rim = sdf > 0 ? Math.exp(-(((sdf - 0.027) / 0.027) ** 2)) : 0;
|
|
42
|
+
return {
|
|
43
|
+
bank: rim * (0.78 + 0.22 * Math.sin(x * 94 + z * 63)),
|
|
44
|
+
coverage: 1 - smoothstep(-0.038, 0.008, sdf),
|
|
45
|
+
disturbance: rim * 0.5,
|
|
46
|
+
relief: 0.012 * tread + groove,
|
|
47
|
+
shape: 0.9 + 0.1 * smoothstep(-0.2, 0.15, z),
|
|
48
|
+
};
|
|
49
|
+
},
|
|
50
|
+
};
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
// Generated for you. Framing is a game-owned decision.
|
|
2
|
+
import type { PerspectiveCamera } from "three";
|
|
3
|
+
import type { CameraView } from "../state.js";
|
|
4
|
+
|
|
5
|
+
export function setupCamera(camera: PerspectiveCamera): void {
|
|
6
|
+
camera.fov = fieldOfView(camera.aspect);
|
|
7
|
+
camera.near = 0.075;
|
|
8
|
+
camera.far = 500;
|
|
9
|
+
camera.updateProjectionMatrix();
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* Vertical field of view for an aspect ratio. A portrait phone keeps the landscape view's
|
|
14
|
+
* horizontal reach rather than its vertical angle, or the explorer fills the screen.
|
|
15
|
+
*/
|
|
16
|
+
export function fieldOfView(aspect: number): number {
|
|
17
|
+
if (aspect >= 1) return 43;
|
|
18
|
+
const horizontal = 2 * Math.atan(Math.tan((43 * Math.PI) / 360) * 1.25);
|
|
19
|
+
const vertical = 2 * Math.atan(Math.tan(horizontal / 2) / aspect);
|
|
20
|
+
return Math.min(70, (vertical * 180) / Math.PI);
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/** Orbit distance and elevation (radians from straight down) for each view. */
|
|
24
|
+
const VIEWS: Record<CameraView, { readonly radius: number; readonly polar: number }> = {
|
|
25
|
+
// Over the shoulder, high enough that the trail behind the explorer reads.
|
|
26
|
+
follow: { polar: 1.1, radius: 11.6 },
|
|
27
|
+
// Low and close on the last footprint: the tread, the rim and the compaction.
|
|
28
|
+
surface: { polar: 1.22, radius: 3.1 },
|
|
29
|
+
overhead: { polar: 0.23, radius: 19 },
|
|
30
|
+
};
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* A damped orbit around a target. Drag and the zoom axis move the goal; the camera eases to it,
|
|
34
|
+
* and never dips under the snow it is looking at.
|
|
35
|
+
*/
|
|
36
|
+
export class OrbitFollow {
|
|
37
|
+
yaw = 0.68;
|
|
38
|
+
#polar = VIEWS.follow.polar;
|
|
39
|
+
#radius = VIEWS.follow.radius;
|
|
40
|
+
#goalPolar = VIEWS.follow.polar;
|
|
41
|
+
#goalRadius = VIEWS.follow.radius;
|
|
42
|
+
readonly #target = { x: 0, y: 0.95, z: 0 };
|
|
43
|
+
|
|
44
|
+
setView(view: CameraView): void {
|
|
45
|
+
this.#goalRadius = VIEWS[view].radius;
|
|
46
|
+
this.#goalPolar = VIEWS[view].polar;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** Drag by pixels: sideways turns, vertical tilts. */
|
|
50
|
+
drag(dx: number, dy: number): void {
|
|
51
|
+
this.yaw -= dx * 0.005;
|
|
52
|
+
this.#goalPolar = Math.max(0.12, Math.min(1.43, this.#goalPolar + dy * 0.004));
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
zoom(amount: number): void {
|
|
56
|
+
this.#goalRadius = Math.max(1.65, Math.min(30, this.#goalRadius * Math.exp(-amount * 0.001)));
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
update(
|
|
60
|
+
camera: PerspectiveCamera,
|
|
61
|
+
goal: { readonly x: number; readonly y: number; readonly z: number },
|
|
62
|
+
ground: (x: number, z: number) => number,
|
|
63
|
+
dt: number,
|
|
64
|
+
): void {
|
|
65
|
+
const ease = 1 - Math.exp(-dt * 4.5);
|
|
66
|
+
const settle = 1 - Math.exp(-dt * 5);
|
|
67
|
+
this.#target.x += (goal.x - this.#target.x) * ease;
|
|
68
|
+
this.#target.y += (goal.y - this.#target.y) * ease;
|
|
69
|
+
this.#target.z += (goal.z - this.#target.z) * ease;
|
|
70
|
+
this.#radius += (this.#goalRadius - this.#radius) * settle;
|
|
71
|
+
this.#polar += (this.#goalPolar - this.#polar) * settle;
|
|
72
|
+
const sine = Math.sin(this.#polar);
|
|
73
|
+
const x = this.#target.x + Math.sin(this.yaw) * sine * this.#radius;
|
|
74
|
+
const z = this.#target.z + Math.cos(this.yaw) * sine * this.#radius;
|
|
75
|
+
const y = this.#target.y + Math.cos(this.#polar) * this.#radius;
|
|
76
|
+
const fov = fieldOfView(camera.aspect);
|
|
77
|
+
if (Math.abs(fov - camera.fov) > 0.01) {
|
|
78
|
+
camera.fov = fov;
|
|
79
|
+
camera.updateProjectionMatrix();
|
|
80
|
+
}
|
|
81
|
+
camera.position.set(x, Math.max(y, ground(x, z) + 0.3), z);
|
|
82
|
+
camera.lookAt(this.#target.x, this.#target.y, this.#target.z);
|
|
83
|
+
}
|
|
84
|
+
}
|