Item Windows & Item Slots

Six windows hold items beside the player's bag: the Bank, a Chest, an NPC Shop, the Market, the Trade window and Mail. This page covers what they share: how players move items between them and the bag, what a bulk move leaves alone, how the pair is laid out on a phone, and how you make them look like your game instead of the default one.

There is no new feature flag here. Each window keeps its own (Bank, Player Chests, NPC Shops, Market, Trading — see Feature Flags).

Where to author it#

Quick transfer#

Whenever one of these windows is open, the bag knows it. Players no longer have to drag.

The gesture works from both sides: right-click a bag item to deposit, sell or offer it; right-click an item in the vault or chest to take it.

With no window open, the bag behaves as before: right-click equips or uses, shift-click splits a stack.

The buttons#

Each button is one request, and the game server decides which items move. Nothing a player's client says is trusted beyond "deposit everything" or "deposit what matches". The buttons live in a section called Quick-transfer buttons, so you can move it or hide it under Sections like any other part of the window. Hiding the section removes the buttons, not the gestures.

Each deposit button shows how many stacks it will move, for example Deposit all (12). The first Deposit all of a play session asks the player to confirm; after a yes it does not ask again until they next log in. Stack matching never asks.

What a bulk move never takes#

Deposit all and Stack matching leave three kinds of item in the bag, every time:

The chat line says so: "Kept in your bag: 1 quest item(s), 2 on your action bar, 0 locked." The rule is applied by the game server, not the player's client. Take all has no exceptions — it only brings things into the bag.

A single, deliberate move is not a bulk move: a player can still drag a quest item or a hotbar potion into a chest, or right-click it across.

Locking an item#

Players can lock any item in their bag.

A locked item shows a small padlock in its corner, and:

• Deposit all and Stack matching skip it.
• The quick gestures ignore it. Right-click, shift-click and double-tap do nothing to it while a bank, chest, shop, trade, market or mail window is open — so a slip next to a merchant cannot sell it.
• It cannot be sold to an NPC shop at all. The server answers "That item is locked. Unlock it in your bag to sell it."
• Dragging it into a bank, chest or trade still works. That is a deliberate move.

The lock belongs to the bag. An item stored in a bank or chest comes back out unlocked.

On a phone#

Two floating windows do not fit a phone, so there aren't two. When the Bank, a Chest, a Shop or a Trade opens on a phone, it and the bag become one layout that fills the screen under the top bar: the window in one half, the bag in the other. Held upright they are stacked; held sideways they sit side by side.

There is no right-click on a phone, so items cross with a tap:

1. Tap an item. Its name appears in the bar above the grid.
2. Tap Deposit (or Store, Sell, Offer, Take — the button is named for the window that is open). A stack asks how many.
3. Or double-tap the item to send the whole stack at once.

Press and hold an item to read its tooltip. On a phone the shop also shows its Buy / Sell button and quantity stepper in a bar under the wares, because the detail pane that normally holds them has no room.

The Market fills the phone screen. Tap a listing and its order book, Buy button and buy-order form rise as a sheet over the list (on a wide screen that is the right-hand column); Back to listings closes it. On the Sell tab the market shares the screen with the bag: tap an item in the bag, tap List, set the price. My orders is a plain list and works at any width.

Mail shares the screen with the bag while you compose, so an attachment is a tap and Attach.

You don't set any of this up. It follows the same rule as the rest of the phone HUD — see UI & HUD editor.

Tooltips#

Every item slot in these windows now shows the same card the bag shows: stats, affixes, description, and the comparison against what the player is wearing. That covers the vault, chests, shop wares (Buy, Sell and Buyback), market listings and the order book, both sides of a trade, mail attachments, the repair list, the loot-roll card and saved loadouts.

Where a slot shows a kind of item rather than a copy somebody owns — a shop ware, a market listing, what the other player put on the table — the card describes the base item. Rolled extras such as affixes belong to the actual copy, so they appear once the player owns it.

Item slots#

Item slots is one look, used by every item grid in the game: the bag, bank, chests, shop wares, the market's sell grid, trade offers, mail attachments, the repair list, saved loadouts, the loot-roll card, the contents list of a premium-shop product and the crafting window.

1. Open the UI & HUD editor and go to Panels.
2. Pick Item slots at the top of the list.
3. Change a field. The preview beside it redraws with sample items.
4. Save. The running game picks it up straight away.

One window that differs#

Every item window has an Item slots in this window card with the same fields. A field left on Same as every grid follows the world's look; anything you set applies to that window alone. A shop with gilt circular slots and a bank with plain square ones is two cards.

Presets#

A UI preset saved from the Presets tab now includes the world's item-slot look, and applying a preset puts it back — including back to the built-in slot, if that is what the preset was saved with. Presets saved before this did not record a slot look, so applying one of those returns slots to the built-in look.

The windows themselves#

Bank, Chest, NPC Shop, Market and Trade are ordinary entries in the Panels list, so each takes the full set of cards.

Custom layout#

Custom layout replaces a window's body with widgets you place yourself. These lists are available to a Repeat List widget:

A list widget only shows items. The working parts of a window come from the Stock Body widget:

1. Add a Stock Body widget and select it.
2. In Shows, pick The whole built-in body, or Only: one section — the vault grid, the shop's wares, the trade's confirm bar.
3. Add one Stock Body per section you want to keep, and place each where you like.

A section placed this way is the real thing: players click it, drag from it, drop onto it and buy from it exactly as in the built-in window. So a custom Bank can be your own artwork and labels around the live vault grid and the live quick-transfer buttons, with the capacity bar left out.

One kind of chest#

A strongbox, a supply crate and a reliquary can each open their own way. The settings live on the chest item and sit on top of the world's Chest panel.

1. Open Database → Items and pick a chest item.
2. Go to the Chest tab and find Chest window.
3. Fill in only what should differ. A blank field uses the Chest panel's value.
4. Save, and publish on a hosted game.

The sound and motion a chest plays when it opens are the Open / Close / Locked cues on the same tab — see Chests & Storage.

Gotchas#

• Untouched means unchanged. If you never open the Item slots card, every grid draws the engine's built-in slot exactly as before. Setting one field does not move anything else: an unset gap keeps each grid's own spacing, and an unset size keeps slots fitted to the window.
• A custom-frame slot with no frame image is invisible. The shape draws no border and no backing by design. Pick a frame image, or pick another shape.
• A hexagon or circle clips the item art to its outline. Icons drawn to the edge of a square lose their corners.
• A fixed slot size can leave empty space beside the grid in a wide window. Raise the columns, or go back to Fit the window.
• Right-click on a bag item changes meaning while a window is open. It deposits, sells or offers instead of equipping or using. Players close the window to get the old behaviour back. The hint line under the bag says which is active.
• Shift-click no longer splits a stack while a window is open — it moves the whole stack. Split stacks with the window closed.
• Deposit all still takes tools and materials. It leaves quest items, action-bar items and locked items, and never touches worn equipment — but an unlocked pickaxe sitting in the bag goes in with the ore. Players lock what they want to keep on them. Stack matching is the careful one.
• A hotbar item is protected by kind. Binding a healing potion to a slot keeps every stack of that potion in the bag on a bulk deposit, not just one.
• Locking needs an up-to-date game server and database. The lock is stored with the item, in a new column. A hosted game picks it up with the normal update; until its server has rolled, the Lock button does nothing.
• The bulk buttons wait their turn. Pressing two of them in quick succession sends only the first; the second is dropped rather than queued.
• Deposit all, Stack matching and Take all need an up-to-date game server. On a hosted game whose server has not rolled to this version yet, the three buttons do nothing. Right-click, shift-click, double-click and drag work on any version, and so does a chest's own window look once the game is published.
• Switching the Quantity Picker panel off makes every "how many?" a whole-stack move, including a plain right-click on a stack.
• A chest's own columns win over the Chest panel's, and the Chest panel's win over the built-in six.
• A recomposed window with no Stock Body widget cannot move items. List widgets are a read-out. Players can still use the bag's own gestures, but there is nothing to click in the window. Add a Stock Body set to the grid section.
• A recomposed Trade needs its confirm bar. Leave the Confirm / cancel bar section out and nobody can confirm; the window's close button still cancels.
• The market's category filters are hidden on a phone. Search and sort remain. The buy sheet covers the lower part of the list until it is closed.
• Loot-only treasure chests have no deposit buttons and refuse deposits from the bag. That is not a setting — see Chests & Storage.