Skip to content

Commit 9ca5493

Browse files
committed
Update quickstart, add doc for BRIDGE mode
1 parent 151cd10 commit 9ca5493

3 files changed

Lines changed: 69 additions & 15 deletions

File tree

docs/clientbuild/README.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,17 @@ downloadinstaller NEOFORGE 1.21.8
6666
installclient MyGreatClient 1.21.8 NEOFORGE
6767
```
6868

69+
## Поддержка устаревших клиентов на Java 8 с помощью режима BRIDGE
70+
71+
Мы не рекомендуем использовать устаревшие клиенты и сервера без поддержки Java 21+. Однако если вам по какой то причине это необходимо вы можете воспользоватся специальным режимом работы лаунчера.
72+
73+
- Если у вас уже есть клиент, работающий на Java 8 - перенесите его в лаунчер опираясь на ваш предыдущий профиль и актуальный формат
74+
- Измените рекомендуемую, минимальную и максимальную версию Java в профиле
75+
- Установите `classLoaderConfig` в значение `BRIDGE`
76+
- Установите специальную версию authlib `https://mirror.gravitlauncher.com/5.7.x/authlib/LauncherAuthlib1-bridge.jar`
77+
- Синхронизируйте изменения и проверьте работу. Для привязке сервера следуйте инструкции для BRIDGE
78+
- Лаунчер не должен закрываться при работе клиентов в режиме BRIDGE. Актуальная версия рантайма покажет вам диалог с предупреждением если вы попытаетесь выйти из лаунчера не закрыв клиент
79+
6980
## Настройка профиля
7081

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

docs/quickstart/README.md

Lines changed: 3 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -196,21 +196,9 @@ git clone https://github.com/GravitLauncher/LauncherDockered.git
196196
cd LauncherDockered
197197
```
198198
199-
- Отредактируйте `docker-compose.yml` указав **внешний** адрес лаунчсервера и желаемое имя проекта
200-
- Запустите лаунчсервер командой `docker compose up -d`
201-
- После завершения инициализации(подождите около 5-10 секунд) выполните базовую настройку:
202-
203-
```bash
204-
echo "modules load MirrorHelper" | docker compose exec -T gravitlauncher socat UNIX-CONNECT:control-file -
205-
echo "modules load GenerateCertificate" | docker compose exec -T gravitlauncher socat UNIX-CONNECT:control-file -
206-
echo "applyworkspace" | docker compose exec -T gravitlauncher socat UNIX-CONNECT:control-file -
207-
echo "generatecertificate" | docker compose exec -T gravitlauncher socat UNIX-CONNECT:control-file -
208-
docker compose exec gravitlauncher wget https://github.com/GravitLauncher/LauncherRuntime/releases/latest/download/JavaRuntime.jar
209-
docker compose exec gravitlauncher bash -c "mkdir runtime && cd runtime && wget https://github.com/GravitLauncher/LauncherRuntime/releases/latest/download/runtime.zip && unzip runtime.zip && rm runtime.zip && cd .."
210-
echo "modules launcher-load JavaRuntime.jar" | docker compose exec -T gravitlauncher socat UNIX-CONNECT:control-file -
211-
echo "modules load Prestarter" | docker compose exec -T gravitlauncher socat UNIX-CONNECT:control-file -
212-
docker compose exec gravitlauncher wget https://github.com/GravitLauncher/LauncherPrestarter/releases/latest/download/Prestarter.exe
213-
```
199+
- Отредактируйте `.env` указав **внешний** адрес лаунчсервера и желаемое имя проекта
200+
- Запустите скрипт `install.sh`
201+
- Управляйте лаунчсервером с помощью скрипта `glctl.sh`
214202
215203
#### Установка через SimpleCabinetDockered
216204

docs/serverwrapper/README.md

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,61 @@ export _JAVA_OPTIONS="-Dlauncher.authlib.inlineClass=pro.gravit.launcher.server.
5353

5454
Замените адрес лаунчсервера и токен на ваш
5555

56+
### Привязка сервера в условиях ограничений хостингов Minecraft серверов
57+
58+
Что бы привязать сервер вам необходимо:
59+
60+
- Иметь контроль над файлами и библиотеками сервера, включая authlib
61+
- Иметь возможность куда либо(например через редактрование строки запуска, файла unix_args.txt или специальных файлов разных ядер) прописать system properties
62+
- Иметь локальный WSL и копию файлов сервера для патча
63+
64+
Так что бы привязать сервер выполните следующие действия:
65+
66+
- Загрузите файлы сервера себе на WSL или машину с Linux окружением
67+
- Выполните патч authlib и ServerWrapperInline по гайду
68+
- Загрузите на хостинг измененные файлы
69+
- Пропишите аргументы `-D` из гайда любым удобным для вас способом(строка запуска, unix_args.txt/user_jvm_args.txt из новых версий Forge/NeoForge, файлы для ядер)
70+
- Локально на вашей WSL или машине Linux выполните следующий скрипт
71+
72+
```
73+
export SERVERWRAPPER_ADDRESS="ws://localhost:9274/api"
74+
export SERVERWRAPPER_CHECK_SERVER_TOKEN="YOUR CHECKSERVER TOKEN"
75+
java -jar ServerWrapper.jar save
76+
```
77+
78+
- Загрузите полученный `ServerWrapperConfig.json` на хостинг
79+
80+
81+
## Привязка устаревшего сервера 1.7.10-1.16.4 с помощью режима BRIDGE
82+
83+
Этот режим используется для запуска устаревших клиентов и серверов на Java 8.
84+
85+
-
86+
- Если вы используете хостинг Minecraft серверов вы должны запустить мост на своей машине с лаунчсервером, так как ServerWrapper требует Java 21+. После чего откройте порт **только для IP сервера**. Открывать порт моста наружу в общий доступ **небезопасно**
87+
- Скачайте ServerWrapper и ServerWrapperInline
88+
89+
```bash
90+
wget https://github.com/GravitLauncher/Launcher/releases/latest/download/ServerWrapper.jar
91+
```
92+
93+
- Установите authlib с поддержкой режима BRIDGE
94+
95+
```bash
96+
java -jar ServerWrapper.jar installAuthlib https://mirror.gravitlauncher.com/5.7.x/authlib/LauncherAuthlib1-bridge.jar
97+
```
98+
99+
- Запустите мост командой
100+
101+
```bash
102+
java -jar ServerWrapper.jar bridge 127.0.0.1 18012
103+
```
104+
105+
- Пропишите любым удобным способом следующие system properties, например через скрипт запуска:
106+
107+
```bash
108+
export _JAVA_OPTIONS="-Dlauncher.authlib.host=127.0.0.1 -Dlauncher.authlib.port=18012"
109+
```
110+
56111
## Привязка Velocity
57112

58113
Так как Velocity не использует authlib, вам необходимо применить [патч](https://mirror.gravitlauncher.com/5.7.x/patches/Velocity.patch)

0 commit comments

Comments
 (0)