Je eigen wereld uploaden naar een Minecraft-server (en weer downloaden)

Wil je op je server spelen in een wereld die je in singleplayer hebt gebouwd, of een wereld van een andere hostingprovider overzetten? We laten zien waar je de wereld op je computer vindt, waar je hem op de server uploadt afhankelijk van de versie en het servertype, en hoe je hem later weer downloadt.

Waar de wereld op de server staat#

De wereld is een map in de hoofdmap van de server. De naam ervan wordt bepaald door de instelling level-name (standaard world, zie server.properties). In de map moet het bestand level.dat staan: daaraan herkent de server dat het een wereld is.

Hoe de map eruitziet, hangt af van de versie en het servertype:

• In versie 26.1 heeft Mojang de opslag van de wereld omgebouwd: alle dimensies staan in de map dimensions en de spelergegevens in de map players. Een oudere wereld converteert de server bij de eerste start vanzelf.
• Paper sloeg de Nether en de End tot en met versie 1.21.x op in aparte mappen naast de wereld. Een wereld in Vanilla-formaat splitst Paper bij de eerste start vanzelf. Vanaf versie 26.1 slaat Paper de wereld op dezelfde manier op als Vanilla.

De wereld op je computer voorbereiden#

1. Sluit de wereld in het spel af (Save and Quit to Title), zodat alles wordt opgeslagen.
2. Zoek de map met de werelden:

Gebruik je een andere launcher (Modrinth App, CurseForge, Prism Launcher), dan staan de werelden in de map saves van de betreffende instantie. Je vindt die in de launcher door de map van de instantie te openen.

3. Elke wereld is één map (met dezelfde naam als de wereld in het spel). Controleer of het bestand level.dat er direct in staat.
4. Controleer de versie: in het spel zie je in de lijst met werelden bij de wereld in welke versie hij het laatst is gespeeld. De server moet dezelfde of een nieuwere versie hebben. Een oudere wereld converteert de server, een nieuwere niet: een downgrade beschadigt de wereld.

Uploaden naar de server#

1. Klik op het tabblad Back-ups op Back-up maken en wacht tot die klaar is.
2. Klik op het tabblad Console op Stoppen en wacht tot de server is gestopt.
3. Klik op het tabblad Bestanden bij de map world op Hernoemen en voer bijvoorbeeld world-oud in. Zo blijft de oude wereld op de schijf staan (je kunt hem later verwijderen om ruimte vrij te maken). Hernoem bij Paper tot en met versie 1.21.x op dezelfde manier ook world_nether en world_the_end.
4. Upload de map van de wereld op een van deze twee manieren:

Voor toegang via SFTP neem je contact op met support. De algemene werkwijze met een SFTP-client vind je in de handleiding Verbinden met een VPS. De gegevens voor de server krijg je apart van ons.

5. Hernoem de geüploade map naar world (of naar de naam uit level-name).

6. Open de map en controleer of het bestand level.dat er direct in staat. Een veelgemaakte fout is een map in een map (world/MijnWereld/level.dat): de server zou dan een nieuwe wereld aanmaken.

7. Klik op het tabblad Console op Starten.

   Komt de wereld uit een oudere versie, dan zie je in de console de voortgang van de conversie, bijvoorbeeld Upgrading progress: 38%. Bij een grote wereld kan de conversie enkele minuten duren. Onderbreek de server niet.

Een andere mapnaam#

Wil je de map onder een andere naam laten staan (bijvoorbeeld bouwwerken), hernoem hem dan niet. Wijzig in plaats daarvan op het tabblad Serverinstellingen, in de groep Wereld, de instelling Map van de wereld (level-name) in bouwwerken en klik op Opslaan en herstarten. De naam mag alleen letters zonder accenten, cijfers, spaties, _ en - bevatten.

Inventaris en positie van spelers#

• Bij een singleplayerwereld tot en met versie 1.21.x is je inventaris direct in level.dat opgeslagen. De server gebruikt die niet: op de server begin je met een lege inventaris bij de spawn. Leg je spullen vóór het overzetten in een kist.
• Vanaf versie 26.1 worden de spelergegevens opgeslagen in de map players/data, op basis van de UUID van het account. Heb je de wereld gespeeld terwijl je was ingelogd met hetzelfde account als waarmee je met de server verbindt, dan zou je inventaris behouden moeten blijven.
• Een wereld van een andere server bevat de gegevens van alle spelers (playerdata, vanaf 26.1 players/data), dus de inventarissen blijven behouden.

De wereld van de server downloaden#

Op het tabblad Bestanden kun je alleen losse bestanden downloaden, geen hele mappen. De hele wereld download je via een back-up:

1. Klik op het tabblad Back-ups op Back-up maken en wacht tot die klaar is.
2. Klik bij de back-up op Downloaden. Je browser downloadt een archief van de hele server (.tar.gz).
3. Pak het archief uit (Windows 10 en 11: het commando tar -xzf <FILE> in PowerShell of het programma 7-⁠Zip; macOS en Linux: tar -xzf <FILE> in de terminal). De stappen staan uitgebreid in de handleiding Back-ups van gameservers.
4. Kopieer uit het uitgepakte archief de map world (bij Paper tot en met 1.21.x ook world_nether en world_the_end) naar de map saves op je computer.

Zonder back-upslot kun je de wereld via SFTP downloaden (vraag support om toegang).

Een wereld van Paper naar singleplayer#

Paper slaat de wereld iets anders op dan het spel. Pas hem aan op basis van de versie voordat je hem in het spel opent:

• Paper tot en met 1.21.x: kopieer de map world_nether/DIM-1 naar de map world en op dezelfde manier world_the_end/DIM1 naar world. Anders zouden de Nether en de End er als nieuw uitzien.
• Paper 26.1 en nieuwer: verplaats de bestanden game_rules.dat, scheduled_events.dat, wandering_trader.dat, weather.dat en world_gen_settings.dat uit de map world/dimensions/minecraft/overworld/data/minecraft/ naar world/data/minecraft/.

Een wereld van een andere hostingprovider#

1. Download bij je vorige hostingprovider een back-up of de hele map van de wereld (bij Paper tot en met 1.21.x alle drie de mappen).

2. Ga na op welke versie en welk servertype de wereld draaide. Stel op onze server op het tabblad Software dezelfde of een nieuwere versie in (handleiding).

   Draaide de wereld op Spigot of CraftBukkit (niet op Paper), dan waarschuwt de documentatie van Paper dat rechtstreeks overstappen naar Paper 26.1 en nieuwer niet kan. De wereld moet eerst volgens de documentatie van Spigot naar Vanilla-formaat worden omgezet en kan pas daarna worden geüpload.

3. Upload de wereld volgens de stappen hierboven.

4. Plugins en hun gegevens (gebiedsbescherming, economie, rechten) staan in de map plugins, niet in de wereld. Zet ze apart over als je ze wilt behouden.

Controle#

1. Verbind met de server. Je zou bij de spawn van de geüploade wereld moeten verschijnen en je bouwwerken moeten zien.
2. Voer in de console seed in. Het resultaat moet overeenkomen met de seed van jouw wereld (in singleplayer vraag je die met hetzelfde commando op).
3. Ga door een portaal naar de Nether en controleer of het jouw Nether is en geen nieuw gegenereerde.

Als iets niet werkt#

De server heeft een nieuwe wereld gegenereerd in plaats van de mijne#

• De map heeft niet de naam uit level-name (standaard world), of de wereld zit in nog een extra map (world/MijnWereld/level.dat).
• In de map ontbreekt level.dat (je hebt maar een deel van de bestanden geüpload).

De server heeft de nieuwe wereld aangemaakt in de map uit level-name. Stop de server, verwijder of hernoem die map en upload de wereld opnieuw, nu op de juiste manier.

De Nether of de End ontbreekt (ze zijn nieuw)#

• Paper tot en met 1.21.x: de mappen world_nether en world_the_end ontbreken. Heb je een wereld uit het spel geüpload, dan moet die DIM-1 en DIM1 bevatten. Paper verplaatst ze bij de eerste start vanzelf.
• Overstap van Paper naar een ander servertype (Vanilla, Fabric) in een oudere versie: de Nether en de End staan in aparte mappen die andere servers niet laden. Verplaats ze volgens het gedeelte Een wereld van Paper naar singleplayer.

Het bestand is groter dan 100 MB. Upload het met een SFTP-client (bijv. FileZilla).#

Het tabblad Bestanden uploadt maximaal 100 MB per bestand. Gebruik SFTP: voor toegang neem je contact op met support.

De wereld komt uit een nieuwere versie dan de server#

De server laadt hem niet, of beschadigt hem. Stel op het tabblad Software dezelfde of een nieuwere Minecraft-versie in en upload de wereld pas daarna.

Failed to load datapacks, can't proceed with server load.#

De wereld bevat een datapack voor een andere versie. De oplossing vind je in het artikel Veelvoorkomende fouten van een Minecraft-server.

Meer bronnen#

• Migreren van en naar Paper (documentatie van Paper) (opent in een nieuw venster)
• Het wereldformaat van Java Edition op de Minecraft Wiki (opent in een nieuw venster)