Items

This page is about what goes into a set and how you set it up: the frames, the size, the quantity, the subsets, the set’s defaults, multiple selection and the magnetic dots. The Sets page covers the set itself (type, container, icon).

You edit an item’s properties in the right-hand panel of the set’s page, see The panel.

What an item is

An item is one piece of a set: one card, one board, one die, one token, one figure. What belongs to an item: images (frames), a size, a quantity, a subset, and possibly magnetic dots. Whatever you do not give it, it inherits from the set’s default.

An item has an id as well, just as a set does. It is formed from the name of the uploaded file, and cannot be edited in the interface. The item’s title is a separate field, bilingual, and can be left empty.

How an item gets into a set

Four roads lead here:

1. You drag an image onto the gallery (or click the tile at the end of the gallery and browse). The images upload, and each one becomes an item: its id from the file name, its front the uploaded image.
2. You select images on the panel’s Images tab and press the Create items button. The same thing happens, only from images that are already uploaded.
3. You drag images onto one of the set rows in the sidebar, either from the Images page or from the panel. One new item in the target set per image.
4. You drag the items of another set onto a set row in the sidebar. That makes a copy: the original stays where it was. If the id clashes, the copy gets a number.

At most two images upload at a time, the rest wait in a queue. While it runs, progress tiles stand in the gallery; the ones that failed you can clear away with an ×. PNG, JPEG and WebP get through, everything else the interface turns back before the upload even starts, see Images.

In an empty set an explanatory box stands in the middle of the gallery (“Drop your images here”), with the Choose images button under it.

The gallery’s tiles

This is what shows on a tile:

• the image: the item’s front (the first face on a die). Hover over the tile or press space and it flips to its back; a die spins through its faces;
• the quantity at the top right, in the shape ×N, if it is more than one;
• a selection tick, if it is selected;
• thumbnails of the other frames, and clicking one switches the big image to that frame;
• its atlas size badge and the item’s size;
• the title at the bottom, and beside it the subset’s letter, if the set has more than one subset.

If an item is missing a required image, the tile carries the words “No front image · Drop one here”. A file dropped there does not make a new item, it fills that frame.

The atlas size badge compares the source image’s resolution with the item’s real size, and says which is the largest resolution in the released package that still adds anything. If a tile says XS or SM, the image is small for the size, and will look pixelated at full size.

A die’s tile is twice as wide, and lists its faces under the image.

Table view

The Gallery | Table switch on the set’s toolbar shows one item per row instead of the gallery: a selection box, the image, the id, the title, the quantity, the width, the height, the depth, the subset.

• Click a cell to edit it. Enter saves, Escape discards, Tab saves and moves on, and clicking outside the cell saves as well.
• If several rows are selected, the value you type goes to all of them.
• The title is edited in the interface language; the header says which one.
• The image’s cell opens the image chooser.
• The slider does not work in the table, and there is no CSV import or export.

On a narrow screen the selection box, the image and the title stay put, and you have to swipe the table sideways for the rest of the columns.

Selection

The selection decides what the panel shows:

What you do	What happens
click a tile	selects only that one and lets the rest go
click the one already selected on its own	clears the selection
Ctrl + click	adds to or takes out of the selection
Shift + click	selects a range from the last one clicked to the new one
Ctrl + Shift + click	adds the range to the existing selection
click an empty part of the gallery	lets everything go

The table’s selection boxes drive the same selection.

The panel

The panel standing to the right of the gallery is the items’ editor. It is not a modal: it stays open while you select in the gallery. The last button on the toolbar shows and hides it.

It has two views:

• Properties, with two tabs inside it:
  • Selection: the details of the selected item or items. With nothing selected, a short pointer stands here, with the Open Set defaults button;
  • Set defaults: what every new item starts with, see Set defaults.
• Images: the game’s images with a search and an All | Used | Unused filter. From here you drag them onto items and frames, see Images.

On a narrow screen the panel is not a column but a sliding page: selecting an item brings it in, the Back button takes it away.

There is no Save button. What you change goes into the draft by itself after a short pause; the top bar says where it stands.

One item’s properties

With one item selected, the panel’s header says which item it is and what its id is. Under that:

1. Title, in a bilingual field;
2. the Magnetic dots row, see Magnetic dots;
3. Frames, see Frames;
4. Quantity, see Quantity;
5. Dimensions (width, height, depth), see Size;
6. Subset, see Subsets;
7. Delete item.

One sign helps you tell whether a value is the item’s own or inherited: a dimmed value comes from the defaults, one at full brightness is the item’s own. The panel writes it out as well: “Dimmed values come from Set defaults.”

If you want to take a value of its own away, clear the field: from then on the item uses the set’s default again.

Frames

A frame is one view of an item: a front, a back, a die face. Which ones exist is decided by the set’s type:

The set’s type	Frames
Card, Board, Token	Front (required) and Back (optional)
Figure	Front only
Dice	Face 1 (required), and as many faces as you add

Every frame is a row: the image’s thumbnail or the words No image, and beside it the Choose button and Remove the image. Next to a required frame stands the word required, and if it is not filled in, the Needs an image warning.

There are three ways to give a frame an image:

• the Choose button opens the panel’s Images tab, where you assign it with the Use this image button on the image;
• you drag the image onto the frame’s row from the Images tab;
• you drag the image onto the tile in the gallery (that one goes to the front, or to the first face on a die).

The Add frame button adds a new frame: the back on a card, a board and a token, the next face on a die. On a die you can go up to a hundred faces.

Set defaults

Whatever is the same on every item (the shared back, the size, the quantity, the subset) does not have to be typed in item by item. The panel’s Set defaults tab sets them for the whole set. The rule stands at the top of the tab: “New items start with these. An item keeps a value of its own only once you change it there.”

Whatever you set here is inherited by every item that has no value of its own. The item is always the stronger one.

At the bottom of the tab, every row says how many items use the default today (for example “9 of 14 items use the default size.”).

Two limits worth knowing up front:

• The front has no default. Only the optional frames appear among the defaults: the back on a card, a board and a token, and the faces on a die.
• On a figure there is nothing to set among the frames, because there is only a front.

The Apply defaults to every item button pulls the defaults onto every item in one go: the frames that have a default image, the quantity, the size and the subset. ⚠ The values items have of their own are overwritten, and the action cannot be undone. The button asks for a confirmation.

The defaults carry a Magnetic dots row of their own too, if you want one shared dot list for the whole set.

Size

The size is a width, a height and a depth given in millimetres: the real, physical size, not the image’s pixel size. Everything is worked out from it: how big the card is on the display next to the board, what size image goes into the released package, what the atlas size badge says.

The depth is optional (1 or 2 mm on a card, as a rule), the width and the height are not.

⚠ Without a size you cannot start a release. The New release modal lists how many items in which set have no size, and links to them as well. An item is fine even if the size is given not on the item itself but in the set’s defaults, so on a deck of identical cards it is enough to enter it once.

Quantity

The quantity says how many copies belong to an item. A stepper sets it in the panel (Fewer and More), and it is inherited from the set’s default in the same way; the default starts at 1.

The counter in the set’s header adds up the kinds of item, not the quantities.

Subsets

Every item belongs to a subset marked with a letter from A to Z; everyone is in A to start with. The interface says what it is for in one sentence: “Items with the same subset appear as a separate group in the box.”

The chooser does not show all twenty-six letters, only:

• A, which is always there;
• every letter you already use in the set;
• and then one free letter, dimmed, which you can start.

That one free letter is always the one after the highest letter in use. So if A, B and D are in use, the chooser holds A B D E: the interface does not offer the skipped C. It is worth going in order because of that.

The moment a set holds a letter other than A, the letter badge appears on the gallery’s tiles.

Editing in bulk

If more than one item is selected, the panel’s header says so (12 items selected), and under it: “Changes apply to all of them.”

This view differs from a single item’s in two ways:

• Where the items’ values differ, the field says Mixed.
• Frames go through at once: give a frame an image and it is written onto every selected item. The quantity, the size and the subset, though, wait for the Apply to all button beside their row, and only go through on that. Until you press it, nothing happens on that row.
• You can apply an empty field with the Apply to all button as well: the items then lose their own value and go back to the set’s default.

At the bottom of the panel, the red Delete N items applies to the whole selection, and asks for a confirmation.

Order

The order of the items in the gallery is the order they stand in inside the set, and it can be rearranged by dragging.

• An unselected tile you simply pick up and carry elsewhere.
• With a selected tile, the whole selection moves together.
• Whether it lands before or after the target is decided by whether you release it on the left or the right half of the target tile.

The new order goes into the draft at once. If you release the same drag on another set’s row in the sidebar, it does not become a rearrangement but a copy: the items stay where they are, and their copies go into the other set.

Magnetic dots

The magnetic dots are anchor points pinned to the item’s image: places that can be lined up to in a party.

Opening: select an item, and press the Magnetic dots row on the panel’s Properties tab. A large modal opens (nearly full width on a desktop machine, the whole screen on a phone): the item’s big image with the dots on the left, the list editor on the right. The Done button closes it.

The dots go into lists. An item can have several lists, each with its own name and its own settings:

What you see in the list’s row	What it does
the dot at the far left	marks the active list; click the dimmed lists to switch
the name	freely editable; Unnamed list when empty
free / ordered	the list is unordered, or numbered, and in the latter case the dots’ order matters
behind	a marker: what is attached to the list goes behind the item
Remove list	deletes the list along with its dots

You place a dot into the active list by clicking the image. Existing dots can be dragged. The tiles under the list show the dots’ coordinates; the bin on a tile deletes them one by one. In an ordered list the tiles are numbered, and can be rearranged by their handles.

Shortcuts, while you are in the editor and not in an input field:

Key or gesture	What it does
Shift + click on the image	lines the new dot up with the last one, horizontally or vertically
Shift + drag	moves the dot along one axis
Space	a new dot in the middle of the image
Backspace	deletes the selected dots
arrows	moves the selected dots by one pixel
Ctrl / Shift + click on a dot	selects several dots

The editor saves itself, there is no save button; Done only closes it.

One shared dot list for the whole set: open the same Magnetic dots row on the panel’s Set defaults tab. The editor then uses the first item’s image as a background, but whatever you lay out is inherited by every item that has no list of its own. A faint mark on the gallery’s tiles shows an inherited list.

Deleting an item

On a single item, Delete item is at the bottom of the panel, and asks for a confirmation, naming the item. With several items selected, Delete N items stands in the same place.

The deletion takes the item, not the image: the image stays among the game’s images, and is reusable from then on as an unused image. There is no undo.