Cette page est la référence technique du système de thèmes. Chaque token est une variable CSS : il se déclare dans Definition.toml (dans la section correspondante ou dans [tokens]) et le launcher l'applique à l'interface.
Pour le flux de travail complet, consultez Créer un thème .
# Ordre de résolutionmodifier Les valeurs sont appliquées dans cet ordre ; la dernière l'emporte :
Valeurs par défaut du launcher (:root).
Variables du thème (Meta.toml + Definition.toml).
Image d'arrière-plan et polices du thème.
Inject.css, dans la couche cubic.theme ou sans couche selon [inject].layer.
Layout.css, toujours sans couche et en dernier.
Les styles globaux du launcher vivent dans la couche cubic ; les styles de chaque composant n'utilisent pas de couche. C'est pourquoi Inject.css peut remplacer sans problème les variables et les styles globaux, mais pour l'emporter sur un composant, il faut layer = "unlayered".
[colors]
accent = "#97C459"
[text]
primary = "#E0ECD4"
[tokens]
"--bg-image-blur" = "12px" Les valeurs sont copiées telles quelles dans le CSS. Un token numérique sans unité (par exemple "12") produit une valeur invalide pour le navigateur et la déclaration est ignorée.
# Surfaces et arrière-plansmodifier Token Contrôle Par défaut --bg-mainArrière-plan de base de la fenêtre #0a0a0a--bg-sidebarArrière-plan de la barre latérale #111113--bg-cardArrière-plan des cartes et des panneaux #111113--bg-inputArrière-plan des champs de texte #0a0a0a--bg-item-activeArrière-plan de l'élément sélectionné #18181a--bg-overlayVoile sur l'interface rgba(0, 0, 0, 0.7)--bg-surfaceAlias de --bg-item-active var(--bg-item-active)--bg-sidebar-gradientDégradé de la barre latérale linear-gradient(180deg, …)--bg-card-gradientDégradé des cartes linear-gradient(135deg, …)--surface-rgbTriplet de base des surfaces translucides 255, 255, 255--surface-hoverSurface au survol rgba(var(--surface-rgb), 0.06)--surface-activeSurface pressée rgba(var(--surface-rgb), 0.08)--surface-selectedSurface sélectionnée rgba(var(--surface-rgb), 0.03)--surface-cardRemplissage des cartes rgba(var(--surface-rgb), 0.03)--surface-inputRemplissage des champs rgba(var(--surface-rgb), 0.03)--surface-subtleSurface à peine visible rgba(var(--surface-rgb), 0.02)--surface-raisedSurface surélevée rgba(var(--surface-rgb), 0.04)--surface-dropdownArrière-plan des menus déroulants var(--bg-card)--toast-bgArrière-plan des notifications color-mix(…)--toast-borderBordure des notifications rgba(var(--surface-rgb), 0.06)
Token Contrôle Par défaut --text-primaryTexte principal #f4f4f5--text-secondaryTexte secondaire #a1a1aa--text-mutedTexte désactivé #71717a--text-tertiaryTexte auxiliaire #71717a
Token Contrôle Par défaut --accentCouleur de marque #ffffff--accent-rgbL'accent sous la forme R, G, B 255, 255, 255--accent-hoverAccent au survol #f4f4f5--accent-textTexte sur l'accent #0a0a0a--accent-primaryAlias de --accent var(--accent)
Gardez le triplet synchronisé
--accent-rgb n'est pas calculé automatiquement. Si vous modifiez --accent et oubliez --accent-rgb, les lueurs, bordures et arrière-plans qui utilisent rgba(var(--accent-rgb), α) conservent l'ancienne couleur.
Token Contrôle Par défaut --border-colorCouleur des bordures rgba(var(--surface-rgb), 0.06)--borderAlias de --border-color var(--border-color)--border-widthÉpaisseur de bordure 1px--border-hoverBordure au survol rgba(var(--surface-rgb), 0.1)--border-focusBordure de focus rgba(var(--surface-rgb), 0.3)--border-radiusRayon global 4px--border-radius-smPetit rayon 3px--border-radius-lgGrand rayon calc(var(--border-radius) * 2)--border-radius-pillRayon de pilule 999px
Token Contrôle Par défaut --shadow-smOmbre subtile 0 1px 3px rgba(0, 0, 0, 0.5)--shadow-mdOmbre moyenne 0 4px 12px rgba(0, 0, 0, 0.5)--shadow-lgGrande ombre 0 8px 28px rgba(0, 0, 0, 0.6)--shadow-insetOmbre intérieure inset 0 1px 2px rgba(0, 0, 0, 0.2)--shadow-floatingÉléments flottants var(--shadow-lg)--shadow-imageImages var(--shadow-md)--shadow-indicatorIndicateurs var(--shadow-sm)--shadow-drawer-leftTiroir gauche -8px 0 32px rgba(0, 0, 0, 0.6)--shadow-drawer-rightTiroir droit 8px 0 32px rgba(0, 0, 0, 0.6)--shadow-drawer-topTiroir supérieur 0 -8px 32px rgba(0, 0, 0, 0.6)--shadow-drawer-bottomTiroir inférieur 0 8px 32px rgba(0, 0, 0, 0.6)
Token Contrôle Par défaut --font-familyTypographie de l'interface "Cantarell", system-ui, sans-serif--font-family-monoTypographie monospace ui-monospace, …--font-size-baseTaille de base 14px--font-size-smPetite taille 0.8rem--font-size-lgGrande taille 1.2rem--font-size-controlTexte des contrôles 0.85rem--font-size-labelÉtiquettes 0.65rem--font-weight-normalGraisse normale 400--font-weight-mediumGraisse moyenne 600--font-weight-boldGraisse en gras 700--line-heightInterligne 1.5
# Espacement, contrôles et mouvementmodifier Token Contrôle Par défaut --space-xsEspace extra-petit 4px--space-smPetit espace 8px--space-mdEspace moyen 12px--space-lgGrand espace 16px--space-xlEspace extra-grand 24px--control-paddingRemplissage des contrôles 10px 12px--button-paddingRemplissage des boutons 8px 16px--icon-scaleÉchelle globale des icônes 1--transition-fastTransition rapide 0.15s--transition-normalTransition normale 0.2s
# Barre latérale et listesmodifier Token Contrôle Par défaut --sidebar-widthLargeur de la barre latérale 260px--sidebar-compact-widthLargeur en mode compact 70px--sidebar-row-heightHauteur de ligne 52px--sidebar-compact-row-heightHauteur de ligne compacte 50px--sidebar-row-gapEspacement entre les lignes 8px--version-row-heightHauteur de ligne de version 78px--resource-row-heightHauteur de ligne de ressource 130px--resource-row-gapEspacement entre les ressources 6px--resource-card-paddingRemplissage de la carte de ressource 14px 16px--resource-icon-sizeTaille de l'icône de ressource 56px
Token Contrôle Par défaut --market-row-heightHauteur de ligne 224px--market-grid-gapEspacement de la grille 12px--market-card-min-widthLargeur minimale de carte 280px--market-grid-paddingRemplissage de la grille 8px--market-card-paddingRemplissage de carte 14px--market-icon-sizeTaille d'icône 48px--market-item-gapEspacement entre les éléments 10px--market-title-sizeTaille du titre 0.9rem--market-description-sizeTaille de la description 0.75rem--market-button-paddingRemplissage du bouton 5px 12px--market-installed-row-heightHauteur de ligne installée 84px--market-installed-row-gapEspacement des éléments installés 6px--market-installed-icon-sizeIcône d'élément installé 40px--market-installed-paddingRemplissage de l'élément installé 8px 12px--market-detail-icon-sizeIcône dans le détail 80px--market-detail-sidebar-widthBarre latérale du détail 270px--market-page-paddingRemplissage de la page 24px--market-page-padding-compactRemplissage en fenêtre étroite 14px
Le marché dérive ses couleurs du thème au moyen d'alias. Pas besoin de les redéfinir : si vous changez --accent et --bg-card, le marché les suit.
Alias Dérivé 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
# États et couleurs sémantiquesmodifier Token Contrôle Par défaut --color-successSuccès #22c55e--color-success-rgbSuccès sous la forme R, G, B 34, 197, 94--color-errorErreur #ef4444--color-error-rgbErreur sous la forme R, G, B 239, 68, 68--color-warningAvertissement #eab308--color-warning-rgbAvertissement sous la forme R, G, B 234, 179, 8--color-infoInformation #60a5fa--color-info-rgbInformation sous la forme R, G, B 96, 165, 250--color-on-successTexte sur succès #fff--color-on-errorTexte sur erreur #fff--color-on-warningTexte sur avertissement #fff--color-on-infoTexte sur information #fff--color-status-startingInstance en cours de démarrage var(--color-info)--color-status-startedInstance démarrée var(--color-success)--errorAlias d'erreur var(--color-error)--warningAlias d'avertissement var(--color-warning)--glow-errorLueur d'erreur 0 0 12px rgba(…)--glow-successLueur de succès 0 0 12px rgba(…)
Token Contrôle Par défaut --download-libraryBibliothèques #4ade80--download-assetAssets #60a5fa--download-nativeNatifs #f59e0b--download-clientClient #a78bfa--download-verifyingVérification #f472b6--download-genericGénérique #94a3b8--download-processingTraitement #fb923c--download-jreJava #22d3ee
Token Contrôle Par défaut --log-traceNiveau trace var(--text-muted)--log-debugNiveau debug var(--text-muted)--log-infoNiveau info var(--text-primary)--log-messageMessages de Minecraft var(--text-primary)--log-warnNiveau warn var(--color-warning)--log-errorNiveau error var(--color-error)--log-fatalNiveau fatal var(--color-error)--log-launcherMessages du launcher var(--text-primary)--log-stderrSortie d'erreur var(--color-error)--log-unknownNiveau inconnu var(--text-tertiary)--log-font-sizeTaille de police 0.75rem--log-line-heightInterligne var(--line-height)--log-line-paddingRemplissage de ligne 2px 14px--log-line-min-heightHauteur minimale de ligne 22px
# Barre de défilementmodifier Token Contrôle Par défaut --scrollbar-thumbPouce rgba(var(--surface-rgb), 0.12)--scrollbar-thumb-hoverPouce au survol var(--text-secondary)--scrollbar-trackRail var(--bg-main)--scrollbar-sizeÉpaisseur 6px--scrollbar-radiusRayon 10px
# Image d'arrière-planmodifier Token Contrôle Par défaut --bg-image-blurFlou (avec unité) 8px--bg-image-opacityOpacité (0–1) 0.3--bg-image-sizeCadrage cover--bg-image-positionPosition center--bg-image-brightnessLuminosité 0.4
[background] écrit automatiquement ces variables. image_blur, image_opacity, mode, position et brightness sont des nombres ou des chaînes sans unité ; le launcher n'ajoute px qu'au flou. Si vous préférez un contrôle total, déclarez la variable dans [tokens] avec l'unité incluse.
# Flous d'arrière-plan (backdrop)modifier Ils se déclarent dans [backdrop] sous forme de nombres et le launcher ajoute px.
Token Contrôle Par défaut --backdrop-blur-overlayVoile superposé 4px--backdrop-blur-modalFenêtres modales 4px--backdrop-blur-dropdownMenus déroulants 4px--backdrop-blur-panelPanneaux 2px--backdrop-blur-floatÉléments flottants 4px--backdrop-blur-viewerVisionneuse d'images 2px
# Superpositions et visionneusesmodifier Token Contrôle Par défaut --media-overlayVoile sur les images rgba(0, 0, 0, 0.6)--media-overlay-textTexte sur les images #fff--media-overlay-borderBordure sur les images rgba(255, 255, 255, 0.1)--viewer-overlayArrière-plan de la visionneuse rgba(0, 0, 0, 0.9)--tutorial-overlayVoile du tutoriel rgba(0, 0, 0, 0.5)--tutorial-overlay-softVoile doux du tutoriel rgba(0, 0, 0, 0.15)
Token Contrôle Par défaut --clr-loader-vanillaVanilla #78909c--clr-loader-fabricFabric #66bb6a--clr-loader-forgeForge #ffa726--clr-loader-quiltQuilt #ab47bc
Token Contrôle Par défaut --icon-filterFiltre CSS pour les icônes raster dans certains contrôles invert(1)--color-schemeSchéma natif (dark, light) : barres et contrôles du système normal
Variables internes
--bg-image-loaded et --font-loaded sont écrites par le launcher pour coordonner les animations d'entrée. Ne les déclarez pas dans un thème : elles sont écrasées lors de l'application du thème et le résultat est imprévisible.
Un thème peut remplacer des icônes en déclarant des clés au format groupe:nom dans [icons.groupe]. Voici les noms utilisés par l'interface :
Groupe Noms 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 et brand:vanilla sont des images raster dans le launcher d'origine ; lors de leur remplacement, il est conseillé d'utiliser des PNG avec un fond transparent.
En plus des groupes, [icons] preview définit l'image du thème dans le sélecteur.
Pour qu'un thème reste lisible sur n'importe quel écran :
Texte principal sur arrière-plan principal : 4.5:1 au minimum.
Texte secondaire et étiquettes : 3:1 au minimum.
Bordures et séparateurs : 1.5:1 par rapport à la surface.
Texte sur --accent : utilisez --accent-text, pas --text-primary.