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
| Kind | What it is |
|---|---|
display | Read-only content: text, a number, a thumbnail. |
input | A control that holds or writes state. |
action | A button. |
nav | Moves between views, or opens Settings. |
notice | A launcher message. Kept so older layouts still validate; a placement renders nothing, because the launcher shows these as toasts. |
list | A list, its header and its rows. |
block | A launcher-owned block, placed whole. |
Where codes
| Code | Allowed files and positions |
|---|---|
app | layout/shell.json, any view file, or layout/settings.json. |
browser | layout/views/browser.json. |
mods | layout/views/mods.json. |
settings | layout/settings.json. |
server | Anywhere a server is the subject: a list.servers row, layout/modals/serverInfo.json, a container with "context": "selection", or popup.serverActions. |
server-panel | Same as server, minus rows. |
mod | A list.mods row, or a container with "context": "modSelection" in layout/views/mods.json. |
mod-panel | A container with "context": "modSelection", not a row. |
serverMod | A list.serverMods row. |
modServer | A list.modServers row. |
workshopMod | A list.modFilterResults row, or a container with "context": "modFilterPreview" in layout/modals/modFilter.json. |
modFilter | layout/modals/modFilter.json. |
update | layout/modals/update.json. |
modal | Any themeable modal file. |
selection | A container with "context": "selection", not a row or modal. |
popup | Any 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
| Code | Required in |
|---|---|
views | Every composition of the shell with the server browser, and of the shell with Mods. |
views+settings | As views, plus the composition of the shell with Settings. |
browser / mods / settings | That composition only. |
row | Every row template of the named list. |
modal | The named modal file. |
popup | The named popup file. |
with join | Every 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.
displayelements repeat freely.input,nav,notice,listand screen-levelactionelements 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
labelpart accepts thelabeloption. It is plain text of at most 40 characters and becomes both the visible and the accessible name. Required elements never acceptlabel. - Wording variants: some required elements offer
wordingvariants instead of a free label, and the launcher picks the exact words for the current state. - Icons: an element with an
iconpart accepts theiconoption 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. displayoptions: these choose betweeniconLabel,labelandicon. Withicon, the launcher's wording remains the accessible name and the tooltip.
No elements match
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
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
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
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.logo display
- Placed in
- the shell, any view, or Settings · any number of times
- Parts
image,wordmark- Options
app.collapseToggle action
- Placed in
- the shell, any view, or Settings · once per target region
- Parts
icon· States:collapsed- Options
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
app.schemeToggle action
- Placed in
- the shell, any view, or Settings · once per composition
- Parts
icon· States:dark,light- Options
nav Views and Settings
Moving between the views and opening Settings.
- Labels and icons: Servers (Globe), Favourites (Star), Recent (Clock), Mods (Package), Settings (gear).
- The current nav item:
currentsetsaria-current="page". - Opening Settings:
nav.settingstoggles Settings and setsaria-pressed. - Keyboard: inside a container with
"landmark": "navigation", nav items rove with the arrow keys and Home/End.
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
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
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
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
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
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.regionandfilter.sortopenpopup.mapFilter,popup.tagsFilter,popup.regionFilterandpopup.sort, witharia-haspopup="listbox"andaria-expanded. Thetriggerpart is the chip that opens the popup. - Filter popups: while open,
filter.map,filter.tagsandfilter.regionrender an inlinepopuppart holding arole="listbox"ofoptionbuttons (role="option"). Each option starts with aboxpart, the check column, which shows a check on picked rows; picked rows also carryselectedandaria-selected="true". Tag options draw a tri-stateindicator(✓ included, ✗ excluded) insideboxin place of the check, then the label "Official", "Modded" or "First person". The map and tag popups end with a hairlineseparatorpart and apopup.clearrow; the region popup ends with aseparator,popup.regionNoteandpopup.clear; sort marks the active key with the check only.filter.map'semptypart renders "Loading maps..." while its list is still loading, and "No maps match" when the search matches nothing. filter.modsopens the mod filter modal.filter.menuis the single Filters button and its grouped menu, with a count of the filters in force (badge,activeonce any filter is on) and a footer reading how many servers match. The button is atriggerholdinglabel,badgeandchevron; while open the popup splits intopopup,bodyand twocolumns, each group rendered in its ownpopup.filter*element with aheading,rows and, in the Server group, aselectrow (value,chevron) that opens alistofoptions. A group's segmented row has alabel,segmentsandsegments (selectedon the picked one); a checkbox row hascheckboxand, when on, aboxwithon. On the Favourites or Recent tab it renders only anoteand thetabNotestate. Its groups arepopup.filterServer,popup.filterConnection,popup.filterGameplay,popup.filterMods,popup.filterAccessandpopup.filterPlayers, and its footer ispopup.filterFooter(footer,total,count,reset). The map list carries its ownsearch,emptyandclear; each list opens under its select row, over the menu, and its pick puts focus back on that row.activestate: map, tags, region and mods areactivewhile they filter anything. Sort isactiveunless it is Players, descending. Ping isactivebelow 500.- Hide toggles: labelled "Hide empty", "Hide full", "Hide locked" and "Hide offline". Default off, persisted, and cleared by
filter.resetalong with every other filter. The control role follows thecontroloption:buttonis a pressable button witharia-pressed,checkboxhasrole="checkbox"andswitchhasrole="switch". Theboxpart renders only forcheckboxandswitch. - Sort keys: Players, Ping, Mods, Name and Map.
Label and value wording: labels are MAP, TAGS, REGION, MODS, SORT and PING.
| Element | Value |
|---|---|
| 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.search input
- Placed in
- the server browser view · once per composition
- Required in
- the shell + server browser composition
- Parts
icon,input,clear,suggestions,suggestion,kind,match,count,hint· States:filled,open,active- Options
Writes the search filter after a 250 ms trailing debounce. Its placeholder is "Search servers…".
- Clear: while the box has text, a
clearbutton empties it and sets the search to null at once, then puts the cursor back in the field. - Suggestions: from two characters on, an All-servers tab with the box focused asks for suggestions 250 ms after the typing stops, and a reply older than the newest request is dropped. The list sits under the box and holds up to three maps, four mods and two versions, each with its server count and the typed text marked.
- Keys: Down and Up move through the list, wrapping at either end; Enter on a row adds it as a filter, Enter with none picked keeps the text as search; Escape closes the list without clearing the text. A list for older text never shows.
- Picking: a map adds to
maps, a mod tomod_ids(only its first id when every mod must match, and off the excluded list), a version replacesversion, and the search text clears.
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
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
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
filter.mods action
- Placed in
- the server browser view · once per composition
- Parts
label,value,chevron· States:active- Options
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,ModsorTime) and avalue, with the full text as its title. Theremovebutton 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
morebutton reading "+N more", which opens the Filters menu. The strip carriesfoldedwhile 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
filter.maxPing input
- Placed in
- the server browser view · once per composition
- Parts
label,track,knob,value· States:active- Options
filter.hideEmpty input
- Placed in
- the server browser view · once per composition
- Parts
label,box,icon· States:on- Options
filter.hideFull input
- Placed in
- the server browser view · once per composition
- Parts
label,box,icon· States:on- Options
filter.hideLocked input
- Placed in
- the server browser view · once per composition
- Parts
label,box,icon· States:on- Options
filter.hideOffline input
- Placed in
- the server browser view · once per composition
- Parts
label,box,icon· States:on- Options
filter.reset action
- Placed in
- the server browser view · once per composition
- Parts
icon,label- Options
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
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
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
| Element | Format |
|---|---|
server.gameTime | "h:mm AM/PM · {multiplier}"; "--:--" when unknown |
server.players | "{players}/{max}", with "+{queue}" when queued |
server.ping | A number, or "—"; good ≤ 80, fair ≤ 120, poor above 120 |
server.modCount | The 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.region | Europe, North America, South America, Asia, Oceania, the raw code if unmapped, or "Unknown region" |
- Readiness data:
server.readinessandserver.downloadSizeread 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.readinesswithbasis: "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.downloadSizeshows "{n} mods" in itscountpart, then "Download size: {size}" ("up to" inqualifierwhen 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:
offlineis 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; theserverInfomodal - Parts
icon,label,spinner· States:busy,disabled,playing,modded,needsMods,offline- Options
Runs the join, which verifies and fixes mods first.
Wording
| State | Wording |
|---|---|
| Idle | "Join", or "Fix and join" when the variant is fixAndJoin and mods need a download or update |
busy | The 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.joininside aselectioncontainer 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
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
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
serverInfomodal · once per subject context - Parts
icon,label· States:offline- Options
Reads "More info" and opens the server info modal.
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
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
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
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
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
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
Reads "Copy address", or "Address copied" for 2 s after copying ip:gamePort.
server.copyJoinLink 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
Reads "Copy join link" (the label option changes it) and copies a link to this server's page on tetralauncher.com, built from the server's address, query port, name and map. offline is set for an offline server. Clicking it closes the popup it sits in.
- Result: inside a popup a successful copy shows "Join link copied" as the server's notice; elsewhere nothing confirms it. A failed copy shows the error text.
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
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
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
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
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
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
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
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
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:
goodis 80 ms or less,fairis up to 120,pooris more.unknownmeans 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
shieldicon (title explains it) comes beforevalue, andtipis 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
estimatedorprotected, for examplefair 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
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
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
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
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
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
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
Wording
| State | Wording |
|---|---|
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
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
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.unsubscribeMenuandmods.verifyMenuopenpopup.modsUnsubscribeandpopup.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.search input
- Placed in
- the Mods view · once per composition
- Parts
icon,input· States:filled- Options
Matches title, tags or Workshop id, with no debounce. Its placeholder is "Search mods by name, tag or id…".
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
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
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
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
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
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
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
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
mods.unsubscribeSelected action
- Placed in
- the Mods view, the modsUnsubscribe popup · once per composition
- Parts
label· States:disabled- Options
mods.unsubscribeAll action
- Placed in
- the Mods view, the modsUnsubscribe popup · once per composition
- Parts
label· States:disabled- Options
mods.updateOutdated action
- Placed in
- the Mods view · once per composition
- Parts
icon,label· States:disabled- Options
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
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
mods.verifySelected action
- Placed in
- the Mods view, the modsVerify popup · once per composition
- Parts
label· States:disabled- Options
mods.verifyAll action
- Placed in
- the Mods view, the modsVerify popup · once per composition
- Parts
label- Options
mod One subscribed mod
Elements that read or act on one subscribed mod, in a list.mods row or a selection panel.
- Selection:
mod.selectchecks 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.tagsfalls back to the Workshop id when the mod has no tags;mod.sizeshows the size on disk to one decimal place;mod.ratingshows "{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
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
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
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
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
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
mod.neededBy display
- Placed in
- a modSelection container, not a row · any number of times
- Parts
value,label· States:disabled- Options
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
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
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
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
Reads "Reinstall".
mod.deselect action
- Placed in
- a modSelection container, not a row · once per subject context
- Parts
icon· States:disabled- Options
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
modal Any themeable modal
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
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
modFiltermodal - 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.search input
- Placed in
- the mod filter modal · once per composition
- Parts
icon,input,error· States:filled,busy- Options
Its placeholder follows the source: "Filter your subscribed mods…", "Filter mods seen on these servers…" or "Search the Workshop by name…". It filters locally, except on Search Workshop, where it runs a 350 ms debounced search and is busy while searching.
modFilter.summary display
- Placed in
- the mod filter modal · any number of times
- Parts
thumbnails,more,counts· States:empty,included,excluded- Options
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
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
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
modFilterPreviewcontainers. - Formats:
workshopMod.serverCountshows "{n} srv" or "—";workshopMod.scoreshows "{score}%";workshopMod.subscribersshows "{n} subscribers";workshopMod.updatedshows "Updated {relative time}". - Icons:
workshopMod.score,workshopMod.subscribers,workshopMod.includeandworkshopMod.excludestart with aniconpart (thumbs-up, people, check, no-entry); theiconoption 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
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
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
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
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
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
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
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
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
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
updatemodal - Parts
icon,label· States:busy,disabled- Options
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
updatemodal - Parts
icon,label- Options
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
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
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.appMenuis required, and each saves as soon as it changes.settings.appMenuis 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.sectionDescriptionandsettings.sectionIconrender the wording for the Game, Launcher and Theme sections;settings.groupTitlerenders the checkbox group headings Window, Startup and Discord;settings.appMenudraws its own App menu heading (parttitle).
settings.back action
- Placed in
- Settings · once per composition
- Required in
- the shell + Settings composition
- Parts
icon,label- Options
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
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
settings.dayzPath input
- Placed in
- Settings · once per composition
- Required in
- the shell + Settings composition
- Parts
label,hint,control- Options
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
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
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
settings.closeToTray input
- Placed in
- Settings · once per composition
- Required in
- the shell + Settings composition
- Parts
label,hint,box· States:checked- Options
settings.onJoin input
- Placed in
- Settings · once per composition
- Required in
- the shell + Settings composition
- Parts
label,hint,control- Options
settings.startWithWindows input
- Placed in
- Settings · once per composition
- Required in
- the shell + Settings composition
- Parts
label,hint,box,note· States:checked- Options
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
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
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
showServerpart and has its ownlabel,hintandbox, carriescheckedwhile 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
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
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
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:
versionreads "Tetra Launcher" and the installed version number.linksholds two icon buttons, "Website" and "Source code on GitHub", that open in the browser. - Update button:
buttonreads "Check for updates" inlabel, and checks once on click. It is disabled while checking or installing. When an update is available it reads "Update" ("Updating…" while installing) and carriesdata-state="update"; clicking installs it, or opens the download page for a copy that cannot update itself. Abadgedot shows beside it while an update is available. - Status:
statusshows "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,whatsnewreads "See what's new" and opens that release's notes. - Credits:
creditsholds 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
settings.sectionDescription display
- Placed in
- Settings · any number of times
- Parts
text- Options
settings.sectionIcon display
- Placed in
- Settings · any number of times
- Parts
icon- Options
settings.groupTitle display
- Placed in
- Settings · any number of times
- Parts
text- Options
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
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
list.modFilterResults list
- Placed in
- the mod filter modal · once per composition
- Required in
- the
modFiltermodal - Parts
header,column,scroller,rows,empty,loading· States:empty,loading,searching- Options
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
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
Shows the first 8 servers; beyond that a more part reads "+{n} more".
popup The themeable 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. 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.regionOptionsandpopup.uniqueServerOptionsare single lists ofrole="option"entries with a check mark on the selected ones.popup.mapOptionshas a search box (partsearch) above its list, which shows the official maps first, then a separator, then the rest.popup.tagOptionscycles Official, Modded and First person through include (✓), exclude (✗) and off.popup.sortOptionslists 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.serverActionsandpopup.serverLoadmay hold anyserver.*action, andserver.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
selectbutton showing itsvalue("Any" when off) and achevron. It carriesonwhile that filter is set andopenwhile itslistis showing. Escape or a click outside closes the list and returns focus to theselect. - Map list: a
searchbox ("Search maps"), the official maps, aseparator, then the rest, each with acount;emptyreads "Loading maps..." or "No maps match". Aclearbutton 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 aflagandcount. Options carryselected; a continent with only some countries picked carriessome, with all of themall. - Server type:
segmentsofsegmentbuttons Any, Official and Community; the picked one carriesselected.
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):
segmentsofsegmentbuttons Any, < 50, < 100 and < 150; the picked one carriesselected. - Hide offline servers: a
checkboxrow with the note "Servers that stopped answering". Itsboxcarriesonwhile 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:
segmentsofsegmentbuttons Any, Modded and Vanilla; the picked one carriesselected. Itslabelis hidden from view and read by screen readers only. - Mods… button: a
selectreading "Mods…" with acountof "none picked" or the mod filter's summary, and achevron. It carriesonwhile 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.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
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
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.sortoffers the server keys Players, Ping, Mods, Name and Map, andlastPlayedis 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 carrieseven, for zebra striping.
Empty and loading text. The empty and loading parts carry the launcher's wording:
| List | Text |
|---|---|
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.