DioramaTiles Studio - User Guide

Everything you need to know to get started - kept short and to the point.

Getting Started

DioramaTiles Studio is a browser-based editor for arranging your Diorama Tiles STL sets into a complete diorama layout - placing, rotating, grouping, and exporting a print list and build guide when you're done.

Everything runs locally in your browser. Nothing you place, save, or load is ever uploaded anywhere - the editor only reads STL files from a folder on your own computer that you select yourself.

The first thing to do: load your STL Source folder (see next section) - without it, the editor has nothing to place.

STL Source & File Naming

How to Start: Getting Your STL Files Ready →

Read this first - especially important if you own files from before the Great Hall campaign, or from Campaign #1 (Adventure Bundle) / Lava Burst.

Setting up your STL Source folder

  1. Create a folder anywhere on your computer (any name works, e.g. STL-Source).
  2. Copy your downloaded Diorama Tiles STL sets into it, keeping their original subfolder structure.
  3. In the editor sidebar, click Load STL Source and select that folder.
  4. The Tile Browser fills in automatically with everything found.
Not sure if you already have the latest files? Re-download your library from MyMiniFactory and replace your STL Source folder contents - it's the simplest way to make sure you're up to date.

Why file naming matters

The editor automatically corrects a number of real-world inconsistencies between STL files - inconsistent origins, small rotation offsets, naming quirks - so that everything snaps together correctly on the grid. This correction logic relies on the current Diorama Tiles naming convention (introduced with the Great Hall campaign).

Older files that still use the previous naming convention will not be recognized correctly. If pieces appear missing or misplaced, re-downloading the current files is the fix - not a setting to change in the editor - see the "How to Start" guide above.

SOCKET locking variant

The editor is built around the SOCKET locking variant of each file. Other locking variants (LOCK, OpenLOCK) work as a fallback and can still be placed, but may show minor visual inconsistencies in the editor (this does not affect your actual 3D prints - it's a display-only issue inside the editor). For the cleanest experience, keep SOCKET files in your STL Source folder.

Asset Check

After loading your STL Source folder, the editor compares what it found against the full Diorama Tiles catalog. If anything is missing or doesn't match, a small warning button appears - click it for a full report, with an option to export it as a text file.

Workflows by Skill Level

Three ways to work with the editor, roughly from easiest to most advanced - pick whichever fits what you're trying to do.

Beginner

A) Start from a complete Setup

Load a ready-made Setup from the Setup Browser - it places a complete, pre-arranged layout in one click. From there, export a Print List and Build Guide right away, or rearrange and duplicate the placed groups to make it your own.

Intermediate

B) Build with Presets

Presets (Preset Browser) are smaller, pre-grouped arrangements you place individually and combine yourself - more flexibility than a full Setup, without starting from a single empty tile.

Advanced

C) Work at Tile level

Full control: place, rotate, and group individual tiles yourself from the Tile Browser. Save your own layouts as Setups to reuse or share later.

The Interface

The DioramaTiles Studio interface with its main areas numbered
The main areas of the editor at a glance.

The sidebar on the left is where you pick what to place. The navigator panels on the right of the viewport show what you have already placed and control what stays visible. You can drag the edge of the sidebar to make it wider or narrower - the width is remembered.

Setup Browser

Complete, ready-to-place layouts. Click one to place the whole Setup at once. Alongside the Setups that ship with the editor, there is a Custom section: point it at a folder of your own saved Setup files and they all appear here together, ready to place like any other.

Preset Browser

Smaller pre-grouped arrangements - click to place, then rearrange as needed. Same Custom option as above: collect your own saved Presets in one folder and load them as a set instead of opening them one file at a time.

Tile Browser

The full catalog, organized by category and set. Drag any tile into the viewport to place it. Items you don't have locally yet are still shown (at reduced opacity) so you can see what's available in the full set. The small i button next to a set opens its description and photos.

Three collapsible panels at the top right of the viewport. They all work the same way: click the header to fold them away, click an entry to select it in the scene.

Groups (Presets) Navigator

Lists every group currently in your scene - useful once the board gets crowded and clicking the right piece becomes fiddly. Groups you named yourself (right-click → Rename group) appear under that name.

Assembly Kit Navigator

The same idea for multi-part kits placed through the Assembly Configurator. They are listed separately because they behave differently: a kit stays a single unit and can be reconfigured later (right-click → Configure) instead of being taken apart.

Level Navigator

Your layout is divided into levels of 50 mm each - Ground Level covers 0 up to 50 mm, Level 1 from 50 to 100 mm, and so on. The panel lists every level currently in use and lets you hide or show each one individually. Hiding upper levels is the easiest way to reach something underneath a bridge or platform.

The two arrows in the panel header move the current selection one level up or down - see Change level for the details and the keyboard shortcuts.

A piece belongs to a level by the height of its anchor point, not by how tall it is - a tall wall standing on Ground Level counts as Ground Level even if it reaches into the level above.

Status Bar & View Menu

Top-left of the viewport: the number of placed tiles, plus two controls.

Color Theme

Switches the look of the tiles in the editor - handy to see structure more clearly, or just to set the mood while building. Display only; nothing about your files changes.

View menu

  • Light Settings - different lighting moods for the scene.
  • Show Axes - a helper cross showing the orientation of the grid.
  • Render Quality - High / Balanced / Low. Turn this down if the viewport feels sluggish.
  • Fix Display - rescue options, see Troubleshooting.

Directly below sits Quick Reference - every action and shortcut at a glance, without leaving the editor.

Actions & Shortcuts

Everything you can do with placed tiles and groups. Most actions have two routes - the mouse or context menu, and a keyboard shortcut. A dash means there is no second route for that action.

Right-click always acts on the current selection. If you right-click something that isn't selected yet, it becomes the selection first.

Loading the action list… if it doesn't appear, open the Ref button in the editor instead - it shows the same overview.

Assembly Configurator

Some catalog items are marked with an "Assembly X" badge - these are parts of a multi-piece kit. Dragging one of them opens the Assembly Configurator instead of placing it directly.

The Assembly Configurator with one option selected per slot and a live preview
Pick one option per slot - the preview updates as you choose.

The Slot System

Each Assembly set has a number of "slots" (e.g. a base and a top piece) - pick one option per slot, preview the result live, then confirm to place the whole assembly as one group.

Limitations

  • Some slots are mandatory and can't be skipped.
  • Not every combination of options is available for every set - the configurator only offers valid combinations.
  • Once placed, an assembly behaves like a single group - use the regular group actions (move/rotate/duplicate) to work with it further.

Board, Export & Import

Board size - the button below the status bar shows your current board template; click it to choose a different size or a custom one. It draws a boundary line only and never restricts where you can place things.

Export

Build Guide - the step-by-step instructions

This is the one to know if you loaded a ready-made Setup and now want to build it for real. It turns your current layout into an illustrated, step-by-step HTML file you can open in any browser, on the tablet next to your workbench or on a second screen - which piece goes where, in order.

Two variants, differing only in how the images travel with the file:

  • Linked - small file, images are fetched from the web when you open it. Needs an internet connection at build time.
  • Embedded - images are baked into the file. Larger and slower to generate, but works completely offline - the safer choice for a workshop without WiFi.

Print List - what to print

A complete parts list of everything in your layout, aggregated by item so you know how many copies of each piece to print. You choose the locking variant (applies to the whole export) and the format:

  • HTML (formatted) - ready to read and print, optionally with preview images: None (fastest), Linked, or Embedded - same trade-off as the Build Guide above.
  • CSV (spreadsheet) - for opening in a spreadsheet, sorting, or feeding into your own print planning.
You can also export just part of your layout: select it, then right-click → Print List or Export. Useful for printing one section at a time instead of the whole board at once.

Save Setup

Stores the current layout as a file you can reload later or pass on to someone else. Worth doing before larger rearrangements - there is no redo, so a saved file is your safety net.

Import

Load Setup

Replaces the current scene with a saved layout. Note the difference to the Setup Browser: this opens a single file, while the browser lists many at once.

Load Preset

Places a saved Preset at the centre of the scene without removing anything already there - the way to combine several saved arrangements into one board.

Collect your own: instead of opening files one at a time, gather your saved Setups or Presets in a folder and point the Custom section of the Setup Browser or Preset Browser at it. Everything in that folder then appears as a gallery, exactly like the built-in ones - much faster once you have built up a small library of your own.

Load Free Samples

A small set of tiles to try the editor without your own library - the same option offered on the welcome screen, available here at any time.

Load STL Source

Same as the button in the sidebar, repeated here for convenience. See STL Source & File Naming.

Troubleshooting

Nothing appears after loading my STL Source

Check the Asset Check warning button - it reports which files were expected but not found. The most common cause by far is an older naming convention; see How to Start.

Tiles look wrong or sit slightly off

The editor is built around the SOCKET variant of each file. LOCK and OpenLOCK files still work, but can show small visual offsets inside the editor. Your actual prints are unaffected.

Black, frozen or glitched viewport

Use View → Fix Display, which offers two levels of repair:

  • Quick Refresh - rebuilds the display. Your layout stays as it is. Try this first.
  • Emergency Rescue - for the case where the 3D view has stopped responding entirely. It saves your current layout so you can reload the page and continue.

Everything feels slow

Set View → Render Quality to Balanced or Low, and hide levels or sets you aren't working on right now - fewer visible pieces means a smoother viewport.

I made a mistake

Ctrl + Z undoes the last change. Note that there is no redo - if you undo one step too far, that step is gone. Saving a Setup before larger rearrangements is the safer habit.

Quick Reference

The same overview is available inside the editor at any time - the Ref button next to the Guide button, top right of the viewport. No need to leave what you're working on.

Jump to the full action list ↑