Theme changes
What changed for theme authors in each release, newest first. Each release starts with what you may need to do; the rest needs nothing from you.
3.2.0: check your theme
Installed themes keep loading. If a row matches your theme, do what the right column says.
| If your theme… | Do this |
|---|---|
ships its own layout/shell.json, or places the nav items in a view, without nav.lan | Add nav.lan beside the other nav items. It is required in every view, so until it is placed the server browser and Mods screens fall back to Neutral's and Dev Mode names it. A theme that places surface.navRail already has it. |
| places a new element from the list below | Set minimumLauncherVersion to 3.2.0. Older launchers don't know these elements, so a file that places one falls back to Neutral's there (ELE-01). |
places or styles the notice.* bars | Nothing breaks, but those placements render nothing now: every launcher message is a toast in the top-right corner, which the launcher owns. The elements stay registered, so you can leave the placements in or remove them, and drop their CSS. |
styles server.region or sizes the column that holds it | It shows the country now, not the region: a flag image, then the country name or its two-letter code. Check the column width, and style or hide [data-part="flag"]. |
styles settings.discordPresence | It is a wrapper now, holding the Rich Presence row and a second row, showServer. Your class lands on the wrapper, and a selector such as [data-el="settings.discordPresence"] [data-part="box"] matches both boxes. Reach the first row with [data-el="settings.discordPresence"] > label and the second with [data-part="showServer"]. |
places server.ping | A server behind DDoS protection now shows a shield and carries a tip paragraph. The tip stays hidden and out of the layout unless your CSS shows it, for example on :hover; the shield's title carries the same text. |
works around popups pausing transforms or filters, or targets [data-popup-ancestor] | Drop the workaround. Anchored popups now show in the browser's top layer (they carry popover), so the elements around them keep their transforms and filters, and the attribute is gone. They paint above toasts. |
3.2.0: new and fixed
Nothing here needs a change, but you may want to use it.
Server browser
filter.menuopens one grouped Filters menu (popupfilterMenu), andfilter.chipsshows a chip for each filter that is on. Both built-in themes now place only search, Filters, chips, Add server and Refresh (and Neutral its Sort); the older filter controls still work wherever a theme places them.- The Filters menu's groups are themeable elements:
popup.filterServer,filterConnection,filterGameplay,filterMods,filterAccess,filterPlayersandpopup.filterFooter. A theme's ownlayout/popups/filterMenu.jsonmay place the groups and must place the footer. filter.regionfilters by country: each continent in its popup, now with Africa as a sixth, picks all of that continent's countries, and only a fully picked continent shows asselected. Filters saved with region codes load as the matching countries.filter.searchhas aclearbutton and a suggestions list (thesuggestions,suggestion,kind,match,countandhintparts, anopenstate, andactiveon the highlighted suggestion).- A LAN tab:
nav.lan, andlan.empty, whichlist.serversdraws in place of rows on that tab (a placement of its own renders nothing). On the LAN tabstatus.serverTotalcounts the LAN servers, labelled " on your network". servers.addServeropens the Add server dialog.- Right-click on a server row, or Shift+F10 or the Menu key on the selected one, opens a row menu at the pointer or the row. A theme can ship
layout/popups/serverRow.jsonfor it, with the newserver.copyJoinLinkandserver.forgetPasswordactions; without one the launcher's menu is used. Items in it are menu items, andserver.favouritea checkable one. list.serverssorts bycountry.
Servers and mods
server.pinggains theestimatedandprotectedstates: a host that blocks ping is timed from its query replies, and one behind DDoS protection says so.server.modDifferswarns above Join when a local mod copy differs from the server's, with a Fix and join button;serverMod.stategainsdiffers, andserverMod.noteexplains it in the mod row.server.versionWarningshows a small triangle when the server runs another DayZ version.server.favouritetakeslabelOn, its label while the server is a favourite.
Settings
- An About section:
settings.about, with"about"as asectionfor the section title, description and icon. settings.launchParamshas a row of launch toggles (thetogglesparts,checkedon each).settings.appMenu, with theappMenugroup title, adds Tetra to the Linux app menu. It is optional and draws nothing outside the AppImage build.
Popups and lists
- A dialog opened while a popup is open paints above it, and so do the window's resize edges and Dev Mode.
- A list's
emptyblock from a theme shows when nothing matches. - Arrow keys in a popup are left to tabs, accordions, grids and resize handles inside it, which move on their own.
- Two more icons:
keyRoundandlink.
3.1.0: check your theme
Installed themes keep loading. If a row matches your theme, do what the right column says.
| If your theme… | Do this |
|---|---|
| overrides a launcher rule that keeps required elements visible or usable | Nothing to change, but those rules win now. styles.css loads inside the theme cascade layer, above Neutral and below the launcher's guarantees, as the CSS API always described. |
styles popup.mapOptions | The element is now a wrapper holding a search part and the role="listbox" list. Style the options inside the list, and give the search box a look if your popups need one. |
hid update.changelog's "No changelog notes" line in CSS | Drop the rule: the element renders nothing while there is no update. |
styles update.title with a tag selector such as span[data-el=…] | It is an h2 now. Attribute selectors keep working. |
gives serverMod.state's label a class and relied on its built-in mono font | Add the font to your class: built-in classes on that label are now defaults your class replaces. |
3.1.0: new and fixed
Nothing here needs a change, but you may want to use it.
- Stack and grid nodes take
"tag": "span", so a header built from stacks can sit inside a button. server.nametakes"heading": trueto render as a heading; Neutral's server info uses it.modFilter.summarythumbnails carrydata-state="included"or"excluded".workshopMod.serverNotehas acountpart beside its text.- The map popup lists the official and DLC maps first, then a separator, then the rest, with a search box on top.
- Blanks match the old launcher: an unknown region or map shows a dash, a checked server with no mods shows 0, a mod with no name shows its Workshop id, and a mod with no tags shows no chips.
server.actionNoticeis no longer required in server list rows, where it draws nothing.- Text boxes inside a popup receive their keys, Enter included.
- The success tint tokens are a little stronger (16% instead of 14%).
3.0.0: check your theme
Installed themes keep loading. A layout file that breaks a stricter rule falls back to Neutral's on its own, and Dev Mode's check names it; a package that breaks an import rule below is refused at import and export until it is fixed. If a row matches your theme, do what the right column says.
| If your theme… | Do this |
|---|---|
has preview images outside previews/ | Move them into previews/ and update theme.json. Import and export refuse any other path. |
has a settings field or option with an empty label, or a number default outside min..max | Give every label 1 to 40 characters and keep defaults in range. Otherwise that field is left out of the settings form. |
ships layout/popups/modActions.json or layout/popups/settingsNav.json | Delete them. Nothing ever loaded them, and import now refuses them. |
uses a text node role outside the list of ten | Use display, heading, subheading, body, label, caption, micro, button, chip or data (LAY-03). |
| has an SVG that links outside itself | Keep href to #id or embedded PNG, JPEG, WebP or GIF data. No <foreignObject>, stylesheet links, @import, outside url(…) or CSS escapes. |
has a CSS selector with a pseudo-class right after a space, such as [data-el="x"] :hover | Anchor it: [data-el="x"] [data-part="y"]:hover or > :hover. :nth-child() takes An+B, odd or even only. See CSS API. |
declares a --z-* custom property | Remove it. The stacking order belongs to the launcher (CSS-04). |
cancels launcher spacing with > :not([hidden]) ~ :not([hidden]) | Use > :not(:last-child). Launcher spacing now sits below or right of each child but the last. |
| sets a colour, background or opacity on an element and relied on the built-in hover or disabled look | Add your own :hover or [data-state~="disabled"] rule. Your rule now wins in every state. |
styles the box part in a filter popup as a checkbox | Style it as an icon column: it holds a check icon (the tag popup's ✓/✗ instead). Select picked rows with [data-part="option"][data-state~="selected"]; excluded tags carry excluded instead. |
styles the tag popup's ✓/✗ with [data-part="option"] > [data-part="indicator"] | Use a descendant selector: the indicator now sits inside the box part. |
styles update.install, update.viewRelease or the workshopMod score, subscribers, include or exclude elements as plain text | They now start with an icon part. Give them display: inline-flex; align-items: center; gap: …, or hide [data-part="icon"]. |
places server.downloadSize | Check its new wording ("{n} mods", then "Download size: {size}") and drop any [data-state~="checking"] rule. |
places server stats inside a "context": "selection" container | They draw as in the server info window now, without the built-in "PLAYERS", "PING", "TIME" and "MODS" labels. Add your own text beside each element, and move [data-part="label"] styling to it. |
places settings.sectionTitle, sectionDescription or sectionIcon in a plain box | They are inline now. Add display: block or put them in a column stack if you want separate lines. |
sizes the mod.thumbnail placeholder as an icon | Check it: the placeholder is text now. |
ships layout/popups/serverActions.json or serverLoad.json | Check them: the server menu now opens them instead of the launcher's own list. |
styles notice.launch | Add a [data-state~="success"] rule. The bar now also shows short "Done" messages, such as "Address copied", for two seconds. |
| started from a starter template | Nothing breaks. New themes now start as a copy of Neutral or Tactical; the starters are gone. |
Newly required elements are not placed for you. A screen that lacks a required element falls back to Neutral's, and Dev Mode names the missing element. When a release lists one, add it to your layout files.
3.0.0: new and fixed
Nothing here needs a change, but you may want to use it.
Layout and settings
- Setting conditions (
hidden: {"setting": …}) now work. A condition on a field the settings check dropped failsLAY-03, and the message names the setting. - A settings combination that would hide a required element makes that file fall back, and Dev Mode names the combination.
- Dev Mode's check lists settings issues beside layout issues, and shows up to 64 combinations.
collapsibletakescollapseBelow(for example"720px") to fold a region in small windows.- A theme can ship
layout/popups/modsVerify.jsonandmodsUnsubscribe.jsonfor the mods menus. list.servers,list.modsandlist.modFilterResultsnow honourheaderandrowGapand emit thescrollerandrowsparts.
Colours and popups
- Every window backdrop reads
color.scrim. The new optionalcolor.scrimBlockingdarkens the Steam required screen. - An open popup can't be pushed off screen by a filter or transform on the elements around it; those pause while it is open.
- Popups work from the keyboard: arrows, Home, End, Enter, Space, and Esc back to the button.
- Windows open on their main action and close on a click on the backdrop. The backdrop can be styled with
[data-modal-host][data-backdrop="dim"].
Elements
server.readinessgainsbasis: "declared", which shows the server's own declared mod state.server.modCounthas avanillastate for a server that is not modded and was never checked.server.regionshows the full region name on hover in both formats.- Filter popups end with a separator and Clear, like the launcher's own menus.
server.menuwithout a popup file opens Neutral's server actions.- Wording now matches the launcher: mod states read Ready, Update or Missing; the list source reads "via index" or "via Steam".
Themes page
- Every theme id the launcher creates follows the package id rule. A copy named in another script keeps its name and gets an id like
local.theme-2. Installed themes keep their ids.