Objects

A HyperSpace Document (HSD) is the spatial equivalent of a web page — a self-contained 3D object with its own geometry, appearance, physics, and behavior. It is stored as a record and can be placed into any space.

Like a web page, an HSD can be authored by anyone and hosted anywhere. Unlike a web page, it carries its own behavior with it. An object does not depend on the space it is in to function.

Structure

An HSD describes a hierarchy of nodes — the parts that make up the object. Each node can have a position, a mesh (its geometry), a material (its appearance), physics properties, and scripts that define its behavior.

Meshes and textures are stored as blobs, separate from the record itself. This keeps the document light while allowing heavy assets to be cached and reused.

Behavior

Scripts are WebAssembly components embedded in the HSD. They run when the object is loaded into a space, letting objects animate, respond to interaction, and communicate with their environment through defined interfaces.

Because scripts are part of the object — not the space — their behavior is consistent wherever the object appears.

Collaboration

HSDs use the same CRDT system as all records. Multiple people can edit an object simultaneously. The object’s owner controls who has write access.