Настройка клиента
Совместимость
Начиная с версии 5.6.0 лаунчер поддерживает запуск клиентов и серверов только с Java 17+
На текущий момент поддерживается запуск:
- Любой Vanilla версии с 1.13 до 1.24.5, включая snapshot
- Forge 1.7.10 с lwjgl3ify
- Forge 1.12.2 с cleanroom
- NeoForge/Forge 1.21+
- Любой Fabric версии с 1.13 до 1.24.5, включая snapshot
Необходимы ручные действия для сборки:
- Forge 1.16.5 с аргументами для поддержки Java 17
- Forge с 1.18 до 1.21 требует ручной сборки библиотек
Подробную информацию о том как собрать 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] Папка назначения [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 клиента
installclient MyVanillaClient 1.20.2 VANILLA
- MyVanillaClient - название вашего клиента
- 1.20.2 - версия Minecraft
Установка Fabric клиента
installclient MyFabricClient 1.20.2 FABRIC
- MyFabricClient - название вашего клиента
- 1.20.2 - версия Minecraft
Установка Forge клиента
- Скачайте forge-installer с сайта Classic Forge/NeoForge
- Поместите его в
LAUNCHSERVER_DIR/config/MirrorHelper/workspace/installers/
с именемforge-VERSION-installer.jar
(для тех версий которые не поддерживают установку без gui) илиforge-VERSION-installer-nogui.jar
(для тех которые поддерживают), где VERSION - версия Minecraft - Установку без gui не поддерживает Forge 1.7.10 (следуйте инструкциям для вашего SSH клиента ниже)
- Если по какой то причине у вас не получается использовать X11 Forwarding вы можете скачать и распаковать forge_install_dir.zip и установить forge локально, а после загрузить получившуюся папку в
LAUNCHSERVER_DIR/config/MirrorHelper/workspace/clients/forge/VERISON
, где VERSION - версия Minecraft
installclient MyForgeClient 1.7.10 FORGE
- MyForgeClient - название вашего клиента
- 1.7.10 - версия Minecraft
- В консоли лаунчсервера вы увидите путь, который вам нужно будет выбрать в установщике Forge
- После успешной установки докачайте необходимые моды
Настройка профиля
Список параметров профиля с пояснениями:
{
"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"
}
],
Триггеры - возможность включать опциональный мод при выполнении некоторых условий
"triggersList": [
{
"os": "MACOSX", // ОС: LINUX, MUSTDIE (Это Windows), MACOSX
"required": false,
"inverted": false,
"type": "os"
}
],
"triggersList": [
{
"type": "java",
"minVersion": 8, //Минимальная версия Java для срабатывания триггера
"maxVersion": 11, //Максимальная версия Java для срабатывания триггера
"required": true, //Показывает, что без этого триггера включение опционального мода не имеет смысла
"inverted": false //Инвертировать триггер
}
],
"triggersList": [
{
"type": "arch",
"arch": "X86_64", //Архитектура для срабатывания триггера
"required": true,
"inverted": false
}
],
Полезные инструкции
Добавление сервера в список серверов
- Запустите клиент, добавьте необходимый сервер
- Откройте папку клиента игры на вашем компьютере
- Пример для Windows:
%appdata%/<Имя-Проекта>/updates/<Имя-Клиента>/
- Пример для Windows:
- Отправьте файл
servers.dat
в папку клиента на ЛаунчСервере - Выполните [синхронизацию] клиента игры
Установка языка по умолчанию в раздаваемых клиентах игры
- Этот метод работает только при первом скачивании клиента
- Создайте файл
options.txt
в папке клиента игры на ЛаунчСервере - Впишите одну строчку:
lang:ru_RU
(Либо любого другого языка) - Выполните [синхронизацию] клиента игры