Element reference

Every element a v2 theme can place, with the conditions the launcher checks before it accepts it.

Everything here is theme API 2.0, except the elements that say since 2.1.

Kinds

KindWhat it is
displayRead-only content: text, a number, a thumbnail.
inputA control that holds or writes state.
actionA button.
navMoves between views, or opens Settings.
noticeA launcher message. Kept so older layouts still validate; a placement renders nothing, because the launcher shows these as toasts.
listA list, its header and its rows.
blockA launcher-owned block, placed whole.

Where codes

CodeAllowed files and positions
applayout/shell.json, any view file, or layout/settings.json.
browserlayout/views/browser.json.
modslayout/views/mods.json.
settingslayout/settings.json.
serverAnywhere a server is the subject: a list.servers row, layout/modals/serverInfo.json, a container with "context": "selection", or popup.serverActions.
server-panelSame as server, minus rows.
modA list.mods row, or a container with "context": "modSelection" in layout/views/mods.json.
mod-panelA container with "context": "modSelection", not a row.
serverModA list.serverMods row.
modServerA list.modServers row.
workshopModA list.modFilterResults row, or a container with "context": "modFilterPreview" in layout/modals/modFilter.json.
modFilterlayout/modals/modFilter.json.
updatelayout/modals/update.json.
modalAny themeable modal file.
selectionA container with "context": "selection", not a row or modal.
popupAny themeable popup file.
popup:<id>That popup's file, layout/popups/<id>.json.

Placing an element outside the positions its codes allow is an import error.

Req codes

CodeRequired in
viewsEvery composition of the shell with the server browser, and of the shell with Mods.
views+settingsAs views, plus the composition of the shell with Settings.
browser / mods / settingsThat composition only.
rowEvery row template of the named list.
modalThe named modal file.
popupThe named popup file.
with joinEvery subject context that places server.join.

A required element doesn't have to sit in the file its requirement names: window controls placed in each view file instead of the shell still count. What it may not do is go missing. A layout file that omits a required element fails validation, and the launcher renders Neutral's version of that screen in its place.

Compositions and multiplicity

Multiplicity is checked over a composition, which is the shell together with one view, the shell together with Settings, a modal file, or a popup file.

  • display elements repeat freely.
  • input, nav, notice, list and screen-level action elements appear at most once per composition, so a control never fights a copy of itself over focus and a notice is announced once.
  • An action on a subject — a server or a mod — appears at most once per subject context. A server row, the server info modal and each selection panel can each hold one server.join.

Labels, wording and icons

  • Free labels: an optional element with a label part accepts the label option. It is plain text of at most 40 characters and becomes both the visible and the accessible name. Required elements never accept label.
  • Wording variants: some required elements offer wording variants instead of a free label, and the launcher picks the exact words for the current state.
  • Icons: an element with an icon part accepts the icon option in one of three forms: a launcher icon name from the list under Icons; a package image path (images/…, SVG or PNG), rendered as a decorative <img alt="">; or "none", allowed only when the element still renders a label.
  • display options: these choose between iconLabel, label and icon. With icon, the launcher's wording remains the accessible name and the tooltip.

app Window and shell

The window frame: window controls, the drag region, the logo and the window-level switches. The window's resize edges are always present and launcher-owned.

app.minimize action

Placed in
the shell, any view, or Settings · once per composition
Required in
as views, plus the composition of the shell with Settings
Parts
icon
Options
  • icon (icon name, a package image path, or "none")

app.maximize action

Placed in
the shell, any view, or Settings · once per composition
Required in
as views, plus the composition of the shell with Settings
Parts
icon · States: maximized
Options
  • icon (icon name, a package image path, or "none")

app.close action

Placed in
the shell, any view, or Settings · once per composition
Required in
as views, plus the composition of the shell with Settings
Parts
icon
Options
  • icon (icon name, a package image path, or "none")

app.dragRegion display

Placed in
the shell, any view, or Settings · any number of times
Required in
as views, plus the composition of the shell with Settings

Fills whatever size the layout gives it, and dragging it moves the window. It never contains other nodes.

app.collapseToggle action

Placed in
the shell, any view, or Settings · once per target region
Parts
icon · States: collapsed
Options
  • region (region id, required)
  • label (text, default sidebar)
  • icon (icon name, a package image path, or "none")

Collapses and expands the named region. Its accessible name is "Collapse {label}" or "Expand {label}", and it carries aria-expanded and aria-controls.

app.uiScale input

Placed in
the shell, any view, or Settings · once per composition
Parts
label, track, knob, value
Options
  • showLabel (on or off, default on)
  • showValue (on or off, default on)
  • label (text)

app.schemeToggle action

Placed in
the shell, any view, or Settings · once per composition
Parts
icon · States: dark, light
Options
  • icon (icon name, a package image path, or "none")

Moving between the views and opening Settings.

  • Labels and icons: Servers (Globe), Favourites (Star), Recent (Clock), Mods (Package), Settings (gear).
  • The current nav item: current sets aria-current="page".
  • Opening Settings: nav.settings toggles Settings and sets aria-pressed.
  • Keyboard: inside a container with "landmark": "navigation", nav items rove with the arrow keys and Home/End.

nav.servers nav

Placed in
the shell, any view, or Settings · once per composition
Required in
every composition of the shell with the server browser, and of the shell with Mods
Parts
icon, label · States: current
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")

nav.favourites nav

Placed in
the shell, any view, or Settings · once per composition
Required in
every composition of the shell with the server browser, and of the shell with Mods
Parts
icon, label · States: current
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")

nav.recent nav

Placed in
the shell, any view, or Settings · once per composition
Required in
every composition of the shell with the server browser, and of the shell with Mods
Parts
icon, label · States: current
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")

nav.lan nav SINCE 2.1

Placed in
the shell, any view, or Settings · once per composition
Required in
every composition of the shell with the server browser, and of the shell with Mods
Parts
icon, label, badge · States: current
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")

Opens the LAN view, and closes Settings if it is open. Its accessible name is "LAN". current is set while the LAN view is showing. The badge reads "New" until the tab has been opened once on this machine, then it is gone for good.

nav.mods nav

Placed in
the shell, any view, or Settings · once per composition
Required in
every composition of the shell with the server browser, and of the shell with Mods
Parts
icon, label · States: current
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")

nav.settings nav

Placed in
the shell, any view, or Settings · once per composition
Required in
every composition of the shell with the server browser, and of the shell with Mods
Parts
icon, label · States: open
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")

lan The LAN tab

What the browser shows on the LAN tab instead of rows.

lan.empty display SINCE 2.1

Placed in
the server browser view · once per composition
Parts
looking, failed, title, note, again · States: idle, scanning, done, failed

Drawn by list.servers, never placed: a placement of its own renders nothing. It fills the list's place on the LAN tab while no search or address lookup is running. scanning shows a spinner and "Looking on your network…"; failed shows "Could not look on the network."; otherwise it shows the title "No servers on your network", a note about other subnets and VPNs, and an again button reading "Look again" that scans once more.

status Launcher status

Read-only figures about the launcher and the server list.

status.steam display

Placed in
the shell, any view, or Settings · any number of times
Required in
every composition of the shell with the server browser, and of the shell with Mods
Parts
dot, label · States: connected, disconnected
Options
  • display (one of dotLabel, dot, label, default dotLabel)

Reads "Steam connected" or "Steam not connected". With display: dot, that text becomes the accessible name and the tooltip.

status.serverTotal display

Placed in
the shell, any view, or Settings · any number of times
Parts
value, label
Options
  • showLabel (on or off, default on)
  • label (text)

Renders nothing while Steam is disconnected.

status.populated display

Placed in
the shell, any view, or Settings · any number of times
Parts
value, label
Options
  • showLabel (on or off, default on)
  • label (text)

Renders nothing while Steam is disconnected.

status.listSource display

Placed in
the shell, any view, or Settings · any number of times
Parts
label · States: index, steam
Options
  • label (text)

Renders nothing while Steam is disconnected, and nothing until the list source is known. Reads "via index" or "via Steam"; a label option replaces the word after "via". The tooltip says where the list came from.

status.lastRefreshed display

Placed in
the shell, any view, or Settings · any number of times
Parts
label, value
Options
  • label (text)

Renders nothing while Steam is disconnected, and nothing before the first refresh.

status.activity display SINCE 2.1

Placed in
the shell, any view, or Settings · any number of times
Parts
dot, label · States: discovering, refreshing, live

The dot and label parts share one state. discovering reads "Discovering servers from Steam…"; refreshing reads "Probing server details…"; otherwise live reads "Live · {time}", or "Live · waiting" before the first refresh.

notice Launcher messages

The launcher shows these messages as toasts in the top-right corner, so a notice.* placement renders nothing and can be left out. The elements stay registered so a layout written before toasts still validates. Beyond them, three more notices are launcher-owned and never placed by a theme: the theme-fallback notice, the incompatible-theme notice and the Activation Safety Window.

notice.launch notice SINCE 2.1

Placed in
the shell, any view, or Settings · once per composition
Parts
tag, server, message, dismiss · States: warning, error, refused, success

Renders nothing. The launcher shows the server last acted on as a toast, carrying the same join warning or launch refusal as that server's server.actionNotice, named with the server and the code's tooltip. A successful launch never shows one. Closing it clears the notice for server.actionNotice too. A list row never shows server.actionNotice; the toast is where a row's join result appears.

notice.update notice

Placed in
the shell, any view, or Settings · once per composition
Parts
title, message, update, later

Renders nothing. The launcher shows a toast with the version; "Update" opens the update modal and "Later" hides it for the session. The toast is optional, because the update modal and Settings also offer updates.

notice.storage notice

Placed in
the shell, any view, or Settings · once per composition
Parts
tag, message

Renders nothing. The launcher shows a toast tagged "Storage" when the server database could not be opened, saying favourites and recent servers won't be saved this session. It cannot be closed while the trouble lasts.

notice.error notice

Placed in
the shell, any view, or Settings · once per composition
Parts
tag, message, dismiss

Renders nothing. The launcher shows the last launcher error as a toast tagged "Error"; its close button clears that error.

notice.modsError notice

Placed in
the Mods view · once per composition
Parts
message

Renders nothing. The launcher shows a mods-page error as a toast tagged "Mods".

notice.modsCached notice

Placed in
the Mods view · once per composition
Parts
message

Renders nothing. The launcher shows a toast tagged "Steam" reading "Steam unreachable — showing last known mod list" while the Mods page runs on a cached list.

notice.modsResult notice

Placed in
the Mods view · once per composition
Parts
message, dismiss · States: success, failure

Renders nothing. The launcher shows the outcome of verify, unsubscribe, clean-up and select-unique as a toast that fades after five seconds, or stays while a removal failed.

notice.modsOutdated notice

Placed in
the Mods view · once per composition
Parts
message, updateAll · States: busy

Renders nothing. The launcher shows a toast tagged "Mods" counting the subscribed mods that need updating, with an Update all button that is disabled while any mod operation runs.

filter Server browser filters and sorting

The filter bar: one control per server filter, plus the reset button.

  • Popup triggers: filter.map, filter.tags, filter.region and filter.sort open popup.mapFilter, popup.tagsFilter, popup.regionFilter and popup.sort, with aria-haspopup="listbox" and aria-expanded. The trigger part is the chip that opens the popup.
  • Filter popups: while open, filter.map, filter.tags and filter.region render an inline popup part holding a role="listbox" of option buttons (role="option"). Each option starts with a box part, the check column, which shows a check on picked rows; picked rows also carry selected and aria-selected="true". Tag options draw a tri-state indicator (✓ included, ✗ excluded) inside box in place of the check, then the label "Official", "Modded" or "First person". The map and tag popups end with a hairline separator part and a popup.clear row; the region popup ends with a separator, popup.regionNote and popup.clear; sort marks the active key with the check only. filter.map's empty part renders "Loading maps..." while its list is still loading, and "No maps match" when the search matches nothing.
  • filter.mods opens the mod filter modal.
  • filter.menu is the single Filters button and its grouped menu, with a count of the filters in force (badge, active once any filter is on) and a footer reading how many servers match. The button is a trigger holding label, badge and chevron; while open the popup splits into popup, body and two columns, each group rendered in its own popup.filter* element with a heading, rows and, in the Server group, a select row (value, chevron) that opens a list of options. A group's segmented row has a label, segments and segments (selected on the picked one); a checkbox row has checkbox and, when on, a box with on. On the Favourites or Recent tab it renders only a note and the tabNote state. Its groups are popup.filterServer, popup.filterConnection, popup.filterGameplay, popup.filterMods, popup.filterAccess and popup.filterPlayers, and its footer is popup.filterFooter (footer, total, count, reset). The map list carries its own search, empty and clear; each list opens under its select row, over the menu, and its pick puts focus back on that row.
  • active state: map, tags, region and mods are active while they filter anything. Sort is active unless it is Players, descending. Ping is active below 500.
  • Hide toggles: labelled "Hide empty", "Hide full", "Hide locked" and "Hide offline". Default off, persisted, and cleared by filter.reset along with every other filter. The control role follows the control option: button is a pressable button with aria-pressed, checkbox has role="checkbox" and switch has role="switch". The box part renders only for checkbox and switch.
  • Sort keys: Players, Ping, Mods, Name and Map.

Label and value wording: labels are MAP, TAGS, REGION, MODS, SORT and PING.

ElementValue
Map"Any", the map name, or "{n} maps"
Tags"Any" or "{n} tag(s)"
Mods"Any", "{n} mod(s)", "{n} excluded", or "{i} in, {e} out"
Region"Any", the region, or "{n} regions"
Sort"{key}" followed by the direction arrow
Ping"{v}ms" or "Any"

filter.map input

Placed in
the server browser view · once per composition
Parts
label, value, chevron, trigger, popup, option, box, indicator, clear, separator, empty · States: active, open
Options
  • showLabel (on or off, default on)
  • label (text)

filter.tags input

Placed in
the server browser view · once per composition
Parts
label, value, chevron, trigger, popup, option, box, indicator, clear, separator, empty · States: active, open
Options
  • showLabel (on or off, default on)
  • label (text)

filter.region input

Placed in
the server browser view · once per composition
Parts
label, value, chevron, trigger, popup, option, box, indicator, clear, separator, empty · States: active, open
Options
  • showLabel (on or off, default on)
  • label (text)

filter.mods action

Placed in
the server browser view · once per composition
Parts
label, value, chevron · States: active
Options
  • showLabel (on or off, default on)
  • label (text)

filter.menu input SINCE 2.1

Placed in
the server browser view · once per composition
Parts
trigger, label, badge, chevron, note, popup, body, column · States: active, open, tabNote, narrow
Options
  • showLabel (on or off, default on)
  • label (text)

The Filters button; clicking trigger opens or closes the filterMenu popup. The label reads "Filters" (the label option changes it, showLabel hides it). The badge shows how many filters are on and is absent at zero; the search text and the tab flags never count. The chevron is always drawn.

  • States: active while any filter is on, open while the popup is showing.
  • Tab note: on Favourites, Recent and LAN the button and popup are replaced by tabNote, a single note reading "Filters only apply to All servers".
  • Popup: without a theme filterMenu file the default popup is a dialog named "Filters" with the groups Server, Connection, Gameplay, Mods, Access and Players in two columns (one below 720 px wide) and the footer. Its popup, body and column parts exist only in that default popup, and body carries narrow while it shows one column.

filter.chips display SINCE 2.1

Placed in
the server browser view · once per composition
Parts
chip, prefix, value, remove, more, clearAll · States: folded

One chip for every filter that is on, in the menu's group order; the search text and the tab flags give none. It renders nothing with no filter on, on the Favourites and Recent tabs, or below 720 px wide, where the menu's badge carries the count.

  • Chip: a prefix (Map, Version, Country, Ping, Mods or Time) and a value, with the full text as its title. The remove button reads "Remove filter: <prefix> <value>" and clears that filter alone.
  • Folding: the strip is one line that never wraps. When the chips don't fit, Clear all goes first, then the chips that still don't fit fold into a more button reading "+N more", which opens the Filters menu. The strip carries folded while any chip is hidden.
  • Clear all: clears every filter but keeps the search text.

filter.sort input

Placed in
the server browser view · once per composition
Parts
label, value, direction, chevron · States: active, open
Options
  • showLabel (on or off, default on)
  • label (text)

filter.maxPing input

Placed in
the server browser view · once per composition
Parts
label, track, knob, value · States: active
Options
  • showLabel (on or off, default on)
  • showValue (on or off, default on)
  • label (text)

filter.hideEmpty input

Placed in
the server browser view · once per composition
Parts
label, box, icon · States: on
Options
  • control (one of button, checkbox, switch, default button)
  • label (text)
  • icon (icon name, a package image path, or "none")

filter.hideFull input

Placed in
the server browser view · once per composition
Parts
label, box, icon · States: on
Options
  • control (one of button, checkbox, switch, default button)
  • label (text)
  • icon (icon name, a package image path, or "none")

filter.hideLocked input

Placed in
the server browser view · once per composition
Parts
label, box, icon · States: on
Options
  • control (one of button, checkbox, switch, default button)
  • label (text)
  • icon (icon name, a package image path, or "none")

filter.hideOffline input

Placed in
the server browser view · once per composition
Parts
label, box, icon · States: on
Options
  • control (one of button, checkbox, switch, default button)
  • label (text)
  • icon (icon name, a package image path, or "none")

filter.reset action

Placed in
the server browser view · once per composition
Parts
icon, label
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")
  • label (text)

servers Server browser actions

Actions on the server list as a whole, rather than on one server.

servers.refresh action

Placed in
the server browser view · once per composition
Required in
the shell + server browser composition
Parts
icon, label · States: busy
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")

Re-probes the first 5,000 servers in the list's current order. It reads "Refresh", or "Refreshing…" while busy, when it is disabled and its icon spins.

servers.addServer action SINCE 2.1

Placed in
the server browser view · once per composition
Parts
icon, label · States: open
Options
  • display (one of iconLabel, label, icon, default icon)
  • icon (icon name, a package image path, or "none")

Opens the Add server dialog, where the user enters a server address. Its accessible name is "Add server". The label reads "Add server" and shows only when display includes it; the default is the icon alone, with the same text as its title. open is set while the dialog is showing.

server One server

Elements that read or act on a single server: its actions first, then the display elements.

Formats

ElementFormat
server.gameTime"h:mm AM/PM · {multiplier}"; "--:--" when unknown
server.players"{players}/{max}", with "+{queue}" when queued
server.pingA number, or "—"; good ≤ 80, fair ≤ 120, poor above 120
server.modCountThe count, "—" for none, or "?" when modded but not yet probed
server.lastPlayed"played {relative time}" or a date; renders nothing when the server was never played, or "—" with showNever. With recentOnly it also renders nothing outside the Recent scope. With label: "" the "played" prefix is dropped
server.regionEurope, North America, South America, Asia, Oceania, the raw code if unmapped, or "Unknown region"
  • Readiness data: server.readiness and server.downloadSize read the data fetched for the selection and the server info modal. They are not allowed in rows, where fetching per visible row would flood Steam.
  • Readiness wording: server.readiness with basis: "declared" reads the server's own data instead of the fetched check: "Mod update pending — verify before join", "Mods not checked — verify before join", "No mods declared" or "{n} mods declared". server.downloadSize shows "{n} mods" in its count part, then "Download size: {size}" ("up to" in qualifier when a size is an estimate, "0 bytes" when nothing needs fetching, one decimal), and renders nothing for a server without mods or while the check runs.
  • Offline servers: offline is added to every server element's states while the server didn't answer the last refresh, and its figures are then the last known values.

server.join action

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · once per subject context
Required in
every row of list.servers; the serverInfo modal
Parts
icon, label, spinner · States: busy, disabled, playing, modded, needsMods, offline
Options
  • wording (one of join, fixAndJoin, default join)
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none", default play)

Runs the join, which verifies and fixes mods first.

Wording

StateWording
Idle"Join", or "Fix and join" when the variant is fixAndJoin and mods need a download or update
busyThe phase label: "Launching…", "Starting DayZ…", "Subscribing…", "Downloading…" or "Verifying…"
playing"Playing"
  • Disabled: during any operation, or while DayZ is running. The tooltip reads "DayZ is running. Quit the game before joining another server."
  • Icon: Download for modded servers, Play otherwise.
  • Selection: clicking Join never selects its row.
  • Visibility: the check measures the selected row's Join, but a visible server.join inside a selection container satisfies it, because joining the selected server always works. A focused-but-unselected row still needs its own.

server.actionNotice notice

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · once per subject context
Required in
every subject context that places server.join, except list rows
Parts
code, title, message · States: warning, error, success, refused, offline

Shows this server's current join warning or error, or the last launch result; a refused launch also carries refused. It is required beside server.join in modals, popups and panels (a file that omits it there fails validation and falls back to Neutral's version of that screen). In a list row it renders nothing: a row's join result shows in notice.launch. It renders only while it has something to report, so the visibility check measures it only then.

server.cancel action

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · once per subject context
Parts
icon, label · States: offline
Options
  • display (one of iconLabel, label, icon, default label)
  • icon (icon name, a package image path, or "none")
  • label (text)

Renders only while this server has a wait that can be cancelled.

server.loadToMenu action

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · once per subject context
Parts
icon, label · States: disabled, busy, offline
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Load to menu": it verifies the mod list, then starts DayZ at the main menu without joining. It is disabled under the same conditions as Join.

server.info action

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup, not the serverInfo modal · once per subject context
Parts
icon, label · States: offline
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "More info" and opens the server info modal.

server.menu action

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup, not any themeable popup · once per subject context
Parts
icon, trigger, popup, item · States: open, offline, disabled
Options
  • menu (one of serverActions, serverLoad, default serverActions)
  • icon (icon name, a package image path, or "none")
  • label (text)

Opens popup.serverActions or popup.serverLoad, with aria-haspopup="menu". Its accessible name is "More actions for {server}". Without a theme popup file, serverActions opens Neutral's menu: the six server actions and this server's notice. An action picked in a popup closes it. It is disabled while a serverLoad menu can't load (while another operation runs or DayZ is running).

server.favourite action

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · once per subject context
Parts
icon, label · States: on, offline
Options
  • display (one of icon, iconLabel, default icon)
  • icon (icon name, a package image path, or "none")
  • label (text)
  • labelOn (text)

Reads "Add to favourites" or "Remove from favourites" as its accessible name. The visible label, shown with display iconLabel, is "Favourite" or "Favourited" by default; label replaces it, and labelOn replaces it while the server is a favourite. on is set while it is. The change is applied optimistically and reverted if saving fails.

server.refresh action SINCE 2.1

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · once per subject context
Parts
icon, label · States: busy, disabled, offline
Options
  • display (one of iconLabel, label, icon, default icon)
  • icon (icon name, a package image path, or "none", default refresh)

Reads "Refresh this server" and re-probes only this server. Only one row probes at a time: the probing row is busy, and every other row's server.refresh is disabled until it finishes.

server.subscribeAll action

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · once per subject context
Parts
icon, label · States: disabled, busy, offline
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Download mods" and subscribes to every mod the server declares. It is disabled while another server action runs.

server.checkMods action

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · once per subject context
Parts
icon, label · States: busy, offline
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Check mods". It re-reads the server's mod list and each mod's state, and never queues a download.

server.unsubscribeUnique action

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · once per subject context
Parts
icon, label · States: disabled, busy, offline
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Unsubscribe unique mods". It opens the launcher's confirmation, whose button reads "Unsubscribe", then reports "Unsubscribed {n} unique mod(s) ({size})", and is disabled when no mod is unique to this server.

server.copyAddress action

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · once per subject context
Parts
icon, label · States: copied, offline
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Copy address", or "Address copied" for 2 s after copying ip:gamePort.

server.forgetPassword action SINCE 2.1

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · once per subject context
Parts
icon, label · States: offline
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none", default keyRound)
  • label (text)

Reads "Forget saved password" (the label option changes it) and deletes the password the launcher saved for this server. It renders nothing until the launcher has found a saved password for the server, and goes away again once it is removed. offline is set for an offline server. Clicking it closes the popup it sits in.

  • Result: the server's notice reads "Saved password removed.", or "Could not remove the saved password." if that fails.

server.deselect action

Placed in
a selection container, not a row or modal · once per subject context
Parts
icon · States: offline
Options
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Close details" and clears the selection.

server.name display

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · any number of times
Parts
text · States: offline
Options
  • heading (on or off, default off)

server.address display

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · any number of times
Parts
address, gamePort · States: offline
Options
  • showGamePort (on or off, default off)

server.map display

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · any number of times
Parts
text · States: offline

server.region display

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · any number of times
Parts
flag, text · States: unknown, offline
Options
  • format (one of name, code, default name)

Shows the server's country: a flag image, then the country name (name) or its two-letter code (code), with the full name on hover. A server with no known country shows a dash and no flag, and is unknown; a country with no flag image shows its text alone.

server.gameTime display

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · any number of times
Parts
icon, time, multiplier · States: day, night, unknown, offline
Options
  • showIcon (on or off, default on)
  • showMultiplier (on or off, default on)
  • icon (icon name, a package image path, or "none")

server.players display

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · any number of times
Parts
value, max, queue, caption · States: empty, full, queued, offline
Options
  • format (one of countMax, count, default countMax)
  • showQueue (on or off, default on)
  • showCaption (on or off, default on)

server.ping display

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · any number of times
Parts
value, unit, shield, tip, caption · States: good, fair, poor, unknown, offline, estimated, protected
Options
  • showUnit (on or off, default off)
  • showCaption (on or off, default on)

The server's ping, read from its last refresh. value is the number in milliseconds, or "—" when there is none. unit (" ms") shows only with showUnit and a number; caption (" ping") shows unless showCaption is off.

  • Bands: good is 80 ms or less, fair is up to 120, poor is more. unknown means no ping, and is also set when the server is offline.
  • offline: the server did not answer the last refresh; its title reads "Server did not respond to the last refresh".
  • estimated: the server doesn't answer pings, so the number is an estimate; its title reads "Estimated: this server doesn't answer pings."
  • protected: the server is behind DDoS protection and the number may be off by up to about 50 ms. A shield icon (title explains it) comes before value, and tip is a tooltip after it, headed "Estimated ping". The tip is always in the element, hidden and out of the layout by default; show it from your CSS, for example on :hover.
  • A band can combine with estimated or protected, for example fair estimated. Neither is set when the ping is unknown.

server.modCount display

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · any number of times
Parts
value, caption · States: none, vanilla, unprobed, offline
Options
  • showCaption (on or off, default on)

none marks a "—" (no mods); vanilla is added when the server is not modded and was never probed, so a server checked and found to have 0 mods can be styled apart from a vanilla one.

server.version display

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · any number of times
Parts
text · States: unknown, offline

server.lastPlayed display

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · any number of times
Parts
label, value · States: offline
Options
  • format (one of relative, date, default relative)
  • recentOnly (on or off, default off)
  • showNever (on or off, default off)
  • label (text)

server.tags display

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · any number of times
Parts
chip · States: offline, official, firstPerson, modded, locked, battleye, modUpdate
Options
  • officialWording (one of vanilla, official, default vanilla)
  • showOffline (on or off, default on)
  • showOfficial (on or off, default on)
  • showModded (on or off, default on)
  • showFirstPerson (on or off, default on)
  • showLocked (on or off, default on)
  • showModUpdate (on or off, default on)
  • showBattleye (on or off, default off)

Renders chips in the order offline, official (VANILLA or OFFICIAL), modded, first person (1PP), BattlEye, locked, mod update.

server.modUpdate display

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · any number of times
Parts
label · States: offline
Options
  • label (text)

Renders "UPDATE" only while a declared mod has a pending Steam update.

server.readiness display

Placed in
the server info modal, a selection container, or the server actions popup, not a row · any number of times
Parts
dot, label, size · States: checking, ready, needsDownload, needsUpdate, downloading, unchecked, noMods, stale, offline
Options
  • showDot (on or off, default on)
  • showSize (on or off, default on)
  • label (text)
  • basis (one of readiness, declared, default readiness)

server.downloadSize display

Placed in
the server info modal, a selection container, or the server actions popup, not a row · any number of times
Parts
count, qualifier, value · States: upperBound, none, offline

server.manageMods action SINCE 2.1

Placed in
the server info modal, a selection container, or the server actions popup, not a row · once per subject context
Parts
icon, label, count · States: offline
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none", default externalLink)

Reads "Manage mods"; once the mod count is known, its count part reads "· {n} declared". Opens the Mods view.

server.modDiffers display SINCE 2.1

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · once per subject context
Parts
icon, text, fix · States: busy

The warning above Join: how many of this server's mods differ, with a Fix and join button that re-downloads them first. It needs a live Check mods to have run (the plain readiness read carries no hashes), and renders nothing in a list row, where readiness is never fetched.

server.versionWarning display SINCE 2.1

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup · any number of times
Parts
icon

A small triangle naming both builds, for a server on another DayZ version. It renders nothing when the versions match or the installed one can't be read.

serverMod A server's required mods

These elements are placed in the row template of list.serverMods. Rows keep the server's declared order.

serverMod.order display

Placed in
a server's mod row · any number of times
Parts
value

serverMod.thumbnail display

Placed in
a server's mod row · any number of times
Parts
image · States: missing

serverMod.name display

Placed in
a server's mod row · any number of times
Parts
text

serverMod.state display

Placed in
a server's mod row · any number of times
Parts
dot, label · States: checking, ready, needsUpdate, downloading, notInstalled, notSubscribed, serverSide, differs
Options
  • display (one of dotLabel, dot, label, default dotLabel)
  • label (text)

Wording

StateWording
ready"Ready"
differs"Differs"
needsUpdate"Needs update"
downloading"Downloading"
notInstalled"Not installed"
notSubscribed"Not subscribed"
serverSide"Unlisted"
checking"Checking…"

A mod reads differs only when it is ready and the live check found its local copy hashes differently from the server's.

serverMod.size display

Placed in
a server's mod row · any number of times
Parts
qualifier, value · States: upperBound, unknown

Shows nothing for ready (the state already says so), "up to {size}" when the size is an upper bound, else the size to one decimal place, or "—" when unknown.

serverMod.progress display

Placed in
a server's mod row · any number of times
Parts
bar, value · States: indeterminate

Renders only while downloading, and is indeterminate until Steam reports a total.

serverMod.unique display

Placed in
a server's mod row · any number of times
Parts
label
Options
  • label (text)

Reads "Only this server" when no other cared-about server needs the mod.

serverMod.openInSteam action

Placed in
a server's mod row · once per subject context
Parts
icon, label · States: disabled
Options
  • display (one of iconLabel, label, icon, default icon)
  • icon (icon name, a package image path, or "none")
  • label (text)

Is disabled for server-side mods, which have no Workshop page.

serverMod.note display SINCE 2.1

Placed in
a server's mod row · any number of times
Parts
text

One line saying the local copy doesn't match the server's and that a join may be refused with a signature error. It renders nothing unless that mod's state is ready and its copy differs, so the plain registry read never shows it.

mods Mods view actions

Actions on the Mods view as a whole.

  • Menus: mods.unsubscribeMenu and mods.verifyMenu open popup.modsUnsubscribe and popup.modsVerify.
  • Menu items: "Unsubscribe selected ({n})", "Unsubscribe from all {n} (destructive)", "Verify selected ({n})" and "Verify all ({n})".
  • Confirmations: every unsubscribe and clean-up action opens the launcher's confirmation dialog first.

mods.statusFilter input

Placed in
the Mods view · once per composition
Parts
option · States: selected

Offers All, Outdated and Downloading as a single-choice group (role="radiogroup").

mods.refresh action

Placed in
the Mods view · once per composition
Parts
icon, label · States: busy
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")
  • label (text)

Re-reads the mod list and refreshes Workshop details.

mods.count display

Placed in
the Mods view · any number of times
Parts
value, label · States: selecting
Options
  • label (text)

Reads "{s} of {n} selected" while anything is selected, otherwise "{n} mod(s)".

mods.selectAll action

Placed in
the Mods view · once per composition
Parts
icon, label · States: disabled, checked
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Select all" and renders only when it would change the checked set. In a list header — a column's headerElement — it always renders, as a toggle: checked while every visible mod is checked, and a click checks all visible mods or clears them. Its accessible name is then "Select all visible" or "Deselect all".

mods.clearSelection action

Placed in
the Mods view · once per composition
Parts
icon, label
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Clear" and renders only when it would change the checked set.

mods.selectUnique input

Placed in
the Mods view · once per composition
Parts
label, value, chevron · States: open, disabled
Options
  • label (text)

Reads "Select unique…", or "Unique: {server}" with the name truncated to 24 characters, and opens popup.modsUnique. It is disabled when there are no cared-about servers.

mods.cleanupRemoved action

Placed in
the Mods view · once per composition
Parts
icon, label · States: disabled
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Clean up {n}" and renders only when removed mods exist.

mods.unsubscribe action

Placed in
the Mods view · once per composition
Parts
icon, label · States: busy, disabled
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Unsubscribe {n}", "Unsubscribe" or "Removing…". It acts on the checked mods and is disabled when none are checked.

mods.unsubscribeMenu action

Placed in
the Mods view · once per composition
Parts
icon · States: open
Options
  • icon (icon name, a package image path, or "none")

mods.unsubscribeSelected action

Placed in
the Mods view, the modsUnsubscribe popup · once per composition
Parts
label · States: disabled
Options
  • label (text)

mods.unsubscribeAll action

Placed in
the Mods view, the modsUnsubscribe popup · once per composition
Parts
label · States: disabled
Options
  • label (text)

mods.updateOutdated action

Placed in
the Mods view · once per composition
Parts
icon, label · States: disabled
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Update {n}" and renders only when mods are outdated.

mods.verify action

Placed in
the Mods view · once per composition
Parts
icon, label · States: busy
Options
  • display (one of iconLabel, label, icon, default iconLabel)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Verify mods" or "Verifying…". It verifies every mod and re-downloads anything outdated.

mods.verifyMenu action

Placed in
the Mods view · once per composition
Parts
icon · States: open
Options
  • icon (icon name, a package image path, or "none")

mods.verifySelected action

Placed in
the Mods view, the modsVerify popup · once per composition
Parts
label · States: disabled
Options
  • label (text)

mods.verifyAll action

Placed in
the Mods view, the modsVerify popup · once per composition
Parts
label
Options
  • label (text)

mod One subscribed mod

Elements that read or act on one subscribed mod, in a list.mods row or a selection panel.

  • Selection: mod.select checks the mod for bulk actions; it doesn't select it for detail panels. Its accessible name is "Select {title}". Clicking elsewhere on a row selects the mod.
  • Formats: mod.tags falls back to the Workshop id when the mod has no tags; mod.size shows the size on disk to one decimal place; mod.rating shows "{up}▲ / {down}▼", or "—" when both are zero.

mod.select input

Placed in
a mod row, or a modSelection container in the Mods view · once per subject context
Required in
every row of list.mods
Parts
box · States: checked, disabled

mod.status display

Placed in
a mod row, or a modSelection container in the Mods view · any number of times
Required in
every row of list.mods
Parts
label, progress, dot · States: ready, update, downloading, missing, notSubscribed, serverSide, disabled

"Ready", "Update", "Downloading", "Missing", "Not subscribed" or "Server-side". While downloading with a known total, the progress part renders as a bar with an inline width percentage; the state follows a 1.5 s live poll, but a live "ready" poll never downgrades an authoritative "Update" row. The dot part carries the same status as the label.

mod.thumbnail display

Placed in
a mod row, or a modSelection container in the Mods view · any number of times
Parts
image, placeholder · States: missing, disabled

Shows the preview image. Without one, or when it fails to load, the placeholder part reads "—" ("⏸" for a disabled mod) in a row and "No preview image" in a modSelection container, and the element carries the missing state.

mod.name display

Placed in
a mod row, or a modSelection container in the Mods view · any number of times
Parts
text · States: disabled

mod.disabledBadge display

Placed in
a mod row, or a modSelection container in the Mods view · any number of times
Parts
label · States: disabled
Options
  • label (text)

Reads "Disabled" and renders only while the mod is locally disabled. disabled is also added to every mod element's states then.

mod.tags display

Placed in
a mod row, or a modSelection container in the Mods view · any number of times
Parts
text, chip · States: disabled
Options
  • limit (one of 3, 6, all, default 3)
  • style (one of text, chips, default text)

mod.size display

Placed in
a mod row, or a modSelection container in the Mods view · any number of times
Parts
value · States: unknown, disabled

mod.updated display

Placed in
a mod row, or a modSelection container in the Mods view · any number of times
Parts
value · States: unknown, disabled
Options
  • format (one of relative, date, default relative)

mod.subscribed display

Placed in
a mod row, or a modSelection container in the Mods view · any number of times
Parts
value · States: unknown, disabled
Options
  • format (one of relative, date, default relative)

mod.created display SINCE 2.1

Placed in
a mod row, or a modSelection container in the Mods view · any number of times
Parts
value · States: unknown, disabled
Options
  • format (one of date, relative, default date)

Reads "Created", the date the Workshop item was published.

mod.publishedSize display SINCE 2.1

Placed in
a mod row, or a modSelection container in the Mods view · any number of times
Parts
value · States: unknown, disabled

Reads "Published size", the Workshop item's published download size.

mod.subscribers display SINCE 2.1

Placed in
a mod row, or a modSelection container in the Mods view · any number of times
Parts
value · States: unknown, disabled

Reads "Subscribers", the localised Workshop subscriber count for this mod.

mod.rating display

Placed in
a mod row, or a modSelection container in the Mods view · any number of times
Parts
up, down · States: disabled

mod.workshopId display

Placed in
a mod row, or a modSelection container in the Mods view · any number of times
Parts
text · States: disabled

mod.folder display SINCE 2.1

Placed in
a mod row, or a modSelection container in the Mods view · any number of times
Parts
text · States: unknown, disabled

Reads "Folder", the mod's install folder name; shows "—" with the unknown state without a folder on disk.

mod.description display

Placed in
a mod row, or a modSelection container in the Mods view · any number of times
Parts
text · States: empty, disabled
Options
  • clamp (one of none, 3, 6, default 6)

mod.neededBy display

Placed in
a modSelection container, not a row · any number of times
Parts
value, label · States: disabled
Options
  • label (text)

Reads "Needed by {n} servers" for the selected mod, counting the entries of list.modServers.

mod.update action

Placed in
a mod row, or a modSelection container in the Mods view · once per subject context
Parts
icon, label · States: busy, disabled
Options
  • display (one of iconLabel, label, icon, default label)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Update" and renders only while the mod needs an update.

mod.openInSteam action

Placed in
a mod row, or a modSelection container in the Mods view · once per subject context
Parts
icon, label · States: disabled
Options
  • display (one of iconLabel, label, icon, default label)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Open in Steam".

mod.openFolder action

Placed in
a mod row, or a modSelection container in the Mods view · once per subject context
Parts
icon, label · States: disabled
Options
  • display (one of iconLabel, label, icon, default label)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Open folder" and renders only while the mod has a folder on disk.

mod.reinstall action

Placed in
a mod row, or a modSelection container in the Mods view · once per subject context
Parts
icon, label · States: busy, disabled
Options
  • display (one of iconLabel, label, icon, default label)
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Reinstall".

mod.deselect action

Placed in
a modSelection container, not a row · once per subject context
Parts
icon · States: disabled
Options
  • icon (icon name, a package image path, or "none")
  • label (text)

Reads "Close details" and clears the mod selection.

modServer Servers that need a mod

These elements are placed in the row template of list.modServers. Entries are servers in the browser that declare the selected mod, most recently played first. They are not server entries for the Join rule and carry no actions.

modServer.name display

Placed in
a mod's server row · any number of times
Parts
text

modServer.address display

Placed in
a mod's server row · any number of times
Parts
text

modServer.lastPlayed display

Placed in
a mod's server row · any number of times
Parts
label, value · States: never
Options
  • format (one of relative, date, default relative)
  • label (text)

The one element every themeable modal needs. The three themeable modals are listed under Modals.

modal.close action

Placed in
any themeable modal · once per composition
Required in
every themeable modal
Parts
icon
Options
  • icon (icon name, a package image path, or "none")

Closes the modal without applying anything. Its accessible name is "Close".

modFilter The mod filter modal

The mod filter modal: its sources, its search and its summary.

  • On open: the picks are seeded from the current filter, and focus moves to modFilter.search, or to the first focusable element if the theme didn't place it.

modFilter.apply action

Placed in
the mod filter modal · once per composition
Required in
the modFilter modal
Parts
label

Reads "Apply". It writes the included mods, the excluded mods and the match mode to the server filter, then closes.

modFilter.source input

Placed in
the mod filter modal · once per composition
Parts
tab · States: selected

Offers Subscribed, Seen on servers and Search Workshop as an ARIA tablist with arrow keys. Switching clears the preview.

modFilter.summary display

Placed in
the mod filter modal · any number of times
Parts
thumbnails, more, counts · States: empty, included, excluded
Options
  • showThumbnails (on or off, default on)

Reads "Nothing selected", or shows up to 4 thumbnails, "+{n}", and "{n} included · {n} excluded".

modFilter.clear action

Placed in
the mod filter modal · once per composition
Parts
label · States: disabled
Options
  • label (text)

Reads "Clear" and removes every pick.

modFilter.matchMode input

Placed in
the mod filter modal · once per composition
Parts
option · States: selected

Offers "Match any" and "Match all" as a radiogroup.

modFilter.cancel action

Placed in
the mod filter modal · once per composition
Parts
label
Options
  • label (text)

Reads "Cancel" and closes without applying.

workshopMod Mods inside the mod filter modal

Elements for one mod inside the mod filter modal, in a list.modFilterResults row or a preview panel.

  • Previewing: clicking a row, or pressing Enter or Space on it, previews that mod in modFilterPreview containers.
  • Formats: workshopMod.serverCount shows "{n} srv" or "—"; workshopMod.score shows "{score}%"; workshopMod.subscribers shows "{n} subscribers"; workshopMod.updated shows "Updated {relative time}".
  • Icons: workshopMod.score, workshopMod.subscribers, workshopMod.include and workshopMod.exclude start with an icon part (thumbs-up, people, check, no-entry); the icon option swaps it.

workshopMod.pick input

Placed in
a mod filter result row, or a modFilterPreview container in the mod filter modal · once per subject context
Required in
every row of list.modFilterResults
Parts
box · States: included, excluded

Cycles from none to include (✓) to exclude (⊘) and back to none. Its accessible name follows the next step: "Include {t}", "Exclude {t} instead" or "Clear the {t} filter".

workshopMod.thumbnail display

Placed in
a mod filter result row, or a modFilterPreview container in the mod filter modal · any number of times
Parts
image, initials · States: missing

workshopMod.name display

Placed in
a mod filter result row, or a modFilterPreview container in the mod filter modal · any number of times
Parts
text

workshopMod.subscribed display

Placed in
a mod filter result row, or a modFilterPreview container in the mod filter modal · any number of times
Parts
icon
Options
  • icon (icon name, a package image path, or "none")

Renders ★ only for subscribed mods.

workshopMod.serverCount display

Placed in
a mod filter result row, or a modFilterPreview container in the mod filter modal · any number of times
Parts
value, unit · States: none

workshopMod.score display

Placed in
a mod filter result row, or a modFilterPreview container in the mod filter modal · any number of times
Parts
icon, value
Options
  • icon (icon name, a package image path, or "none")

workshopMod.subscribers display

Placed in
a mod filter result row, or a modFilterPreview container in the mod filter modal · any number of times
Parts
icon, value, label
Options
  • label (text)
  • icon (icon name, a package image path, or "none")

workshopMod.size display

Placed in
a mod filter result row, or a modFilterPreview container in the mod filter modal · any number of times
Parts
value · States: unknown

workshopMod.updated display

Placed in
a mod filter result row, or a modFilterPreview container in the mod filter modal · any number of times
Parts
label, value
Options
  • format (one of relative, date, default relative)
  • label (text)

workshopMod.description display

Placed in
a mod filter result row, or a modFilterPreview container in the mod filter modal · any number of times
Parts
text · States: empty
Options
  • clamp (one of none, 3, 6, default none)

workshopMod.tags display

Placed in
a mod filter result row, or a modFilterPreview container in the mod filter modal · any number of times
Parts
chip
Options
  • limit (one of 3, 6, all, default all)

workshopMod.serverNote display

Placed in
a mod filter result row, or a modFilterPreview container in the mod filter modal · any number of times
Parts
count, text

workshopMod.viewOnSteam action

Placed in
a mod filter result row, or a modFilterPreview container in the mod filter modal · once per subject context
Parts
label, icon
Options
  • label (text)
  • icon (icon name, a package image path, or "none")

Reads "View on Steam" and opens the Workshop page. Renders nothing for a mod without a Workshop URL.

workshopMod.include action

Placed in
a mod filter result row, or a modFilterPreview container in the mod filter modal · once per subject context
Parts
icon, label · States: on
Options
  • label (text)
  • icon (icon name, a package image path, or "none")

Reads "Include" or "Included".

workshopMod.exclude action

Placed in
a mod filter result row, or a modFilterPreview container in the mod filter modal · once per subject context
Parts
icon, label · States: on
Options
  • label (text)
  • icon (icon name, a package image path, or "none")

Reads "Exclude" or "Excluded".

update The update modal

The update modal, and the notice that opens it.

update.install action

Placed in
the update modal · once per composition
Required in
the update modal
Parts
icon, label · States: busy, disabled
Options
  • icon (icon name, a package image path, or "none")

Reads "Update & Restart" with a download icon and renders only for an installed copy. It and update.viewRelease are both required, so the modal always has its primary action.

update.viewRelease action

Placed in
the update modal · once per composition
Required in
the update modal
Parts
icon, label
Options
  • icon (icon name, a package image path, or "none")

Reads "View Release" and renders only for a portable copy.

update.later action

Placed in
the update modal · once per composition
Parts
label · States: disabled
Options
  • label (text)

Reads "Later", or "Updating…" while installing.

update.title display

Placed in
the update modal · any number of times
Parts
text

Reads "Update available" or "Updates".

update.summary display

Placed in
the update modal · any number of times
Parts
message, version, date · States: available, upToDate

Reads "A newer version of Tetra Launcher is available." with "v{version}" and the date, or "You're up to date.".

update.changelog display

Placed in
the update modal · any number of times
Parts
content · States: empty

Markdown rendered by the launcher, with links opening externally.

update.progress display

Placed in
the update modal · any number of times
Parts
label, bar, error · States: downloading, failed
Options
  • label (text)

Reads "Downloading… {pct}%", and shows any error.

update.portableNote display

Placed in
the update modal · any number of times
Parts
text

settings Settings

The Settings screen: one control per setting, plus the headings that group them.

  • Required controls: every Settings control except settings.appMenu is required, and each saves as soon as it changes. settings.appMenu is optional because it draws nothing outside the Linux AppImage build. They may sit in closed sections, and their labels, hints, placeholders and choices are the launcher's current wording.
  • Section and group text: settings.sectionTitle, settings.sectionDescription and settings.sectionIcon render the wording for the Game, Launcher and Theme sections; settings.groupTitle renders the checkbox group headings Window, Startup and Discord; settings.appMenu draws its own App menu heading (part title).

settings.back action

Placed in
Settings · once per composition
Required in
the shell + Settings composition
Parts
icon, label
Options
  • display (one of iconLabel, label, icon, default label)
  • icon (icon name, a package image path, or "none")

Reads "Back" and closes Settings. When Settings is presented as a view, it returns to the previous view. Its accessible name is "Back to the launcher".

settings.done action SINCE 2.1

Placed in
Settings · once per composition
Parts
icon, label
Options
  • display (one of iconLabel, label, icon, default label)
  • icon (icon name, a package image path, or "none", default check)

Reads "Done" and closes Settings. It is optional, since settings.back and an overlay's backdropClose also close it.

settings.themeManagement block

Placed in
Settings · once per composition
Required in
the shell + Settings composition

The launcher-owned theme management block: installed themes, Import, New theme and pagination; the active theme strip, the token customiser and theme settings; Dev Mode and Reset to Default.

settings.profileName input

Placed in
Settings · once per composition
Required in
the shell + Settings composition
Parts
label, hint, control
Options
  • showHint (on or off, default on)

settings.dayzPath input

Placed in
Settings · once per composition
Required in
the shell + Settings composition
Parts
label, hint, control
Options
  • showHint (on or off, default on)

settings.detectPaths action

Placed in
Settings · once per composition
Required in
the shell + Settings composition
Parts
label · States: busy

Reads "Detect", or "…" while busy, and fills in the Steam, DayZ and Workshop paths.

settings.workshopPath display

Placed in
Settings · any number of times
Required in
the shell + Settings composition
Parts
label, hint, control
Options
  • showHint (on or off, default on)

A read-only field showing the Workshop folder.

settings.launchParams input

Placed in
Settings · once per composition
Required in
the shell + Settings composition
Parts
label, hint, control, toggles, toggles-label, toggle, box, name, flag · States: checked
Options
  • showHint (on or off, default on)

toggles holds a toggles-label reading "Launch options" and one toggle per flag (Skip intro, No splash screen, Keep running in the background, Windowed), each with a box, a name and its flag. Ticking a toggle appends its line to the same list the text box shows, and typing the line ticks the box. Each toggle carries data-state="checked" while its flag is in the list; the whole line matches, so -window=1 doesn't tick Windowed.

settings.minimiseToTray input

Placed in
Settings · once per composition
Required in
the shell + Settings composition
Parts
label, hint, box · States: checked
Options
  • showHint (on or off, default on)

settings.closeToTray input

Placed in
Settings · once per composition
Required in
the shell + Settings composition
Parts
label, hint, box · States: checked
Options
  • showHint (on or off, default on)

settings.onJoin input

Placed in
Settings · once per composition
Required in
the shell + Settings composition
Parts
label, hint, control
Options
  • showHint (on or off, default on)

settings.startWithWindows input

Placed in
Settings · once per composition
Required in
the shell + Settings composition
Parts
label, hint, box, note · States: checked
Options
  • showHint (on or off, default on)

Its note part is the always-shown debug-build note.

settings.startMinimised input

Placed in
Settings · once per composition
Required in
the shell + Settings composition
Parts
label, hint, box · States: checked, disabled
Options
  • showHint (on or off, default on)

Disabled unless Start with Windows is on.

settings.discordPresence input

Placed in
Settings · once per composition
Required in
the shell + Settings composition
Parts
label, hint, box, showServer · States: checked
Options
  • showHint (on or off, default on)

Reads "Show Rich Presence in Discord", with the hint "Shows a server you're playing on (or 'Browsing servers') on your Discord profile. Off means the launcher never talks to Discord at all." (hidden when showHint is off). checked is set while it is on, and box is the checkbox.

  • showServer: a second checkbox row inside the element, reading "Show which server I'm on" with the hint "Off: Discord shows only \"Playing DayZ\"." It carries the showServer part and has its own label, hint and box, carries checked while it is on, and is disabled while the main box is off.

settings.appMenu input SINCE 2.1

Placed in
Settings · once per composition
Parts
title, label, hint, status, button · States: installed, busy
Options
  • showHint (on or off, default on)

Linux AppImage only. Renders nothing unless this copy is running as an AppImage. Not installed: the note that Tetra isn't in the app menu yet, with an Add to app menu button that reads "Adding…" and is disabled while it works, and any failure under it in status. Installed: "Tetra is in your app menu." and no button.

settings.dataFolder display

Placed in
Settings · any number of times
Required in
the shell + Settings composition
Parts
label, hint, control
Options
  • showHint (on or off, default on)

A read-only field; it shows "Locating…" until its path is known.

settings.openDataFolder action

Placed in
Settings · once per composition
Required in
the shell + Settings composition
Parts
label · States: disabled

Reads "Open" and is disabled until the path is known.

settings.autoRefresh input

Placed in
Settings · once per composition
Required in
the shell + Settings composition
Parts
label, hint, control
Options
  • showHint (on or off, default on)

settings.about display SINCE 2.1

Placed in
Settings · any number of times
Parts
links, version, button, label, badge, status, whatsnew, credits · States: update

The About block with the version, update check and credits.

  • Version: version reads "Tetra Launcher" and the installed version number. links holds two icon buttons, "Website" and "Source code on GitHub", that open in the browser.
  • Update button: button reads "Check for updates" in label, and checks once on click. It is disabled while checking or installing. When an update is available it reads "Update" ("Updating…" while installing) and carries data-state="update"; clicking installs it, or opens the download page for a copy that cannot update itself. A badge dot shows beside it while an update is available.
  • Status: status shows "Checking…", "Downloading…" with a percentage when known, "You're up to date." after a check, or the error. When there is no status and an update is available, whatsnew reads "See what's new" and opens that release's notes.
  • Credits: credits holds the IP geolocation, flag icon and licence lines.

settings.title display

Placed in
Settings · any number of times
Parts
text

settings.sectionTitle display

Placed in
Settings · any number of times
Parts
text
Options
  • section (one of game, launcher, theme, about)

settings.sectionDescription display

Placed in
Settings · any number of times
Parts
text
Options
  • section (one of game, launcher, theme, about)

settings.sectionIcon display

Placed in
Settings · any number of times
Parts
icon
Options
  • section (one of game, launcher, theme, about)
  • icon (icon name, a package image path, or "none")

settings.groupTitle display

Placed in
Settings · any number of times
Parts
text
Options
  • group (one of window, startup, discord, appMenu)

list The lists

Every list follows one model: the theme declares the list's columns once, a launcher-rendered header shows them, and a row template places elements into those same columns. Subjects, sort keys, states and empty text are under Lists.

list.servers list

Placed in
the server browser view · once per composition
Required in
the shell + server browser composition
Parts
header, column, scroller, rows, empty, loading · States: empty, loading, filtered
Options
  • header (on or off, default on)
  • rowGap (token name, default none)
  • estimatedRowHeight (length, default 56px)

list.mods list

Placed in
the Mods view · once per composition
Required in
the shell + Mods composition
Parts
header, column, scroller, rows, empty, loading · States: empty, loading, filtered
Options
  • header (on or off, default on)
  • rowGap (token name, default none)
  • estimatedRowHeight (length, default 54px)

list.modFilterResults list

Placed in
the mod filter modal · once per composition
Required in
the modFilter modal
Parts
header, column, scroller, rows, empty, loading · States: empty, loading, searching
Options
  • header (on or off, default on)
  • rowGap (token name, default none)
  • estimatedRowHeight (length, default 44px)

list.serverMods list

Placed in
the server info modal, a selection container, or the server actions popup, not a row · once per subject context
Parts
header, column, scroller, rows, empty, loading · States: empty, loading, stale
Options
  • header (on or off, default on)
  • rowGap (token name, default none)
  • estimatedRowHeight (length, default 32px)

list.modServers list

Placed in
a modSelection container, not a row · once per subject context
Parts
header, column, scroller, rows, empty, loading, more · States: empty, loading
Options
  • header (on or off, default off)
  • rowGap (token name, default none)
  • estimatedRowHeight (length, default 32px)

Shows the first 8 servers; beyond that a more part reads "+{n} more".

Each popup has its own file, layout/popups/<id>.json, declaring its placement mode and its contents. A missing file means the launcher's default popup. The serverRow menu is the one exception to placement: it always opens at the pointer, or at the selected row from the keyboard (Shift+F10 or the Menu key), and its file's placement is not read.

  • Option lists: popup.regionOptions and popup.uniqueServerOptions are single lists of role="option" entries with a check mark on the selected ones. popup.mapOptions has a search box (part search) above its list, which shows the official maps first, then a separator, then the rest. popup.tagOptions cycles Official, Modded and First person through include (✓), exclude (✗) and off. popup.sortOptions lists the server sort keys.
  • Empty text: "Loading maps..." or "No maps match" for maps, and "No favourites or recently played servers yet." for unique servers.
  • Server actions in menus: popup.serverActions and popup.serverLoad may hold any server.* action, and server.actionNotice. They read the server their trigger belongs to.

popup.mapOptions input

Placed in
the mapFilter popup · once per composition
Required in
the mapFilter popup
Parts
option, empty, box, search, count, separator · States: selected

popup.tagOptions input

Placed in
the tagsFilter popup · once per composition
Required in
the tagsFilter popup
Parts
option, box, indicator · States: included, excluded, selected

popup.regionOptions input

Placed in
the regionFilter popup · once per composition
Required in
the regionFilter popup
Parts
option, box · States: selected

popup.regionNote display

Placed in
the regionFilter popup · any number of times
Parts
text

Reads "Approximate — based on IP block, not confirmed location".

popup.sortOptions input

Placed in
the sort popup · once per composition
Required in
the sort popup
Parts
option, box · States: selected, ascending, descending

popup.filterServer input SINCE 2.1

Placed in
the filterMenu popup · once per composition
Parts
group, heading, row, label, select, value, chevron, list, option, box, count, search, empty, separator, clear, clearSelection, flag, segments, segment · States: selected, on, open, all, some

The Server group in the filterMenu popup, with heading "Server" and four rows: Map, Game version, Country and Server type.

  • Selects: each of the first three is a select button showing its value ("Any" when off) and a chevron. It carries on while that filter is set and open while its list is showing. Escape or a click outside closes the list and returns focus to the select.
  • Map list: a search box ("Search maps"), the official maps, a separator, then the rest, each with a count; empty reads "Loading maps..." or "No maps match". A clear button empties the map filter.
  • Version list: "All versions", "Same as mine" with the installed version when known, then each version with its count.
  • Country list: a Continents heading with clearSelection ("Clear selection"), the continents as tri-state options, a Countries heading, then every country A to Z with a flag and count. Options carry selected; a continent with only some countries picked carries some, with all of them all.
  • Server type: segments of segment buttons Any, Official and Community; the picked one carries selected.

popup.filterConnection input SINCE 2.1

Placed in
the filterMenu popup · once per composition
Parts
group, heading, row, label, segments, segment, checkbox, box · States: selected, on

The Connection group in the filterMenu popup, with heading "Connection".

  • Ping (ms): segments of segment buttons Any, < 50, < 100 and < 150; the picked one carries selected.
  • Hide offline servers: a checkbox row with the note "Servers that stopped answering". Its box carries on while the filter is on.

popup.filterGameplay input SINCE 2.1

Placed in
the filterMenu popup · once per composition
Parts
group, heading, row, label, segments, segment · States: selected

The Gameplay group in the filterMenu popup, with heading "Gameplay" and two rows of segments: Perspective (Any, 1PP only, 3PP allowed) and Time of day (Any, Day, Night). The picked segment in each row carries selected.

popup.filterMods input SINCE 2.1

Placed in
the filterMenu popup · once per composition
Parts
group, heading, row, label, segments, segment, select, count, chevron · States: selected, on

The Mods group in the filterMenu popup, with heading "Mods".

  • Mods: segments of segment buttons Any, Modded and Vanilla; the picked one carries selected. Its label is hidden from view and read by screen readers only.
  • Mods… button: a select reading "Mods…" with a count of "none picked" or the mod filter's summary, and a chevron. It carries on while any mod is picked. Clicking it closes the popup and opens the mod filter dialog.

popup.filterAccess input SINCE 2.1

Placed in
the filterMenu popup · once per composition
Parts
group, heading, row, checkbox, box · States: on

The Access group in the filterMenu popup, with heading "Access" and two checkbox rows: "No password" and "BattlEye on" (with the note "The anti-cheat DayZ uses"). The box carries on while the filter is on. Ticking BattlEye on keeps only servers with BattlEye; unticking clears it rather than excluding them.

popup.filterPlayers input SINCE 2.1

Placed in
the filterMenu popup · once per composition
Parts
group, heading, row, checkbox, box · States: on

The Players group in the filterMenu popup, with heading "Players" and two checkbox rows: "Hide empty servers" and "Hide full servers". The box carries on while the filter is on.

popup.filterFooter display SINCE 2.1

Placed in
the filterMenu popup · once per composition
Required in
the filterMenu popup
Parts
footer, total, count, reset

The footer of the filterMenu popup, and required in it. total reads the number of matching servers in count followed by " servers match"; count shows "…" until the number arrives, or "Couldn't count servers" (with no trailing text) if counting failed. reset reads "Reset filters" and clears every filter but keeps the search text.

popup.uniqueServerOptions input

Placed in
the modsUnique popup · once per composition
Required in
the modsUnique popup
Parts
option, empty

popup.clear action

Placed in
the mapFilter popup, the tagsFilter popup, the regionFilter popup · once per composition
Parts
label · States: disabled
Options
  • label (text)

Reads "Clear" and resets that filter.

popup.close action

Placed in
any themeable popup · once per composition
Required in
the region popup; the inline popup
Parts
icon
Options
  • icon (icon name, a package image path, or "none")

Required only where a popup can't be dismissed by clicking outside an anchored panel, so a region or inline popup always has a way out.

Surfaces

A surface is placed whole. Its elements keep their own ids, states and parts, so CSS still reaches them; only its arrangement is fixed. Placing a surface satisfies the requirements of every required element inside it, and counts as one placement of each element inside it — so placing surface.filterBar and a separate filter.search in the same composition is a multiplicity error.

surface.windowControls

Placed in
the shell, any view, or Settings
Contains
app.minimize, app.maximize, app.close

surface.navRail

Placed in
the shell, any view, or Settings
Contains
app.logo, nav.servers, nav.favourites, nav.recent, nav.lan, nav.mods, nav.settings, app.collapseToggle

surface.filterBar

Placed in
the server browser view
Contains
filter.search, filter.menu, filter.chips, filter.map, filter.tags, filter.mods, filter.region, filter.sort, filter.maxPing, filter.hideEmpty, filter.hideFull, filter.hideLocked, filter.hideOffline, filter.reset, servers.addServer, servers.refresh

surface.footerStatus

Placed in
the shell, any view, or Settings
Contains
status.steam, status.serverTotal, status.populated, status.listSource, status.lastRefreshed, app.uiScale, app.schemeToggle

surface.serverIdentity

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup
Contains
server.name, server.address, server.tags

surface.serverStats

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup
Contains
server.players, server.ping, server.gameTime

surface.serverProps

Placed in
anywhere a server is the subject: a server row, the server info modal, a selection container, or the server actions popup
Contains
server.map, server.version, server.region, server.modCount

surface.modDetails

Placed in
a mod row, or a modSelection container in the Mods view
Contains
mod.subscribed, mod.updated, mod.size, mod.rating, mod.workshopId

surface.modsActionBar

Placed in
the Mods view
Contains
mods.count, mods.selectAll, mods.clearSelection, mods.selectUnique, mods.cleanupRemoved, mods.unsubscribe, mods.unsubscribeMenu, mods.updateOutdated, mods.verify, mods.verifyMenu

surface.updateBody

Placed in
the update modal
Contains
update.summary, update.changelog, update.progress, update.portableNote

Lists

Every list follows one model: the theme declares the list's columns once, a launcher-rendered header shows them, and a row template places elements into those same columns.

  • Sort keys: a column may name a sort key only from its own list's set. Clicking that column's header sorts by it; clicking again reverses the direction. popup.sort offers the server keys Players, Ping, Mods, Name and Map, and lastPlayed is reachable only through a column header.
  • Row states: every row carries data-state, and rows are not focusable themselves — Tab moves into their elements. In the server and Mods lists, every second row also carries even, for zebra striping.

Empty and loading text. The empty and loading parts carry the launcher's wording:

ListText
list.servers"No servers match the current filters." after the first load; "No servers yet — the list fills in once Steam connects." before it
list.mods"Loading subscribed mods…", "No mods match the current filter.", or "You have no subscribed DayZ Workshop mods."
list.modFilterResults"Loading…", "Type a mod name above to search the Workshop.", "No subscribed DayZ mods.", or "No mods match."
list.serverMods"Checking mod readiness…" while loading; "No mods required." for an unmodded server, or "No mods found or not probed yet."
list.modServers"No servers in the browser need this mod."

A theme may place its own theme text instead, by giving the list an empty subtree.

list.servers

Row subject
server
Row template
layout/lists/servers.json
Sort keys
players, ping, mods, name, map, lastPlayed, country
Default sort
players, descending
Row states
selected, focused, offline, favourite, modded, official, firstPerson, locked, full, empty, modsPending, busy, even

list.mods

Row subject
mod
Row template
layout/lists/mods.json
Sort keys
name, status, size, updated, subscribed
Default sort
name, ascending
Row states
selected, focused, checked, disabled, ready, update, downloading, missing, notSubscribed, serverSide, even

list.modFilterResults

Row subject
workshopMod
Row template
layout/lists/modFilterResults.json
Sort keys
none: the list keeps its own order
Default sort
none
Row states
previewed, focused, included, excluded, subscribed

list.serverMods

Row subject
serverMod
Row template
layout/lists/serverMods.json
Sort keys
none: the list keeps its own order
Default sort
none
Row states
ready, needsUpdate, downloading, notInstalled, notSubscribed, serverSide, unique

list.modServers

Row subject
modServer
Row template
layout/lists/modServers.json
Sort keys
none: the list keeps its own order
Default sort
none
Row states
favourite, played

Modals

Three dialogs are themeable, and each one is a file under layout/modals/. Every other dialog is launcher-owned and takes only colour and type tokens: the destructive confirmations, theme import and export, delete-theme, Steam required, and first-run setup. If a modal file omits one of its required elements, the launcher renders Neutral's version of that modal.

serverInfo

File
layout/modals/serverInfo.json
Subject
server
Required
modal.close, server.join, server.actionNotice

modFilter

File
layout/modals/modFilter.json
Subject
none: the modal is not about one row
Required
modal.close, modFilter.apply, list.modFilterResults

update

File
layout/modals/update.json
Subject
none: the modal is not about one row
Required
modal.close, update.install, update.viewRelease

Popups

Each popup has its own file, layout/popups/<id>.json, declaring its placement mode and its contents. A missing file means the launcher's default popup.

mapFilter

Opened by
filter.map
Required contents
popup.mapOptions

tagsFilter

Opened by
filter.tags
Required contents
popup.tagOptions

regionFilter

Opened by
filter.region
Required contents
popup.regionOptions

sort

Opened by
filter.sort
Required contents
popup.sortOptions

serverActions

Opened by
server.menu
Required contents
none: the popup holds an action menu

serverLoad

Opened by
server.menu
Required contents
none: the popup holds an action menu

serverRow

Opened by
list.servers
Required contents
none: the popup holds an action menu

modsUnsubscribe

Opened by
mods.unsubscribeMenu
Required contents
none: the popup holds an action menu

modsVerify

Opened by
mods.verifyMenu
Required contents
none: the popup holds an action menu

modsUnique

Opened by
mods.selectUnique
Required contents
popup.uniqueServerOptions

filterMenu

Opened by
filter.menu
Required contents
popup.filterFooter

Icons

The names the icon option accepts.

alertTriangle, appWindow, arrowRight, ban, check, checkCircle, chevronDown, chevronLeft, chevronRight, chevronsLeft, chevronsRight, clock, copy, download, externalLink, fileArchive, fileOutput, filter, folder, folderOpen, gamepad, globe, inbox, info, keyRound, link, listTree, loader, minus, moon, moreHorizontal, package, palette, play, plus, refresh, rotateCcw, search, settings, square, star, sun, thumbsUp, trash, upload, users, x

Not placeable

These are launcher-owned and never appear in a layout file:

  • the toasts;
  • the window's resize edges;
  • the theme-fallback notice, the incompatible-theme notice and the Activation Safety Window;
  • Steam required, first-run setup and the splash;
  • the confirmation dialog, and the theme import, export and delete dialogs;
  • everything inside settings.themeManagement.