Migracja do Sponge
Celem tych artykułów jest pomoc aktualnym właścicielom serwerów w przenoszeniu ich z innych platform na Sponge.
Ostrzeżenie
Wykonaj kopię zapasową plików serwera przed rozpoczęciem migracji. Gdyby coś poszło nie tak, nadal będziesz miał wtedy swoje pliki!
Migracja do Sponge
Aby przenieść serwer na SpongeForge lub SpongeVanilla przejrzyj poniższe sekcje. Większość instrukcji dla tych implementacji jest taka sama, wszelkie ewentualne różnice są zaznaczone.
Migrating from CraftBukkit, Spigot, or Paper
Informacja
Spigot jest zmodyfikowaną wersją CraftBukkit.
Światy
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 i SpongeVanilla zapewniają w pełni zautomatyzowany skrypt, który przekonwertuje Twoje światy. Oto jak z niego skorzystać:
Wyłącz Twój serwer Bukkit lub Spigot i zrób kopię zapasową całego folderu.
Zainstaluj SpongeForge lub SpongeVanilla w folderze, w którym uruchamiałeś swój stary serwer, usuń pliki jar Bukkita lub Spigota. Jeśli nie jesteś pewien jak poprawnie zainstalować SpongeForge lub SpongeVanilla, przeczytaj ten artykuł.
Uruchom serwer Sponge, migrator powinien zostać uruchomiony automatycznie.
Migrator pobierze z pliku
bukkit.yml
wartośćworld-container
i przejrzy ten folder szukając światów to przetransferowania. Jeśli nie znajdzie tego pliku (lub nie będzie w stanie go odczytać) to przeszuka za światami główny folder serwera (co jest domyślnym ustawieniem CraftBukkita).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 umieszcza rzeczy w dziwnych miejscach (i dziwnie je nazywa), przez co muszą zostać wprowadzone 2 ważne zmiany. Poprawki te są oparte tylko na założeniach (ze względu na strukturę Bukkita).
Pierwszą poprawką jest zmiana nazwy każdego folderu, którego nazwa zaczyna się od właściwości
level-name
i kończy nazwą wymiaru (_nether
/_the_end
) na odpowiednioDIM-1
iDIM1
.The second fix is to migrate up the
region
data within a Bukkit Vanilla nether/the_end. Bukkit puts this data intoDIM-1\region
andDIM1\region
respectively whereas Vanilla/Forge expectregion
to be in the root of the world’s folder structure.
Migrator nie jest w stanie zdobyć wszystkich potrzebnych wartości konfiguracji. Z tego powodu należy zmienić kilka opcji ręcznie, aby świat poprawnie działał po załadowaniu go na SpongeForge lub SpongeVanilla. Zaleca się skorzystać z wtyczki do zarządzania światami aby ustawić odpowiednie opcje i faktycznie załadować świat.
Informacja
Jak już wcześniej zostało wspomniane, migracja światów opiera się na kilku założeniach (które w niektórych przypadkach mogą okazać się nie do końca poprawne). Dlatego Sponge nie załaduje światów bezpośrednio, musisz skorzystać z wtyczki aby to zrobić.
Jeśli wszystko poszło dobrze, to logi generowane w konsoli podczas migracji powinny wyglądać mniej więcej tak:
[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.
Po zakończeniu migracji powinieneś mieć kopię Twoich światów w strukturze, którą Sponge może odczytać. Oryginalne pliki światów pozostają nietknięte w swoich dotychczasowych lokacjach, na wypadek gdyby coś poszło źle.
Pliki konfiguracji serwera i świata
Zarówno CraftBukkit jak i Sponge wykorzystują pliki, które są dostępne przez Minecraft. Pliki te mogą być ponownie użyte, jeżeli są obecne w aktualnej instalacji CraftBukkit:
server.properties
banned-ips.json
banned-players.json
ops.json
usercache.json
whitelist.json
Poniższe pliki są używane jedynie przez CraftBukkit więc mogą zostać usunięte jako, że nie są wykorzystywane przez Sponge:
bukkit.yml
commands.yml
help.yml
permissions.yml
Osoby migrujące ze Spigot mogą wykorzystać istniejący plik spigot.yml
. Niektóre elementy w spigot.yml
mają swoje odpowiedniki w global.conf
i możliwe jest przeniesienie wartości elementów, które występują w obydwu plikach.
Pluginy
Sponge nie ma wbudowanej obsługi pluginów Bukkit. Jendak kilku członków społeczności re-implementuje Bukkit API za pomocą specjalnej wtyczki Sponge, która ma umożliwić funkcjonowanie pluginów Bukkit na serwerze Sponge. Wtyczka ta jednak nie została jeszcze wydana.
Ore jest oficjalnym repozytorium pluginów Sponge i to właśnie pobieranie pluginów z niego jest zalecane. Podczas szukania zamienników dla pluginów Bukkit, weź pod uwagę poniższe kwestie:
Nie wszyscy deweloperzy pluginów na Bukkit zdecydowali się przenieść ich plugin na Sponge. W międzyczasie, może ktoś stworzy odpowiednik.
Nie wszystkie pluginy przeniesione na z Bukkit dokonają automatycznej konwersji plików konfiguracyjnych. To od twórców danego pluginu zależy czy zdecydują się oni na automatyczną konwersje czy nie.
Niektóre pluginy przeniesione z Bukkit, mogą mieć zmienioną funkcjonalność lub nawet korzystać z innej struktury konfiguracji.
Migrating from CanaryMod
Światy
Forge i tym samym SpongeForge (oraz SpongeVanilla), korzystają z tej samej struktury folderów świata co zwykły Minecraft. Umieszcza on wymiary nether (zwykle world_nether
) i end (zwykle world_the_end
) wewnątrz folderu world
.
Canary relocates the nether and end dimensions outside of the world
folder, which must be remedied if it is desired
to retain the nether and end dimensions when running Sponge. However, Canary provides an easy method to convert Canary
worlds to a structure usable by Sponge with the /makevanilla
command. If the world conversion is successful, the
output will be placed in the vanilla
folder.
Pliki konfiguracji serwera i świata
Sponge uses many files that are made available by vanilla Minecraft, such as server.properties
. Canary, however,
does not; the only file it has in common with vanilla Minecraft is usercache.json
. Thus, usercache.json
is the
only file from Canary that can be reused on Sponge.
Nevertheless, it is possible to manually migrate some Canary configuration files to their Sponge counterparts, which have been provided below.
Pliki Canary |
Odpowiedniki Sponge |
---|---|
server.cfg <świat>_<wymiar>.cfg |
Plik server.properties |
<świat>_<wymiar>.cfg |
global.conf <wymiar>/dimension.conf |
ops.cfg |
ops.json |
db.cfg |
Brak odpowiednika |
motd.txt |
Brak odpowiednika |
Pluginy
SpongeVanilla i SpongeForge nie posiadają wbudowanej obsługi pluginów Canary. Może być jednak możliwa re-implementacja Canary API za pomocą specjalnej wtyczki Sponge.
Ore to oficjalne repozytorium Sponge, w którym można znaleźć wtyczki. Zalecane jest pobierać wtyczki Sponge tylko z Ore. Szukając zamienników dla Twoich pluginów Canary, miej na uwadze, że:
Nie wszyscy twórcy pluginów Canary zdecydowali się przepisać swoje pluginy na Sponge API. W między czasie ktoś inny mógł jednak stworzyć wygodny ich odpowiednik.
Nie wszystkie wtyczki, które zostały przepisane z Canary automatycznie przekonwertują swoje pliki konfiguracyjne. To czy to zrobią zależy od decyzji poszczególnych twórców.
Niektóre z pluginów Sponge przepisanych z Canary mogą zmienić swoją funkcjonalność albo mogą korzystać z całkiem innej struktury konfiguracji.
Migracja z Forge
Migrating from a plain Forge server to a SpongeForge or SpongeVanilla server is a fairly simple process that needs little-to-no preparatory work.
Migracja na SpongeForge
You must first ensure you are running a version of Forge that is compatible with the version of SpongeForge your plan to use. You may find recommended builds of Forge at Forge Downloads. If you are using any other mods, they must also be updated.
When you are ready to install SpongeForge, you may proceed with the following steps:
Wyłącz swój serwer Forge jeśli jest uruchomiony.
Pobierz SpongeForge ze strony Sponge i Forge ze strony MinecraftForge.
Umieść
SpongeForge.jar
w folderzemods
.Uruchom serwer i baw się dobrze!
Informacja
Jeśli SpongeForge jest jedynym modem na serwerze, gracze będą mogli zalogować się korzystając z domyślnego clienta. Inne mody mogą wymagać od graczy instalacji Forge.
Migracja na SpongeVanilla
Ostrzeżenie
Jeśli migrujesz na SpongeVanilla: Stracisz wszystkie dane modów, bloki i moby - SpongeVanilla nie obsługuje modów Forge. Miej to na uwadze podczas wyboru pomiędzy SpongeForge i SpongeVanilla.
Proces migracji jest prawie identyczny jak powyżej:
Wyłącz swój serwer Forge jeśli nadal jest uruchomiony.
Pobierz SpongeVanilla i domyślny serwer od Mojang.
Umieść swoje światy i pliki konfiguracyjne w folderze serwera.
Włącz serwer uruchamiając plik
spongevanilla.jar
.
Migracja z Vanilla
Administrators of vanilla Minecraft servers can migrate to Sponge easily because Forge, and thus SpongeForge
(and SpongeVanilla), use the same world structure as vanilla Minecraft. Sponge also uses the same files used by
vanilla Minecraft, such as server.properties
.
Na początku powinieneś zdecydować czy chcesz korzystać z SpongeForge czy z SpongeVanilla.
Informacja
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.
Wyłącz swój serwer Vanilla jeśli nadal jest uruchomiony.
Pobierz SpongeVanilla lub SpongeForge.
Umieść swoje światy i pliki konfiguracyjne w folderze serwera.
Uruchom swój nowy serwer.
Instalowanie Sponge
Poradniki Instalacja SpongeForge i Instalacja SpongeVanilla zapewniają instrukcje na temat instalacji Sponge podczas migracji.