Вики Cryndel
Launcher

Другие способы получить сборку

1. Открой страницу «Сборки». В панели действий нажми «Импорт .mpcryn (Publsborka)».
2. Выбери файл сборки. Диалог выбора принимает контейнеры Cryndel с расширением .mpcryn. Файлы .plcryn ставят пакет Plugin API, а не сборку.
3. Посмотри сведения перед импортом. Лаунчер проверяет, что в архиве есть build.mpcryn.json с типом mpcryn, и показывает краткую информацию.
4. Укажи название нового профиля. Можно оставить предложенное имя или задать своё.
5. Нажми «Импортировать». Создаётся новый профиль с параметрами из манифеста, после чего игровые файлы распаковываются в его папку.
6. Дождись завершения и проверь профиль. После успешного импорта откроется страница новой сборки. Проверь её версию и нажми «Играть», когда будешь готов.

Это руководство намеренно ограничено импортом MPCRYN: создание/публикация контейнера и внутреннее устройство его полной логики здесь не разбираются.

cryndel-greeting/
├── manifest.json
└── index.js

{
  "id": "cryndel-greeting",
  "name": "Приветствие",
  "version": "1.0.0",
  "description": "Пример плагина",
  "author": "Ваше имя",
  "main": "index.js",
  "api": 4,
  "permissions": [],
  "settings": [
    {
      "key": "message",
      "label": "Текст приветствия",
      "type": "text",
      "default": "Привет!"
    }
  ]
}

Точка входа index.js

module.exports = {
  async activate(api) {
    const message = await api.config.get('message', 'Привет!');

    api.log('Плагин активирован');
    api.ui.toast(message, 'ok');
  },

  async deactivate(api) {
    api.log('Плагин выключен');
  }
};

Точка входа должна экспортировать функцию или объект с функцией activate(api). Для аккуратного выключения можно экспортировать deactivate(api). Ошибки плагина выводятся как предупреждения и не должны ломать загрузку остальных расширений.

Добавление настроек в карточку плагина

Поле схемы описывает ключ, подпись, тип и начальное значение. Пользователь меняет значения прямо на странице «Плагины»; после изменения они сохраняются в конфиге этого плагина.

Упаковка и установка

1. Проверь локально. Положи папку с манифестом и точкой входа в каталог плагинов через кнопку «Папка».
2. Подготовь ZIP-архив. Предпочтительно положить manifest.json и файлы плагина в корень. Обычная папка-обёртка тоже поддерживается: лаунчер распаковывает содержимое каталога с манифестом.
3. Установи через страницу «Плагины». Нажми «Установить .zip», выбери архив и дождись результата.
4. Проверь статус и настройки. Включи плагин, посмотри предупреждения, открой его настройки и проверь нужное поведение.

Локальные моды, обои и примеры

Чтобы добавить локальный JAR в общий экран «Моды от плагинов», объяви его в манифесте. Имя файла задаётся относительным путём, а каталог показывает только метаданные — сам файл остаётся в каталоге плагина до явного нажатия «Установить».

{
  "permissions": ["ui", "install"],
  "providedMods": [{
    "id": "example_mod",
    "name": "Example Mod",
    "version": "1.0.0",
    "description": "Описание, загрузчик и поддерживаемая версия игры",
    "file": "mods/example.jar",
    "iconSvg": "<svg viewBox=\"0 0 24 24\">...безопасная геометрия...</svg>"
  }]
}

providedMods не доказывает совместимость или безопасность JAR. При установке проверяется путь внутри папки плагина, ограничивается размер, вычисляется SHA-512 и создаётся запись lockfile. Это не автоматическая проверка того, что файл действительно запускается на указанном загрузчике.

Разрешение wallpaper открывает HTML-мост window.cryndel.call('wallpaper.set', 'wallpapers/name.svg'). Файл должен лежать в папке плагина, быть SVG не больше 256 КБ и содержать только простую геометрию, базовые фигуры и градиенты. Скрипты, ссылки, стили, фильтры и внешние ресурсы запрещены. Для изменения глобальной цветовой темы дополнительно запрашивается ui.theme. Атрибут homeButton: true добавляет страницу плагина в ряд действий главного экрана; SVG в iconSvg проходит фильтрацию перед показом.

В разделе «Плагины» есть кнопка «Примеры плагинов». Она устанавливает три демонстрационных ZIP: «Обои и стили», «Каталог плагинных модов» и «Локальный test.jar». Тестовый JAR содержит корректные Fabric-метаданные для проверки каталога и копирования, но намеренно не содержит игровой код и не добавляет функций в Minecraft.

Обновление каталога Plugin API через .PLcryn

Файл .PLcryn — ZIP-контейнер с двумя JSON-файлами в корне. Он не принимает и не исполняет JavaScript, исполняемые файлы или команды. Реализации API входят в лаунчер; пакет API v4 задаёт совместимую версию, описание поддерживаемых возможностей и именованные псевдонимы. Он не может добавить исполняемый код или выдать плагину новое разрешение.

{
  "type": "cryndel-plugin-api",
  "version": "4.0.0",
  "apiVersion": 4,
  "name": "Cryndel Plugin API v4"
}

{
  "aliases": {
    "quickSearch": "modrinth.search",
    "notifyUser": "toast",
    "readPluginConfig": "config.get"
  }
}

Допустимые цели включают существующие API v2, безопасные методы API v4 (например, fs.read, settings.get, crypto.hash, net.fetch и mc.servers.read) и только перечисленные в реализации функции. Максимум — 100 псевдонимов и 1 МБ распакованных данных. Плагин обращается к псевдониму через api.extensions.quickSearch(...); разрешения всё равно проверяются самим методом.

Перед заменой текущая версия переносится в резервную. Кнопка отката меняет активную и предыдущую версии местами. Сброс сначала восстанавливает предыдущую версию; повторный сброс удаляет обе пользовательские версии и возвращает встроенный каталог. Настройки плагинов при этом не удаляются.

1. Сначала реши, что должен делать плагин

2. Подготовь ID и папку

Выбери уникальное постоянное имя, например my-weather-tool. Именно из поля id формируется имя каталога установленного плагина и идентификатор его конфигурации. Не используй один и тот же ID для разных расширений и не меняй его между обновлениями без причины: иначе лаунчер увидит другое расширение с отдельными настройками.

my-weather-tool/
├── manifest.json     # обязательные сведения о плагине
├── index.js          # основной JavaScript-модуль
└── data/             # необязательно: собственные данные
    └── state.json

Папка data/ в примере — обычная подпапка в каталоге расширения; создавай или читай её через api.storage. Не путай эту папку с автоматически создаваемым config.json, предназначенным для пользовательских параметров.

3. Сделай манифест осмысленным

4. Настройки: ключи, вложенность и сохранение

Настройки в манифесте создают элементы управления на карточке расширения. Рабочие алиасы полей: ключ берётся из key, затем id, затем name; подпись — из label, затем title, затем ключа. Поэтому предпочтительны явные key и label.

"settings": [
  {
    "key": "message",
    "label": "Текст приветствия",
    "type": "text",
    "default": "Привет!",
    "placeholder": "Напиши свой текст"
  },
  {
    "key": "enabled",
    "label": "Включить функцию",
    "type": "toggle",
    "default": true
  },
  {
    "key": "refreshSeconds",
    "label": "Интервал обновления",
    "type": "number",
    "min": 10,
    "max": 300,
    "default": 60
  },
  {
    "key": "mode",
    "label": "Режим",
    "type": "select",
    "options": [
      { "value": "quiet", "label": "Тихий" },
      { "value": "normal", "label": "Обычный" }
    ],
    "default": "normal"
  }
]

Поддерживаемые типы формы: строка по умолчанию, булевы bool/toggle/checkbox, number, range и select с массивом options. Для number/range интерфейс передаёт числовое значение. Не полагайся на сложные поля, описанные только в интернете: массивы, многострочный текст, вложенные объекты и валидация схемой как отдельные контроли здесь не реализованы.

5. Полный пример жизненного цикла и своего JSON

module.exports = {
  async activate(api) {
    const config = await api.config.get('message', 'Добро пожаловать!');
    api.log('Активирован:', api.pluginId, 'API', api.apiVersion);

    // storage.json читает JSON-файл из каталога этого плагина.
    let state = await api.storage.json('data/state.json');
    if (!state) {
      state = { activations: 0 };
    }
    state.activations += 1;
    await api.storage.writeJson('data/state.json', state);

    api.ui.registerSettings([
      {
        key: 'message',
        label: 'Текст сообщения',
        type: 'text',
        default: 'Добро пожаловать!'
      }
    ]);

    api.log(config, 'Запусков плагина:', state.activations);
  },

  async deactivate(api) {
    // Очисти таймеры/ресурсы, которые создал сам плагин.
    api.log('Деактивирован');
  }
};

В этом примере показаны только безопасные локальные операции с настройкой и JSON. Если добавишь таймер через доступный setInterval, сохрани его ID и останови в deactivate; исключение в фоне может попасть в журнал не так очевидно, как ошибка при старте.

6. Как плагин проходит загрузку

Скрипт исполняется в VM-контексте с переданными глобалами module, exports, console, api, setTimeout/clearTimeout и setInterval/clearInterval. Поддерживаются два варианта экспорта: module.exports = { activate(api) {} } и module.exports = function (api) {}. Если экспорт не содержит activate-функцию, плагин может быть помечен загруженным, но предупреждение сообщит, что он фактически ничего не активировал. Если в манифесте указано API выше 2, загрузка отклоняется; более низкое значение само по себе не гарантирует совместимость.

Начальное выполнение скрипта ограничено таймаутом VM. Асинхронный activate ожидается менеджером, но таймаут выполнения исходного скрипта не является общим таймаутом для любой дальнейшей работы плагина. Не создавай бесконечные циклы, не блокируй event loop и не оставляй бесконечные таймеры.

7. Хранилище данных и границы путей

Пути хранилища вычисляются относительно папки текущего плагина. Путь, который после разрешения выходит за пределы каталога плагина, отклоняется. Сохраняй в JSON только сериализуемые значения; хранилище не предназначено для больших бинарных файлов или сетевых секретов.

8. Hooks: реальное поведение и важное ограничение

module.exports = {
  activate(api) {
    api.on('my-plugin-event', (payload) => {
      api.log('Получено событие:', payload);
      return { received: true };
    });

    // Вызывает обработчики с этим именем, зарегистрированные в менеджере.
    const results = api.emit('my-plugin-event', { source: 'self' });
    api.log('Результаты:', results);
  },

  deactivate(api) {
    api.off('my-plugin-event');
  }
};

Hooks — именованные функции в менеджере плагинов. on регистрирует обработчик; off(hook) удаляет все подписки данного плагина на это имя; emit синхронно вызывает зарегистрированные обработчики и собирает возвращённые ими значения. Ошибка одного синхронного обработчика записывается как предупреждение, остальные обработчики продолжают выполняться. Если обработчик асинхронный, emit не ожидает его Promise: результатом будет Promise-объект внутри массива результатов.

9. Сеть и разрешение net

При выданном разрешении net методы api.fetch(url, opts) (совместимость) и api.net.fetch(url, opts) (API v4) отправляют только HTTP(S)-запросы на публичные адреса, без перенаправлений, с ограничением метода, размера тела и ответа. Локальные адреса и нестандартные порты отклоняются; перед каждым запросом показывается подтверждение, а метаданные записываются в аудит. Для совместимого api.fetch отказ возвращается как { ok: false, error }; API v4 сообщает об отказе исключением. Успешный ответ имеет форму { ok, status, data }; тип data зависит от сервера.

module.exports = {
  async activate(api) {
    const result = await api.fetch('https://example.org/status', {
      method: 'GET'
    });

    if (!result.ok) {
      api.warn('Не удалось получить статус:', result.error);
      return;
    }

    api.log('HTTP:', result.status);
    api.log('Ответ:', JSON.stringify(result.data));
  }
};

Не помещай токены и пароли в URL, публичные логи или сообщение об ошибке. Не делай запросы циклически и без необходимости. Указывай сетевое разрешение только если функциональность действительно требует запросов.

10. Страница плагина, модальное окно и оформление

Запроси разрешения ui и при необходимости ui.theme. Страница регистрируется из activate(api). Вставляемый HTML — фрагмент для body; собственный JavaScript страницы использует window.cryndel. Каждый экран плагина работает в отдельном iframe с sandbox: у него нет прямого доступа к интерфейсу приложения, Electron, Node.js или IPC. При выключении плагина его страницы и оформление удаляются.

module.exports = {
  activate(api) {
    api.ui.registerPage({
      id: 'tools',
      title: 'Мои инструменты',
      icon: 'page',
      html: \`<h1>Инструменты</h1>
        <button id="open">Опрос</button>
        <button id="mods">Найти моды</button>
        <script>
          document.querySelector('#open').onclick = () =>
            window.cryndel.modal({
              title: 'Опрос',
              html: '<h2>Какую функцию добавить?</h2><button id="vote">Голосовать</button><script>document.querySelector("#vote").onclick=async()=>{await window.cryndel.call("net.fetch","https://example.org/vote",{method:"POST",data:{answer:"new-feature"}});window.cryndel.closeModal()}</script>'
            });
          document.querySelector('#mods').onclick = async () => {
            const result = await window.cryndel.call('modrinth.search', { query: 'sodium', type: 'mod' });
            document.body.insertAdjacentText('beforeend', ' Найдено: ' + result.hits.length);
          };
        </script>\`,
      css: 'button { padding: 10px 14px; border-radius: 10px; }'
    });
    api.ui.setTheme(':root { --accent: #62d6bf; --radius: 20px; }');
  },
  deactivate(api) {
    api.ui.clearTheme();
  }
};

Для небольшой страницы достаточно api.ui.addNav({ id, label, icon, html, css }); для оформления всего лаунчера передай CSS через api.ui.setTheme(css). Глобальный стиль применяется только если выдано ui.theme. HTML-страница может открыть modal через window.cryndel.modal({ title, html, css }), закрыть через window.cryndel.closeModal() и отправить POST через window.cryndel.call('net.fetch', url, { method: 'POST', data }).

Модальные страницы, кнопки опросов и формы — это обычный HTML/JavaScript внутри sandboxed iframe. Для отправки голосов нужен ваш сервер опросов и разрешение net; сам лаунчер не хранит и не подсчитывает голоса. Не включай пользовательский HTML в общую страницу лаунчера: держи его внутри plugin iframe.

11. Настройки лаунчера, загрузки и установка модов

Методы HTML-моста вызываются как await window.cryndel.call('settings.set', 'ui.theme', 'ocean'). Ответ или ошибка возвращаются Promise. Конфигурация самого плагина доступна через plugin.config.get(key, fallback) и plugin.config.set(key, value) без доступа к чужим файлам. Попытка вызвать метод без разрешения завершится понятной ошибкой. Для установки используй ID сборки и проекта Modrinth; API не даёт плагину запускать произвольные файлы или команды.

12. Настройки плагина и публикация опросов

Параметры самого расширения по-прежнему описываются через manifest.settings или хранятся в api.config. HTML-страницы могут рисовать любые формы, но сохранение конфигурации плагина из UI должно проходить через зарегистрированный API плагина, а не писать в файлы напрямую. Для публичного опроса используй собственный HTTPS endpoint: iframe не имеет прямого сетевого доступа, запрос отправляется через ограниченный net.fetch.

11. Установка, обновление и выключение

1. Для проверки открой реальную папку плагинов. Кнопка «Папка» открывает общий каталог плагинов пользователя. Каждый каталог расширения должен содержать манифест непосредственно на ожидаемом уровне.
2. Для распространения создай ZIP. Лучше положить manifest.json в корень архива. Также поддерживается обычная папка-обёртка вида my-plugin/manifest.json: лаунчер использует содержимое каталога, где лежит манифест.
3. Установи или переустанови. Перед установкой ZIP лаунчер показывает запрошенные разрешения; можно выдать их все или установить без них. Файлы распаковываются в папку по ID. Повторная установка записывает файлы поверх совпадающих, но не удаляет старые лишние файлы автоматически.
4. Включай конкретный плагин. Переключатель карточки вызывает загрузку или выгрузку этого расширения. Список отключённых ID хранится отдельно в .disabled.json.
5. Перезагружай после ручных изменений. Кнопка «Перезагрузить» очищает текущие записи менеджера о загруженных плагинах и hooks и затем загружает их повторно. Не полагайся на неё как на гарантированный вызов deactivate перед очисткой — свои таймеры и ресурсы проектируй с явным жизненным циклом.
6. Удаляй только если данные не нужны. Удаление вызывает выгрузку плагина и удаляет его каталог, включая конфиг и собственные файлы этого расширения.

12. Диагностика ошибок плагина

13. Чек-лист перед тем, как отдать ZIP другому игроку

• У плагина уникальный стабильный id, заполнены имя, версия, описание и автор.
• JSON манифеста валиден; main действительно существует.
• ZIP открыт и проверен: manifest.json лежит на верхнем уровне, нет внешней папки-обёртки.
• Расширение работает после чистой установки, а не только в старом каталоге с забытыми файлами.
• Изменение и чтение параметров проверены после перезапуска; данные не записываются за пределы каталога плагина.
• Сетевое разрешение присутствует лишь при необходимости; URL, передаваемые данные и ошибки проверены.
• Пользователю честно описано, какие файлы, данные и сетевые сервисы использует расширение.

1. Куда вводить стили, как сохранить и восстановить

1. Открой настройки лаунчера и найди секцию «Свой CSS».
2. Вставь обычный CSS в большое текстовое поле. Это именно CSS: без тегов <style>, HTML и JavaScript.
3. Нажми «Применить CSS». Лаунчер сохраняет текст и применяет стили сразу.
4. Чтобы использовать готовый файл, нажми «Из файла…» и выбери файл с расширением CSS. Чтобы вернуть штатный вид, нажми «Очистить».

Файл хранится в пользовательском каталоге данных лаунчера, в подпапке themes/custom.css. Он переживает перезапуск и обновление приложения, потому что это пользовательские данные, а не исходный CSS-файл в каталоге проекта. Размер ограничен примерно 400 000 символами. Загрузчик сохраняет текст CSS; это не проверка дизайна и не гарантия, что каждое свойство поддерживается Chromium.

Изменяй по одной группе правил и проверяй результат после каждого применения. Если интерфейс стал нечитаемым, вернись в настройки и очисти пользовательский CSS. Если изменились лишь отдельные элементы, вероятнее всего, правило не совпало с селектором, проиграло более специфичному правилу или содержит неподдерживаемое свойство.

2. Из чего состоит правило CSS

селектор {
  свойство: значение;
  другое-свойство: другое-значение;
}

Селектор находит элементы, которым адресовано правило. Свойство обозначает часть оформления, а значение задаёт результат. Фигурные скобки и точка с запятой обязательны для привычного надёжного форматирования. Несколько элементов можно перечислить через запятую.

Точка перед именем означает класс; решётка — ID. Два селектора подряд, например .nav-item.active, означают, что один элемент должен одновременно иметь оба класса. Пробел в .nav-item .label означает вложенность: элемент .label внутри .nav-item. Не добавляй пробел, если хочешь выбрать именно один элемент с двумя классами.

3. Каскад, порядок и специфичность: почему правило «не сработало»

У элемента могут быть правила из базового оформления, темы, CSS конкретного экрана и пользовательского CSS. Браузер сначала учитывает важность и специфичность, а при равенстве обычно выигрывает правило, объявленное позже. Пользовательский файл подключается как слой пользовательского оформления, поэтому часто может переопределить стандарт, если выбран сопоставимый или более точный селектор.

• .btn точнее, чем просто button: класс обычно выигрывает у селектора по тегу.
• .stage .btn точнее, чем .btn, потому что дополнительно ограничивает область.
• #stage .btn обычно уже слишком точен для общего переоформления кнопок и усложняет дальнейшие изменения.
• !important принудительно поднимает объявление в приоритете. Не добавляй его «на всякий случай»: он затрудняет отладку и может сломать состояния наведения, фокуса или отключённой кнопки.

/* Начинай с простого правила. */
.stage .card {
  border-color: var(--line);
  border-radius: var(--card-radius);
}

/* Если стиль нужен только на наведении, добавь состояние,
   а не отдельное правило с !important. */
.stage .card:hover {
  border-color: var(--accent);
}

4. Переменные Cryndel: меняй всю тему согласованно

Основные переменные заданы в таблице дизайн-токенов и используются повторно по всем экранам. Переопределяя токен, ты меняешь много компонентов сразу — кнопки, карточки, рамки, текст или прозрачность. Это предпочтительнее десятков разрозненных правил с одинаковыми цветами.

Значение переменной должно соответствовать её типу. Например, цвет нельзя присвоить переменной размытия, а 16 для свойства border-radius не задаёт длину — нужно 16px. Некоторые токены являются вычисляемыми: для полупрозрачной темы меняй исходные --panel-raw/--panel-2-raw и процент, а не пытайся превратить конечную переменную в неподходящий формат.

:root {
  --bg: #10131b;
  --bg-2: #171c28;
  --panel-raw: rgba(25, 31, 45, .94);
  --panel-2-raw: rgba(31, 39, 56, .97);
  --text: #edf2ff;
  --muted: #a8b2c8;
  --line: rgba(183, 199, 232, .18);
  --accent: #8caeff;
  --accent-2: #6f8ff0;
  --radius: 16px;
  --card-radius: 20px;
  --shadow: 0 14px 36px rgba(0, 0, 0, .32);
}

5. Стили по темам, состояниям и элементам интерфейса

У темы есть атрибут data-theme на корневом элементе. Если нужен общий дизайн, используй :root. Если конкретная корректировка нужна только одной теме — ограничь правило атрибутом. Так, например, светлая тема может сохранить собственный текст, даже если ты меняешь фон остальных тем.

/* Общее правило для всех тем. */
:root {
  --accent: #8d7bff;
}

/* Только для темы forest. */
:root[data-theme="forest"] {
  --accent: #78c98c;
  --accent-2: #4e9c69;
}

/* Взаимодействие мышью и клавиатурой. */
.btn:hover {
  filter: brightness(1.08);
}
.btn:focus-visible,
.field:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 2px;
}
.btn:disabled {
  opacity: .55;
  cursor: not-allowed;
}

Имена атрибутов и состояний должны совпадать буквально. Cryndel использует, в частности, data-anim, data-background-animation, data-compact, data-density, data-dock, data-glow, data-header, data-homebuttons, data-interaction-animation, data-motion-reduced, data-nav-labels, data-notification-animation, data-statusbar и data-toast. Это динамические состояния: для общей кастомизации сначала проверь селектор на экране и не считай каждый атрибут отдельной пользовательской настройкой.

6. Реальные классы: кнопки, карточки, поля, навигация

/* Оформить кнопки и поля в общем стиле. */
.btn {
  border-radius: 12px;
  font-size: 13px;
  transition: filter .18s ease, transform .18s ease;
}
.btn:hover {
  transform: translateY(-1px);
}
.field {
  border-radius: 12px;
  color: var(--text);
}
.field:focus {
  border-color: var(--accent);
}

/* Карточки экранов остаются гибкими и получают мягкую рамку. */
.stage .card {
  border-color: color-mix(in srgb, var(--accent) 22%, var(--line));
  border-radius: var(--card-radius, 18px);
  box-shadow: var(--shadow);
}

7. Типографика, размеры, отступы и фоны

Для цвета используй HEX, RGB/RGBA, HSL или поддерживаемый Chromium color-mix(). Для размеров — px, rem, проценты, vw/vh и ограничители вроде min()/clamp(). Не убирай min-width: 0 у элементов в flex/grid без проверки: оно помогает длинному тексту не раздвигать весь экран.

.home-title {
  color: var(--text);
  font-size: clamp(30px, 4.6vw, 56px);
  line-height: 1;
  letter-spacing: -.035em;
}

.stage .card {
  padding: clamp(12px, 2vw, 20px);
  background:
    linear-gradient(145deg,
      color-mix(in srgb, var(--panel) 94%, var(--accent)),
      var(--panel-2));
  border: 1px solid var(--line);
}

Для фонового изображения лучше сначала выбрать его штатной кнопкой в настройках. Тогда лаунчер сам управляет хранением, подложкой и применением. CSS-фильтры filter на всём контейнере способны размыть текст и кнопки вместе с обоями; если надо изменить только задний план, меняй фон штатно или применяй эффект к конкретному фоновому слою после проверки структуры.

8. Адаптивность: не ломай узкое окно

Сетка окна и CSS экранов содержат media queries на нескольких ширинах: около 1240, 1100, 900, 860, 820, 640, 620 и 560 px, а для компактной высоты — около 620 и 560 px. Внутреннее окно также может изменяться по размеру. Не создавай дизайн, который работает только на одной ширине, и не заменяй адаптивную навигацию фиксированным абсолютным блоком.

/* Сетка из двух колонок на широком окне,
   одна колонка на узком. */
.stage .custom-grid {
  display: grid;
  grid-template-columns: repeat(2, minmax(0, 1fr));
  gap: 14px;
}

@media (max-width: 700px) {
  .stage .custom-grid {
    grid-template-columns: minmax(0, 1fr);
  }

  .stage .custom-grid .card {
    padding: 12px;
  }
}

@media (max-height: 620px) {
  .stage .hero {
    padding-top: 16px;
  }
}

Важно: .custom-grid в этом примере — пример собственного класса, а не обязательный класс приложения. Его можно применять к элементам плагина или к собственному классу существующего элемента, если DOM действительно позволяет это сделать; для уже существующих областей используй подтверждённый класс вроде .hero или .grid-cards.

Проверяй минимум четыре ситуации: обычную ширину окна, узкую ширину, короткую высоту и длинный текст/переводы. Для сеток используй minmax(0, 1fr); для размеров — min() и clamp(); для строк — overflow-wrap: anywhere, если длинное имя может выходить за границу. Мобильная адаптация не сводится к уменьшению шрифта: иногда колонку надо перестроить в одну, а горизонтальную панель — разрешить прокручивать.

9. Уважай отключение анимаций и доступность

В приложении есть пользовательское выключение анимаций и правило для системного предпочтения уменьшенного движения. Не добавляй бесконечные вращения, вспышки и принудительные переходы поверх этого поведения. Используй умеренную длительность, сохраняй чёткую рамку фокуса и контраст текста относительно фона.

.custom-indicator {
  transition: opacity .18s ease, transform .18s ease;
}

@media (prefers-reduced-motion: reduce) {
  .custom-indicator {
    transition: none;
  }
}

.btn:focus-visible,
.nav-item:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 3px;
}

Встроенные анимации завязаны на --anim-dur и выключаются глобальным состоянием. CSS-переопределение с animation: ... !important может намеренно или случайно отменить это поведение, поэтому не используй его без веской причины.

10. Практические рецепты

:root {
  --radius: 8px;
  --card-radius: 10px;
}
.card,
.modal,
.music-card {
  border-radius: var(--card-radius);
}

:root {
  --panel-raw: rgba(20, 25, 37, .88);
  --panel-2-raw: rgba(25, 31, 46, .94);
  --glass-blur: 12px;
  --panel-pct: 92%;
}
.card,
.modal,
.dl-dock {
  backdrop-filter: var(--glass);
}

.play-btn {
  border-radius: 16px;
  box-shadow: 0 10px 28px
    color-mix(in srgb, var(--play) 28%, transparent);
}
.play-btn:hover {
  filter: brightness(1.07);
}

:root {
  --nav-user: 84px;
}
.nav-item {
  border-radius: 12px;
}

:root {
  --muted: #c1cbe0;
  --line: rgba(195, 210, 240, .28);
}
.hint {
  line-height: 1.6;
}

11. Частые ошибки и порядок диагностики

Что происходит после кнопки «Играть»

1. Проверяется выбранный профиль и игрок. Для запуска необходима существующая сборка и текущий профиль пользователя.
2. Определяется среда выполнения. Лаунчер использует Java, подходящую версии Minecraft; при необходимости Java может быть обнаружена или установлена.
3. Подготавливаются файлы. Если игровые файлы/библиотеки отсутствуют, лаунчер скачивает необходимые компоненты и сообщает ход подготовки.
4. Показывается прогресс. В интерфейсе виден статус подготовки; если это загрузка, доступна её отмена.
5. Стартует процесс игры. При ошибке сообщение показывается в интерфейсе; информацию о причинах можно искать в «Починке» и игровых логах.
6. Учитывается время игры. После завершения процесса лаунчер завершает сессию счётчика времени и может вернуть своё окно согласно настройкам.

Главная страница

Экран «Сборки» и страница профиля

Каталог Modrinth — путь от поиска до установки

1. Сначала выбери целевую сборку. Фильтры каталога берут выбранные загрузчик и версию Minecraft как исходные значения. Без выбранного профиля установку мода выполнить некуда.
2. Введи поисковый запрос и настрой тип. Ищутся моды, ресурспаки, шейдеры и модпаки; также доступны фильтры загрузчика, версии игры и сортировки.
3. Посмотри список результатов. Карточки показывают название, автора, число загрузок, описание и действие перехода на страницу.
4. Открой подробности проекта. Страница может содержать категории, галерею, описание и список версий, соответствующих выбранным фильтрам.
5. Установи совместимую версию. Установка добавляет проект в выбранную сборку и обрабатывает зависимости через менеджер зависимостей.

Если выбрана категория модпаков, действие означает создание отдельной сборки, а не добавление набора JAR в уже существующую папку модов. Если проект уже найден в сборке, страница может показать это и предложить переустановку.

Экран модов: конкретные операции

Скриншоты, встроенный браузер и кабинет

Тема и внешний вид

Главная, фон и поведение анимаций

Звуки и фоновая музыка

Minecraft, память, Java и картинка

Язык, Discord, поведение окна и сброс

Точная карта пользовательских настроек

В таблицах ниже приведены реальные поля формы настроек и соответствующие ключи. Диапазон у ползунка — это границы контролла в интерфейсе. Если для сохранённого значения не показан ползунок, это не означает, что лаунчер автоматически проверит или исправит его при ручном редактировании файла настроек.

Внешний вид и интерфейс

Главная, заставка и фон

Звуки и музыка

В исходниках файлы музыки кладутся в muzick/fon. В установленном лаунчере используй кнопку «Открыть папку» в настройках: папка находится в доступном для записи каталоге данных пользователя. Не путай индивидуальную громкость события с общей громкостью звука и громкостью музыки: это три самостоятельных слоя управления.

Память, разрешение и Java

Поведение лаунчера и кабинет

Секция «Настройки» также содержит кнопки перехода в «Плагины» и «О лаунчере». Это навигация, а не переключатели конфигурации.

Поля из схемы хранения, у которых нет контролла в этой форме

Ниже перечислены дополнительные ключи, существующие в текущих значениях по умолчанию проекта. Их присутствие в schemas.js означает, что хранилище знает такое поле, но не означает, что в обычном экране настроек есть для него переключатель. Не редактируй JSON напрямую без резервной копии: структура может меняться при миграции версии лаунчера.

У игровой схемы есть и другие значения Minecraft — например лимит FPS, дальность прорисовки и симуляции, FOV, VSync, чувствительность мыши, громкость, сложность, чат и параметры HUD. Это не контролы глобального раздела «Память и картинка» в текущем settings.js. Настройки, относящиеся к отдельной сборке, следует искать в настройках/конфигурации выбранного профиля и самой игры, а не предполагать наличие скрытого переключателя в этом экране.

В ключах Minecraft есть похожие по смыслу поля — например defaultFullscreen и fullscreenOnLaunch, а также два ключа showOnGameExit в группах game и launcher. Это разные пространства настроек, и не следует подменять одно другим без проверки места, где значение читается.