Cargando

Cargando...

Saltar al contenido
CubicLauncherDocs

Referencia de tokens de tema

Lista completa de variables CSS que puede sobrescribir un tema de CubicLauncher, con su función y su valor por defecto, más los nombres de iconos disponibles.

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:

  1. Valores por defecto del launcher (:root).
  2. Variables del tema (Meta.toml + Definition.toml).
  3. Imagen de fondo y fuentes del tema.
  4. Inject.css, en la capa cubic.theme o sin capa según [inject].layer.
  5. 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

toml
[colors]
accent = "#97C459"          # --accent

[text]
primary = "#E0ECD4"         # --text-primary

[tokens]
"--bg-image-blur" = "12px"  # variable literal

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

TokenControlaPor 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 interfazrgba(0, 0, 0, 0.7)
--bg-surfaceAlias de --bg-item-activevar(--bg-item-active)
--bg-sidebar-gradientDegradado de la barra laterallinear-gradient(180deg, …)
--bg-card-gradientDegradado de tarjetaslinear-gradient(135deg, …)
--surface-rgbTriplete base de superficies translúcidas255, 255, 255
--surface-hoverSuperficie en hoverrgba(var(--surface-rgb), 0.06)
--surface-activeSuperficie presionadargba(var(--surface-rgb), 0.08)
--surface-selectedSuperficie seleccionadargba(var(--surface-rgb), 0.03)
--surface-cardRelleno de tarjetasrgba(var(--surface-rgb), 0.03)
--surface-inputRelleno de camposrgba(var(--surface-rgb), 0.03)
--surface-subtleSuperficie apenas visiblergba(var(--surface-rgb), 0.02)
--surface-raisedSuperficie elevadargba(var(--surface-rgb), 0.04)
--surface-dropdownFondo de desplegablesvar(--bg-card)
--toast-bgFondo de notificacionescolor-mix(…)
--toast-borderBorde de notificacionesrgba(var(--surface-rgb), 0.06)

Textoeditar

TokenControlaPor defecto
--text-primaryTexto principal#f4f4f5
--text-secondaryTexto secundario#a1a1aa
--text-mutedTexto deshabilitado#71717a
--text-tertiaryTexto auxiliar#71717a

Acentoeditar

TokenControlaPor defecto
--accentColor de marca#ffffff
--accent-rgbEl acento como R, G, B255, 255, 255
--accent-hoverAcento en hover#f4f4f5
--accent-textTexto sobre el acento#0a0a0a
--accent-primaryAlias de --accentvar(--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

TokenControlaPor defecto
--border-colorColor de bordesrgba(var(--surface-rgb), 0.06)
--borderAlias de --border-colorvar(--border-color)
--border-widthGrosor de borde1px
--border-hoverBorde en hoverrgba(var(--surface-rgb), 0.1)
--border-focusBorde de focorgba(var(--surface-rgb), 0.3)
--border-radiusRadio global4px
--border-radius-smRadio pequeño3px
--border-radius-lgRadio grandecalc(var(--border-radius) * 2)
--border-radius-pillRadio de píldora999px

Sombraseditar

TokenControlaPor defecto
--shadow-smSombra sutil0 1px 3px rgba(0, 0, 0, 0.5)
--shadow-mdSombra media0 4px 12px rgba(0, 0, 0, 0.5)
--shadow-lgSombra grande0 8px 28px rgba(0, 0, 0, 0.6)
--shadow-insetSombra interiorinset 0 1px 2px rgba(0, 0, 0, 0.2)
--shadow-floatingElementos flotantesvar(--shadow-lg)
--shadow-imageImágenesvar(--shadow-md)
--shadow-indicatorIndicadoresvar(--shadow-sm)
--shadow-drawer-leftCajón izquierdo-8px 0 32px rgba(0, 0, 0, 0.6)
--shadow-drawer-rightCajón derecho8px 0 32px rgba(0, 0, 0, 0.6)
--shadow-drawer-topCajón superior0 -8px 32px rgba(0, 0, 0, 0.6)
--shadow-drawer-bottomCajón inferior0 8px 32px rgba(0, 0, 0, 0.6)

Tipografíaeditar

TokenControlaPor defecto
--font-familyTipografía de la interfaz"Cantarell", system-ui, sans-serif
--font-family-monoTipografía monoespaciadaui-monospace, …
--font-size-baseTamaño base14px
--font-size-smTamaño pequeño0.8rem
--font-size-lgTamaño grande1.2rem
--font-size-controlTexto de controles0.85rem
--font-size-labelEtiquetas0.65rem
--font-weight-normalPeso normal400
--font-weight-mediumPeso medio600
--font-weight-boldPeso negrita700
--line-heightInterlineado1.5

Espaciado, controles y movimientoeditar

TokenControlaPor defecto
--space-xsEspacio extra pequeño4px
--space-smEspacio pequeño8px
--space-mdEspacio medio12px
--space-lgEspacio grande16px
--space-xlEspacio extra grande24px
--control-paddingRelleno de controles10px 12px
--button-paddingRelleno de botones8px 16px
--icon-scaleEscala global de iconos1
--transition-fastTransición rápida0.15s
--transition-normalTransición normal0.2s

Barra lateral y listaseditar

TokenControlaPor defecto
--sidebar-widthAncho de la barra lateral260px
--sidebar-compact-widthAncho en modo compacto70px
--sidebar-row-heightAlto de fila52px
--sidebar-compact-row-heightAlto de fila compacta50px
--sidebar-row-gapSeparación entre filas8px
--version-row-heightAlto de fila de versión78px
--resource-row-heightAlto de fila de recurso130px
--resource-row-gapSeparación entre recursos6px
--resource-card-paddingRelleno de tarjeta de recurso14px 16px
--resource-icon-sizeTamaño de icono de recurso56px

Mercado de contenidoeditar

TokenControlaPor defecto
--market-row-heightAlto de fila224px
--market-grid-gapSeparación de la grilla12px
--market-card-min-widthAncho mínimo de tarjeta280px
--market-grid-paddingRelleno de la grilla8px
--market-card-paddingRelleno de tarjeta14px
--market-icon-sizeTamaño de icono48px
--market-item-gapSeparación entre elementos10px
--market-title-sizeTamaño de título0.9rem
--market-description-sizeTamaño de descripción0.75rem
--market-button-paddingRelleno de botón5px 12px
--market-installed-row-heightAlto de fila instalada84px
--market-installed-row-gapSeparación de instalados6px
--market-installed-icon-sizeIcono de instalado40px
--market-installed-paddingRelleno de instalado8px 12px
--market-detail-icon-sizeIcono en detalle80px
--market-detail-sidebar-widthBarra lateral del detalle270px
--market-page-paddingRelleno de página24px
--market-page-padding-compactRelleno en ventana angosta14px

El mercado deriva sus colores del tema mediante alias. No hace falta redefinirlos: si cambiás --accent y --bg-card, el mercado los sigue.

AliasDeriva 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

TokenControlaPor defecto
--color-successÉxito#22c55e
--color-success-rgbÉxito como R, G, B34, 197, 94
--color-errorError#ef4444
--color-error-rgbError como R, G, B239, 68, 68
--color-warningAdvertencia#eab308
--color-warning-rgbAdvertencia como R, G, B234, 179, 8
--color-infoInformación#60a5fa
--color-info-rgbInformación como R, G, B96, 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 iniciandovar(--color-info)
--color-status-startedInstancia iniciadavar(--color-success)
--errorAlias de errorvar(--color-error)
--warningAlias de advertenciavar(--color-warning)
--glow-errorResplandor de error0 0 12px rgba(…)
--glow-successResplandor de éxito0 0 12px rgba(…)

Descargaseditar

TokenControlaPor 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

Consola y logseditar

TokenControlaPor defecto
--log-traceNivel tracevar(--text-muted)
--log-debugNivel debugvar(--text-muted)
--log-infoNivel infovar(--text-primary)
--log-messageMensajes de Minecraftvar(--text-primary)
--log-warnNivel warnvar(--color-warning)
--log-errorNivel errorvar(--color-error)
--log-fatalNivel fatalvar(--color-error)
--log-launcherMensajes del launchervar(--text-primary)
--log-stderrSalida de errorvar(--color-error)
--log-unknownNivel desconocidovar(--text-tertiary)
--log-font-sizeTamaño de fuente0.75rem
--log-line-heightInterlineadovar(--line-height)
--log-line-paddingRelleno de línea2px 14px
--log-line-min-heightAlto mínimo de línea22px

Barra de desplazamientoeditar

TokenControlaPor defecto
--scrollbar-thumbPulgarrgba(var(--surface-rgb), 0.12)
--scrollbar-thumb-hoverPulgar en hovervar(--text-secondary)
--scrollbar-trackRielvar(--bg-main)
--scrollbar-sizeGrosor6px
--scrollbar-radiusRadio10px

Imagen de fondoeditar

TokenControlaPor defecto
--bg-image-blurDesenfoque (con unidad)8px
--bg-image-opacityOpacidad (0–1)0.3
--bg-image-sizeEncuadrecover
--bg-image-positionPosicióncenter
--bg-image-brightnessBrillo0.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.

TokenControlaPor defecto
--backdrop-blur-overlayVelo superpuesto4px
--backdrop-blur-modalModales4px
--backdrop-blur-dropdownDesplegables4px
--backdrop-blur-panelPaneles2px
--backdrop-blur-floatElementos flotantes4px
--backdrop-blur-viewerVisor de imágenes2px

Superposiciones y visoreseditar

TokenControlaPor defecto
--media-overlayVelo sobre imágenesrgba(0, 0, 0, 0.6)
--media-overlay-textTexto sobre imágenes#fff
--media-overlay-borderBorde sobre imágenesrgba(255, 255, 255, 0.1)
--viewer-overlayFondo del visorrgba(0, 0, 0, 0.9)
--tutorial-overlayVelo del tutorialrgba(0, 0, 0, 0.5)
--tutorial-overlay-softVelo suave del tutorialrgba(0, 0, 0, 0.15)

Cargadores de modseditar

TokenControlaPor defecto
--clr-loader-vanillaVanilla#78909c
--clr-loader-fabricFabric#66bb6a
--clr-loader-forgeForge#ffa726
--clr-loader-quiltQuilt#ab47bc

Varioseditar

TokenControlaPor defecto
--icon-filterFiltro CSS para iconos raster en algunos controlesinvert(1)
--color-schemeEsquema nativo (dark, light): barras y controles del sistemanormal
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.

Iconoseditar

Un tema puede reemplazar iconos declarando claves con el formato grupo:nombre en [icons.grupo]. Estos son los nombres que usa la interfaz:

GrupoNombres
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, upload
navcreate, edit, pencil, settings, sliders
instancebox, check-square, clock, code, database, external-link, folder, grid, image, market, multiplayer, puzzle, resources, screenshots, servers, shader, terminal, worlds
logarrow-down, chevron-down, chevron-up, clear, copy, logs, scroll-down, search, spinner, upload
brandcubic, 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.