mml

# MML (Metaverse Markup Language)

> **Full compiled reference:** `/home/ubuntu/.openclaw/workspace/research/mml-reference.md`
> Source: mml.io + DashBODK Studio (dashbodk.vercel.app/docs). All elements, attrs, events, collision patterns.

MML is an HTML-like markup language for building 3D scenes. Documents are served via WebSocket and rendered by clients (Web/Three.js or Unreal Engine). MML supports scripting via inline `<script>` tags (standard DOM APIs).

## Key Concepts

- **Units:** Positions in meters, rotations in degrees, font sizes in centimeters
- **Coordinate system:** x (right), y (up), z (forward)
- **Common attributes:** All visible elements share `x y z rx ry rz sx sy sz visible id class`
- **Collision system:** Set `collision-interval` (ms) on an element to receive `collisionstart`, `collisionmove`, `collisionend` events
- **Document time:** Animations and media use document lifecycle time (ms since document start)
- **Scripting:** Standard DOM manipulation via `<script>` tags. Use `document.getElementById()`, `addEventListener()`, `setAttribute()`, etc.

## Elements Quick Reference

| Element | Purpose | Key Attrs |
|---------|---------|-----------|
| `m-group` | Container, transforms children as unit | (transform only) |
| `m-cube` | 3D box | `width height depth color opacity` |
| `m-sphere` | 3D sphere | `radius color opacity` |
| `m-cylinder` | 3D cylinder | `radius height color opacity` |
| `m-plane` | Flat surface | `width height color opacity` |
| `m-model` | Load 3D model (GLTF/OBJ/FBX) | `src anim-src anim-loop anim-enabled start-time pause-time` |
| `m-character` | 3D character (composable with m-model children) | `src anim-src anim-loop anim-enabled start-time pause-time` |
| `m-light` | Point or spotlight | `type intensity distance angle enabled cast-shadows color` |
| `m-image` | Display image in 3D | `src width height emissive opacity` |
| `m-video` | Display video in 3D (supports WHEP streaming) | `src width height emissive loop enabl...