Guides
Legacy Studio
Design your own game screen: see it in the middle, change anything from the panels around it, then play it or share it.
Legacy Studio is where you build a Custom layout for the game. Your screen sits in the middle at whatever size you choose, and everything you can change lives in panels around it: a list of every piece, a toolbox to add more, a settings panel for whatever you click, and your colours, fonts and textures. This guide takes you from your first layout to sharing it.
Getting started
Two ways to open the Studio
- Inside the game. In the desktop app choose Settings → Modes → Custom (Beta), then press Ctrl+L (or Edit layout in Settings → Modes). The Studio covers the window and your game carries on in the middle of it, showing your real character. Press Ctrl+L again, or Done, to go back to playing.
- The Legacy Studio shortcut. The desktop app puts a Legacy Studio shortcut on your desktop (once: delete it and it stays gone), in your Start menu and in its install folder. It opens the same program straight into the Studio with no game running, so there is nothing extra to download. It signs in with the account the game uses.
With no game behind it, the shortcut fills the screen with sample data. Choose what to design against from the Sample datalist in the toolbar: a quiet town, a fight (low health, monsters in the room), a full party in a busy room, or a brand new character. The sample data is recorded from real play, so the story, the room and the people look just as they do in the game. Typing in the command line there does nothing.
Your first layout, in six steps
- Open the Studio and choose File → New design from a layout. Pick the closest to what you want; Full-style is the safe one.
- Pick the screen size in the toolbar that matches your monitor.
- Click a piece on the screen and drag it, or drag its edges to resize it. Use the Outline to find small things.
- Add anything missing from the Toolbox by clicking it, or dragging it onto the screen.
- Open Theme to change the colours, fonts and background for the whole screen.
- Check the Problems panel, press F5 to try it out, then close the Studio. Your design is saved to your account as you go, and the game uses it straight away.
The workspace
| Where | What it is |
|---|---|
| Menu bar and toolbar (top) | Files, editing commands, arranging, view options, and the zoom, screen size and sample data controls. |
| Outline, Toolbox and Designs (left) | Every piece on your screen, everything you can add to it, and your layouts and the ones you have imported. |
| The design surface (middle) | Your screen, live, at a size and zoom you choose. |
| Properties, Theme and Library (right) | The settings for what is selected, your colours and textures, and your saved layouts and panels. |
| Problems and History (bottom) | What might be wrong with the layout, and a list of every change you have made. |
| Status bar (very bottom) | What is selected with its position and size in pixels, any problems, where the pointer is, the screen size and the zoom. |
Moving the panels around
The panels are yours to arrange. Drag a panel's tab to the left, right or bottom dock to move it there, or drop it between two tabs to put it in order. The ⋯ button at the end of a dock's tab bar can dock the panel to another side, float it as a window you can drag and resize, or close it. A floating panel's ⇲ button docks it back. The arrow beside it collapses a whole dock out of the way, and you can drag a dock's inner edge to make it wider or taller.
Closed a panel by mistake? Every panel is listed in the View menu. The Studio remembers how you left things, and View → Reset the panel layout puts everything back.
The toolbar and menus
- ↶ ↷ undo and redo.
- − Zoom + zoom out, pick a zoom (or Fit), zoom in.
- Screen size the size of screen you are designing for.
- 📏 ▦ 🧲 turn the rulers, the grid, and snapping on or off.
- Align buttons line up several selected pieces: left, centre, right, top, middle, bottom, and space evenly.
- ▶ Preview plays your layout instead of editing it.
- 🖼 Background hides every panel so you can work on the backdrop on its own. Press it again to bring them back.
- Done (or Exit in the Legacy Studio shortcut) closes the Studio.
The design surface
The middle of the Studio is your real screen, live, not a picture of it. Click, drag and resize pieces right on it.
Choose the screen size
Players have different screens, so the Studio lets you design for any of them. The screen size list offers 1920×1080, the size layouts are drawn at (1600×1000), a typical laptop (1366×768), 1280×720, 1024×768 and a small 800×600 window, plus Custom for any size you type. Fill the workspace instead draws the screen at exactly the size of the middle area, as the game would.
Panels are placed as shares of the screen, so a layout that looks right at 1600×1000 stretches sensibly everywhere else. Switch to 800×600 and 1920×1080 now and then and look: that is the quickest way to find a panel that gets cramped. The contents of every panel also scale with the window, so text and buttons keep their shape.
Zoom, pan, rulers and guides
- Zoom with the toolbar, Ctrl + mouse wheel, or Ctrl+= and Ctrl+−. Ctrl+0 fits the screen to the workspace.
- Pan by holding Space and dragging, with the middle mouse button, or with the scroll bars.
- Rulers run along the top and left, in pixels of the screen size you chose.
- Guides are lines you drag out of a ruler. Pieces snap to them. Drag a guide to move it, or drag it off the edge to remove it. View → Clear guides removes them all.
- Grid and snapping. While you drag, a piece's edges jump to the edges and centres of other pieces, to your guides and to the grid. Hold Alt to move freely. Set the grid step in Properties when nothing is selected.
Selecting, moving and resizing
- Click a piece to select it. Drag it to move it, or drag an edge or corner handle to resize it.
- Shift-click to add or remove pieces from the selection, or drag a box on empty space to select everything it touches. Ctrl+A selects everything. Click empty space or press Esc to deselect.
- With several selected, dragging one moves them all together.
- Arrow keys nudge the selection by one grid step (hold Shift for five).
- Locked pieces cannot be moved, and pieces attached to another keep following it.
Preview
Preview (press F5) hides the editing outlines and lets you use the layout: switch its tabs, open its menus, try its buttons. F5 or Esc returns to editing. Anything that would act on the game, like typing a command or pressing an action button, does nothing while the Studio is open.
Outline: everything on your screen
The Outline lists every piece from front to back, and under each Custom panel the controls inside it, down through groups and tabbed pages. It is the easiest way to find something small or hidden, and the only way to select a control buried inside a panel.
- Click a row to select it, Shift-click to add more.
- Drag a piece up or down the list to change what is in front. The line shows where it will land.
- Drag a control within its panel to reorder it, or onto a group (the row lights up) to put it inside.
- Double-click a piece to give it a name of your own, like "Stats column". Clear the name to go back to the default.
- The eye hides a piece (hidden pieces stay in the list so you can bring them back), the padlock locks it in place, and the ✕ on a control removes it.
- The search box narrows the list to matching names.
Grouped pieces show a small "group" label. The story (Chronicle) and the command line are required, so the last of each cannot be hidden or removed.
Toolbox: adding things
The Toolbox holds everything you can add, with a search box on top. Click an entry to add it, or drag it onto the screen and drop it where you want it. Hover an entry for a description.
- Panels are the pieces of the game screen: Chronicle, Command line, Character Info, Character sheet, Room, Exits, Minimap, People / Objects, Inventory, Equipment, Spells, Action buttons, Character tabs, Menu, Day & night, Diagnostics, a text label, an empty frame, and the flexible Custom panel. You can add the same one more than once; a second Chronicle showing only chat is a popular choice.
- Ready-made panels are Custom panels already filled with controls and laid out like Full's header bar and name card.
- Controls are the small parts a Custom panel is made of: bars, stats, the room's name and description, exits, buttons, and whole panels. Add one while a Custom panel is selected (or drop it onto one) and it goes inside that panel. With nothing suitable selected, it gets a panel of its own.
New pieces land in free space, so they do not cover what you have already built.
Properties: the settings for what you selected
The Properties panel changes with what is selected. Use its search box to find a setting by word.
Nothing selected: the layout itself
With nothing selected, Properties shows the whole layout: whether things snap, whether the grid shows and how fine it is, and the margin between the screen edge and your panels.
One piece selected
Everything about the piece, in four parts. At the top, Duplicate, Lock, Hide and Remove.
- Position and size. Exact numbers for left, top, width and height (as percentages of the screen, so the layout fits any window), buttons to centre or stretch it and send it forward or back, and Fit to contents. Width across the screen decides how the width behaves when the window changes: leave it as a share of the screen so everything grows together, or keep a fixed width against the left or right edge, or stretch between two fixed margins, to build layouts like Widescreen where side panels stay a steady size and only the story stretches. Attach to another panel fixes this piece to the edge of another so it follows when that one moves, grows or folds.
- Behaviour. Different for every piece: the Chronicle chooses what it shows and how many lines it keeps; the Inventory its columns and slot size; the Minimap its cell size and frame; Equipment which slots show. Each setting says what it does.
- Look. Override the theme for this piece: title bar (show, hide, retitle, fold away, even put controls in it), background and how solid it is, border, corner radius, text and accent colours, text size, padding, opacity, glass blur and a drop shadow. Titles can show where you are with {room}, {roomid}, {zone} and {name}. A piece with no settings of its own follows the theme, so changing the theme later still reaches it. Match the look of another panel copies another panel's colours, border, corners and text size onto this one, and Reset this widget's look clears every override.
- Share this panel at the foot, covered under Saving and sharing below.
A control inside a Custom panel
Select a control in the Outline and Properties shows just that control: Move up, Move down, Duplicate, Remove, and Back to the panel to return to the panel itself. Below that are the settings for the box the control sits in (its width in columns or pixels, height, docking, whether it takes up leftover space), the control's own options, and Look of the box to colour just that control.
Several pieces selected
Select two or more and Properties becomes a tool for arranging them.
- Align lines up their left, centre or right edges, or their top, middle or bottom edges.
- Space evenly (three or more) makes the gaps between them equal, keeping the outer two where they are.
- Same width and Same height match every piece to the first one you selected.
- Group ties pieces together so they are always selected and moved as one. Ungroup splits them.
- Lock, Unlock, To front, To back and Remove all.
- Set the same look on all changes title bars, text size or corner radius for the whole selection in one go.
Locked pieces and pieces attached to another are left where they are by Align and Space evenly. You can also copy and paste with Ctrl+C and Ctrl+V, duplicate with Ctrl+D, and cut with Ctrl+X.
Checking your work: Problems and History
Problems: the layout checker
The Problems panel checks your layout as you work and lists anything worth fixing; the number on its tab and in the status bar is how many. Click a problem to select the piece it is about. It looks for:
- a missing Chronicle or Command line (the game cannot be played without them),
- pieces that run off the edge of the screen,
- pieces that would be too small for their contents at 1920×1080, 1366×768 and 1024×768, so their text or buttons could be cut off,
- panels that overlap,
- text that is hard to read against its background, in the theme or on a single piece,
- empty Custom panels, and hidden pieces that will not show in the game (these two are reminders, not warnings).
History: every change you have made
History lists each change in words ("Moved Chronicle", "Added Day & night", "Changed the theme"). Click any step to return the layout to how it was then, and click a later one to go forward again. Greyed steps are ahead of you. Making a new change after going back drops the steps that were ahead. Ctrl+Z and Ctrl+Y step through the same list. History covers this session.
Your layouts and imported layouts
There are two separate lists. My layouts are the ones you made. Imported layouts are other people's, and always show who made them. They live in the Designs panel in the Studio, and in the Custom Layouts window from the game menu.
My layouts
- They save themselves. Change something and, a moment later, the layout you have open is saved to your account. The status bar and the top of the Designs panel say when. The first change after you open the Studio on something that is not one of yours creates a new layout for you.
- It keeps saving into the same layout. Which of your layouts is open is remembered on your account, so closing the Studio, or reopening it on another computer, carries on with it instead of starting a new one. Closing the Studio straight after a change saves that change too. If extra copies have piled up, Remove duplicates above the list deletes layouts with the same name and size, keeping the newest.
- There is no limit you will meet. Keep as many as you like (the account ceiling is 500).
- Open loads one so you can keep working on it, and replaces what is on screen (Undo brings the old one back, and it is already saved as its own layout).
- To test one in the game, open it and close the Studio. Whatever you had open is the layout the game keeps.
- Save copy keeps a copy of what you are working on under a new name, and ⧉ duplicates any layout. Double-click a name, or press ✎, to rename it. ✕ deletes it. The search box finds one by name.
- New from a ready-made layout starts a fresh layout from one of the layouts under Ready-made layouts below. It never overwrites the one you had open.
Imported layouts
- Bring one in with File → Import a layout (a file or a share code), or Import a layout file in the game menu's Custom Layouts window. It goes in the Imported list, up to 20, and is never mixed in with yours.
- Each one shows who made it. The creator's name is signed into the file by the server, so it cannot be changed or invented by editing the file. A layout with no valid signature (an older file, or one that was altered) still imports, and is shown as Unknown creator.
- The creator chooses whether it is Locked or Editable. You can Use a locked layout, but the Studio will only let you look at it: it cannot be edited, saved or shared on. An editable one can be changed: press Edit a copy and it becomes one of your own layouts, with the original left as it was.
- Make a change to an editable imported layout and your change is saved as a new layout of yours, called "… (edited)". It keeps "based on" credit to the original creator, which goes on if you export it.
Ready-made layouts and your saved ones
File → New design from a layout, or the Designs panel, starts you from one. Each is built entirely from the Studio's own tools, so you can take it apart and change anything. Starting from one replaces your current layout, and Undo brings it back.
The Library panel
The Library panel holds the ready-made layouts, the grid settings, Share (copy your layout as text, or load one a friend sent) and Reset. My panels holds single panels you have kept, and a box for a panel code or file someone sent you. Loading a whole layout from here starts a new design, so it never overwrites the one you had open. Your layouts are kept under Designs.
Custom panels: build a panel from small controls
A Custom panel is a blank box you fill with the game's own controls. Add one from the Toolbox, then drop controls into it or use its Controls list in Properties.
Anything can go in: the health, mana, stamina and experience bars, your six stats, level, gold, bank, food and water, your portrait, name and class, the room's name and description, the exits, the action buttons, the menu buttons, the room's command buttons, a text note, even whole panels like the Inventory or the Spells list. In the list, each control has a gear (its settings), a duplicate button, arrows to reorder it and a cross to remove it. The Outline shows the same list as a tree and lets you drag things around. The bars take their colours from the theme's HP, Mana, Stamina and XP colours.
The panel's Arrange the controls setting decides how they sit: a grid of columns, side by side in a row, stacked in a column, or docked (below). You can also set the spacing, how they line up and, for a grid, the width of every column.
Group boxes
A group box holds other controls and arranges them its own way, so you can nest them: a row of stats inside a column, a name card beside a portrait. A group can have a heading, can fold away, and can be drawn as a panel of its own with a title bar like Full's side panels.
Docking
Set a panel (or group) to Docked and give each control a Dock edge: top, bottom, left or right. Each docked control sticks to its edge in the order listed, and the one marked Fill what is left takes whatever space remains, like the side columns in Full. It is the way to make one thing stretch while others stay put.
Tabbed pages: several things in one box
Want your stats, items, spells and map to share one box, with tabs to switch between them? That is a Tabbed pages control, and it needs no scripting.
- Add a Custom panel and set its arrangement to Docked.
- Add Tabbed pages to it (from the Toolbox, with the panel selected) and set its dock to Fill what is left.
- Select the Tabbed pages row in the Outline. In Properties, under Tabs, add a Group box for each tab.
- Open each group box's settings (the gear) and give it a Tab name (Stats, Items, Map…).
- Add the controls for that tab to the group from its own list: the six stats for Stats, an Inventory for Items, a Minimap for Map.
Tabs look like chooses buttons, cards joined to the page, or plain words with an underline. Tabs sit puts them above or below, and they can share the width evenly or take only what they need. The tab you pick is remembered.
Theme: colours, fonts and shape
The Theme panel styles the whole screen at once. A live preview at the top shows every change as you make it, and anything you have not styled on its own piece follows the theme.
Palette maker, starting palettes and quick tweaks
Pick one colour, choose Dark or Light, and every colour (panels, borders, text, title bars, buttons and the background) is built from it. The slider chooses how strongly it tints the panels, and Surprise me randomises the lot, including a pattern. Starting palettes has fifteen ready-made sets, Quick tweaks nudges the whole palette (hue, colour, lightness), and Readability grades how easy the main colour pairs are to read, from Great to Poor.
Colours, shape and type, title bars
Colours sets each colour yourself, including the HP, Mana, Stamina and XP bar colours, and how see-through the panels are. Shape and type sets the corner roundness, base text size, screen margin and font (including any font installed on your computer), and whether panel contents scale with the window. Title bars sets their text size, letter spacing, height and capitals, and Weight makes all the text bold.
My themes
My themes keeps a theme under a name on your account. It stores colours, fonts and shape only, never your layout, so you can try a new look without changing where anything sits. Copy to share turns a theme into text for a friend, and Load pasted reads one back in. A theme sent to someone else is a starting mood, not a promise: pieces that have their own colours keep them, so the result varies from layout to layout.
Backgrounds, patterns and textures
There are three places for a pattern, and each can hold up to five layers on top of each other:
- Background pattern covers the screen behind everything.
- Panel texture goes on every panel, over its colour.
- Window inside the screen is its own pattern for the window described below.
Patterns include bricks, cut stone, natural stone, cobblestones, wood planks, scales, diamonds, hexagons, grids, dots, stripes, crosshatch, checkerboard, rings, crosses, glows and dark edges. For each layer you choose the colour, strength, spacing, line thickness and, where it makes sense, the angle or position, and you can reorder or remove layers. While working on one, press 🖼 Background in the toolbar to hide the panels.
A window inside the screen
Window inside the screen puts the whole layout inside a window of its own shape, with its own background, pattern and border, while the main background shows around it. Pick a shape (4:3 gives the look of an old 800x600 game window), then style the window's background and border. Classic Nightmist is built this way.
Saving, sharing and playing your layout
You do not need to export or import your own layouts. They save to your account as you work, and you can play any of them from the Studio, from the app's game menu or from the browser. Files and codes are for sending a layout to someone else, or keeping a backup outside your account.
Files and codes come in three kinds, for when you do want to send or keep one:
| What | As a file | As text you can paste |
|---|---|---|
| A whole layout | File → Save layout file (.nlayout) | File → Copy share code |
| …to receive one | File → Import a layout (a file or a pasted code) | In the game: menu → Custom Layouts → Import |
| One panel | Select the panel → Properties → Share this panel → Save panel file (.npanel), or File beside a kept panel in the Library. Open it with Library → My panels → Open a panel file. | Share this panel → Copy panel code. Paste it into Library → My panels. |
| A theme | Not as a file. | Theme → My themes → Copy to share, and Load pasted |
Layout files
A .nlayout file holds your layout and its theme, plus the themes and panels you have kept on your account. Importing one adds it to your Imported layouts and shows it on screen (Undo brings yours back), and adds its themes and panels to yours without overwriting any you already have. A damaged file is refused with a message. It carries nothing about your character or account.
Note that the file carries your whole saved themes and panels library, so sending it shares all of those, and any text you put in titles and labels.
Sharing single panels
A panel file or code carries the panel, everything inside it and its look, but not where it sits or what it is attached to. Keep saves a panel under a name on your account so you can add it to any layout later.
A shared panel keeps any colours its maker gave it, so it may not match your other panels. Before adding it, choose Match the look of another panel and pick one of yours: the new panel takes that panel's colours, border, corners, text size and so on, and Clear the colours of the controls inside it too makes the buttons and bars inside follow it as well. You choose each time, so you can run different looks on different panels. The same choice is in any panel's Look settings, to line up panels you already have.
Playing a layout in the browser
The browser has no Studio, but it plays your layouts straight from your account, so there is nothing to export or import for your own. Open the game menu, choose Custom Layouts (reload the page first if it was already open), and press Use beside any layout under My layouts. When you change a layout in the Studio, the browser shows the new version the next time it loads. Full is always there to go back to, and is what the browser uses until you choose something else. You can also switch from Settings → Modes (Full, Tablet or Custom layouts…), and Ctrl+Shift+L opens the Custom Layouts window from anywhere, even in a layout with no menu.
The ready-made layouts are listed there too, so you can play Classic Nightmist or Kaos Realms in the browser without making anything. Layouts other people send you go under Imported layouts in the same window (Import a layout file, or paste a code), up to twenty, each showing its creator. To edit one, open the Studio and press Edit a copy.
The browser only uses the layout itself, not the themes or panels in a file. Picking a layout in the browser does not change what the desktop app shows. The same Custom Layouts window is in the desktop game menu too, for switching without opening the Studio.
Keyboard and mouse
| Key or action | What it does |
|---|---|
| Ctrl+L | Open or close the Studio (in the game) |
| Click / Shift-click | Select / add to the selection |
| Drag on empty space | Select everything the box touches |
| Drag a piece, or an edge or corner | Move / resize. Hold Alt to ignore snapping |
| Arrow keys | Nudge by one grid step (Shift for five) |
| Ctrl+Z / Ctrl+Y | Undo / redo |
| Ctrl+C, Ctrl+X, Ctrl+V | Copy, cut, paste |
| Ctrl+D | Duplicate |
| Delete | Remove what is selected |
| Ctrl+A | Select everything |
| Ctrl+G / Ctrl+Shift+G | Group / ungroup |
| Ctrl+= / Ctrl+− / Ctrl+0 | Zoom in / zoom out / fit |
| Ctrl + mouse wheel | Zoom |
| Space + drag, or middle button | Pan |
| Drag from a ruler | Make a guide |
| F5 | Preview, and back |
| Ctrl+S / Ctrl+O | Save / open a layout file |
| Esc | Deselect, or leave preview |
The same list is under Help → Keyboard shortcuts in the Studio.
Tips and common questions
- I lost a piece. Look in the Outline. Hidden pieces stay listed, and the eye brings them back.
- I made a mess. Undo with Ctrl+Z, jump back in History, or open an earlier layout of yours or start a new one from a ready-made layout. Your other layouts are not affected.
- A panel is hard to click because others are on top of it. Select it in the Outline instead, or drag it forward there.
- It looks different in the game. Check the screen size in the toolbar: the Studio shows exactly the size you chose, and the game uses the size of your window. Try the sizes in the list.
- The sample data does not match my character. That is expected in the Legacy Studio shortcut, where there is no game running. Open the Studio from inside the game to design against your real character.
- Can someone copy my layout? If you export it Locked, the Studio will not let anyone edit, save or share it on, and your name stays on it. That is an honour system built into the app, not secrecy: the layout is still readable data, so a determined person could rebuild it. Allowing editing instead gives them a copy that credits you. Where are my layouts stored? On your account, so they follow you to another computer: your layouts, your imported layouts, and your themes and kept panels.
- Pressing Enter in an empty command line looks around (sends /look) in any layout that prints the room description to the story.
- Something looks wrong or broken. This is a beta, and your report helps. Tell us on Discord and say which layout you were using.
Keep reading
