# threejs-3d-assets

Premium low-poly 3D assets for three.js: game-ready, flat-shaded, real-world scale,
one draw call per model. 59 published assets (32 free). Every asset ships as a
GLB (works in three.js, Unity, Godot, Unreal, Blender) plus a drop-in ES module for
three.js. Characters are rigged on a standard humanoid skeleton.

This site is agent-friendly: everything below is stable, JSON, and keyable.

## API

Base: threejs-3d-assets.com/api (self-describing: GET /api)

- GET /api/assets            browse. filters: q, class (prop|building|vehicle|character|ultra),
                             free (0|1), kit, sort (latest|tris), page, per_page (max 100)
- GET /api/assets/{id}       one asset: triangles, size, palette, rigged parts, renders,
                             license, and the correct download URLs for you
- GET /api/kits              kits with published part counts
- GET /api/kits/{id}         one kit + its published parts
- GET /api/me                your account: email, plan, purchases (key required)

Auth: create an API key at /account (sign in with Google first), then send
  Authorization: Bearer tja_...
Public browsing works without a key; the key unlocks owned downloads and /api/me.

## Downloads

- FREE assets: no auth at all. Hotlink or fetch:
    /cdn/{id}.glb   /cdn/{id}.mjs
- PAID assets you own (purchase, kit, or lifetime): same Bearer key:
    /dl/{id}.glb    /dl/{id}.mjs
- A kit you own, as one file:  /dl/kit-{kit-id}.zip  (all parts + scene + license)
- Any published asset has a public degraded preview:  /cdn/{id}-preview.glb

## One draw call scenes (merging)

Every asset shares the SAME vertex-colored material (no textures), so any set of
them merges into a single geometry = one draw call for the whole scene:
    import { mergeAssets } from /cdn/merge.mjs
    const { merged, dynamic } = mergeAssets([obj1, obj2, {object: obj3, rig}]);
    scene.add(merged); dynamic.forEach(d => scene.add(d));
Place assets BEFORE merging (world transforms are baked in). Rig-declared parts and
skinned characters come back in `dynamic`, still animatable. For many copies of one
model, prefer THREE.InstancedMesh.

## License (summary)

Use anywhere, commercial included, modify freely, no attribution. Do not resell or
redistribute the files themselves as assets. Full terms: /licensing

## Humans

Store: /  ·  Browse: /assets  ·  Kits: /kits  ·  Account + API keys: /account