make3d

@

make3d is a lightweight framework for building 3D WebGL games in JavaScript, built on top of Three.js.

It focuses on providing game-oriented primitives (levels, players, NPCs, physics helpers, input, rendering utilities), while leaving scene hierarchy and lifecycle management to Three.js itself.

$3

- efficient, mobile-friendly rendering (Three.js)
- ready-to-use game abstractions (Level, Player, NPC)
- simple physics integration (powered by check2d)
- input, camera, rendering, and debug utilities included
- minimal structure, low abstraction overhead

---

demo

👉 https://nenjack.github.io/make3d/demo/?fps

---

demo code

``ts
import { Level, Player, NPC } from 'make3d'

Level.create().then(async (level) => {
await Player.create(level)

Array.from({ length: 50 }, () => new NPC({ level, ...Player.DEFAULT_PROPS }))
})
`

---

design philosophy

make3d relies on Three.js for scene hierarchy and object lifecycle, instead of introducing a separate entity system.

- Scene graph and transforms are managed by Three.js
- Game logic is built around Level, Player, and NPC
- Utilities are exposed as composable modules, not enforced patterns

---

exports

make3d exposes a focused set of modules, grouped by responsibility:

$3

- BaseLevel – base class for custom levels
- Level – main game level ready to use

$3

- Renderer – Three.js renderer wrapper
- Camera – camera helper
- BoxMesh – basic 2.5D mesh
- Sprite – sprite helper
- Skybox – skybox
- Ocean – ocean / water surface

$3

- Billboard – camera-facing objects
- Player – player entity
- NPC – non-player character

$3

- physics – shared physics instance (powered by check2d)
- DynamicBody – movable physics body
- StaticBody – static physics body
- AbstractBody – base physics body

$3

- mouse – shared mouse instance
- Mouse – mouse input handler

$3

- state – shared state container
- Events – event bus

$3

- Loader – asset loader
- TextureUtils – texture helpers

$3

- getQueryParams – get query params from current url
- Debug – debug helpers
- DeviceDetector – device detection

---

documentation

- API & architecture
https://nenjack.github.io/make3d/hierarchy.html

---

installation

`bash
yarn add make3d
``

---

license

MIT