From 1c2cae491a4692aad4ac306efaf45d21e5b7b690 Mon Sep 17 00:00:00 2001 From: kostya-main Date: Fri, 26 Jan 2024 19:47:24 +0300 Subject: [PATCH 1/2] =?UTF-8?q?=D0=A1=D0=B8=D1=81=D1=82=D0=B5=D0=BC=D0=B0?= =?UTF-8?q?=20=D1=81=D0=BA=D0=B8=D0=BD=D0=BE=D0=B2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/.vitepress/sidebar.js | 4 ++++ docs/basic/install-launch-server.md | 4 ++-- docs/basic/server.md | 2 +- docs/basic/system-skin.md | 33 +++++++++++++++++++++++++++++ 4 files changed, 40 insertions(+), 3 deletions(-) create mode 100644 docs/basic/system-skin.md diff --git a/docs/.vitepress/sidebar.js b/docs/.vitepress/sidebar.js index 2a68901..5ca6690 100644 --- a/docs/.vitepress/sidebar.js +++ b/docs/.vitepress/sidebar.js @@ -15,6 +15,10 @@ export const sidebar = { text: "Настройка авторизации", link: "/basic/auth", }, + { + text: "Настройка системы снинов", + link: "/basic/system-skin", + }, { text: "Привязка Minecraft сервера", link: "/basic/server", diff --git a/docs/basic/install-launch-server.md b/docs/basic/install-launch-server.md index 4b5707d..73b6d93 100644 --- a/docs/basic/install-launch-server.md +++ b/docs/basic/install-launch-server.md @@ -65,7 +65,7 @@ - `disableListing` - Включить отдачу папок и файлов силами лаунчсервера, рекомендуется отключать при проксировании файлов, например через [Nginx](nginx.md) - `hideListing` - Отключить вывод списка папок и файлов, не работает если `disableListing` установлен в значении `true` - `useSSL` - Использовать SSL сертификат для сервера. При использовании сертификата не забудьте поменять в `address` url с `ws` на `wss` -- `ssl` - пути для используемых файлов сертификата в PEM формате. Можно указывать как абсолютный так и относительный (из директории в которой был запущен лаунчсервер) путь до файлов. Подробнее о параметрах [cert и key](https://nodejs.org/api/tls.html#tls_tls_createsecurecontext_options) -- `skinDomains` - Список адресов для загрузки скинов +- `ssl` - пути для используемых файлов сертификата в PEM формате. Можно указывать как абсолютный так и относительный (из директории в которой был запущен лаунчсервер) путь до файлов. Подробнее о параметрах [cert и key](https://nodejs.org/api/tls.html#tls_tls_createsecurecontext_options) +- `skinDomains` - Список адресов для загрузки скинов, подробнее в разделе [Настройка системы скинов](system-skin.md) Для работы с защищённым подключением с использованием SSL сертификата рекомендуется вместо настройки `ssl` в лаунчсервере использовать проксирование сервера через [Nginx](nginx.md). Данный подход позволяет более удобно настраивать подключение (например с использованием автоматизированных скриптов certbot-a), а также переложить часть нагрузки с Node.js сервера на [Nginx](nginx.md). diff --git a/docs/basic/server.md b/docs/basic/server.md index b83f6ff..90f5584 100644 --- a/docs/basic/server.md +++ b/docs/basic/server.md @@ -15,7 +15,7 @@ "arguments": "", "injectorFilename": "injector.jar", "serverFilename": "server.jar", - "apiUrl": "example.com" + "apiUrl": "http://127.0.0.1:1370" } ``` diff --git a/docs/basic/system-skin.md b/docs/basic/system-skin.md new file mode 100644 index 0000000..59603d6 --- /dev/null +++ b/docs/basic/system-skin.md @@ -0,0 +1,33 @@ +# Настройка системы скинов + +В лаунчере используется проект [authlib-injector](https://github.com/yushijinhun/authlib-injector) для работы кастомной системы скинов и авторизации. +Система скинов будет работать только при использовании авторизацию через `DB` или `Json`. + +::: warning Важно +В нынешней версии лаунчера моделька игрока на главном экране не синхронизирована с системой. Моделька постоянно будет в скине Steve +::: +## Настройка LauncherServer + +Для корректной работы нужно указать в `LauncherServerConfig.hjson` **все домины**, от куда будут производиться загрузка скинов. +```hjson +injector: +{ + skinDomains: [ + ".discordapp.net", + "i.imgur.com" + ] +} +``` +::: info Для справки: +Если в начали домена стоит `.` это говорит что разрешены все поддомены. +Если в **начале нет** `.` это говорит что разрешён только этот домен. +::: + +## Настройка при авторизации `DB` + +Все файлы должны быть размещены на сторонем хостинге или сайте предоставляющий прямую ссылку на файл. +Данные ссылки должны быть расположены в столбце `skinURL` или `capeURL` в зависимости от типа файла. + +## Настройка при авторизации `Json` + +Вам нужно будет реализовать запросы `/hasJoined`, `/profile` по схеме описанной в [этой](../for-developers/json-auth.md) статье. \ No newline at end of file From 25ef3a641b8a43abf8bdbf059b0278dbcedde68f Mon Sep 17 00:00:00 2001 From: kostya-main Date: Fri, 26 Jan 2024 20:28:00 +0300 Subject: [PATCH 2/2] =?UTF-8?q?=D0=9E=D1=80=D1=84=D0=BE=D0=B3=D1=80=D0=B0?= =?UTF-8?q?=D1=84=D0=B8=D1=8F=20=D1=8D=D1=82=D0=BE=20=D0=BD=D0=B0=D1=88?= =?UTF-8?q?=D0=B5=20=D0=B2=D1=81=D1=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/basic/system-skin.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/basic/system-skin.md b/docs/basic/system-skin.md index 59603d6..0e5761e 100644 --- a/docs/basic/system-skin.md +++ b/docs/basic/system-skin.md @@ -8,7 +8,7 @@ ::: ## Настройка LauncherServer -Для корректной работы нужно указать в `LauncherServerConfig.hjson` **все домины**, от куда будут производиться загрузка скинов. +Для корректной работы нужно указать в `LauncherServerConfig.hjson` **все домены**, от куда будет производиться загрузка скинов. ```hjson injector: {