create-threenative 0.2.0

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.
Files changed (320) hide show
  1. package/README.md +16 -0
  2. package/dist/index.d.ts +30 -0
  3. package/dist/index.js +283 -0
  4. package/dist/threenative.d.ts +6 -0
  5. package/dist/threenative.js +757 -0
  6. package/package.json +44 -0
  7. package/templates/action-rpg/.mcp.json +16 -0
  8. package/templates/action-rpg/AGENTS.md +40 -0
  9. package/templates/action-rpg/CLAUDE.md +42 -0
  10. package/templates/action-rpg/index.html +13 -0
  11. package/templates/action-rpg/kit.json +7 -0
  12. package/templates/action-rpg/package.json +47 -0
  13. package/templates/action-rpg/playtests/combat.playtest.json +61 -0
  14. package/templates/action-rpg/playtests/fail.playtest.json +21 -0
  15. package/templates/action-rpg/playtests/inventory.playtest.json +111 -0
  16. package/templates/action-rpg/playtests/progress.playtest.json +99 -0
  17. package/templates/action-rpg/playtests/survives.playtest.json +32 -0
  18. package/templates/action-rpg/playtests/win.playtest.json +30 -0
  19. package/templates/action-rpg/public/favicon.svg +5 -0
  20. package/templates/action-rpg/src/abilities/Ability.ts +45 -0
  21. package/templates/action-rpg/src/entities/Enemy.ts +143 -0
  22. package/templates/action-rpg/src/entities/Player.ts +83 -0
  23. package/templates/action-rpg/src/game.ts +40 -0
  24. package/templates/action-rpg/src/items/Inventory.ts +163 -0
  25. package/templates/action-rpg/src/loot/drops.ts +40 -0
  26. package/templates/action-rpg/src/main.ts +15 -0
  27. package/templates/action-rpg/src/physics.ts +40 -0
  28. package/templates/action-rpg/src/playtest-events.ts +15 -0
  29. package/templates/action-rpg/src/progress.ts +35 -0
  30. package/templates/action-rpg/src/render/camera.ts +26 -0
  31. package/templates/action-rpg/src/render/lighting.ts +30 -0
  32. package/templates/action-rpg/src/render/loading.ts +90 -0
  33. package/templates/action-rpg/src/render/materials.ts +40 -0
  34. package/templates/action-rpg/src/render/palette.ts +9 -0
  35. package/templates/action-rpg/src/render/postprocessing.ts +18 -0
  36. package/templates/action-rpg/src/render/shapes.ts +110 -0
  37. package/templates/action-rpg/src/render/sky.ts +18 -0
  38. package/templates/action-rpg/src/render/types.ts +3 -0
  39. package/templates/action-rpg/src/scenes/Boot.ts +12 -0
  40. package/templates/action-rpg/src/scenes/Play.ts +449 -0
  41. package/templates/action-rpg/src/state.ts +40 -0
  42. package/templates/action-rpg/src/stats/StatBlock.ts +57 -0
  43. package/templates/action-rpg/src/style.css +32 -0
  44. package/templates/action-rpg/src/ui/AbilityBar.tsx +28 -0
  45. package/templates/action-rpg/src/ui/App.tsx +21 -0
  46. package/templates/action-rpg/src/ui/CharacterPanel.tsx +31 -0
  47. package/templates/action-rpg/src/ui/Hud.tsx +29 -0
  48. package/templates/action-rpg/src/ui/InventoryPanel.tsx +37 -0
  49. package/templates/action-rpg/tailwind.config.ts +7 -0
  50. package/templates/action-rpg/threenative.config.ts +29 -0
  51. package/templates/action-rpg/tsconfig.json +17 -0
  52. package/templates/action-rpg/vite.config.ts +8 -0
  53. package/templates/defense/.mcp.json +16 -0
  54. package/templates/defense/AGENTS.md +53 -0
  55. package/templates/defense/CLAUDE.md +55 -0
  56. package/templates/defense/README.md +9 -0
  57. package/templates/defense/index.html +13 -0
  58. package/templates/defense/kit.json +7 -0
  59. package/templates/defense/package.json +46 -0
  60. package/templates/defense/playtests/leak.playtest.json +18 -0
  61. package/templates/defense/playtests/placement.playtest.json +40 -0
  62. package/templates/defense/playtests/scan.playtest.json +20 -0
  63. package/templates/defense/playtests/survive.playtest.json +26 -0
  64. package/templates/defense/playtests/survives.playtest.json +36 -0
  65. package/templates/defense/public/favicon.svg +5 -0
  66. package/templates/defense/src/attackers/Attacker.ts +104 -0
  67. package/templates/defense/src/board/Route.ts +80 -0
  68. package/templates/defense/src/economy.ts +36 -0
  69. package/templates/defense/src/entities/Player.ts +44 -0
  70. package/templates/defense/src/game.ts +30 -0
  71. package/templates/defense/src/main.ts +15 -0
  72. package/templates/defense/src/physics.ts +43 -0
  73. package/templates/defense/src/placement/Buildable.ts +49 -0
  74. package/templates/defense/src/playtest-events.ts +15 -0
  75. package/templates/defense/src/render/camera.ts +10 -0
  76. package/templates/defense/src/render/lighting.ts +32 -0
  77. package/templates/defense/src/render/loading.ts +89 -0
  78. package/templates/defense/src/render/materials.ts +13 -0
  79. package/templates/defense/src/render/palette.ts +21 -0
  80. package/templates/defense/src/render/postprocessing.ts +14 -0
  81. package/templates/defense/src/render/shapes.ts +89 -0
  82. package/templates/defense/src/render/sky.ts +45 -0
  83. package/templates/defense/src/scenes/Boot.ts +12 -0
  84. package/templates/defense/src/scenes/Defense.ts +165 -0
  85. package/templates/defense/src/state.ts +50 -0
  86. package/templates/defense/src/style.css +32 -0
  87. package/templates/defense/src/towers/Tower.ts +96 -0
  88. package/templates/defense/src/towers/targeting.ts +53 -0
  89. package/templates/defense/src/ui/App.tsx +17 -0
  90. package/templates/defense/src/ui/Hud.tsx +61 -0
  91. package/templates/defense/src/ui/Menu.tsx +7 -0
  92. package/templates/defense/src/waves.ts +40 -0
  93. package/templates/defense/tailwind.config.ts +1 -0
  94. package/templates/defense/threenative.config.ts +29 -0
  95. package/templates/defense/tsconfig.json +17 -0
  96. package/templates/defense/vite.config.ts +5 -0
  97. package/templates/minimal/.mcp.json +16 -0
  98. package/templates/minimal/AGENTS.md +400 -0
  99. package/templates/minimal/CLAUDE.md +402 -0
  100. package/templates/minimal/assets/.gitkeep +0 -0
  101. package/templates/minimal/index.html +14 -0
  102. package/templates/minimal/kit.json +7 -0
  103. package/templates/minimal/package.json +40 -0
  104. package/templates/minimal/playtests/play.playtest.json +32 -0
  105. package/templates/minimal/playtests/survives.playtest.json +32 -0
  106. package/templates/minimal/public/.gitkeep +0 -0
  107. package/templates/minimal/public/favicon.svg +4 -0
  108. package/templates/minimal/public/icon.png +0 -0
  109. package/templates/minimal/src/entities/Player.ts +66 -0
  110. package/templates/minimal/src/game.ts +28 -0
  111. package/templates/minimal/src/main.ts +17 -0
  112. package/templates/minimal/src/render/camera.ts +11 -0
  113. package/templates/minimal/src/render/hud.ts +53 -0
  114. package/templates/minimal/src/render/lighting.ts +46 -0
  115. package/templates/minimal/src/render/loading.ts +113 -0
  116. package/templates/minimal/src/render/materials.ts +16 -0
  117. package/templates/minimal/src/render/palette.ts +9 -0
  118. package/templates/minimal/src/render/postprocessing.ts +20 -0
  119. package/templates/minimal/src/render/sky.ts +41 -0
  120. package/templates/minimal/src/scenes/Boot.ts +5 -0
  121. package/templates/minimal/src/scenes/Play.ts +65 -0
  122. package/templates/minimal/src/state.ts +1 -0
  123. package/templates/minimal/src/style.css +41 -0
  124. package/templates/minimal/threenative.config.ts +32 -0
  125. package/templates/minimal/tsconfig.json +16 -0
  126. package/templates/minimal/vite.config.ts +3 -0
  127. package/templates/platformer/.mcp.json +16 -0
  128. package/templates/platformer/AGENTS.md +199 -0
  129. package/templates/platformer/CLAUDE.md +201 -0
  130. package/templates/platformer/assets/.gitkeep +0 -0
  131. package/templates/platformer/index.html +13 -0
  132. package/templates/platformer/kit.json +7 -0
  133. package/templates/platformer/package.json +50 -0
  134. package/templates/platformer/playtests/avoidance.playtest.json +23 -0
  135. package/templates/platformer/playtests/buffer.playtest.json +17 -0
  136. package/templates/platformer/playtests/chase.playtest.json +21 -0
  137. package/templates/platformer/playtests/collect.playtest.json +56 -0
  138. package/templates/platformer/playtests/collision-layers.playtest.json +36 -0
  139. package/templates/platformer/playtests/coyote.playtest.json +21 -0
  140. package/templates/platformer/playtests/damage.playtest.json +31 -0
  141. package/templates/platformer/playtests/dash.playtest.json +21 -0
  142. package/templates/platformer/playtests/jump.playtest.json +21 -0
  143. package/templates/platformer/playtests/oneway.playtest.json +17 -0
  144. package/templates/platformer/playtests/patrol.playtest.json +13 -0
  145. package/templates/platformer/playtests/performance.playtest.json +21 -0
  146. package/templates/platformer/playtests/physics.playtest.json +14 -0
  147. package/templates/platformer/playtests/respawn.playtest.json +31 -0
  148. package/templates/platformer/playtests/stomp-rise.playtest.json +41 -0
  149. package/templates/platformer/playtests/stomp.playtest.json +34 -0
  150. package/templates/platformer/playtests/survives.playtest.json +32 -0
  151. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +29 -0
  152. package/templates/platformer/playtests/terminal-loop-win.playtest.json +52 -0
  153. package/templates/platformer/public/.gitkeep +0 -0
  154. package/templates/platformer/public/favicon.svg +4 -0
  155. package/templates/platformer/public/icon.png +0 -0
  156. package/templates/platformer/src/entities/Character.ts +218 -0
  157. package/templates/platformer/src/entities/Chaser.ts +118 -0
  158. package/templates/platformer/src/entities/Patrol.ts +88 -0
  159. package/templates/platformer/src/entities/Pickup.ts +72 -0
  160. package/templates/platformer/src/game.ts +27 -0
  161. package/templates/platformer/src/level/Checkpoints.ts +66 -0
  162. package/templates/platformer/src/level/Platform.ts +34 -0
  163. package/templates/platformer/src/main.ts +14 -0
  164. package/templates/platformer/src/playtest-events.ts +15 -0
  165. package/templates/platformer/src/render/camera.ts +8 -0
  166. package/templates/platformer/src/render/lighting.ts +38 -0
  167. package/templates/platformer/src/render/loading.ts +113 -0
  168. package/templates/platformer/src/render/materials.ts +11 -0
  169. package/templates/platformer/src/render/palette.ts +54 -0
  170. package/templates/platformer/src/render/postprocessing.ts +18 -0
  171. package/templates/platformer/src/render/rig.ts +60 -0
  172. package/templates/platformer/src/render/sky.ts +47 -0
  173. package/templates/platformer/src/render/terrain.ts +31 -0
  174. package/templates/platformer/src/render/touch-controls.ts +157 -0
  175. package/templates/platformer/src/render/touch-layout.ts +63 -0
  176. package/templates/platformer/src/scenes/Boot.ts +12 -0
  177. package/templates/platformer/src/scenes/Level.ts +176 -0
  178. package/templates/platformer/src/state.ts +23 -0
  179. package/templates/platformer/src/style.css +31 -0
  180. package/templates/platformer/src/ui/App.tsx +17 -0
  181. package/templates/platformer/src/ui/Hud.tsx +41 -0
  182. package/templates/platformer/src/ui/Menu.tsx +7 -0
  183. package/templates/platformer/tailwind.config.ts +2 -0
  184. package/templates/platformer/threenative.config.ts +32 -0
  185. package/templates/platformer/tsconfig.json +17 -0
  186. package/templates/platformer/vite.config.ts +5 -0
  187. package/templates/racing/.mcp.json +16 -0
  188. package/templates/racing/AGENTS.md +48 -0
  189. package/templates/racing/CLAUDE.md +50 -0
  190. package/templates/racing/index.html +13 -0
  191. package/templates/racing/kit.json +7 -0
  192. package/templates/racing/package.json +46 -0
  193. package/templates/racing/playtests/boost.playtest.json +45 -0
  194. package/templates/racing/playtests/outcome.playtest.json +78 -0
  195. package/templates/racing/playtests/ranking.playtest.json +37 -0
  196. package/templates/racing/playtests/rescue.playtest.json +28 -0
  197. package/templates/racing/playtests/reverse.playtest.json +37 -0
  198. package/templates/racing/playtests/shortcut.playtest.json +44 -0
  199. package/templates/racing/playtests/survives.playtest.json +32 -0
  200. package/templates/racing/public/favicon.svg +6 -0
  201. package/templates/racing/src/entities/RacingCar.ts +114 -0
  202. package/templates/racing/src/entities/Rival.ts +46 -0
  203. package/templates/racing/src/game.ts +29 -0
  204. package/templates/racing/src/kart/boost.ts +38 -0
  205. package/templates/racing/src/main.ts +15 -0
  206. package/templates/racing/src/playtest-events.ts +15 -0
  207. package/templates/racing/src/render/camera.ts +28 -0
  208. package/templates/racing/src/render/lighting.ts +32 -0
  209. package/templates/racing/src/render/loading.ts +58 -0
  210. package/templates/racing/src/render/materials.ts +15 -0
  211. package/templates/racing/src/render/palette.ts +30 -0
  212. package/templates/racing/src/render/postprocessing.ts +14 -0
  213. package/templates/racing/src/render/shapes.ts +37 -0
  214. package/templates/racing/src/render/sky.ts +45 -0
  215. package/templates/racing/src/scenes/Boot.ts +12 -0
  216. package/templates/racing/src/scenes/Race.ts +180 -0
  217. package/templates/racing/src/state.ts +35 -0
  218. package/templates/racing/src/style.css +32 -0
  219. package/templates/racing/src/track/Checkline.ts +19 -0
  220. package/templates/racing/src/track/Lap.ts +104 -0
  221. package/templates/racing/src/track/Ranking.ts +35 -0
  222. package/templates/racing/src/track/Track.ts +229 -0
  223. package/templates/racing/src/track/TrackSector.ts +77 -0
  224. package/templates/racing/src/track/rescue.ts +21 -0
  225. package/templates/racing/src/ui/App.tsx +17 -0
  226. package/templates/racing/src/ui/Hud.tsx +71 -0
  227. package/templates/racing/src/ui/Menu.tsx +7 -0
  228. package/templates/racing/tailwind.config.ts +2 -0
  229. package/templates/racing/threenative.config.ts +29 -0
  230. package/templates/racing/tsconfig.json +17 -0
  231. package/templates/racing/vite.config.ts +5 -0
  232. package/templates/shooter/.mcp.json +16 -0
  233. package/templates/shooter/AGENTS.md +69 -0
  234. package/templates/shooter/CLAUDE.md +71 -0
  235. package/templates/shooter/index.html +13 -0
  236. package/templates/shooter/kit.json +7 -0
  237. package/templates/shooter/package.json +46 -0
  238. package/templates/shooter/playtests/fail.playtest.json +30 -0
  239. package/templates/shooter/playtests/shooter.playtest.json +89 -0
  240. package/templates/shooter/playtests/survives.playtest.json +32 -0
  241. package/templates/shooter/public/favicon.svg +4 -0
  242. package/templates/shooter/src/combat/damage.ts +41 -0
  243. package/templates/shooter/src/entities/Pickup.ts +70 -0
  244. package/templates/shooter/src/entities/Player.ts +93 -0
  245. package/templates/shooter/src/entities/Target.ts +103 -0
  246. package/templates/shooter/src/game.ts +36 -0
  247. package/templates/shooter/src/level/SpawnPoints.ts +28 -0
  248. package/templates/shooter/src/main.ts +26 -0
  249. package/templates/shooter/src/physics.ts +49 -0
  250. package/templates/shooter/src/playtest-events.ts +15 -0
  251. package/templates/shooter/src/render/camera.ts +29 -0
  252. package/templates/shooter/src/render/lighting.ts +38 -0
  253. package/templates/shooter/src/render/loading.ts +86 -0
  254. package/templates/shooter/src/render/materials.ts +38 -0
  255. package/templates/shooter/src/render/palette.ts +9 -0
  256. package/templates/shooter/src/render/postprocessing.ts +19 -0
  257. package/templates/shooter/src/render/shapes.ts +194 -0
  258. package/templates/shooter/src/render/sky.ts +37 -0
  259. package/templates/shooter/src/render/types.ts +3 -0
  260. package/templates/shooter/src/render/ui.css +212 -0
  261. package/templates/shooter/src/render/ui.ts +59 -0
  262. package/templates/shooter/src/scenes/Boot.ts +12 -0
  263. package/templates/shooter/src/scenes/Play.ts +428 -0
  264. package/templates/shooter/src/state.ts +29 -0
  265. package/templates/shooter/src/ui/App.tsx +25 -0
  266. package/templates/shooter/src/ui/Hud.tsx +49 -0
  267. package/templates/shooter/src/ui/Menu.tsx +26 -0
  268. package/templates/shooter/src/waves.ts +50 -0
  269. package/templates/shooter/src/weapons/Hitscan.ts +43 -0
  270. package/templates/shooter/src/weapons/Projectile.ts +76 -0
  271. package/templates/shooter/tailwind.config.ts +5 -0
  272. package/templates/shooter/threenative.config.ts +29 -0
  273. package/templates/shooter/tsconfig.json +17 -0
  274. package/templates/shooter/vite.config.ts +8 -0
  275. package/templates/starter/.mcp.json +16 -0
  276. package/templates/starter/AGENTS.md +450 -0
  277. package/templates/starter/CLAUDE.md +452 -0
  278. package/templates/starter/assets/.gitkeep +0 -0
  279. package/templates/starter/index.html +13 -0
  280. package/templates/starter/kit.json +7 -0
  281. package/templates/starter/package.json +49 -0
  282. package/templates/starter/playtests/buffer.playtest.json +29 -0
  283. package/templates/starter/playtests/coyote.playtest.json +35 -0
  284. package/templates/starter/playtests/forward.playtest.json +15 -0
  285. package/templates/starter/playtests/hot-reload.playtest.json +28 -0
  286. package/templates/starter/playtests/look.playtest.json +43 -0
  287. package/templates/starter/playtests/monitoring.playtest.json +41 -0
  288. package/templates/starter/playtests/pause.playtest.json +33 -0
  289. package/templates/starter/playtests/play.playtest.json +16 -0
  290. package/templates/starter/playtests/respawn.playtest.json +28 -0
  291. package/templates/starter/playtests/restart.playtest.json +36 -0
  292. package/templates/starter/playtests/seed.playtest.json +18 -0
  293. package/templates/starter/playtests/survives.playtest.json +32 -0
  294. package/templates/starter/public/.gitkeep +0 -0
  295. package/templates/starter/public/favicon.svg +4 -0
  296. package/templates/starter/public/icon.png +0 -0
  297. package/templates/starter/public/native-proof.glb +0 -0
  298. package/templates/starter/public/native-proof.png +0 -0
  299. package/templates/starter/public/pickup.ogg +0 -0
  300. package/templates/starter/src/entities/Crate.ts +34 -0
  301. package/templates/starter/src/entities/Player.ts +80 -0
  302. package/templates/starter/src/game.ts +30 -0
  303. package/templates/starter/src/main.ts +15 -0
  304. package/templates/starter/src/render/camera.ts +57 -0
  305. package/templates/starter/src/render/lighting.ts +55 -0
  306. package/templates/starter/src/render/materials.ts +12 -0
  307. package/templates/starter/src/render/palette.ts +9 -0
  308. package/templates/starter/src/render/postprocessing.ts +18 -0
  309. package/templates/starter/src/render/shapes.ts +147 -0
  310. package/templates/starter/src/render/sky.ts +56 -0
  311. package/templates/starter/src/scenes/Play.ts +161 -0
  312. package/templates/starter/src/state.ts +10 -0
  313. package/templates/starter/src/style.css +45 -0
  314. package/templates/starter/src/ui/App.tsx +19 -0
  315. package/templates/starter/src/ui/Hud.tsx +37 -0
  316. package/templates/starter/src/ui/Menu.tsx +43 -0
  317. package/templates/starter/tailwind.config.ts +2 -0
  318. package/templates/starter/threenative.config.ts +31 -0
  319. package/templates/starter/tsconfig.json +17 -0
  320. package/templates/starter/vite.config.ts +8 -0
@@ -0,0 +1,41 @@
1
+ import type { IPhysicsContext } from "@threenative/physics";
2
+ import { CollisionShape3D } from "@threenative/physics";
3
+ import type { Vector3 } from "three";
4
+ import { HOSTILE_LAYER } from "../entities/Player.js";
5
+ import type { Target } from "../entities/Target.js";
6
+ import { directSpaceState } from "../physics.js";
7
+
8
+ export function applyDirectDamage(
9
+ targets: ReadonlyMap<number, Target>,
10
+ bodyId: number,
11
+ amount: number,
12
+ ): boolean {
13
+ const target = targets.get(bodyId);
14
+ return target?.takeDamage(amount) ?? false;
15
+ }
16
+
17
+ export function applyRadiusDamage(
18
+ physics: IPhysicsContext,
19
+ centre: Vector3,
20
+ radius: number,
21
+ amount: number,
22
+ targets: ReadonlyMap<number, Target>,
23
+ ): Set<number> {
24
+ const hits = directSpaceState(physics).intersectShape({
25
+ collisionMask: HOSTILE_LAYER,
26
+ maxResults: 16,
27
+ position: centre,
28
+ shape: CollisionShape3D.sphere(radius),
29
+ });
30
+ const defeated = new Set<number>();
31
+ for (const hit of hits) {
32
+ const target = targets.get(hit.body.id);
33
+ if (target === undefined || !target.alive) continue;
34
+ // Candidate discovery is the physics query. This single falloff calculation is the weapon's
35
+ // design, not a JavaScript distance scan over the level.
36
+ const distance = target.mesh.position.distanceTo(centre);
37
+ const falloff = Math.max(0, 1 - distance / radius);
38
+ if (target.takeDamage(amount * Math.max(0.25, falloff))) defeated.add(hit.body.id);
39
+ }
40
+ return defeated;
41
+ }
@@ -0,0 +1,70 @@
1
+ import type { ICtx } from "@threenative/core";
2
+ import { Area3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
3
+ import type { Group, Vector3 } from "three";
4
+ import { createPickupVisual } from "../render/shapes.js";
5
+ import type { GameState } from "../state.js";
6
+ import { PLAYER_LAYER } from "./Player.js";
7
+
8
+ type GameCtx = ICtx<GameState, IPhysicsContext>;
9
+
10
+ export class Pickup {
11
+ readonly mesh: Group;
12
+ readonly area: Area3D;
13
+ readonly tags = ["pickup", "health"];
14
+ collected = false;
15
+ #base: Vector3;
16
+ #time = 0;
17
+ #unsubscribe: () => void;
18
+ #onCollect: () => void;
19
+
20
+ constructor(
21
+ ctx: GameCtx,
22
+ materials: Parameters<typeof createPickupVisual>[0],
23
+ position: Vector3,
24
+ playerBodyId: number,
25
+ onCollect: () => void,
26
+ ) {
27
+ this.#base = position.clone();
28
+ this.#onCollect = onCollect;
29
+ this.mesh = createPickupVisual(materials);
30
+ this.mesh.position.copy(position);
31
+ ctx.add(this.mesh);
32
+ this.area = new Area3D({
33
+ collisionMask: PLAYER_LAYER,
34
+ entity: "health-pickup",
35
+ physics: ctx.physics,
36
+ position,
37
+ shape: CollisionShape3D.sphere(0.25),
38
+ });
39
+ this.#unsubscribe = this.area.on("bodyEntered", (body) => {
40
+ if (this.collected || body.body.id !== playerBodyId) return;
41
+ this.collected = true;
42
+ this.mesh.visible = false;
43
+ this.area.monitoring = false;
44
+ this.#onCollect();
45
+ });
46
+ }
47
+
48
+ update(dt: number): void {
49
+ if (this.collected) return;
50
+ this.#time += dt;
51
+ this.mesh.rotation.y += dt * 2.6;
52
+ this.mesh.position.y = this.#base.y + Math.sin(this.#time * 3) * 0.12;
53
+ }
54
+
55
+ respawn(): void {
56
+ this.collected = false;
57
+ this.mesh.visible = true;
58
+ this.area.monitoring = true;
59
+ }
60
+
61
+ debug(): Record<string, unknown> {
62
+ return { collected: this.collected, position: this.mesh.position.toArray() };
63
+ }
64
+
65
+ dispose(): void {
66
+ this.#unsubscribe();
67
+ this.area.dispose();
68
+ this.mesh.removeFromParent();
69
+ }
70
+ }
@@ -0,0 +1,93 @@
1
+ import type { ICtx } from "@threenative/core";
2
+ import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
3
+ import { type Group, Vector3 } from "three";
4
+ import { createPlayerVisual } from "../render/shapes.js";
5
+ import type { GameState } from "../state.js";
6
+
7
+ export const WORLD_LAYER = 1;
8
+ export const PLAYER_LAYER = 2;
9
+ export const HOSTILE_LAYER = 4;
10
+ export const FRIENDLY_LAYER = 8;
11
+ export const PROJECTILE_LAYER = 16;
12
+
13
+ type GameCtx = ICtx<GameState, IPhysicsContext>;
14
+
15
+ const SPAWN = new Vector3(0, 0.85, 5);
16
+ const MOVE_SPEED = 4.2;
17
+
18
+ export class Player {
19
+ readonly mesh: Group;
20
+ readonly body: CharacterBody3D;
21
+ readonly maxHealth = 100;
22
+ health = 100;
23
+ dead = false;
24
+ #onDamage: (amount: number) => void;
25
+ #onDeath: () => void;
26
+
27
+ constructor(
28
+ ctx: GameCtx,
29
+ materials: Parameters<typeof createPlayerVisual>[0],
30
+ spawn: Vector3 = SPAWN,
31
+ onDamage: (amount: number) => void = () => undefined,
32
+ onDeath: () => void = () => undefined,
33
+ ) {
34
+ this.#onDamage = onDamage;
35
+ this.#onDeath = onDeath;
36
+ this.mesh = createPlayerVisual(materials);
37
+ this.mesh.position.copy(spawn);
38
+ ctx.add(this.mesh);
39
+ this.body = new CharacterBody3D({
40
+ collisionLayer: PLAYER_LAYER,
41
+ collisionMask: WORLD_LAYER | HOSTILE_LAYER,
42
+ autostep: { maxHeight: 0.25, minWidth: 0.18 },
43
+ object: this.mesh,
44
+ physics: ctx.physics,
45
+ shape: CollisionShape3D.capsule(0.45, 0.38),
46
+ });
47
+ }
48
+
49
+ update(ctx: GameCtx, dt: number): void {
50
+ if (this.dead) return;
51
+ const move = ctx.input.vector("move");
52
+ this.body.velocity.x = move.x * MOVE_SPEED;
53
+ this.body.velocity.z = -move.y * MOVE_SPEED;
54
+ this.body.moveAndSlide(dt);
55
+ }
56
+
57
+ takeDamage(amount: number): void {
58
+ if (this.dead || !Number.isFinite(amount) || amount <= 0) return;
59
+ this.health = Math.max(0, this.health - amount);
60
+ this.#onDamage(amount);
61
+ if (this.health > 0) return;
62
+ this.dead = true;
63
+ this.mesh.visible = false;
64
+ this.body.velocity.set(0, 0, 0);
65
+ this.#onDeath();
66
+ }
67
+
68
+ respawn(spawn: Vector3): void {
69
+ this.body.teleport(spawn);
70
+ this.health = 40;
71
+ this.dead = false;
72
+ this.mesh.visible = true;
73
+ }
74
+
75
+ aimOrigin(): Vector3 {
76
+ return this.mesh.position.clone().add(new Vector3(0, 0.72, -0.72));
77
+ }
78
+
79
+ debug(): Record<string, unknown> {
80
+ return {
81
+ dead: this.dead,
82
+ health: this.health,
83
+ position: this.mesh.position.toArray(),
84
+ };
85
+ }
86
+
87
+ dispose(): void {
88
+ this.body.dispose();
89
+ this.mesh.removeFromParent();
90
+ }
91
+ }
92
+
93
+ export { SPAWN };
@@ -0,0 +1,103 @@
1
+ import type { ICtx, ScheduleHandle } from "@threenative/core";
2
+ import { CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
3
+ import { type Group, Vector3 } from "three";
4
+ import { directSpaceState } from "../physics.js";
5
+ import { createTargetVisual } from "../render/shapes.js";
6
+ import type { GameState } from "../state.js";
7
+ import { HOSTILE_LAYER, PLAYER_LAYER, WORLD_LAYER } from "./Player.js";
8
+
9
+ type GameCtx = ICtx<GameState, IPhysicsContext>;
10
+
11
+ const SCAN_RADIUS = 7;
12
+
13
+ export class Target {
14
+ readonly mesh: Group;
15
+ readonly body: RigidBody3D;
16
+ readonly tags = ["hostile", "target"];
17
+ readonly wave: number | undefined;
18
+ health: number;
19
+ alive = true;
20
+ acquired = false;
21
+ scanCount = 0;
22
+ #scanHandle: ScheduleHandle | undefined;
23
+ #fireTimer = 0;
24
+ #onFire: (origin: Vector3) => void;
25
+ #scanShape = CollisionShape3D.sphere(SCAN_RADIUS);
26
+
27
+ constructor(
28
+ ctx: GameCtx,
29
+ materials: Parameters<typeof createTargetVisual>[0],
30
+ position: Vector3,
31
+ options: {
32
+ readonly health?: number;
33
+ readonly onFire?: (origin: Vector3) => void;
34
+ readonly wave?: number;
35
+ } = {},
36
+ ) {
37
+ this.wave = options.wave;
38
+ this.health = options.health ?? 40;
39
+ this.#onFire = options.onFire ?? (() => undefined);
40
+ this.mesh = createTargetVisual(materials);
41
+ this.mesh.position.copy(position);
42
+ ctx.add(this.mesh);
43
+ this.body = new RigidBody3D({
44
+ collisionLayer: HOSTILE_LAYER,
45
+ collisionMask: WORLD_LAYER,
46
+ object: this.mesh,
47
+ physics: ctx.physics,
48
+ shape: CollisionShape3D.box(1.2, 1.8, 1),
49
+ type: "kinematic",
50
+ });
51
+ }
52
+
53
+ startScanning(ctx: GameCtx, playerBodyId: number): void {
54
+ const scan = (): void => {
55
+ if (!this.alive) return;
56
+ this.scanCount += 1;
57
+ const hits = directSpaceState(ctx.physics).intersectShape({
58
+ collisionMask: PLAYER_LAYER,
59
+ maxResults: 4,
60
+ position: this.mesh.position,
61
+ shape: this.#scanShape,
62
+ });
63
+ this.acquired = hits.some((hit) => hit.body.id === playerBodyId);
64
+ this.#scanHandle = ctx.after(ctx.random.range(3, 8) / 60, scan);
65
+ };
66
+ this.#scanHandle = ctx.after(ctx.random.range(3, 8) / 60, scan);
67
+ }
68
+
69
+ update(dt: number): void {
70
+ if (!this.alive || !this.acquired) return;
71
+ this.#fireTimer -= dt;
72
+ if (this.#fireTimer > 0) return;
73
+ this.#fireTimer = 6;
74
+ this.#onFire(this.mesh.position.clone().add(new Vector3(0, 0.9, 0)));
75
+ }
76
+
77
+ takeDamage(amount: number): boolean {
78
+ if (!this.alive || !Number.isFinite(amount) || amount <= 0) return false;
79
+ this.health = Math.max(0, this.health - amount);
80
+ if (this.health > 0) return false;
81
+ this.alive = false;
82
+ this.mesh.visible = false;
83
+ return true;
84
+ }
85
+
86
+ debug(): Record<string, unknown> {
87
+ return {
88
+ acquired: this.acquired,
89
+ alive: this.alive,
90
+ health: this.health,
91
+ position: this.mesh.position.toArray(),
92
+ scanCount: this.scanCount,
93
+ selected: this.acquired ? 1 : 0,
94
+ wave: this.wave ?? 0,
95
+ };
96
+ }
97
+
98
+ dispose(): void {
99
+ this.#scanHandle?.cancel();
100
+ this.body.dispose();
101
+ this.mesh.removeFromParent();
102
+ }
103
+ }
@@ -0,0 +1,36 @@
1
+ import { defineGame, replay } 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 { drainPlaytestEvents } from "./playtest-events.js";
7
+ import { Boot } from "./scenes/Boot.js";
8
+ import { Play } from "./scenes/Play.js";
9
+ import type { GameState } from "./state.js";
10
+
11
+ const game = defineGame<GameState, IPhysicsContext>({
12
+ input: {
13
+ // The four directions of `input.vector("move")`. Declared rather than inherited from the
14
+ // default binding, so the axis every scene reads is visible where the game is defined.
15
+ move: {
16
+ down: ["ArrowDown", "KeyS"],
17
+ left: ["ArrowLeft", "KeyA"],
18
+ right: ["ArrowRight", "KeyD"],
19
+ up: ["ArrowUp", "KeyW"],
20
+ },
21
+ blast: { keys: ["KeyE"], buttons: [2] },
22
+ damage: { keys: ["KeyH"] },
23
+ fire: { buttons: [0], keys: ["KeyF"], pointer: true },
24
+ lethal: { keys: ["KeyX"] },
25
+ probe: { keys: ["KeyC"] },
26
+ projectile: { buttons: [1], keys: ["KeyG"] },
27
+ restart: { keys: ["KeyR"] },
28
+ },
29
+ plugins: [rapier(), replay(), playtest({ events: drainPlaytestEvents })],
30
+ render: config.renderer,
31
+ scenes: { boot: Boot, play: Play },
32
+ seed: 89089,
33
+ start: "boot",
34
+ });
35
+
36
+ export default game;
@@ -0,0 +1,28 @@
1
+ import type { Vector3 } from "three";
2
+ import type { Target } from "../entities/Target.js";
3
+
4
+ export class SpawnPoints {
5
+ readonly points: readonly Vector3[];
6
+
7
+ constructor(points: readonly Vector3[]) {
8
+ if (points.length === 0) throw new Error("SpawnPoints requires at least one point.");
9
+ this.points = points.map((point) => point.clone());
10
+ }
11
+
12
+ furthestFrom(hostiles: readonly Target[]): Vector3 {
13
+ let best = this.points[0] as Vector3;
14
+ let bestDistance = -1;
15
+ for (const point of this.points) {
16
+ let nearest = Number.POSITIVE_INFINITY;
17
+ for (const hostile of hostiles) {
18
+ if (!hostile.alive) continue;
19
+ nearest = Math.min(nearest, point.distanceToSquared(hostile.mesh.position));
20
+ }
21
+ if (nearest > bestDistance) {
22
+ best = point;
23
+ bestDistance = nearest;
24
+ }
25
+ }
26
+ return best.clone();
27
+ }
28
+ }
@@ -0,0 +1,26 @@
1
+ import { acceptHotUpdate } from "@threenative/core/hot";
2
+ import { createElement, useState } from "react";
3
+ import { createRoot } from "react-dom/client";
4
+ import game from "./game.js";
5
+ import { App } from "./ui/App.js";
6
+ import "./render/ui.css";
7
+
8
+ function WebApp({ game: currentGame }: { game: typeof game }) {
9
+ const [paused, setPaused] = useState(false);
10
+ const onTogglePause = () => {
11
+ if (paused) currentGame.resume();
12
+ else currentGame.pause();
13
+ setPaused((value) => !value);
14
+ };
15
+ const onRestart = () => void currentGame.goto("play");
16
+ return createElement(App, { game: currentGame, onRestart, onTogglePause, paused });
17
+ }
18
+
19
+ import.meta.hot?.accept();
20
+ acceptHotUpdate(game, import.meta.hot);
21
+ const root = document.getElementById("root");
22
+ if (root === null) throw new Error("Missing #root element.");
23
+ const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
24
+ const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
25
+ appRoot.__threenativeRoot = reactRoot;
26
+ reactRoot.render(createElement(WebApp, { game }));
@@ -0,0 +1,49 @@
1
+ import type { CollisionShape3D, IPhysicsBodyHandle, IPhysicsContext } from "@threenative/physics";
2
+ import type { Vector3 } from "three";
3
+
4
+ export type SpacePoint = Pick<Vector3, "x" | "y" | "z">;
5
+
6
+ export interface IRayHit {
7
+ readonly body: IPhysicsBodyHandle;
8
+ readonly distance: number;
9
+ readonly entity?: string;
10
+ readonly normal: SpacePoint;
11
+ readonly position: SpacePoint;
12
+ }
13
+
14
+ export interface IShapeHit {
15
+ readonly body: IPhysicsBodyHandle;
16
+ readonly entity?: string;
17
+ readonly position?: SpacePoint;
18
+ }
19
+
20
+ export interface IPhysicsDirectSpaceState {
21
+ intersectRay(options: {
22
+ readonly collisionMask?: number;
23
+ readonly from: SpacePoint;
24
+ readonly maxResults?: number;
25
+ readonly to: SpacePoint;
26
+ }): IRayHit | undefined;
27
+ intersectShape(options: {
28
+ readonly collisionMask?: number;
29
+ readonly maxResults?: number;
30
+ readonly position: SpacePoint;
31
+ readonly shape: CollisionShape3D;
32
+ }): readonly IShapeHit[];
33
+ }
34
+
35
+ type QueryPhysics = IPhysicsContext & {
36
+ readonly directSpaceState: IPhysicsDirectSpaceState;
37
+ };
38
+
39
+ /**
40
+ * PRD-088 is the only route to a collider query. The cast keeps this kit source-compatible with
41
+ * the dependency lane while that public field is being integrated; it is not a fallback query.
42
+ */
43
+ export function directSpaceState(physics: IPhysicsContext): IPhysicsDirectSpaceState {
44
+ const state = (physics as QueryPhysics).directSpaceState;
45
+ if (state === undefined) {
46
+ throw new Error("TN_SHOOTER_SPACE_MISSING: @threenative/physics directSpaceState is required.");
47
+ }
48
+ return state;
49
+ }
@@ -0,0 +1,15 @@
1
+ type PlaytestEvent = {
2
+ readonly [key: string]: string | number;
3
+ readonly entity: string;
4
+ readonly name: string;
5
+ };
6
+
7
+ const pendingEvents: PlaytestEvent[] = [];
8
+
9
+ export function emitPlaytestEvent(event: PlaytestEvent): void {
10
+ pendingEvents.push(event);
11
+ }
12
+
13
+ export function drainPlaytestEvents(): PlaytestEvent[] {
14
+ return pendingEvents.splice(0);
15
+ }
@@ -0,0 +1,29 @@
1
+ // Generated for you. Camera framing is game-owned source; edit it to change the feel.
2
+ import type { PerspectiveCamera, Vector3 } from "three";
3
+ import { Vector3 as Vec3 } from "three";
4
+
5
+ export interface ICameraRig {
6
+ readonly follow: (target: Vector3, dt: number) => void;
7
+ readonly snap: (target: Vector3) => void;
8
+ }
9
+
10
+ export function createArenaCamera(camera: PerspectiveCamera): ICameraRig {
11
+ const offset = new Vec3(0, 5.2, 9.2);
12
+ const lookAhead = new Vec3(0, 0.4, -4.6);
13
+ const desired = new Vec3();
14
+ const aim = new Vec3();
15
+
16
+ const pose = (target: Vector3): void => {
17
+ camera.position.copy(target).add(offset);
18
+ camera.lookAt(aim.copy(target).add(lookAhead));
19
+ };
20
+
21
+ return {
22
+ follow: (target, dt) => {
23
+ desired.copy(target).add(offset);
24
+ camera.position.lerp(desired, 1 - Math.exp(-dt / 0.2));
25
+ camera.lookAt(aim.copy(target).add(lookAhead));
26
+ },
27
+ snap: pose,
28
+ };
29
+ }
@@ -0,0 +1,38 @@
1
+ // Generated for you. Keep the key, rim, and fill balanced with your new palette.
2
+ import {
3
+ AmbientLight,
4
+ DirectionalLight,
5
+ HemisphereLight,
6
+ PCFSoftShadowMap,
7
+ type Scene,
8
+ } from "three";
9
+ import { palette } from "./palette.js";
10
+
11
+ type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
12
+
13
+ export function setupLighting(scene: Scene, renderer: ShadowRenderer): void {
14
+ renderer.shadowMap.enabled = true;
15
+ renderer.shadowMap.type = PCFSoftShadowMap;
16
+ scene.add(new HemisphereLight(palette.skyHigh, palette.skyLow, 1.25));
17
+
18
+ const key = new DirectionalLight(palette.accent, 3.1);
19
+ key.name = "key-light";
20
+ key.position.set(-6, 10, 7);
21
+ key.castShadow = true;
22
+ key.shadow.mapSize.set(1024, 1024);
23
+ key.shadow.camera.near = 0.5;
24
+ key.shadow.camera.far = 70;
25
+ key.shadow.camera.left = -20;
26
+ key.shadow.camera.right = 20;
27
+ key.shadow.camera.top = 20;
28
+ key.shadow.camera.bottom = -20;
29
+ key.shadow.bias = -0.0008;
30
+ key.shadow.normalBias = 0.035;
31
+ scene.add(key);
32
+
33
+ const rim = new DirectionalLight(palette.player, 1.05);
34
+ rim.name = "rim-light";
35
+ rim.position.set(8, 5, -10);
36
+ scene.add(rim);
37
+ scene.add(new AmbientLight(palette.skyLow, 0.3));
38
+ }
@@ -0,0 +1,86 @@
1
+ import {
2
+ type Camera,
3
+ Mesh,
4
+ MeshBasicMaterial,
5
+ type OrthographicCamera,
6
+ PlaneGeometry,
7
+ type Scene,
8
+ } from "three";
9
+ import { palette } from "./palette.js";
10
+
11
+ export interface LoadingHost {
12
+ readonly camera: Camera;
13
+ readonly canvasLayer: {
14
+ readonly camera: OrthographicCamera;
15
+ readonly scene: Scene;
16
+ opaque: boolean;
17
+ };
18
+ readonly renderer: { compileAsync(scene: Scene, camera: Camera): Promise<void> };
19
+ readonly startup: { readonly progress: number; whenReady(): Promise<void> };
20
+ }
21
+
22
+ export function createLoadingScreen(host: LoadingHost) {
23
+ const layer = host.canvasLayer;
24
+ const camera = layer.camera;
25
+ const cover = (color: number, order: number): Mesh => {
26
+ const mesh = new Mesh(
27
+ new PlaneGeometry(1, 1),
28
+ new MeshBasicMaterial({ color, depthTest: false, depthWrite: false }),
29
+ );
30
+ mesh.frustumCulled = false;
31
+ mesh.renderOrder = order;
32
+ layer.scene.add(mesh);
33
+ return mesh;
34
+ };
35
+ const backdrop = cover(palette.skyLow, 0);
36
+ const track = cover(palette.skyHigh, 1);
37
+ const fill = cover(palette.accent, 2);
38
+ layer.opaque = true;
39
+ let width = 1;
40
+ let height = 1;
41
+ let progress = 0;
42
+
43
+ const layout = (): void => {
44
+ width = Math.max(1, camera.right - camera.left);
45
+ height = Math.max(1, camera.top - camera.bottom);
46
+ backdrop.scale.set(width, height, 1);
47
+ track.scale.set(width * 0.48, height * 0.012, 1);
48
+ track.position.set(0, -height * 0.06, 0);
49
+ };
50
+ const setProgress = (value: number): void => {
51
+ progress = Number.isFinite(value) ? Math.max(0, Math.min(1, value)) : 0;
52
+ const full = width * 0.48;
53
+ const bar = Math.max(full * 0.002, full * progress);
54
+ fill.scale.set(bar, height * 0.012, 1);
55
+ fill.position.set(-full / 2 + bar / 2, -height * 0.06, 0);
56
+ };
57
+ layout();
58
+ setProgress(0);
59
+ let done = false;
60
+ const finish = (): void => {
61
+ if (done) return;
62
+ done = true;
63
+ for (const mesh of [backdrop, track, fill]) {
64
+ mesh.removeFromParent();
65
+ mesh.geometry.dispose();
66
+ if (!Array.isArray(mesh.material)) mesh.material.dispose();
67
+ }
68
+ layer.opaque = false;
69
+ };
70
+ void (async () => {
71
+ await host.startup.whenReady();
72
+ await host.renderer.compileAsync(host.canvasLayer.scene, host.camera).catch(() => undefined);
73
+ finish();
74
+ })();
75
+
76
+ return {
77
+ finish,
78
+ update(): void {
79
+ if (done) return;
80
+ const nextWidth = camera.right - camera.left;
81
+ const nextHeight = camera.top - camera.bottom;
82
+ if (nextWidth !== width || nextHeight !== height) layout();
83
+ setProgress(host.startup.progress);
84
+ },
85
+ };
86
+ }
@@ -0,0 +1,38 @@
1
+ // Generated for you: ordinary Three.js materials, owned by this game.
2
+ import { MeshStandardMaterial } from "three";
3
+ import { palette } from "./palette.js";
4
+
5
+ export function createMaterials() {
6
+ return {
7
+ arena: new MeshStandardMaterial({ color: palette.arena, metalness: 0.35, roughness: 0.62 }),
8
+ accent: new MeshStandardMaterial({
9
+ color: palette.accent,
10
+ emissive: palette.accent,
11
+ emissiveIntensity: 0.24,
12
+ metalness: 0.2,
13
+ roughness: 0.38,
14
+ }),
15
+ hostile: new MeshStandardMaterial({
16
+ color: palette.hostile,
17
+ emissive: palette.hostile,
18
+ emissiveIntensity: 0.7,
19
+ metalness: 0.1,
20
+ roughness: 0.3,
21
+ }),
22
+ player: new MeshStandardMaterial({
23
+ color: palette.player,
24
+ emissive: palette.player,
25
+ emissiveIntensity: 0.22,
26
+ metalness: 0.35,
27
+ roughness: 0.34,
28
+ }),
29
+ shadow: new MeshStandardMaterial({ color: 0x101820, metalness: 0.5, roughness: 0.7 }),
30
+ trim: new MeshStandardMaterial({
31
+ color: palette.accent,
32
+ emissive: palette.accent,
33
+ emissiveIntensity: 0.45,
34
+ metalness: 0.45,
35
+ roughness: 0.28,
36
+ }),
37
+ };
38
+ }
@@ -0,0 +1,9 @@
1
+ // Generated for you. Keep the six palette roles coherent when you repaint the arena.
2
+ export const palette = {
3
+ skyHigh: 0x263449,
4
+ skyLow: 0x090d13,
5
+ arena: 0x18232d,
6
+ player: 0x64d8cb,
7
+ hostile: 0xff6b7a,
8
+ accent: 0xf6c85f,
9
+ } as const;
@@ -0,0 +1,19 @@
1
+ // Generated for you: ordinary Three.js postprocessing, owned by this game.
2
+ import { ACESFilmicToneMapping, type Camera, type Scene } from "three";
3
+ import { bloom } from "three/addons/tsl/display/BloomNode.js";
4
+ import { pass } from "three/tsl";
5
+
6
+ type OutputRenderer = {
7
+ kind: string;
8
+ raw: unknown;
9
+ setOutputNode(node: unknown): void;
10
+ };
11
+
12
+ export function setupPost(renderer: OutputRenderer, scene: Scene, camera: Camera): void {
13
+ const raw = renderer.raw as { toneMapping?: number; toneMappingExposure?: number };
14
+ raw.toneMapping = ACESFilmicToneMapping;
15
+ raw.toneMappingExposure = 1.12;
16
+ if (renderer.kind !== "webgpu") return;
17
+ const colour = pass(scene, camera).getTextureNode();
18
+ renderer.setOutputNode(colour.add(bloom(colour, 0.75, 0.48, 0.2)));
19
+ }