Cargando

Cargando...

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

Инстансы

Как создавать, организовывать и управлять изолированными инстансами Minecraft, каждый из которых имеет собственный контент, миры, серверы и конфигурацию.

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

Структура на дискередактировать

По умолчанию инстансы находятся в .cubic/instances/. Каждый инстанс — это папка с именем, которое вы выбрали:

plaintext
.cubic/
├── instances/
│   └── My Instance/
│       ├── instance.cub        ← instance metadata
│       ├── mods/               ← mods (.jar / .jar.disabled)
│       ├── resourcepacks/      ← resource packs
│       ├── shaderpacks/        ← shader packs
│       ├── saves/              ← worlds
│       ├── screenshots/        ← screenshots
│       └── ...                 ← Minecraft runtime files
└── shared/                     ← shared versions, libraries, assets and Java

Файл instance.cub хранит метаданные в формате JSON. Среди прочих полей он содержит имя, версию, значок, необязательный объём памяти, назначенный профиль options.txt и информацию о том, применяется ли он автоматически при запуске:

jsonc
{
  "name": "My Instance",
  "version": "1.21-fabric",
  "last_played": 1717000000,
  "playtime_seconds": 3600,
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "icon": "/images/instances/fabric.png",
  "cover_image": null,
  "min_memory": null,
  "max_memory": null,
  "pinned": false,
  "options_profile_id": null,
  "auto_apply_options": false
}

Пути instances и shared можно изменить в разделе Настройки → Хранилище. При перемещении инстансов лаунчер использует жёсткие ссылки, если целевой диск это позволяет; в противном случае он копирует данные. Общие файлы можно очистить — они будут загружены заново при запуске инстанса.

Создание инстансаредактировать

  1. Нажмите «Создать инстанс» на боковой панели.
  2. Выберите имя длиной до 24 символов ASCII.
  3. Выберите версию из уже загруженных (если нужной нет, сначала загрузите её с помощью кнопки загрузок).
  4. Выберите значок и, при желании, обложку.
  5. Нажмите Создать.

Вы также можете создать инстанс из модпака Modrinth или CurseForge, импортировать .mrpack/ZIP или перенести существующую установку из раздела Создать инстанс → Локальный.

Версия автоматически определяет загрузчик: если идентификатор содержит fabric, он определяется как Fabric, forge — как Forge, neoforge — как NeoForge, quilt — как Quilt, а если ничего не совпадает, версия считается Vanilla.

Представление инстансаредактировать

При выборе инстанса открывается его главная панель с:

  • Hero — баннер с именем, значком, версией, загрузчиком, временем в игре и текущим статусом.
  • Кнопка «Играть» — запускает Minecraft с этим инстансом.
  • Строка состояния — показывает статус в реальном времени: Выключен, Запускается, Запущен или Ошибка.
  • Чип модпака — если инстанс создан из модпака, показывает его версию и действия для защиты, обновления или восстановления инвентаря.

Вкладка «Детали»редактировать

Показывает общую информацию об инстансе:

  • Значки версии и загрузчика (Vanilla, Fabric, Forge, NeoForge, Quilt).
  • Путь на диске с кнопкой открытия папки.
  • Ярлыки к папкам модов, скриншотов, наборов ресурсов и шейдеров.
  • Живая консоль с выводом Minecraft и автопрокруткой.
  • Кнопка «Принудительно закрыть», если инстанс запущен.

Маркет модовредактировать

Показывает, ищет и устанавливает моды из Modrinth и CurseForge или управляет уже установленными из источника Локальный. Вы можете включать и отключать моды (переименование .jar ↔ .jar.disabled) и видеть, какие моды относятся к модпаку.

Раздел доступен, только если инстанс использует загрузчик модов. В инстансах Vanilla и OptiFine этот раздел не отображается.

Ресурсы и шейдерыредактировать

Вкладки Ресурсы и Шейдеры используют тот же Маркет, но ограничены наборами ресурсов или шейдерами. Вы можете искать совместимый контент, устанавливать его и управлять локальными файлами.

Шейдеры недоступны в инстансах Vanilla.

Миры и серверыредактировать

У каждого инстанса есть собственный список миров и серверов. Из этих разделов вы можете открыть папку saves/, добавить серверы, проверить их статус и подключиться с помощью Quick Play. См. Серверы и миры.

Скриншотыредактировать

Галерея скриншотов, сделанных внутри инстанса:

  • Предпросмотр в виде миниатюр.
  • Просмотр в лайтбоксе по клику.
  • Удаление скриншотов.

Жизненный циклредактировать

plaintext
Off ──► Starting ──► Started ──► Off
 │         │            │
 │         │            │
 └────► Error ◄─────────┘
  • Выключен — инстанс не запущен.
  • Запускается — лаунчер подготавливает и запускает Minecraft.
  • Запущен — Minecraft работает.
  • Ошибка — при запуске произошла ошибка (отсутствует версия, неправильная Java и т. д.).

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

Управление инстансамиредактировать

На боковой панели или в меню инстанса вы можете:

  • Переименовать — изменяет имя и папку на диске.
  • Удалить — удаляет инстанс и всё его содержимое.
  • Открыть папку — открывает каталог инстанса напрямую.
  • Закрепить — размещает инстанс в верхней части списка.
  • Экспорт — создаёт .mrpack с выбранным контентом.
  • Импорт — восстанавливает инстанс из совместимого ZIP с предпросмотром перед подтверждением.

Редактор инстансаредактировать

Редактор позволяет изменить версию и загрузчик, восстановить установку, настроить собственный объём памяти и аргументы JVM инстанса, а также назначить профиль options.txt.

Смена версии или загрузчика

Смена версии или загрузчика может повредить установку и нарушить работу модов. Перед применением изменений лаунчер показывает предупреждение.

Профили options.txtредактировать

Профили хранят содержимое options.txt и могут применяться к любому инстансу вручную или перед запуском. Эта функция экспериментальная.

  • Управление ими осуществляется в разделе Настройки → Minecraft → Профили options.txt.
  • В редакторе каждого инстанса вы выбираете профиль и то, применяется ли он автоматически при запуске.
  • Если в инстансе уже есть options.txt, перед его заменой сохраняется резервная копия.
  • Когда профиль применяется автоматически, изменения, сделанные вами в игре, теряются при следующем запуске.
  • Вы также можете импортировать options.txt из файла или сохранить текущие настройки инстанса как профиль.

Модпакиредактировать

  • Импортируйте .mrpack Modrinth или ZIP CurseForge.
  • Лаунчер разрешает зависимости и загружает правильные версии.
  • Вы можете увидеть план перед установкой и отменить её, если передумаете.
  • Чип модпака позволяет защитить пакет от случайных изменений, обновить его из опубликованной версии или локального файла и просмотреть конфликты перед применением.
  • Если исходный инвентарь отсутствует, чип предлагает восстановить инвентарь, чтобы определить моды пакета.

Обновления модпаков являются экспериментальными.

Загрузка версийредактировать

Используйте кнопку загрузок на боковой панели, чтобы открыть Загрузчик версий. Там вы можете загрузить:

  • Версии Vanilla (release и snapshot).
  • Версии Alpha/Beta.
  • Fabric, Forge, NeoForge, Quilt и OptiFine.

Загруженные версии хранятся в папке shared и являются общими для всех инстансов. В разделе Настройки → Minecraft вы можете выбрать, показывать ли снапшоты, версии Alpha и нестабильные версии загрузчиков.

Оперативная памятьредактировать

Глобальный объём памяти настраивается в разделе Настройки → Minecraft → Производительность (ОЗУ). Лаунчер показывает рекомендуемый диапазон исходя из общего объёма вашей ОЗУ.

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