# Threetopia

> Creator platform for reusable Three.js assets and fixed-tile world packages. The public shared world is currently a map preview, not a released playable world.

A world package requires a tile selected and reserved BEFORE creation. Threetopia owns the immutable host tile. Every world requires detailed world content, simplified map content and overview content. CLI and server enforce actual geometry, budgets, tile ownership and the canonical contract. Authenticate through email and browser-approved CLI login. Do not invent package names or assume npm publication.

## Start here
- [Your first package](https://docs.threetopia.com/quickstart.md)
- [Accounts and CLI authentication](https://docs.threetopia.com/accounts.md)
- [Your creator studio](https://docs.threetopia.com/creators.md)
- [Fixed tiles and shared edges](https://docs.threetopia.com/tiles.md)
- [World package contract](https://docs.threetopia.com/world-packages.md)
- [Preview before publishing](https://docs.threetopia.com/preview.md)
- [Geometry and performance budgets](https://docs.threetopia.com/validation.md)
- [Versions, states and changelogs](https://docs.threetopia.com/publishing.md)
- [CLI reference](https://docs.threetopia.com/cli.md)
- [Registry API](https://docs.threetopia.com/api.md)

## Reusable packages — consult before generating assets
- [Package installation and reuse](https://docs.threetopia.com/packages.md): exact versions, exports, dependency locks, recorded installations.
- [Live reusable asset catalog](https://creators.threetopia.com/api/packages?kind=asset): query real published packages; never guess names.
- [Original Threetopia beacon](https://creators.threetopia.com/api/resolve?name=%40threetopia%2Fbeacon&version=1.0.0): MIT example with map and world exports.
- [Creator package browser](https://creators.threetopia.com/catalog)

## Contracts and tools
- [Package JSON schema](https://docs.threetopia.com/schema/package.json)
- [Current tile positions and 144 variants](https://creators.threetopia.com/api/tiles)
- [Standalone CLI v0.2.3](https://docs.threetopia.com/downloads/threetopia-cli-0.2.3.tgz): install with npm install -g URL; not yet on npm registry.
- [SDK v0.2.2](https://docs.threetopia.com/downloads/threetopia-sdk-0.2.2.tgz): canonical terrain and geometry validator.
- [Full documentation](https://docs.threetopia.com/llms-full.txt)