Merge pull request #5 from kostya-main/main

Система скинов
AuroraTeam · Jan 26, 2024 · b4d699b · b4d699b
2 parents b7f2f61 + 25ef3a6
commit b4d699b
Show file tree

Hide file tree

Showing 4 changed files with 40 additions and 3 deletions.
diff --git 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
@@ -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
@@ -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
@@ -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) статье.