Placements

A package places other packages in its own model: a building's sofa, bar and tables are Object packages its document places. A scene places buildings, characters and objects the same way, from the town's origin.

Placing

Drag a package from the Project tree onto a Design tab. While dragging, the view draws the object's box where it would land, as a dashed outline: a building opens for it (its roof and outer walls move aside), and the object sits on the floor inside, on a table, or on the ground (with Snap on, in 0.5 m steps). Drop it, and the document gets a placement, as one undoable command ("Place Uhren · Sofa"), and the new placement is selected:

"placements": [
  {"id": "uhren-sofa-2", "object": "uid://…", "position": {"x": 1.2, "y": 0, "z": -3},
   "rotation": {"x": 0, "y": 90, "z": 0}}
]

• position is in metres from the package's base centre (from the town's origin in a scene); rotation is in degrees, about the object's own base centre; scale is optional.
• The id comes from the object's folder: uhren-sofa, then uhren-sofa-2.
• A drag that cannot be done says why beside the pointer.

Placed into	What
a building or an object	objects
a scene	buildings, characters and objects

A package is not placed into itself; animations and scenes are not placed.

A placed object stays its own package

Its model, parts, fields and components are its own document's; the placement only says where it stands. A change to the object's document shows in every placement of it.

• The objects a placed object places show too (a sofa's cushion), up to four levels; an object that places what places it stops there. They are edited in their own packages.
• A selected placement moves and turns with the tools; the Inspector shows its place, with Open for its package.
• In Play every placement is an object of its own: its fields and components run separately in every placement, and Add the fields they use adds a missing field to the object's own package (Play).