This page is the technical reference for the theme system. Each token is a CSS variable: it is declared in Definition.toml (in the corresponding section or in [tokens]) and the launcher applies it to the interface.
For the complete workflow, see Creating a theme .
# Resolution orderedit Values are applied in this order; the last one wins:
Launcher defaults (:root).
Theme variables (Meta.toml + Definition.toml).
Theme background image and fonts.
Inject.css, in the cubic.theme layer or without a layer depending on [inject].layer.
Layout.css, always without a layer and last.
The launcher's global styles live in the cubic layer; each component's styles do not use layers. That is why Inject.css can override variables and global styles without problems, but to beat a component it needs layer = "unlayered".
# How to declare a tokenedit [colors]
accent = "#97C459"
[text]
primary = "#E0ECD4"
[tokens]
"--bg-image-blur" = "12px" Values are copied to CSS as-is. A numeric token without a unit (for example "12") produces an invalid value for the browser and the declaration is discarded.
# Surfaces and backgroundsedit Token Controls Default --bg-mainBase window background #0a0a0a--bg-sidebarSidebar background #111113--bg-cardCard and panel background #111113--bg-inputText field background #0a0a0a--bg-item-activeSelected item background #18181a--bg-overlayVeil over the interface rgba(0, 0, 0, 0.7)--bg-surfaceAlias of --bg-item-active var(--bg-item-active)--bg-sidebar-gradientSidebar gradient linear-gradient(180deg, …)--bg-card-gradientCard gradient linear-gradient(135deg, …)--surface-rgbBase triplet for translucent surfaces 255, 255, 255--surface-hoverSurface on hover rgba(var(--surface-rgb), 0.06)--surface-activePressed surface rgba(var(--surface-rgb), 0.08)--surface-selectedSelected surface rgba(var(--surface-rgb), 0.03)--surface-cardCard fill rgba(var(--surface-rgb), 0.03)--surface-inputField fill rgba(var(--surface-rgb), 0.03)--surface-subtleBarely visible surface rgba(var(--surface-rgb), 0.02)--surface-raisedRaised surface rgba(var(--surface-rgb), 0.04)--surface-dropdownDropdown background var(--bg-card)--toast-bgNotification background color-mix(…)--toast-borderNotification border rgba(var(--surface-rgb), 0.06)
Token Controls Default --text-primaryMain text #f4f4f5--text-secondarySecondary text #a1a1aa--text-mutedDisabled text #71717a--text-tertiaryAuxiliary text #71717a
Token Controls Default --accentBrand color #ffffff--accent-rgbThe accent as R, G, B 255, 255, 255--accent-hoverAccent on hover #f4f4f5--accent-textText on the accent #0a0a0a--accent-primaryAlias of --accent var(--accent)
--accent-rgb is not calculated automatically. If you change --accent and forget --accent-rgb, glows, borders and backgrounds that use rgba(var(--accent-rgb), α) keep the previous color.
# Borders and radiiedit Token Controls Default --border-colorBorder color rgba(var(--surface-rgb), 0.06)--borderAlias of --border-color var(--border-color)--border-widthBorder thickness 1px--border-hoverBorder on hover rgba(var(--surface-rgb), 0.1)--border-focusFocus border rgba(var(--surface-rgb), 0.3)--border-radiusGlobal radius 4px--border-radius-smSmall radius 3px--border-radius-lgLarge radius calc(var(--border-radius) * 2)--border-radius-pillPill radius 999px
Token Controls Default --shadow-smSubtle shadow 0 1px 3px rgba(0, 0, 0, 0.5)--shadow-mdMedium shadow 0 4px 12px rgba(0, 0, 0, 0.5)--shadow-lgLarge shadow 0 8px 28px rgba(0, 0, 0, 0.6)--shadow-insetInner shadow inset 0 1px 2px rgba(0, 0, 0, 0.2)--shadow-floatingFloating elements var(--shadow-lg)--shadow-imageImages var(--shadow-md)--shadow-indicatorIndicators var(--shadow-sm)--shadow-drawer-leftLeft drawer -8px 0 32px rgba(0, 0, 0, 0.6)--shadow-drawer-rightRight drawer 8px 0 32px rgba(0, 0, 0, 0.6)--shadow-drawer-topTop drawer 0 -8px 32px rgba(0, 0, 0, 0.6)--shadow-drawer-bottomBottom drawer 0 8px 32px rgba(0, 0, 0, 0.6)
Token Controls Default --font-familyInterface typography "Cantarell", system-ui, sans-serif--font-family-monoMonospaced typography ui-monospace, …--font-size-baseBase size 14px--font-size-smSmall size 0.8rem--font-size-lgLarge size 1.2rem--font-size-controlControl text 0.85rem--font-size-labelLabels 0.65rem--font-weight-normalNormal weight 400--font-weight-mediumMedium weight 600--font-weight-boldBold weight 700--line-heightLine height 1.5
# Spacing, controls and motionedit Token Controls Default --space-xsExtra-small space 4px--space-smSmall space 8px--space-mdMedium space 12px--space-lgLarge space 16px--space-xlExtra-large space 24px--control-paddingControl padding 10px 12px--button-paddingButton padding 8px 16px--icon-scaleGlobal icon scale 1--transition-fastFast transition 0.15s--transition-normalNormal transition 0.2s
Token Controls Default --sidebar-widthSidebar width 260px--sidebar-compact-widthWidth in compact mode 70px--sidebar-row-heightRow height 52px--sidebar-compact-row-heightCompact row height 50px--sidebar-row-gapGap between rows 8px--version-row-heightVersion row height 78px--resource-row-heightResource row height 130px--resource-row-gapGap between resources 6px--resource-card-paddingResource card padding 14px 16px--resource-icon-sizeResource icon size 56px
# Content marketplaceedit Token Controls Default --market-row-heightRow height 224px--market-grid-gapGrid gap 12px--market-card-min-widthMinimum card width 280px--market-grid-paddingGrid padding 8px--market-card-paddingCard padding 14px--market-icon-sizeIcon size 48px--market-item-gapGap between items 10px--market-title-sizeTitle size 0.9rem--market-description-sizeDescription size 0.75rem--market-button-paddingButton padding 5px 12px--market-installed-row-heightInstalled row height 84px--market-installed-row-gapGap between installed items 6px--market-installed-icon-sizeInstalled icon 40px--market-installed-paddingInstalled item padding 8px 12px--market-detail-icon-sizeDetail icon 80px--market-detail-sidebar-widthDetail sidebar 270px--market-page-paddingPage padding 24px--market-page-padding-compactPadding in a narrow window 14px
The marketplace derives its colors from the theme through aliases. You do not need to redefine them: if you change --accent and --bg-card, the marketplace follows.
Alias Derives from --market-card-bg, --market-panel-bg, --market-input-bg--bg-card, --bg-sidebar, --bg-input--market-accent, --market-accent-hover, --market-accent-text--accent, --accent-hover, --accent-text--market-border, --market-border-hover, --market-card-radius--border, --border-radius--market-success, --market-error, --market-warning, --market-info--color-success, --color-error, --color-warning, --color-info--market-text-secondary--text-secondary
# States and semantic colorsedit Token Controls Default --color-successSuccess #22c55e--color-success-rgbSuccess as R, G, B 34, 197, 94--color-errorError #ef4444--color-error-rgbError as R, G, B 239, 68, 68--color-warningWarning #eab308--color-warning-rgbWarning as R, G, B 234, 179, 8--color-infoInformation #60a5fa--color-info-rgbInformation as R, G, B 96, 165, 250--color-on-successText on success #fff--color-on-errorText on error #fff--color-on-warningText on warning #fff--color-on-infoText on information #fff--color-status-startingInstance starting var(--color-info)--color-status-startedInstance started var(--color-success)--errorAlias of error var(--color-error)--warningAlias of warning var(--color-warning)--glow-errorError glow 0 0 12px rgba(…)--glow-successSuccess glow 0 0 12px rgba(…)
Token Controls Default --download-libraryLibraries #4ade80--download-assetAssets #60a5fa--download-nativeNative libraries #f59e0b--download-clientClient #a78bfa--download-verifyingVerification #f472b6--download-genericGeneric #94a3b8--download-processingProcessing #fb923c--download-jreJava #22d3ee
# Console and logsedit Token Controls Default --log-traceTrace level var(--text-muted)--log-debugDebug level var(--text-muted)--log-infoInfo level var(--text-primary)--log-messageMinecraft messages var(--text-primary)--log-warnWarn level var(--color-warning)--log-errorError level var(--color-error)--log-fatalFatal level var(--color-error)--log-launcherLauncher messages var(--text-primary)--log-stderrError output var(--color-error)--log-unknownUnknown level var(--text-tertiary)--log-font-sizeFont size 0.75rem--log-line-heightLine height var(--line-height)--log-line-paddingLine padding 2px 14px--log-line-min-heightMinimum line height 22px
Token Controls Default --scrollbar-thumbThumb rgba(var(--surface-rgb), 0.12)--scrollbar-thumb-hoverThumb on hover var(--text-secondary)--scrollbar-trackTrack var(--bg-main)--scrollbar-sizeThickness 6px--scrollbar-radiusRadius 10px
# Background imageedit Token Controls Default --bg-image-blurBlur (with unit) 8px--bg-image-opacityOpacity (0–1) 0.3--bg-image-sizeFraming cover--bg-image-positionPosition center--bg-image-brightnessBrightness 0.4
[background] writes these variables automatically. image_blur, image_opacity, mode, position and brightness are numbers or unitless strings; the launcher adds px only to the blur. If you prefer full control, declare the variable in [tokens] with the unit included.
# Backdrop blursedit They are declared in [backdrop] as numbers and the launcher adds px.
Token Controls Default --backdrop-blur-overlayOverlaid veil 4px--backdrop-blur-modalModals 4px--backdrop-blur-dropdownDropdowns 4px--backdrop-blur-panelPanels 2px--backdrop-blur-floatFloating elements 4px--backdrop-blur-viewerImage viewer 2px
# Overlays and viewersedit Token Controls Default --media-overlayVeil over images rgba(0, 0, 0, 0.6)--media-overlay-textText over images #fff--media-overlay-borderBorder over images rgba(255, 255, 255, 0.1)--viewer-overlayViewer background rgba(0, 0, 0, 0.9)--tutorial-overlayTutorial veil rgba(0, 0, 0, 0.5)--tutorial-overlay-softSoft tutorial veil rgba(0, 0, 0, 0.15)
# Mod loadersedit Token Controls Default --clr-loader-vanillaVanilla #78909c--clr-loader-fabricFabric #66bb6a--clr-loader-forgeForge #ffa726--clr-loader-quiltQuilt #ab47bc
# Miscellaneousedit Token Controls Default --icon-filterCSS filter for raster icons in some controls invert(1)--color-schemeNative scheme (dark, light): system scrollbars and controls normal
Internal variables
--bg-image-loaded and --font-loaded are written by the launcher to coordinate entrance animations. Do not declare them in a theme: they are overwritten when the theme is applied and the result is unpredictable.
A theme can replace icons by declaring keys in the group:name format in [icons.group]. These are the names the interface uses:
Group Names uibell, interface, check, check-circle, chevron-down, chevron-left, chevron-right, close, copy, download, error, flag, lock, logout, performance, pin, play, refresh, resources, search, shaders, spinner, success, trash, unlock, uploadnavcreate, edit, pencil, settings, slidersinstancebox, check-square, clock, code, database, external-link, folder, grid, image, market, multiplayer, puzzle, resources, screenshots, servers, shader, terminal, worldslogarrow-down, chevron-down, chevron-up, clear, copy, logs, scroll-down, search, spinner, uploadbrandcubic, curseforge, discord, fabric, forge, github, microsoft, modrinth, neoforged, optifine, quilt, vanilla
brand:curseforge, brand:fabric, brand:forge, brand:modrinth, brand:neoforged, brand:optifine and brand:vanilla are raster images in the original launcher; when replacing them, it is best to use PNG with a transparent background.
In addition to the groups, [icons] preview defines the theme image in the selector.
# Minimum contrastedit For a theme to be readable on any screen:
Main text on the main background: 4.5:1 minimum.
Secondary text and labels: 3:1 minimum.
Borders and separators: 1.5:1 relative to the surface.
Text on --accent: use --accent-text, not --text-primary.