Esta página es la referencia técnica del sistema de temas. Cada token es una variable CSS: se declara en Definition.toml (en la sección correspondiente o en [tokens]) y el launcher la aplica sobre la interfaz.
Para el flujo de trabajo completo, mirá Crear un tema .
# Orden de resolucióneditar Los valores se aplican en este orden; lo último gana:
Valores por defecto del launcher (:root).
Variables del tema (Meta.toml + Definition.toml).
Imagen de fondo y fuentes del tema.
Inject.css, en la capa cubic.theme o sin capa según [inject].layer.
Layout.css, siempre sin capa y al final.
Los estilos globales del launcher viven en la capa cubic; los estilos de cada componente no usan capas. Por eso Inject.css puede sobrescribir variables y estilos globales sin problemas, pero para ganarle a un componente hace falta layer = "unlayered".
# Cómo declarar un tokeneditar [colors]
accent = "#97C459"
[text]
primary = "#E0ECD4"
[tokens]
"--bg-image-blur" = "12px" Los valores se copian tal cual al CSS. Un token numérico sin unidad (por ejemplo "12") produce un valor inválido para el navegador y la declaración se descarta.
# Superficies y fondoseditar Token Controla Por defecto --bg-mainFondo base de la ventana #0a0a0a--bg-sidebarFondo de la barra lateral #111113--bg-cardFondo de tarjetas y paneles #111113--bg-inputFondo de campos de texto #0a0a0a--bg-item-activeFondo del elemento seleccionado #18181a--bg-overlayVelo sobre la interfaz rgba(0, 0, 0, 0.7)--bg-surfaceAlias de --bg-item-active var(--bg-item-active)--bg-sidebar-gradientDegradado de la barra lateral linear-gradient(180deg, …)--bg-card-gradientDegradado de tarjetas linear-gradient(135deg, …)--surface-rgbTriplete base de superficies translúcidas 255, 255, 255--surface-hoverSuperficie en hover rgba(var(--surface-rgb), 0.06)--surface-activeSuperficie presionada rgba(var(--surface-rgb), 0.08)--surface-selectedSuperficie seleccionada rgba(var(--surface-rgb), 0.03)--surface-cardRelleno de tarjetas rgba(var(--surface-rgb), 0.03)--surface-inputRelleno de campos rgba(var(--surface-rgb), 0.03)--surface-subtleSuperficie apenas visible rgba(var(--surface-rgb), 0.02)--surface-raisedSuperficie elevada rgba(var(--surface-rgb), 0.04)--surface-dropdownFondo de desplegables var(--bg-card)--toast-bgFondo de notificaciones color-mix(…)--toast-borderBorde de notificaciones rgba(var(--surface-rgb), 0.06)
Token Controla Por defecto --text-primaryTexto principal #f4f4f5--text-secondaryTexto secundario #a1a1aa--text-mutedTexto deshabilitado #71717a--text-tertiaryTexto auxiliar #71717a
Token Controla Por defecto --accentColor de marca #ffffff--accent-rgbEl acento como R, G, B 255, 255, 255--accent-hoverAcento en hover #f4f4f5--accent-textTexto sobre el acento #0a0a0a--accent-primaryAlias de --accent var(--accent)
Mantené el triplete sincronizado
--accent-rgb no se calcula solo. Si cambiás --accent y olvidás --accent-rgb, los brillos, bordes y fondos que usan rgba(var(--accent-rgb), α) quedan con el color anterior.
# Bordes y radioseditar Token Controla Por defecto --border-colorColor de bordes rgba(var(--surface-rgb), 0.06)--borderAlias de --border-color var(--border-color)--border-widthGrosor de borde 1px--border-hoverBorde en hover rgba(var(--surface-rgb), 0.1)--border-focusBorde de foco rgba(var(--surface-rgb), 0.3)--border-radiusRadio global 4px--border-radius-smRadio pequeño 3px--border-radius-lgRadio grande calc(var(--border-radius) * 2)--border-radius-pillRadio de píldora 999px
Token Controla Por defecto --shadow-smSombra sutil 0 1px 3px rgba(0, 0, 0, 0.5)--shadow-mdSombra media 0 4px 12px rgba(0, 0, 0, 0.5)--shadow-lgSombra grande 0 8px 28px rgba(0, 0, 0, 0.6)--shadow-insetSombra interior inset 0 1px 2px rgba(0, 0, 0, 0.2)--shadow-floatingElementos flotantes var(--shadow-lg)--shadow-imageImágenes var(--shadow-md)--shadow-indicatorIndicadores var(--shadow-sm)--shadow-drawer-leftCajón izquierdo -8px 0 32px rgba(0, 0, 0, 0.6)--shadow-drawer-rightCajón derecho 8px 0 32px rgba(0, 0, 0, 0.6)--shadow-drawer-topCajón superior 0 -8px 32px rgba(0, 0, 0, 0.6)--shadow-drawer-bottomCajón inferior 0 8px 32px rgba(0, 0, 0, 0.6)
Token Controla Por defecto --font-familyTipografía de la interfaz "Cantarell", system-ui, sans-serif--font-family-monoTipografía monoespaciada ui-monospace, …--font-size-baseTamaño base 14px--font-size-smTamaño pequeño 0.8rem--font-size-lgTamaño grande 1.2rem--font-size-controlTexto de controles 0.85rem--font-size-labelEtiquetas 0.65rem--font-weight-normalPeso normal 400--font-weight-mediumPeso medio 600--font-weight-boldPeso negrita 700--line-heightInterlineado 1.5
# Espaciado, controles y movimientoeditar Token Controla Por defecto --space-xsEspacio extra pequeño 4px--space-smEspacio pequeño 8px--space-mdEspacio medio 12px--space-lgEspacio grande 16px--space-xlEspacio extra grande 24px--control-paddingRelleno de controles 10px 12px--button-paddingRelleno de botones 8px 16px--icon-scaleEscala global de iconos 1--transition-fastTransición rápida 0.15s--transition-normalTransición normal 0.2s
# Barra lateral y listaseditar Token Controla Por defecto --sidebar-widthAncho de la barra lateral 260px--sidebar-compact-widthAncho en modo compacto 70px--sidebar-row-heightAlto de fila 52px--sidebar-compact-row-heightAlto de fila compacta 50px--sidebar-row-gapSeparación entre filas 8px--version-row-heightAlto de fila de versión 78px--resource-row-heightAlto de fila de recurso 130px--resource-row-gapSeparación entre recursos 6px--resource-card-paddingRelleno de tarjeta de recurso 14px 16px--resource-icon-sizeTamaño de icono de recurso 56px
# Mercado de contenidoeditar Token Controla Por defecto --market-row-heightAlto de fila 224px--market-grid-gapSeparación de la grilla 12px--market-card-min-widthAncho mínimo de tarjeta 280px--market-grid-paddingRelleno de la grilla 8px--market-card-paddingRelleno de tarjeta 14px--market-icon-sizeTamaño de icono 48px--market-item-gapSeparación entre elementos 10px--market-title-sizeTamaño de título 0.9rem--market-description-sizeTamaño de descripción 0.75rem--market-button-paddingRelleno de botón 5px 12px--market-installed-row-heightAlto de fila instalada 84px--market-installed-row-gapSeparación de instalados 6px--market-installed-icon-sizeIcono de instalado 40px--market-installed-paddingRelleno de instalado 8px 12px--market-detail-icon-sizeIcono en detalle 80px--market-detail-sidebar-widthBarra lateral del detalle 270px--market-page-paddingRelleno de página 24px--market-page-padding-compactRelleno en ventana angosta 14px
El mercado deriva sus colores del tema mediante alias. No hace falta redefinirlos: si cambiás --accent y --bg-card, el mercado los sigue.
Alias Deriva de --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
# Estados y colores semánticoseditar Token Controla Por defecto --color-successÉxito #22c55e--color-success-rgbÉxito como R, G, B 34, 197, 94--color-errorError #ef4444--color-error-rgbError como R, G, B 239, 68, 68--color-warningAdvertencia #eab308--color-warning-rgbAdvertencia como R, G, B 234, 179, 8--color-infoInformación #60a5fa--color-info-rgbInformación como R, G, B 96, 165, 250--color-on-successTexto sobre éxito #fff--color-on-errorTexto sobre error #fff--color-on-warningTexto sobre advertencia #fff--color-on-infoTexto sobre información #fff--color-status-startingInstancia iniciando var(--color-info)--color-status-startedInstancia iniciada var(--color-success)--errorAlias de error var(--color-error)--warningAlias de advertencia var(--color-warning)--glow-errorResplandor de error 0 0 12px rgba(…)--glow-successResplandor de éxito 0 0 12px rgba(…)
Token Controla Por defecto --download-libraryLibrerías #4ade80--download-assetAssets #60a5fa--download-nativeNativos #f59e0b--download-clientCliente #a78bfa--download-verifyingVerificación #f472b6--download-genericGenérico #94a3b8--download-processingProcesamiento #fb923c--download-jreJava #22d3ee
Token Controla Por defecto --log-traceNivel trace var(--text-muted)--log-debugNivel debug var(--text-muted)--log-infoNivel info var(--text-primary)--log-messageMensajes de Minecraft var(--text-primary)--log-warnNivel warn var(--color-warning)--log-errorNivel error var(--color-error)--log-fatalNivel fatal var(--color-error)--log-launcherMensajes del launcher var(--text-primary)--log-stderrSalida de error var(--color-error)--log-unknownNivel desconocido var(--text-tertiary)--log-font-sizeTamaño de fuente 0.75rem--log-line-heightInterlineado var(--line-height)--log-line-paddingRelleno de línea 2px 14px--log-line-min-heightAlto mínimo de línea 22px
# Barra de desplazamientoeditar Token Controla Por defecto --scrollbar-thumbPulgar rgba(var(--surface-rgb), 0.12)--scrollbar-thumb-hoverPulgar en hover var(--text-secondary)--scrollbar-trackRiel var(--bg-main)--scrollbar-sizeGrosor 6px--scrollbar-radiusRadio 10px
# Imagen de fondoeditar Token Controla Por defecto --bg-image-blurDesenfoque (con unidad) 8px--bg-image-opacityOpacidad (0–1) 0.3--bg-image-sizeEncuadre cover--bg-image-positionPosición center--bg-image-brightnessBrillo 0.4
[background] escribe estas variables automáticamente. image_blur, image_opacity, mode, position y brightness son números o cadenas sin unidad; el launcher agrega px solo al desenfoque. Si preferís control total, declará la variable en [tokens] con la unidad incluida.
# Desenfoques de fondo (backdrop)editar Se declaran en [backdrop] como números y el launcher agrega px.
Token Controla Por defecto --backdrop-blur-overlayVelo superpuesto 4px--backdrop-blur-modalModales 4px--backdrop-blur-dropdownDesplegables 4px--backdrop-blur-panelPaneles 2px--backdrop-blur-floatElementos flotantes 4px--backdrop-blur-viewerVisor de imágenes 2px
# Superposiciones y visoreseditar Token Controla Por defecto --media-overlayVelo sobre imágenes rgba(0, 0, 0, 0.6)--media-overlay-textTexto sobre imágenes #fff--media-overlay-borderBorde sobre imágenes rgba(255, 255, 255, 0.1)--viewer-overlayFondo del visor rgba(0, 0, 0, 0.9)--tutorial-overlayVelo del tutorial rgba(0, 0, 0, 0.5)--tutorial-overlay-softVelo suave del tutorial rgba(0, 0, 0, 0.15)
# Cargadores de modseditar Token Controla Por defecto --clr-loader-vanillaVanilla #78909c--clr-loader-fabricFabric #66bb6a--clr-loader-forgeForge #ffa726--clr-loader-quiltQuilt #ab47bc
Token Controla Por defecto --icon-filterFiltro CSS para iconos raster en algunos controles invert(1)--color-schemeEsquema nativo (dark, light): barras y controles del sistema normal
Variables internas
--bg-image-loaded y --font-loaded las escribe el launcher para coordinar animaciones de entrada. No las declares en un tema: se sobrescriben al aplicar el tema y el resultado es impredecible.
Un tema puede reemplazar iconos declarando claves con el formato grupo:nombre en [icons.grupo]. Estos son los nombres que usa la interfaz:
Grupo Nombres 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 y brand:vanilla son imágenes raster en el launcher original; al reemplazarlas conviene usar PNG con fondo transparente.
Además de los grupos, [icons] preview define la imagen del tema en el selector.
# Contraste mínimoeditar Para que un tema sea legible en cualquier pantalla:
Texto principal sobre fondo principal: 4.5:1 como mínimo.
Texto secundario y etiquetas: 3:1 como mínimo.
Bordes y separadores: 1.5:1 respecto de la superficie.
Texto sobre --accent: usá --accent-text, no --text-primary.