Эта страница — технический справочник системы тем. Каждый токен является переменной CSS: он объявляется в Definition.toml (в соответствующей секции или в [tokens]), и лаунчер применяет его к интерфейсу.
Полный рабочий процесс описан в разделе Как создать тему .
Значения применяются в этом порядке; побеждает последнее:
Значения по умолчанию лаунчера (:root).
Переменные темы (Meta.toml + Definition.toml).
Фоновое изображение и шрифты темы.
Inject.css, в слое cubic.theme или без слоя в зависимости от [inject].layer.
Layout.css, всегда без слоя и в конце.
Глобальные стили лаунчера живут в слое cubic; стили каждого компонента не используют слои. Поэтому Inject.css может без проблем переопределять переменные и глобальные стили, но чтобы победить компонент, нужен layer = "unlayered".
[colors]
accent = "#97C459"
[text]
primary = "#E0ECD4"
[tokens]
"--bg-image-blur" = "12px" Значения копируются в CSS как есть. Числовой токен без единицы измерения (например "12") создаёт недопустимое для браузера значение, и объявление отбрасывается.
Токен Управляет По умолчанию --bg-mainБазовый фон окна #0a0a0a--bg-sidebarФон боковой панели #111113--bg-cardФон карточек и панелей #111113--bg-inputФон текстовых полей #0a0a0a--bg-item-activeФон выбранного элемента #18181a--bg-overlayВуаль поверх интерфейса rgba(0, 0, 0, 0.7)--bg-surfaceПсевдоним --bg-item-active var(--bg-item-active)--bg-sidebar-gradientГрадиент боковой панели linear-gradient(180deg, …)--bg-card-gradientГрадиент карточек linear-gradient(135deg, …)--surface-rgbБазовый триплет полупрозрачных поверхностей 255, 255, 255--surface-hoverПоверхность при наведении rgba(var(--surface-rgb), 0.06)--surface-activeПоверхность при нажатии rgba(var(--surface-rgb), 0.08)--surface-selectedВыбранная поверхность rgba(var(--surface-rgb), 0.03)--surface-cardЗаливка карточек rgba(var(--surface-rgb), 0.03)--surface-inputЗаливка полей rgba(var(--surface-rgb), 0.03)--surface-subtleЕдва заметная поверхность rgba(var(--surface-rgb), 0.02)--surface-raisedПриподнятая поверхность rgba(var(--surface-rgb), 0.04)--surface-dropdownФон выпадающих списков var(--bg-card)--toast-bgФон уведомлений color-mix(…)--toast-borderГраница уведомлений rgba(var(--surface-rgb), 0.06)
Токен Управляет По умолчанию --text-primaryОсновной текст #f4f4f5--text-secondaryВторичный текст #a1a1aa--text-mutedОтключённый текст #71717a--text-tertiaryВспомогательный текст #71717a
Токен Управляет По умолчанию --accentФирменный цвет #ffffff--accent-rgbАкцент как R, G, B 255, 255, 255--accent-hoverАкцент при наведении #f4f4f5--accent-textТекст поверх акцента #0a0a0a--accent-primaryПсевдоним --accent var(--accent)
Держите триплет синхронизированным
--accent-rgb не вычисляется сам. Если вы изменили --accent и забыли про --accent-rgb, свечения, границы и фоны, использующие rgba(var(--accent-rgb), α), останутся с прежним цветом.
Токен Управляет По умолчанию --border-colorЦвет границ rgba(var(--surface-rgb), 0.06)--borderПсевдоним --border-color var(--border-color)--border-widthТолщина границы 1px--border-hoverГраница при наведении rgba(var(--surface-rgb), 0.1)--border-focusГраница фокуса rgba(var(--surface-rgb), 0.3)--border-radiusГлобальный радиус 4px--border-radius-smМалый радиус 3px--border-radius-lgБольшой радиус calc(var(--border-radius) * 2)--border-radius-pillРадиус-таблетка 999px
Токен Управляет По умолчанию --shadow-smТонкая тень 0 1px 3px rgba(0, 0, 0, 0.5)--shadow-mdСредняя тень 0 4px 12px rgba(0, 0, 0, 0.5)--shadow-lgБольшая тень 0 8px 28px rgba(0, 0, 0, 0.6)--shadow-insetВнутренняя тень inset 0 1px 2px rgba(0, 0, 0, 0.2)--shadow-floatingПлавающие элементы var(--shadow-lg)--shadow-imageИзображения var(--shadow-md)--shadow-indicatorИндикаторы var(--shadow-sm)--shadow-drawer-leftЛевый ящик -8px 0 32px rgba(0, 0, 0, 0.6)--shadow-drawer-rightПравый ящик 8px 0 32px rgba(0, 0, 0, 0.6)--shadow-drawer-topВерхний ящик 0 -8px 32px rgba(0, 0, 0, 0.6)--shadow-drawer-bottomНижний ящик 0 8px 32px rgba(0, 0, 0, 0.6)
Токен Управляет По умолчанию --font-familyТипографика интерфейса "Cantarell", system-ui, sans-serif--font-family-monoМоноширинная типографика ui-monospace, …--font-size-baseБазовый размер 14px--font-size-smМалый размер 0.8rem--font-size-lgБольшой размер 1.2rem--font-size-controlТекст элементов управления 0.85rem--font-size-labelПодписи 0.65rem--font-weight-normalНормальная насыщенность 400--font-weight-mediumСредняя насыщенность 600--font-weight-boldЖирная насыщенность 700--line-heightМежстрочный интервал 1.5
# Отступы, элементы управления и движениередактировать Токен Управляет По умолчанию --space-xsОчень малый отступ 4px--space-smМалый отступ 8px--space-mdСредний отступ 12px--space-lgБольшой отступ 16px--space-xlОчень большой отступ 24px--control-paddingВнутренний отступ элементов управления 10px 12px--button-paddingВнутренний отступ кнопок 8px 16px--icon-scaleГлобальный масштаб иконок 1--transition-fastБыстрый переход 0.15s--transition-normalОбычный переход 0.2s
Токен Управляет По умолчанию --sidebar-widthШирина боковой панели 260px--sidebar-compact-widthШирина в компактном режиме 70px--sidebar-row-heightВысота строки 52px--sidebar-compact-row-heightВысота компактной строки 50px--sidebar-row-gapРасстояние между строками 8px--version-row-heightВысота строки версии 78px--resource-row-heightВысота строки ресурса 130px--resource-row-gapРасстояние между ресурсами 6px--resource-card-paddingВнутренний отступ карточки ресурса 14px 16px--resource-icon-sizeРазмер иконки ресурса 56px
Токен Управляет По умолчанию --market-row-heightВысота строки 224px--market-grid-gapРасстояние в сетке 12px--market-card-min-widthМинимальная ширина карточки 280px--market-grid-paddingВнутренний отступ сетки 8px--market-card-paddingВнутренний отступ карточки 14px--market-icon-sizeРазмер иконки 48px--market-item-gapРасстояние между элементами 10px--market-title-sizeРазмер заголовка 0.9rem--market-description-sizeРазмер описания 0.75rem--market-button-paddingВнутренний отступ кнопки 5px 12px--market-installed-row-heightВысота строки установленного 84px--market-installed-row-gapРасстояние между установленными 6px--market-installed-icon-sizeИконка установленного 40px--market-installed-paddingВнутренний отступ установленного 8px 12px--market-detail-icon-sizeИконка в подробностях 80px--market-detail-sidebar-widthБоковая панель подробностей 270px--market-page-paddingВнутренний отступ страницы 24px--market-page-padding-compactОтступ в узком окне 14px
Магазин выводит свои цвета из темы через псевдонимы. Их не нужно переопределять: если вы измените --accent и --bg-card, магазин последует за ними.
Псевдоним Происходит из --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
# Состояния и семантические цветаредактировать Токен Управляет По умолчанию --color-successУспех #22c55e--color-success-rgbУспех как R, G, B 34, 197, 94--color-errorОшибка #ef4444--color-error-rgbОшибка как R, G, B 239, 68, 68--color-warningПредупреждение #eab308--color-warning-rgbПредупреждение как R, G, B 234, 179, 8--color-infoИнформация #60a5fa--color-info-rgbИнформация как R, G, B 96, 165, 250--color-on-successТекст поверх успеха #fff--color-on-errorТекст поверх ошибки #fff--color-on-warningТекст поверх предупреждения #fff--color-on-infoТекст поверх информации #fff--color-status-startingИнстанс запускается var(--color-info)--color-status-startedИнстанс запущен var(--color-success)--errorПсевдоним ошибки var(--color-error)--warningПсевдоним предупреждения var(--color-warning)--glow-errorСвечение ошибки 0 0 12px rgba(…)--glow-successСвечение успеха 0 0 12px rgba(…)
Токен Управляет По умолчанию --download-libraryБиблиотеки #4ade80--download-assetРесурсы #60a5fa--download-nativeНативные #f59e0b--download-clientКлиент #a78bfa--download-verifyingПроверка #f472b6--download-genericОбщее #94a3b8--download-processingОбработка #fb923c--download-jreJava #22d3ee
Токен Управляет По умолчанию --log-traceУровень trace var(--text-muted)--log-debugУровень debug var(--text-muted)--log-infoУровень info var(--text-primary)--log-messageСообщения Minecraft var(--text-primary)--log-warnУровень warn var(--color-warning)--log-errorУровень error var(--color-error)--log-fatalУровень fatal var(--color-error)--log-launcherСообщения лаунчера var(--text-primary)--log-stderrВывод ошибок var(--color-error)--log-unknownНеизвестный уровень var(--text-tertiary)--log-font-sizeРазмер шрифта 0.75rem--log-line-heightМежстрочный интервал var(--line-height)--log-line-paddingВнутренний отступ строки 2px 14px--log-line-min-heightМинимальная высота строки 22px
Токен Управляет По умолчанию --scrollbar-thumbБегунок rgba(var(--surface-rgb), 0.12)--scrollbar-thumb-hoverБегунок при наведении var(--text-secondary)--scrollbar-trackДорожка var(--bg-main)--scrollbar-sizeТолщина 6px--scrollbar-radiusРадиус 10px
Токен Управляет По умолчанию --bg-image-blurРазмытие (с единицей измерения) 8px--bg-image-opacityНепрозрачность (0–1) 0.3--bg-image-sizeКадрирование cover--bg-image-positionПоложение center--bg-image-brightnessЯркость 0.4
[background] записывает эти переменные автоматически. image_blur, image_opacity, mode, position и brightness — это числа или строки без единицы измерения; лаунчер добавляет px только к размытию. Если вы хотите полный контроль, объявите переменную в [tokens] с единицей измерения.
Объявляются в [backdrop] как числа, и лаунчер добавляет px.
Токен Управляет По умолчанию --backdrop-blur-overlayНаложенная вуаль 4px--backdrop-blur-modalМодальные окна 4px--backdrop-blur-dropdownВыпадающие списки 4px--backdrop-blur-panelПанели 2px--backdrop-blur-floatПлавающие элементы 4px--backdrop-blur-viewerПросмотрщик изображений 2px
Токен Управляет По умолчанию --media-overlayВуаль поверх изображений rgba(0, 0, 0, 0.6)--media-overlay-textТекст поверх изображений #fff--media-overlay-borderГраница поверх изображений rgba(255, 255, 255, 0.1)--viewer-overlayФон просмотрщика rgba(0, 0, 0, 0.9)--tutorial-overlayВуаль обучения rgba(0, 0, 0, 0.5)--tutorial-overlay-softМягкая вуаль обучения rgba(0, 0, 0, 0.15)
Токен Управляет По умолчанию --clr-loader-vanillaVanilla #78909c--clr-loader-fabricFabric #66bb6a--clr-loader-forgeForge #ffa726--clr-loader-quiltQuilt #ab47bc
Токен Управляет По умолчанию --icon-filterCSS-фильтр для растровых иконок в некоторых элементах управления invert(1)--color-schemeНативная схема (dark, light): полосы и системные элементы управления normal
Внутренние переменные
--bg-image-loaded и --font-loaded записывает лаунчер для согласования анимаций появления. Не объявляйте их в теме: они перезаписываются при применении темы, и результат становится непредсказуемым.
Тема может заменять иконки, объявляя ключи в формате группа:имя в [icons.группа]. Вот имена, которые использует интерфейс:
Группа Имена 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 и brand:vanilla — это растровые изображения в оригинальном лаунчере; при их замене лучше использовать PNG с прозрачным фоном.
Помимо групп, [icons] preview задаёт изображение темы в списке.
Чтобы тема была читаемой на любом экране:
Основной текст на основном фоне: минимум 4.5:1 .
Вторичный текст и подписи: минимум 3:1 .
Границы и разделители: 1.5:1 относительно поверхности.
Текст поверх --accent: используйте --accent-text, а не --text-primary.