diff --git a/.gitignore b/.gitignore index 940eff6..b24904a 100644 --- a/.gitignore +++ b/.gitignore @@ -3,3 +3,6 @@ ### BUILD FOLDER /build + +### venv folder +/venv diff --git a/source/ru/minecraft-auth.rst b/source/ru/minecraft-auth.rst index 034388e..1fb3036 100644 --- a/source/ru/minecraft-auth.rst +++ b/source/ru/minecraft-auth.rst @@ -243,29 +243,69 @@ accessToken. Вам остаётся только заменить пути вн ``<директория установки minecraft>/libraries/com/mojang/authlib/``. Убедитесь в том, что версии скачанного и заменяемого файлов совпадают. +.. _install-server: + Установка authlib на сервер -~~~~~~~~~~~~~~~~~~~~~~~~~~~ +=========================== -Соответствующие изменения должны быть также применены и к серверу. Для этого вам понадобится файл сервера с расширением -.jar. Откройте этот файл в любом удобном архиваторе. Затем точно также откройте архив с authlib, соответствующей версии -игры, для которой ваш сервер. +Сервер также использует authlib для выполнения авторизации игрока, поэтому соответствующие изменения должны быть +также применены и к нему. Ниже приведены инструкции по установки authlib для различных реализаций сервера Minecraft. -Перед вами будет 2 окна: одно с файлами сервера, другое с файлами authlib. Вам необходимо перетащить -**только папки "com" и "by"** из authlib в сервер и подтвердить замену. +.. note:: Если ни одна из приведённых ниже инструкций не подошла для вашей реализации сервера, пожалуйста, + создайте `новый issue `_ и мы допишем инструкцию для вашего сервера. + +.. _vanilla: + +Оригинальный сервер +~~~~~~~~~~~~~~~~~~~ + +С помощью архиватора откройте файл сервера ``minecraft_server.ВЕРСИЯ.jar``. Таким же образом откройте архив с +authlib для соответствующей версии сервера. Перед вами будет два окна: одно с файлами сервера, другое с файлами authlib. +Вам необходимо "перетащить" из архива с authlib все файлы и папки, **за исключением директории META-INF**, и подтвердить +замену. .. figure:: _static/minecraft-auth/authlib-install.png :align: center :alt: Процесс установки authlib. - Обратите внимание: "перетягивать" папки нужно ниже папок сервера (в область файлов .class). + Обратите внимание: "перетягивать" содержимое нужно ниже папок сервера (в область файлов .class). -После этих действий вы можете закрыть оба окна и в настройках сервера установить значение ``online-mode=true``. +После этих действий вы можете закрыть оба окна и в файле ``server.properties`` установить значение ``online-mode=true``. -.. hint:: Некоторые сервера запускаются как обёртка над оригинальным сервером Minecraft (например, Forge и Sponge). - В этом случае модификацию нужно производить именно в оригинальном сервере, а не обёртке. +Bukkit/Spigot +~~~~~~~~~~~~~ - Для серверов, работающих через BungeeCord, установку необходимо производить только на сервер, выполняющим - роль авторизационного. +Сперва выполните установку, как она описана для `оригинального сервера <#vanilla>`_. Затем скачайте библиотеки +`commons-io `_ и +`commons-lang3 `_, +после чего аналогичным с authlib образом последовательно переместите содержимое скачанных архивов в файлы сервера. + +Forge/Sponge +~~~~~~~~~~~~ + +Прежде чем производить установку, необходимо определить, какой именно файл подлежит модификации: + +* **>=1.16**: ``libraries/net/minecraft/server/ВЕРСИЯ-ЦИФРЫ/server-ВЕРСИЯ-ЦИФРЫ-extra.jar``. +* **1.13-1.15**: ``libraries/net/minecraft/server/ВЕРСИЯ/server-ВЕРСИЯ-extra.jar``. +* **<=1.12**: ``minecraft_server.ВЕРСИЯ.jar``. + +Когда необходимый файл найден, выполните для него установку authlib, аналогично `оригинальному серверу <#vanilla>`_. + +Paper (PaperSpigot) +~~~~~~~~~~~~~~~~~~~ + +Установка производится по аналогии с `Bukkit/Spigot <#bukkit-spigot>`_ в файл ``cache/patched-ВЕРСИЯ.jar``. +После внесения изменений, запускать сервер нужно через jar-файл из директории ``cache``, поскольку в противном случае +**Paper восстановит исходное состояние файла**: + +| До: ``java -jar paper-ВЕРСИЯ-БИЛД.jar`` +| После: ``java -jar cache/patched-ВЕРСИЯ.jar`` + +Bungeecord +~~~~~~~~~~ + +Установку необходимо производить только на сервер, на который пользователь выполняет первичных вход. В зависимости от +используемого ядра сервера, обратитесь к одному из пунктов `выше <#install-server>`_. Установка на версии ниже 1.7.2 ==============================