Переход на Sponge
Статьи в этом разделе призваны помочь владельцам уже существующих серверов перейти с других серверных платформ на Sponge.
Предупреждение
Создайте резервную копию файлов вашего сервера перед переходом. В случае, если что-то пойдёт не так, у вас будет резервная копия!
Переход на Sponge
Для перехода на SpongeForge или SpongeVanilla обратите внимание на разделы ниже. Большинство инструкций одинаковы для обеих реализаций, различия указываются ниже.
Migrating from CraftBukkit, Spigot, or Paper
Примечание
Spigot — модифицированное ответвление CraftBukkit.
Миры
Forge, and thus SpongeForge (and also SpongeVanilla), use the same world structure as vanilla Minecraft. Vanilla Minecraft
places the nether (typically world_nether
) and the end (typically world_the_end
) dimensions within the
world
folder. However, Bukkit and Spigot don’t use this system to save the worlds, thus migration is needed.
SpongeForge и SpongeVanilla обеспечивают полностью автоматизированный процесс по преобразованию миров. Вот как это работает:
Остановите работу вашего сервера Bukkit или Spigot, после чего создайте резервную копию всех папок.
Установите SpongeForge или SpongeVanilla в папку, где вы запускали старый сервер, удалите jar-файлы Bukkit или Spigot. Если вы не знаете, как правильно установить SpongeForge или SpongeVanilla, прочтите здесь.
Запустите сервер Sponge, и программа перехода будет запущена автоматически.
Программа перехода будет определять папки миров для переноса в параметре
world-container
файлаbukkit.yml
. Если этого файла нет (или что-то привело к сбою чтения файла), тогда перенос будет осуществляться изroot
папки сервера (которая является стандартной для CraftBukkit).Now the migration is performed. At this point, worlds are copied over from what we call the
world container
into the folder defined in the server.properties file via thelevel-name
key. Note that the original files in theworld container
remain unchanged, a copy is made during migration.Bukkit помещает вещи в странные места (со странными именами), поэтому необходимо применить два важных исправления. Запомните, что эти исправления основаны на предположениях (ввиду структуры Bukkit).
Первое исправление применяется для переименования всех папок, имя которых начинается со значения параметра
level-name
и заканчивается названием измерения (_nether
/_the_end
), наDIM-1
иDIM1
соответственно.Второе исправление предназначено для перемещения данных
region
из nether/the_end. Bukkit размещает эти данные вDIM-1\region
иDIM1\region
, в то время как Vanilla/Forge помещаетregion
в корень структуры папок миров.
Программа перехода не может предоставить все необходимые значения конфигурации. Именно поэтому необходимо некоторые из них изменить вручную, чтобы обеспечить правильную работу мира при загрузке его на SpongeForge или SpongeVanilla. Настоятельно рекомендуется использовать World Management Plugin для установки правильных параметров и загрузки мира.
Примечание
Как уже отмечалось, нам приходится иметь дело с несколькими предположениями во время миграции вашего мира. Таким образом, Губка не загружает мир напрямую, для обработки необходимо установить плагин.
Если всё прошло успешно, выходные данные, созданные инструментом перехода, должны выглядеть так:
[17:32:29] [Server thread/INFO] [Sponge]: Checking for worlds that need to be migrated...
[17:32:29] [Server thread/INFO] [Sponge]: Migrating [world_lol] from [.].
[17:32:29] [Server thread/INFO] [Sponge]: Migrated world [world_lol] from [.] to [.\world\world_lol]
[17:32:29] [Server thread/INFO] [Sponge]: Migrating [world_nether] from [.].
[17:32:29] [Server thread/INFO] [Sponge]: Migrated world [world_nether] from [.] to [.\world\DIM-1]
[17:32:29] [Server thread/INFO] [Sponge]: Migrating [world_the_end] from [.].
[17:32:29] [Server thread/INFO] [Sponge]: Migrated world [world_the_end] from [.] to [.\world\DIM1]
[17:32:29] [Server thread/INFO] [Sponge]: [3] worlds have been migrated back to Vanilla's format.
После завершения у вас должна появиться копия мира(ов) в необходимой для Sponge структуре. Если что-то пошло не так, оригинальные файлы мира остаются нетронутыми в исходном месте.
Файлы конфигурации сервера и мира
CraftBukkit и Sponge используют файлы, созданные «ванильным» сервером Minecraft. Таким образом, эти файлы можно повторно использовать в Sponge, если они уже использовались CraftBukkit’ом. Список данных файлов:
server.properties
banned-ips.json
banned-players.json
ops.json
usercache.json
whitelist.json
Также есть файлы, которые использует только CraftBukkit. Их можно спокойно удалить, так как Sponge они не нужны:
bukkit.yml
commands.yml
help.yml
permissions.yml
Пользователи, переходящие со Spigot, возможно захотят сравнить spigot.yml
с global.conf
из Sponge. Некоторые параметры в spigot.yml
имеют аналоги в global.conf
, и вы, если хотите, можете перенести значения присутствующих в обоих файлах параметров.
Плагины
Sponge не имеет встроенной поддержки Bukkit-плагинов. Однако, некоторые участники сообщества переделывают API Bukkit в специальный плагин для Sponge. Это позволит Bukkit-плагинам функционировать на сервере Sponge, но его релиз ещё не намечен.
Ore — это официальный репозиторий Sponge для поиска плагинов. Рекомендуем скачивать все Sponge-плагины из Ore. При поиске замены для Bukkit-плагинов имейте ввиду:
Не все разработчики с Bukkit’а переносят свои плагины на Sponge. Однако, со временем, кто-то другой сможет создать подходящую замену.
Не все переносимые на Sponge плагины будут автоматически конвертировать конфигурационные файлы. Разработчики плагинов принимают решение об автоматической конвертации конфигурационных файлов индивидуально.
Функционал некоторых плагинов, перенесённых с Bukkit, может измениться, даже их структура конфигурации может стать другой.
Migrating from CanaryMod
Миры
Forge, а следовательно и SpongeForge (SpongeVanilla), используют структуру мира обычного Minecraft. В этой структуре измерения Незер (обычно world_nether
) и Энд (обычно world_the_end
) размещаются внутри папки world
.
Canary изменяет местоположение измерений Nether и End на местоположение вне папки world
. Это следует устранить, если желаете сохранить измерения Nether и End при работе Sponge. Хорошо, что Canary предоставляет простой способ преобразовать миры в структуру, которую использует Sponge, с помощью команды /makevanilla
. Результат будет находиться в папке vanilla
, если преобразование пройдет успешно.
Файлы конфигурации сервера и мира
Sponge использует много файлов, созданных «ванильным» сервером Minecraft, например, server.properties
. Однако, Canary использует только один файл, созданный «ванильным» сервером Minecraft, этот файл — usercache.json
. Следовательно, только usercache.json
может быть повторно использован в Sponge.
Тем не менее, возможно вручную перенести некоторые файлы конфигурации Canary к их аналогам в Sponge. Список аналогов предоставлен ниже.
Файл(ы) Canary |
Аналог(и) на Sponge |
---|---|
server.cfg <world>_<dimension>.cfg |
server.properties |
<world>_<dimension>.cfg |
global.conf <dimension>/dimension.conf |
ops.cfg |
ops.json |
db.cfg |
Нет аналога |
motd.txt |
Нет аналога |
Плагины
SpongeVanilla и SpongeForge не имеют встроенной поддержки Canary-плагинов. Это возможно, если переделать API Canary в специальный плагин для Sponge.
Ore это официальный репозиторий Sponge для поиска плагинов, рекомендуем скачивать все плагины для Sponge оттуда. При поиске замены плагинов для Canary имейте ввиду:
Не все разработчики Canary переносят свои плагины на Sponge. Однако, со временем, кто-нибудь другой может создать подходящую замену.
Не все Sponge-плагины, что переносятся с Canary, будут автоматически конвертировать конфигурационные файлы. Индивидуальные разработчики плагинов принимают решение, следует ли автоматически конвертировать конфигурационные файлы.
В некоторых Sponge-плагинах, перенесенных с Canary, может измениться функционал, или они даже могут использовать не ту структуру конфигурации.
Переход с Forge
Переход с простого сервера Forge на SpongeForge или SpongeVanilla — довольно простой процесс, который почти не требует подготовки.
Переход на SpongeForge
Сначала необходимо убедиться, что Вы используете версию Forge, совместимую с версией SpongeForge, которую планируете использовать. Вы можете найти рекомендованные сборки Forge на странице Загрузки Forge. Если Вы используете модификации, они также должны быть обновлены.
Когда будете готовы установить SpongeForge, можете приступать делать следующие шаги:
Остановите сервер Forge, если он запущен.
Загрузите SpongeForge с сайта Sponge и Forge с сайта Minecraft Forge.
Поместите
SpongeForge.jar
в папкуmods
.Запустите сервер и получайте удовольствие!
Примечание
Если SpongeForge — единственная модификация на Вашем сервере, игроки смогут подключиться со стандартного клиента. Другие модификации могут потребовать у игроков установки Forge на их компьютеры.
Переход на SpongeVanilla
Предупреждение
Если переходите на SpongeVanilla: Вы потеряете все данные, блоки и сущности Forge-модификаций, т. к. SpongeVanilla не может запускать эти модификации. Имейте это в виду при принятии решения, перейти на SpongeForge или SpongeVanilla.
Процесс перехода почти такой же, как выше:
Остановите сервер Forge, если он еще запущен.
Загрузите SpongeVanilla и стандартный сервер от Mojang.
Положите миры и файлы конфигурации в папку с сервером.
Запустите сервер с помощью
spongevanilla.jar
.
Переход со стандартного сервера
Администраторы «ванильных» серверов Minecraft могут спокойно перейти на Sponge, т.к. Forge, как и SpongeForge (а также SpongeVanilla), используют такую же структуру мира, как и «ванильный» Minecraft. Sponge также может использовать файлы «ванильного» сервера Minecraft, например, server.properties
.
Сначала надо решить, Вы хотите запустить SpongeForge или SpongeVanilla.
Примечание
Both flavors of Sponge are able to serve vanilla clients. Keep in mind that this only applies to SpongeForge as long as you don’t install Forge mods which require client modifications.
Остановите Vanilla сервер, если он еще запущен
Загрузите SpongeVanilla или SpongeForge.
Положите миры и файлы конфигурации в папку с сервером.
Запустите новый сервер.
Установка Sponge
Эти два руководства: Установка SpongeForge и Установка SpongeVanilla — содержат инструкции по установке Sponge.