The Plaza — GitWorld Template

A virtual world as a git repository. Fork it, edit it, push it — your world goes live on GitHub Pages.

A cobblestone town square: a two-tier stone fountain at the center, shop facades with glowing windows and striped awnings, market stalls, iron lamps, planters, and benches. A natural fit for social and event worlds.

Quick Start

1. Fork this repository (or click "Use this template")
2. Go to Settings > Pages and set Source to GitHub Actions
3. Push any change (or manually trigger the workflow)
4. Visit https://YOUR-USERNAME.github.io/YOUR-REPO-NAME/

Project Structure

world.veml                  # World definition (entities, sky, lighting)
models/                     # glTF (.glb) scenery: fountain, shops, market stall, lamp, planter, bench, cobble ground
scripts/                    # Player controller + panel bridge
panels/welcome.html         # Screen-space UI overlay
index.html                  # WebGL runtime loader page
.github/workflows/deploy.yml# CI: downloads runtime + deploys to Pages

Editing

Everything visual lives in world.veml. Copy any <entity> block and change its position/rotation/scale to rearrange the scene. Three things to know:

1. mesh-name is the glTF file the runtime loads (path relative to the world or an absolute HTTPS URL). For self-contained .glb files, repeat the same path in mesh-resource (required by the schema).
2. Primitives (plane/cube/cylinder) are corner-anchored — they extend in +x/+z from their position. Offset by half the scale to center.
3. Entity id values must be valid UUIDs — generate at uuidgenerator.net.

For the full walkthrough (VEML reference, scripting, HTML panels, multiplayer), see the GitWorld-Starter tutorial.

Controls

Input	Action
W/A/S/D	Move
Mouse	Look
Space	Jump
VR Sticks	Move + Look

License

World content in this template is released under CC0 1.0. The WebVerse runtime has its own license — see WebVerse-Runtime.