Cargando

Cargando...

Перейти к содержимому
CubicLauncherDocs

Справочник по токенам темы

Полный список переменных CSS, которые может переопределить тема CubicLauncher, с их назначением и значением по умолчанию, а также доступные имена иконок.

Эта страница — технический справочник системы тем. Каждый токен является переменной CSS: он объявляется в Definition.toml (в соответствующей секции или в [tokens]), и лаунчер применяет его к интерфейсу.

Полный рабочий процесс описан в разделе Как создать тему.

Порядок разрешенияредактировать

Значения применяются в этом порядке; побеждает последнее:

  1. Значения по умолчанию лаунчера (:root).
  2. Переменные темы (Meta.toml + Definition.toml).
  3. Фоновое изображение и шрифты темы.
  4. Inject.css, в слое cubic.theme или без слоя в зависимости от [inject].layer.
  5. Layout.css, всегда без слоя и в конце.

Глобальные стили лаунчера живут в слое cubic; стили каждого компонента не используют слои. Поэтому Inject.css может без проблем переопределять переменные и глобальные стили, но чтобы победить компонент, нужен layer = "unlayered".

Как объявить токенредактировать

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

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

[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-activevar(--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, B255, 255, 255
--accent-hoverАкцент при наведении#f4f4f5
--accent-textТекст поверх акцента#0a0a0a
--accent-primaryПсевдоним --accentvar(--accent)
Держите триплет синхронизированным

--accent-rgb не вычисляется сам. Если вы изменили --accent и забыли про --accent-rgb, свечения, границы и фоны, использующие rgba(var(--accent-rgb), α), останутся с прежним цветом.

Границы и радиусыредактировать

ТокенУправляетПо умолчанию
--border-colorЦвет границrgba(var(--surface-rgb), 0.06)
--borderПсевдоним --border-colorvar(--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, B34, 197, 94
--color-errorОшибка#ef4444
--color-error-rgbОшибка как R, G, B239, 68, 68
--color-warningПредупреждение#eab308
--color-warning-rgbПредупреждение как R, G, B234, 179, 8
--color-infoИнформация#60a5fa
--color-info-rgbИнформация как R, G, B96, 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Уровень tracevar(--text-muted)
--log-debugУровень debugvar(--text-muted)
--log-infoУровень infovar(--text-primary)
--log-messageСообщения Minecraftvar(--text-primary)
--log-warnУровень warnvar(--color-warning)
--log-errorУровень errorvar(--color-error)
--log-fatalУровень fatalvar(--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)редактировать

Объявляются в [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, 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 и brand:vanilla — это растровые изображения в оригинальном лаунчере; при их замене лучше использовать PNG с прозрачным фоном.

Помимо групп, [icons] preview задаёт изображение темы в списке.

Минимальный контрастредактировать

Чтобы тема была читаемой на любом экране:

  • Основной текст на основном фоне: минимум 4.5:1.
  • Вторичный текст и подписи: минимум 3:1.
  • Границы и разделители: 1.5:1 относительно поверхности.
  • Текст поверх --accent: используйте --accent-text, а не --text-primary.