Настройка клиента

Совместимость

Начиная с версии 5.6.0 лаунчер поддерживает запуск клиентов и серверов только с Java 17+

На текущий момент поддерживается запуск:

  • Любой Vanilla версии с 1.13 до 1.20.4, включая snapshot
  • Forge 1.7.10 с lwjgl3ify
  • Любой Fabric версии с 1.13 до 1.20.4, включая snapshot

Необходимы ручные действия для сборки:

  • Forge 1.12.2 с cleanroom
  • Forge 1.16.5 с аргументами для поддержки Java 17
  • Forge 1.18+ по гайду в нашем Discord сервере

Подробную информацию о том как собрать 1.7.10 с lwjgl3ify, 1.12.2 cleanroom и forge 1.18+ можно получить на нашем Discord сервере в канале guides

Рекомендации

  • При создании проекта используйте самую новую версию Minecraft, доступную для ключевых модов в вашей сборке
  • Используйте Fabric вместо Forge для проектов на Minecraft 1.16.5 и выше
  • Используйте Sodium и Iris вместо OptiFine для проектов на Minecraft 1.16.5 и выше
  • Избегайте использования OptiFabric - он создает в корне клиента скрытую папку с .jar внутри, которая не будет проверяться Лаунчером
  • Избегайте использования модов из непроверенных источников. Скачивайте моды с Curseforge/Modrinth или напрямую с GitHub разработчика

Работа модов 1.7.10 на Java 17+

Начиная с версии 5.6.0 лаунчер работает только с клиентами, поддерживающими запуск на Java 17 и выше. Forge 1.7.10 и 1.12.2 были портированы на Java 17+ сторонними разработчиками, что привело к несовместимости с некоторыми грязными трюками, которые применяли мододелы в своих модах на эту версию. Вот что вам нужно сделать для портирования своей сборки на Java 17+:

  • Установите мод Hodgepodge
  • Установите библиотеку GTNHLib и при желании Angelica
  • Проверьте наличие актуальной исправленной версии ваших модов при помощи поиска в репозитории GTNH и обновите их
  • Если проблема остается актуальной обратитесь в наш Discord сервер в канал support

Скачивание ассетов

Для скачивания ассетов выполните команду:

  • Пример: downloadasset 1.20.0
downloadasset <minecraft-version>

Options:
      <minecraft-version> Версия Minecraft [default: null]
      [assets-folder] Deprecated папка назначения [default: "assets"]
  • Загрузка происходит с серверов Mojang
  • При скачивании нескольких версий ассетов в одну папку будут скачаны только недостающие

Настройка MirrorHelper

В актуальных версиях лаунчера рекомендуемым способом установки является MirrorHelper. Это модуль для лаунчсервера, позволяющий скачивать клиенты напрямую с серверов Mojang, устанавливать Forge/Fabric, скачивать моды с Modrinth и CurseForge и т.д.

К сожалению, некоторые файлы не могут быть скачаны автоматически (например установщик Forge и OptiFine) и вам придется скачать их вручную. Также Forge, в отличии от Fabric, не предоставляет возможности ставить клиент автоматически без участия пользователя. Поэтому для установки Forge вам понадобится иметь GUI на машине с лаунчсервером, либо применить X11 Forwarding.

  • Установите модуль MirrorHelper
  • Установите git на вашу машину, если его еще нет
  • Пропишите команду applyworkspace

Примечание

Команда applyworkspace не поддерживается на Windows. Используйте для установки клиента WSL2, Linux или MacOS.

  • Установите клиент
[ Vanilla ]

Установка Vanilla клиента

installclient MyVanillaClient 1.20.2 VANILLA
  • MyVanillaClient - название вашего клиента
  • 1.20.2 - версия Minecraft

Использование X11 Forwarding

Для установки некоторых Forge версий клиентов вам может понадобиться использование X11 Forwarding:

  • Установите пакет xauth на ваш сервер
  • Добавьте или измените параметр X11Forwarding на yes в sshd_config на вашем сервере
  • Перезапустите sshd
  • Следуйте инструкции для вашего SSH клиента:
[ WSL 2 ]

Использование WSL 2 (рекомендуется)

  • Установите WSL 2 по этому гайду
  • Находясь в WSL, выполните команду ssh -XYC yourusername@SERVER_IP
  • Находясь в этой SSH сессии, запустите лаунчсервер без использования screen, docker, tmux и других средств
  • Теперь вы можете установить Forge клиент командой installclient (см. выше)

Команды синхронизации

ЛаунчСервер хранит информацию о файлах и профилях в подготовленном виде.
Первое автоматическое сохранение происходит при скачивании клиента и ассетов игры.
Для поддержания информации в актуальном состоянии при изменении файлов в папке updates и профилях в папке profiles их необходимо синхронизировать с кэш файлом ЛаунчСервера.

Синхронизация всех клиентов и профилей:

sync up

Синхронизация всех профилей:

sync profiles

Синхронизация клиентов игры:

sync updates [folder]

Options:
      [folder] Выбрать папку для синхронизации [default: all]

Сборка AuthLib

Для сборки AuthLib следуйте инструкции:

[ 1.7.10 - 1.16.3 ]

Информация:

  • Скачайте файл LauncherAuthlib1.jar
  • Откройте его архиватором и распакуйте папку com в отдельную папку
  • Откройте ваш AuthLib файл архиватором по пути libraries/com/mojang/authlib/1.x.xx/authlib-1.x.xx.jar и вставьте все файлы с заменой, распакованные на предыдущем этапе
Примечания:
  • В файле LauncherAuthlib1.jar содержатся изменённые классы оригинальной AuthLib 1.x.xx, которые предоставляют обработку AuthCoreProvider для GravitLauncher
  • При замене файлов .class, остальные файлы не трогайте. Файлы должны быть перезаписаны и некоторые будут добавлены

Применение патчей Fabric-Loader

Для клиентов Fabric с версией fabric-loader 0.14.X и выше необходимо применить следующий патч командой git apply -3 FabricLoader.patch

Настройка профиля

Список параметров профиля с пояснениями:

{
  "title": "Vanilla1.17", // Заголовок профиля
  "uuid": "fa9c1a52-6fa9-4da6-a488-9fc80250095c", // UUID профиля (profileUUID)
  "version": "1.17", // Версия майнкрафта
  "info": "Информация о сервере", // Информация о сервере в окне выбора серверов
  "dir": "Vanilla1.17", // Папка клиента в updates
  "sortIndex": 0, // Порядковый номер в окне выбора серверов
  "assetIndex": "1.17", // Название используемого индекса в ассетах
  "assetDir": "asset1.17", // Папка с ассетами
  "update": [ // Список файлов и папок, которые будут перекачиваться при старте клиента
    "servers.dat"
  ],
  "updateExclusions": [], // Список файлов и папок, которые не надо проверять
  "updateVerify": [ // Список файлов и папок, которые будут перекачиваться при старте клиента и  во время работы
    "libraries",
    "natives",
    "minecraft.jar",
    "forge.jar",
    "liteloader.jar",
    "mods"
  ],
  "updateOptional": [], // Список опциональных модов и дополнительных аргументов
  "jvmArgs": [ // Аргументы JVM
    "-XX:+DisableAttachMechanism",
    "-XX:+UseG1GC",
    "-XX:+UnlockExperimentalVMOptions",
    "-XX:G1NewSizePercent=20",
    "-XX:MaxGCPauseMillis=50",
    "-XX:G1HeapRegionSize=32M",
    "-Djava.library.path=natives",
    "-Dfml.ignorePatchDiscrepancies=true",
    "-Dfml.ignoreInvalidMinecraftCertificates=true"
  ],
  "classPath": [ // Список файлов и библиотек, загружаемых при запуске выбранным загрузчиком классов
    "libraries",
    "minecraft.jar",
    "forge.jar",
    "liteloader.jar"
  ],
  "altClassPath": [], // Список файлов и библиотек, загружаемых при запуске системным загрузчиком классов
  "clientArgs": [], // Дополнительные аргументы клиента
  "compatClasses": [], // Список дополнительных MainClass, которые будут запущены перед основным
  "properties": {}, // Кастомная информация о профиле
  "servers": [ // Список серверов
    {
      "name": "Vanilla1.17", // Название (serverName)
      "serverAddress": "localhost", // Адрес сервера
      "serverPort": 25535, // Порт сервера
      "isDefault": true, // По умолчанию
      "protocol": -1, // Версия протокола сервера
      "socketPing": true // Прямой пинг для получения онлайна
    }
  ],
  "classLoaderConfig": "LAUNCHER", // Тип загрузчика классов (LAUNCHER, AGENT, SYSTEM_ARGS)
  "recommendJavaVersion": 16, // Рекомендуемая версия Java
  "minJavaVersion": 16, // Минимальная версия Java
  "maxJavaVersion": 999, // Максимальная версия Java
  "warnMissJavaVersion": true, // Предупреждение о несоответствии Java требованиям для запуска
  "settings": { // Настройки по умолчанию
    "ram": 0, // Количество ОЗУ (в мегабайтах), 0 - автоматически
    "autoEnter": false, //Авто—вход, может крашиться
    "fullScreen": false // Полноэкранный режим
  },
  "limited": false, // Ограничен permissions
  "mainClass": "net.minecraft.client.main.Main" // MainClass клиента
}

Примечание:

  • limited так-же должен быть true, для работы profileWhitelist

Опциональные моды

"updateOptional": [
    {
       "actions": [ //Список действий опционального мода
        { //Первое действие
          "files": {
            "mods/1.7.10/NotEnoughItems-1.7.10-1.0.5.118-universal.jar": "", //Простое добавление файла без переименований
            "mods/SuperStrangeMod0.jar": "mods/SuperStrangeMod.jar", //Добавление файла с перемещением. на стороне ЛаунчСервера файл находится по пути "mods/SuperStrangeMod0.jar", а в клиент он попадет сюда "mods/SuperStrangeMod.jar"
            "mods2/LowStrangeMod.jar": "mods/LowStrangeMod.jar", //Между папками перемещение тоже работает
            "config2/ic2": "config/ic2" //Перемещение папок тоже работает
          },
          "type": "file" //Тип действия - обработка файлов
        }
      ],
       "info": "Мод, показывающий рецепты", //Описание
       "visible": true, //Видимость
       "mark": true, //Включен по умолчанию
       "limited": false, //Ограничен permissions
       "name": "NotEnoughItems", //Имя
       "category": "Интерфейс" //Категория мода. По умолчанию GLOBAL, если не указано
    },
    {
       "actions": [
        {
          "files": {
            "mods/Waila_1.5.10_1.7.10.jar": ""
          },
          "type": "file"
        }
      ],
       "info": "Мод, показывающий дополнительную информацию при наведении на блок",
       "name": "Walia",
       "visible": true,
       "dependenciesFile": [{"name":"NotEnoughItems"/* Имя зависимого мода */}],
       "conflictFile": [{"name":"ClientFixer"/* Имя конфликтующего мода */}],
       "subTreeLevel": 2  //Смещение относительно первого мода. Используется для создания визуального отображения дерева зависимостей
    },
    {
       "actions": [
         {
           "args": [
             "--add-modules",
             "jdk.unsupported"
           ],
           "type": "jvmArgs"
         }
       ],
       "triggers": [], //Триггеры, о них ниже
       "info": "Аргументы Java 9+",
       "visible": false,
       "permissions": 0,
       "name": "Java9Args"
    },
    {
       "actions": [
        {
          "files": {
            "mods/1.7.10/OptiFine_1.7.10_HD_U_E7.jar": ""
          },
          "type": "file"
        }
      ],
       "info": "Улучшение производительности",
       "visible": true,
       "name": "OptiFine HD"
    }
  ],

Триггеры - возможность включать опциональный мод при выполнении некоторых условий

[ Тип OS ]
"triggersList": [
{
  "os": "MACOSX", // ОС: LINUX, MUSTDIE (Это Windows), MACOSX
  "required": false,
  "inverted": false,
  "type": "os"
}
],

Полезные инструкции

Добавление сервера в список серверов

  1. Запустите клиент, добавьте необходимый сервер
  2. Откройте папку клиента игры на вашем компьютере
    • Пример для Windows: %appdata%/<Имя-Проекта>/updates/<Имя-Клиента>/
  3. Отправьте файл servers.dat в папку клиента на ЛаунчСервере
  4. Выполните [синхронизацию] клиента игры

Установка языка по умолчанию в раздаваемых клиентах игры

  • Этот метод работает только при первом скачивании клиента
  1. Создайте файл options.txt в папке клиента игры на ЛаунчСервере
  2. Впишите одну строчку: lang:ru_RU (Либо любого другого языка)
  3. Выполните [синхронизацию] клиента игры