3D Props Tool
The 3D Props Tool browses and places linked Prefabs, static MZ mesh recipes and modular construction stamps. It is available in the 3D cameras (3D Iso, Orbit and First Person). In 2D and 2D Iso, use the Tile Picker and Rect tool.
Outside Orbit mode, its 3D keyboard shortcut is B. In Orbit, B is reserved for one-shot Box Select, so activate the 3D Props Tool from the left toolbar.
What It Does
The 3D Props Tool lets you:
- choose project Prefabs and built-in construction stamps from the Prefabs dock
- place project Prefabs as lightweight linked instances
- place practical building pieces such as floors, walls, corners, doorways, stairs, ceilings, columns, and solid blocks
- preview each block with a 3D-rendered icon
- stamp one block with a click
- drag line or rectangle strokes of repeated blocks
- replace or erase existing block instances
- rotate blocks in 90-degree steps
- stack blocks on different grid levels
- make component-aware height and width adjustments before stamping
- stamp clean or damaged geometry variants
MZ mesh placements remain linked to their recipe without requiring a Prefab. Project Prefab placements remain linked to their shared UUID-backed source. Built-in construction stamps currently become ordinary editable Geometry Objects; you can continue editing them with the Object, Face, Edge, and Vertex tools.
Reusable Prefabs
Project Prefabs are Eldiron's reusable 3D assets. One source asset owns its Geometry Objects, part hierarchy, pivots, paint, support surfaces, and behavior. Regions contain lightweight instances that refer to the source through its stable UUID.
This distinction is important:
| Source asset | Linked instance |
|---|---|
| Shared geometry, materials, paint, parts, pivots, support surfaces, and behavior | World position, rotation, scale, and runtime state for one placement |
| Edited in the isolated Prefab editor | Selected and positioned in a region |
| One stable project UUID | Its own stable instance UUID plus the source UUID |
| A source edit updates every linked placement | Moving one instance does not move or edit the others |
Built-in construction stamps and project Prefabs share the 3D Props Tool, but they have different results. A project Prefab is placed as a linked instance. A built-in floor, wall, stair, doorway, or similar stamp is baked into ordinary editable Geometry Objects.
Create A Project Prefab
Prefab creation is an Object-mode operation in a normal 3D region:
- Model the asset from one or more Geometry Objects.
- Switch to the Object Tool and select every object that belongs to the asset.
- In the action list, choose either Create Linked Prefab or Create Prefab Copy.
- Eldiron creates a project asset with a stable UUID and selects it in the Prefabs dock.
- Rename and refine the source in the isolated Prefab editor.
The creation actions differ as follows:
- Create Linked Prefab moves the selected content into a reusable source and replaces the region selection with one linked instance at the same location. Surface-clipped 3D Paint owned by the selected objects is moved into asset-local Prefab paint so it renders on every linked instance.
- Create Prefab Copy creates a reusable source but leaves the selected region objects untouched. Those original objects remain independent geometry and no longer follow the Prefab source.
The source is localized around the bottom center of the selected geometry. This gives the Prefab a practical placement origin while the replacement instance remains at the original world position.
New assets receive an automatic name such as Prefab 1. To rename one, open its isolated editor and edit the Prefab field in the lower inspector. Renaming changes only the display name; the UUID, instances, geometry, paint, and authored behavior remain linked.
Place A Project Prefab
- Activate the 3D Props Tool.
- Select the project Prefab in the Prefabs dock.
- Move the pointer over the desired 3D placement surface.
- Click to place a linked instance.
Place as many instances as needed. Every placement keeps an independent transform and runtime state, but all resolve the same source asset. Editing the source later updates them without recreating the placements.
To reposition an existing linked instance, select any visible part of it with the Object Tool, press M if necessary, and drag the move gizmo or drag the selected instance directly. Moving changes only that placement's world transform. The Size operation is intentionally unavailable for linked instances because geometry dimensions belong to the shared source; edit the source, make the instance unique, or unpack it when its shape must change independently.
Open And Close The Isolated Editor
Select a project Prefab in the browser, then click Edit Prop in the viewport overlay to open it. Selecting its thumbnail only selects it for placement. The top-right Edit / Maximize Dock control (Cmd/Ctrl + [) also opens the source. Editing a built-in construction stamp first creates an editable project Prefab from it.
The isolated editor:
- displays only the selected Prefab source and a neutral preview grid
- starts in Orbit view and frames the asset automatically
- reuses the normal Object, Face, Edge, Vertex, camera, ViewCube, gizmo, action, undo, and redo paths
- disables unrelated region content and editor post-processing while it is open
- writes changes back to the same Prefab UUID
- provides Prefab-specific hierarchy, pivot, Door, paint, tile, palette, and support-surface controls
Use Restore Dock (Cmd/Ctrl + ]) to return to the normal region layout. Eldiron restores the previous region and camera context and returns to the 3D Props Tool.
Advanced source editing happens in this isolated editor. A linked instance in a region can be positioned, made unique, or unpacked, but its shared Geometry Objects are not edited directly in place.
Editor Modes
The lower section follows the active tool so each workflow has one shared UI implementation:
- Parts: Object, Face, Edge, and Vertex tools show independent part branches, the shared node canvas, support surfaces, and Prefab actions.
- 3D Paint: the 3D Paint Tool shows the same brush and layer UI used by the region editor, but writes asset-local Prefab paint.
- Tiles: the Tile Picker Tool shows the normal Tiles dock for applying tiles and materials to the Prefab's selected faces or objects.
- Palette: the Palette Tool shows the normal project palette editor and lets Prefab geometry use the same project palette workflow.
The contextual action list remains available beside the editor. Region-only actions, post-processing controls, and tools that do not apply to a Prefab source are hidden.
Model The Source
Prefab parts can also use MZ geometry recipes. Select source objects or faces and run Apply MZ Recipe. The selected geometry stays in place and a new recipe-backed part holds the generated result. Select that result and use Edit MZ Recipe to edit its MZ construction and published controls. Pivots, attachments, support surfaces and behavior remain Prefab data.
Use the Object, Face, Edge, and Vertex tools exactly as in the normal 3D editor. Object editing shortcuts such as M for move and S for size operate on source geometry, and camera movement keeps the transform handles aligned to the current view.
The same contextual modeling actions are available where applicable. Common Prefab-building operations include:
- Create Box to attach a box fitted to the selected surface
- Create Unit Box to attach a centered
1 × 1 × 1primitive without fitting its size - duplicate selected Geometry Objects for repeated legs, slats, handles, or trim
- edit faces with extrude, inset, subdivide, delete, texture, and opening actions
- edit edges, contours, and vertices with the normal direct-geometry tools
- assign tiles, materials, project palette colors, and 3D Paint
See Object Tool, Sector / Face Tool, Linedef / Edge Tool, Vertex Tool, and Creator Actions for the complete shared modeling operations.
Prefab Part Branches
Each logical part has its own graph. Select a part in the left branch list to edit its nodes and select its Geometry Objects in the viewport. A typical branch runs left to right:
Part → Transform → Door
- Part sets the part name while preserving its identity. The Part node's Geometry output carries its authored meshes into the chain. Continue modeling and painting those meshes in the viewport.
- Transform provides numeric text fields for the Prefab-local pivot coordinates. Type a value and press Return to apply it. Set Pivot fills these fields from the current geometry selection.
- Door configures swing or slide motion, open angle, slide distance and usage distance. Existing paired gates retain both leaves and their shared state.
Open the sidebar's Node List and drag nodes into the selected branch. Connect their terminals from left to right. Shift-drag across a connection to cut it. Disconnected Door nodes retain their settings but do not configure an active door. Reconnect the node to restore it.
Branches use global undo/redo. Tidy Branch arranges the current branch and fits it into view; branches are also arranged on first opening. Editing connections does not rearrange the graph.
The toolbar keeps direct mesh operations:
- Create Part moves selected Geometry Objects into a new logical part.
- Remove Part moves its objects into another remaining part without deleting the meshes. A Prefab retains at least one part.
- Set Pivot derives the pivot from the current vertex, edge, face or object selection and updates the Transform node.
- Part Links opens prefab naming, part parenting and selected-object assignment controls.
- Create Surface creates a support surface from selected faces. Select a support surface in the left list to open its settings; Remove Surface removes its definition.
- Preview Door toggles the selected part's door preview.
Set A Part Pivot
The pivot controls part motion. For a swinging door, it must lie on the hinge axis rather than at the center of the leaf.
- Select the part in the branch list.
- Switch to Vertex, Edge, Face, or Object mode.
- Select the geometry whose center represents the desired pivot. For a door hinge, select the vertical hinge edge or its two vertices.
- Click Set Pivot.
The Transform node updates in Prefab-local coordinates. Rotating a Door part then keeps the hinge edge fixed while the rest of the leaf moves around it.
Paint A Prefab
Choose the 3D Paint Tool while the isolated editor is open. The lower section switches to the complete shared Paint UI, including its brush, layer, and palette controls.
Prefab paint is stored in source-local coordinates and is resolved against stable geometry identities. Painting the source therefore appears on every linked instance, including differently positioned or rotated placements. Returning to the Object, Face, Edge, or Vertex tool switches the lower section back to the part branches without discarding the paint.
Tiles and materials are still face properties rather than 3D Paint. Use the Tile Picker or Palette Tool for those sources, and 3D Paint for brush-based surface detail.
Create A Door Or Gate
A standard Door is behavior attached to a complete moving part. You do not select interaction faces: clicking any visible geometry in the controlled part can resolve the Door.
For a single swinging door:
- Create or fit the door geometry. For an opening, select one rim edge, press C to select its contour, and run Create Fitted Geometry; it derives the opposite contour from the connected reveal faces.
- Convert the new object to a linked Prefab and open its isolated editor.
- If the Prefab also contains a frame or other static geometry, select the leaf objects and click Create Part so only the leaf moves. A Prefab containing only the leaf can use its existing part.
- Select the leaf's hinge edge or hinge vertices and click Set Pivot.
- Drag a Door node from the Node List into the part branch and connect it after Transform.
- Set Motion to Swing, then choose the signed Open Angle and Usage Distance.
- Click Preview Door to toggle the open/closed preview.
For a sliding door, choose Slide and set Slide Distance. Open Angle is ignored. Existing fitted motion axes and paired-gate bindings are preserved when importing a prefab.
Preview Door changes only the editor preview. It does not modify the Prefab's authored closed geometry and closes automatically when geometry editing resumes.
At runtime, the existing authoring and rules system remains in control. Look can target any visible part of any Prefab and show its authored description, whether or not the Prefab has a component. Use, Open, and Close first pass through contextual authoring/rules resolution and may then continue into the built-in Door behavior. This allows a Door to show Look text, reject a locked interaction through rules, or perform authored logic without requiring marked faces.
Create A Support Surface
A support surface marks exact Prefab faces on which items may be placed, such as a tabletop, shelf, counter, altar, bed, or window ledge. It references existing faces without copying or changing their geometry.
To author one:
- Open the Prefab's isolated editor and switch to the Sector / Face Tool.
- Select one or more coplanar faces that form the usable area.
- Ensure all selected faces belong to the same logical part. They may span several Geometry Objects within that part.
- Click Create Surface in the Prefab toolbar.
- Edit the surface in the anchored settings popover.
The new surface appears below its owning part in the hierarchy. Select it to restore its face selection and make the usable area visible. Click Surface Settings to reopen the popover, or Remove Surface to remove only the placement definition. Removing a surface never deletes or modifies its Geometry Objects.
The settings are:
- Surface Name: label shown in the hierarchy and available to later authoring or scripting tools.
- Snap Spacing: item-placement grid in Prefab-local units. Use
0for continuous placement. - Allowed Tags: comma-separated item tags. Leave empty to allow any item. Authored items automatically offer
placeableand their item type in addition to explicit tags. - Capacity: maximum number of items on the surface. Leave empty for no explicit limit.
- Occupancy:
- Reject Overlap rejects an occupied snapped position.
- Allow Overlap permits multiple items at the same position.
- Single Occupant permits only one item on the entire surface.
Create Surface is enabled only when a valid face selection exists. Surface Settings and Remove Surface are enabled only while a surface is selected in the left list. Creation is rejected if the faces are not coplanar or span more than one part.
Place Items On A Support Surface
Support surfaces are used in the normal region editor, not in the isolated source editor:
- Place a linked instance of the table, shelf, or other supporting Prefab.
- Use the Entity Tool to drag an existing item, or drag a new item from the sidebar.
- Move it over the authored support surface and drop it.
Eldiron snaps the position, validates allowed tags, capacity, and occupancy, and stores a relationship containing the Prefab instance UUID, support-surface UUID, and a surface-local transform. The item therefore follows the linked Prefab when the instance moves and is recalculated when the source or instance transform changes.
If placement is rejected, the status bar reports whether the item is not allowed, the surface is full, or the position is occupied.
Update, Detach, Or Branch A Prefab
These contextual Object-mode actions operate in a normal 3D region:
- Update Prefab Source replaces the currently selected project Prefab's authored source with the selected Geometry Objects while preserving the asset UUID and all linked instances. This is a source rebuild: existing parts, support surfaces, interaction targets, components, and asset-local paint are cleared because their stable geometry references belonged to the old source. Use the isolated editor for ordinary incremental changes.
- Make Prefab Unique duplicates the source behind exactly one selected linked instance, creates a new UUID, and relinks only that instance. Later source edits no longer affect placements of the original asset.
- Unpack Prefab resolves selected linked instances into ordinary editable Geometry Objects and removes those placements' source links, support-surface placement relationships, and Prefab behavior. The reusable source asset and its other instances remain unchanged.
Use Make Prefab Unique when one placement should become a separately reusable variant. Use Unpack Prefab when the result should stop being a Prefab entirely.
Example: Build A Table Prefab
- Create the tabletop with Create Box or Create Unit Box, then size it.
- Create one leg, duplicate it, and position the copies.
- Select the tabletop and legs in Object mode and run Create Linked Prefab.
- Open the selected Prefab in the isolated editor and rename it in the Prefab field.
- Apply tiles, materials, palette colors, and 3D Paint as needed.
- Switch to Face mode, select the top face or coplanar top faces, and click Create Surface.
- Give the surface a useful name such as
Tabletop, then configure snapping, tags, capacity, and occupancy. - Restore the normal editor and place additional linked table instances from the Prefabs dock.
- Drag an item onto any table instance with the Entity Tool.
The table does not need separate parts unless a section must move independently or needs its own hierarchy, pivot, or semantic ownership.
Current Boundaries
- Project Prefab parts may use authored Geometry Objects or MZ recipes applied to source geometry. Static standalone MZ recipes can also be placed directly from MZ Meshes, without creating Prefab assets.
- Direct MZ placement currently accepts static mesh recipes. Rigs, particle-effect recipes and recipes requiring selection input belong to their existing character/item or Apply MZ Recipe workflows.
- Direct static MZ meshes do not add runtime state behavior. Author existing Door components in the Prefab editor.
- Built-in construction stamps are editable baked geometry, not linked project Prefabs.
- Linked source geometry is edited in the isolated editor rather than directly inside a region.
- Update Prefab Source is a destructive source rebuild for Prefab-specific semantics; it is not the normal way to save incremental source edits.
- Unpack Prefab removes Prefab behavior and support relationships from those placements.
- Stable UUIDs make project assets suitable for future library, packaging, import/export, and database sharing, but those sharing workflows are not yet exposed by the Creator UI.
Browser And Viewport Overlay
Activating 3D Props opens the lower browser. Categories separate Blocks, Furniture, Decoration, Lighting, Project Props and MZ Meshes. The browser contains thumbnails; placement settings live in the floating viewport overlay.
MZ recipe names appear first. A background worker generates thumbnails for the visible rows and prioritizes the selected recipe; scrolling requests the newly visible rows. Scrolling and selection stay available while previews arrive, and updating a thumbnail preserves the current scroll position. A selected recipe finishes preparing in the background before its placement preview becomes available.
Selecting a thumbnail keeps the map open. Move over the map to see the placement ghost, then click once or drag a line/rectangle stroke. To edit the source, explicitly choose Edit Prop or Edit Recipe in the overlay.
| Overlay control | Effect |
|---|---|
| Place / Replace / Erase | Add geometry, replace stamped content at the target cells, or erase it |
| Line / Rect | Choose the repetition pattern while dragging |
| Rotate | Turn the next placement by 90°; existing placements stay in place |
| Placement… | Set block-grid size and level; project Props and MZ meshes also expose the normal map subdivisions |
| Height / Width expansion / Depth expansion | Available in Placement for resizable construction stamps and auto-sized Prefabs |
| Clean / Damaged | Available for construction stamps |
| Edit Prop | Explicitly open the isolated source editor |
| Duplicate / Delete Prefab | Manage project Prefab sources; deletion refuses sources with live placements |
| Edit Recipe | Explicitly open the selected MZ mesh's recipe |
| Recipe Controls… | Change the recipe's published inputs without opening the full MZ editor |
Overlay gestures are captured through release, including a release outside the panel. Rotating or changing a setting does not place an object on the map.
Place An MZ Fence Without A Prefab
- Create or import a mesh with the MZ recipe browser, for example Fence. It appears in MZ Meshes once it is a valid static mesh recipe.
- Select it in 3D Props → MZ Meshes. Selection keeps the map visible.
- Set rotation and placement snapping in the overlay, then click to place it.
- Open Recipe Controls…. Change Post count or Spacing. Published numeric, integer and palette inputs use normal editor controls. Calculated fields are displayed as values.
- The saved recipe updates and its placed geometry rebuilds. The calculated fence length follows count and spacing. Each placement retains its own transform and stable face identities, including individual face material overrides.
- Save and reopen the project. Placements still reference that same MZ recipe. No Prefab wrapper was created.
These controls edit the shared source, so all linked placements follow. For a separately reusable variant, duplicate the recipe in the MZ recipe browser and place that variant. Use the geometry selection tools to move existing objects.
A recipe requiring a selected frame, such as Pitched roof, uses Apply MZ Recipe on selected geometry. It is intentionally absent from the standalone placement category.
Try Doors, Lights And Stacking
- Hinged door: create a leaf as a project Prefab, choose Edit Prop, set its hinge pivot and connect the existing Door node. Place two copies; each keeps its own open/closed state.
- Wall light: select Lighting → Wall Torch, then point at a valid wall. Mounting, attached particles and the live light are retained. Invalid mounting surfaces are rejected.
- Tabletop decoration: place a furniture Prefab with a support surface, then place a small Any Surface decoration on that surface. Existing snapping, capacity and occupancy checks remain active.
- Parameterized mesh: use the fence example above; its construction inputs stay in MZ rather than becoming placement-only scale values.
Switching Between 2D Iso And 3D
2D Iso tiles are baked sprite art. Their sprite sheets and placement footprints are excluded from 3D editor rendering. Switching cameras does not convert them into 3D objects. The shared terrain, its material layers and sculpting, authored Geometry Objects and linked 3D Props remain available. To use an MZ construction in 3D, place its actual mesh recipe through 3D Props → MZ Meshes.
The source Iso tiles and map placements are retained when switching views. Returning to 2D Iso shows them again. The 3D Props tool button is dimmed and inactive in both 2D cameras.
Placement Grid
The 3D Props Tool uses its own block grid for construction stamps in 3D views. While placing these stamps, this grid replaces the normal edit grid.
Placement and preview are projected onto the active block-grid plane. This keeps stamps aligned even when the camera is zoomed in or the cursor is over existing geometry.
Use the stack shortcuts to move the active block grid up and down.
Block Stamps
The current starter library includes:
- Floor Slab
- Floor + Wall
- Floor + Wall + Ceiling
- Floor + Corner
- Floor + Doorway
- Stairs
- Wall
- Doorway
- Ceiling Slab
- Full Block
- Large Block
- Column
- Plain Column
Composite stamps are intended as the main workflow. For example, Floor + Wall places a walkable floor tile and a wall on one cell edge in a single action. Rotation changes which side of the cell receives the wall.
Columns are stamped as editable faceted cylinder geometry, not rectangular posts. Column includes base and cap pieces, while Plain Column is a clean single shaft.
Place, Replace, And Erase
The operation buttons control what happens when you click or drag:
- Place: add the selected block stamp
- Replace: remove existing block instances on the affected cells, then place the selected block stamp
- Erase: remove existing block instances on the affected cells
Replace and Erase operate on whole block instances. A doorway, corner, or floor+wall stamp may contain multiple Geometry Objects, but it is removed as one block instance.
Line And Rectangle Strokes
Click places one block stamp.
Drag with Line selected to stamp along a straight grid line between the drag start and end cells.
Drag with Rect selected to stamp a filled rectangular area.
The 3D overlay previews the whole pending stroke before mouse-up. Erase strokes are shown with red cell outlines.
Clean And Damaged Stamps
Use Clean / Damaged to choose whether newly stamped geometry should be intact or chipped.
When Damaged is active, the 3D Props Tool applies deterministic damage while stamping. The damage is baked into the placed Geometry Objects and stored with a seed, so undo, redo, save/load, and copy/paste do not regenerate a different result.
Damage only affects newly stamped blocks. Existing blocks are not changed when you toggle the mode.
Component-Aware Sizing
The 3D Props Tool remembers height and width settings for built-in construction stamps. These settings are applied intelligently per component:
- floors ignore height changes
- walls, posts, columns, ceilings, and lintels react to height changes
- width-aware pieces expand by tile increments
- widened doorways grow the opening without thickening the side posts
This means make higher affects wall-like pieces but not floor slabs. Make wider affects the useful span of pieces such as walls, floors, ceilings, stairs, and doorway openings.
Shortcuts
When the 3D view has focus:
- B: activate the 3D Props Tool in Iso and First Person; in Orbit, arm Box Select instead
- R: rotate the selected block 90 degrees
- E: toggle Place / Erase
- D: toggle Clean / Damaged stamping
- [: move the block grid one level down
- ]: move the block grid one level up
- h: make height-aware components one tile higher
- Shift + H: make height-aware components one tile lower
- w: make width-aware components one tile wider on each side
- Shift + W: make width-aware components one tile narrower
After Stamping
Built-in construction stamps are baked as editable Geometry Objects. After stamping, use the direct 3D tools to refine them. Project Prefabs should instead be edited through their isolated shared-source editor unless you first use Unpack Prefab.
- Object Tool: move, resize, duplicate, delete, and assign sources to whole objects
- Sector / Face Tool: edit faces and assign tile/material sources
- Linedef / Edge Tool: edit edges and draw surface details
- Vertex Tool: edit vertices
Tips
- Use Floor + Wall and Floor + Corner for room outlines.
- Use Floor + Doorway where corridors or rooms connect.
- Use Rect strokes with Floor Slab for fast room floors.
- Use Replace to correct a run of wall cells without erasing manually first.
- Use Erase to remove block instances cleanly, especially multi-piece doorways and corners.
- Use the height shortcuts before stamping taller walls; floors in composite stamps stay thin.