Van vanilla naar Paper migreren zonder je wereld te breken

Van vanilla naar Paper overstappen is in de kern één handeling: je stopt de server, vervangt de server-jar en start opnieuw op. Je wereld hoeft niet geconverteerd te worden, want Paper leest en schrijft exact hetzelfde wereldformaat als de vanilla-server van Mojang. Wat wél verandert is de configuratie: na de eerste start staan er vier nieuwe bestanden klaar (bukkit.yml, spigot.yml, config/paper-global.yml en config/paper-world-defaults.yml), en de standaardwaarden daarin kunnen redstone-timings, mob-spawns en bestaande farms anders laten lopen dan je gewend bent.

Waarom blijft je wereld gewoon werken?

Paper is een fork van Spigot, dat op zijn beurt een fork is van de vanilla-server. Alle drie schrijven ze dezelfde regionbestanden weg in world/region, plus dezelfde level.dat, playerdata en entity-mappen. Er zit geen conversiestap tussen, geen import en geen migratiescherm.

Praktisch betekent dat: gebouwen, kisten met inhoud, spelerinventarissen, advancements, dorpen en je seed blijven staan zoals ze waren, en ook server.properties, ops.json en whitelist.json worden ongewijzigd meegenomen. Wat Paper toevoegt komt ernaast te staan, niet erin: een set configuratiebestanden en een plugins-map.

Hoe migreer je stap voor stap?

1. Stop de server netjes. Gebruik /stop of de stopknop in je paneel, nooit een harde kill. Alleen dan worden alle geladen chunks en spelerdata volledig weggeschreven.
2. Maak een back-up van de hele servermap. Dus niet alleen world, maar ook world_nether, world_the_end en je losse json-bestanden. Bij MC-Node draaien automatische back-ups standaard mee, maar maak vlak voor een migratie altijd nog een handmatige: eentje van vijf minuten oud is meer waard dan die van vannacht.
3. Pak de Paper-build voor exact jouw versie. Draai je 1.21 "Tricky Trials", nog altijd de meest gespeelde versie op Nederlandse servers, neem dan een 1.21-build en spring niet meteen door naar 26.1 of 26.2. Een versie-upgrade en een softwarewissel tegelijk maken foutzoeken onnodig lastig.
4. Vervang de jar. Upload de Paper-jar en wijs je startcommando ernaar; in het Pterodactyl-paneel doe je dat onder Startup. Laat de oude vanilla-jar gewoon staan, die is je snelste terugweg.
5. Controleer je Java-versie. Minecraft 1.21 en nieuwer draait op Java 21. Een omgeving die nog op Java 17 staat, start de server niet op.
6. Start op en lees de console mee. Deze eerste start duurt langer dan normaal, omdat alle configuratiebestanden worden aangemaakt.
7. Controleer in de wereld zelf. Join, typ /version om te bevestigen dat je op Paper draait, en loop je belangrijkste bouwwerken, farms en portals na. Laat de server daarna een half uur draaien voordat je iedereen terugstuurt, zodat je ziet of de TPS stabiel blijft.

Welke configuratiebestanden verschijnen er na de eerste start?

Vanilla kent alleen server.properties. Paper voegt daar vier lagen aan toe, elk met een eigen herkomst.

paper-world-defaults.yml geldt als standaard voor al je werelden. Wil je één wereld afwijkend instellen, dan maak je een paper-world.yml in de map van die wereld; wat daar staat wint van de defaults. Verander op de migratiedag zelf bij voorkeur niets.

Welke vanilla-mechanieken kunnen anders gaan lopen?

Paper haalt zijn winst grotendeels uit het minder vaak of minder precies simuleren van dingen die er zelden toe doen. Op de meeste servers merkt niemand dat. Leunt jouw wereld op exact vanilla-gedrag, dan wringt het op vier plekken.

Redstone. Paper laat je via misc.redstone-implementation in paper-world-defaults.yml kiezen tussen de vanilla-implementatie en twee snellere alternatieven (Eigencraft en Alternate Current). Die alternatieven zijn goedkoper qua rekenwerk, maar niet in alle randgevallen identiek. Schakelingen die op de exacte updatevolgorde leunen, zoals instant repeaters, bepaalde zuigertrucs en 0-tick-constructies, kunnen daardoor haperen of vastlopen.

Mob-spawning. Paper kan de mobcap per speler verdelen in plaats van serverbreed. Dat is eerlijker op een drukke server, maar het verandert wel de opbrengst van een mobfarm. Daar bovenop staan de spawn-limits in bukkit.yml en de mob-spawn-range in spigot.yml.

Entity activation range. Entiteiten die ver genoeg van een speler af staan, krijgen minder ticks. Mobs in een farm lijken dan te bevriezen, dorpelingen stoppen met werken en transportlijnen lopen achter zodra je wegloopt. Hier komen in de praktijk de meeste "mijn farm is stuk"-meldingen vandaan.

Items en spawners. Losse items en ervaringsbollen worden over een grotere afstand samengevoegd dan in vanilla: prettig voor de prestaties, vervelend voor farms die items per stuk tellen. En staat nerf-spawner-mobs aan, dan krijgen mobs uit een spawner geen AI meer.

Hoe draai je dat vanilla-gedrag weer terug?

Bijna alles is een configuratieregel. Werk één ding per keer af, herstart en test.

Elk stukje vanilla-gedrag dat je terugzet, kost je prestatiewinst. Met een handvol spelers is dat geen probleem, op een drukke survivalserver wel. Meet het effect met de plugin spark in plaats van het te gokken; welke knoppen er verder nog zijn, staat in ons artikel over het optimaliseren van je Minecraft-server.

Kun je later terug naar vanilla?

Technisch: ja, meestal probleemloos. Je stopt de server, zet de vanilla-jar terug en start op; de wereld laadt gewoon, want het formaat is hetzelfde gebleven. Toch is de weg terug niet symmetrisch.

Wat je kwijtraakt zijn de plugins en alles wat zij bijhielden. De rangen in LuckPerms, de homes van EssentialsX, de claims van GriefPrevention en de rollback-geschiedenis van CoreProtect staan nog wel als bestand of database op schijf, maar doen niets meer zodra vanilla draait. Beschermde regio's zijn dan simpelweg niet meer beschermd, en op een openbare server is dat binnen een dag zichtbaar. Daarnaast gaat Paper-specifieke data verloren: extra gegevens die plugins aan items, entiteiten of blokken hingen, en de configuratie in de paper-bestanden. Vanilla kent die velden niet en bewaart ze niet.

Gebruikte je een plugin die terrein genereerde, dan kun je bovendien zichtbare naden krijgen tussen oude en nieuwe chunks. Bewaar dus ook een back-up van vlak vóór de stap terug.

Waarom test je eerst op een kopie?

Omdat een migratie zelden op de jar misgaat, maar op iets wat je pas dagen later merkt: die ene ijzerfarm die stilstaat, een klok die niet rond komt, een plugin die net niet met jouw versie overweg kan.

De goedkoopste variant is een kopie van je wereldmap downloaden en er lokaal een Paper-server op zetten. Wil je dichter bij de echte situatie zitten, inclusief netwerk en plugins, dan zet je tijdelijk een tweede server op. Een testserver van 2 GB kost op de budgetlijn van Minecraft-hosting bij MC-Node 2,20 euro per maand, oftewel 1,10 euro per GB, en die zeg je daarna weer op. Ga je tegelijk plugins installeren, doe dat dan ook eerst daar; welke je waarvoor nodig hebt staat in ons overzicht van de beste Minecraft-plugins.

Wanneer is Paper niet de juiste keuze?

Paper is voor de meeste servers de standaardkeuze, maar niet voor alle. Wil je echt nieuwe blokken, items, mobs of dimensies, dan heb je mods nodig en geen plugins. Plugins draaien uitsluitend server-side op verder vanilla mechanieken; mods worden geladen door Forge, NeoForge, Fabric of Quilt en moeten op server én client in dezelfde versie staan. Dat is een andere route, die we uitleggen in ons artikel over modpacks.

Draai je een technische server waar farms tot op de tick vanilla moeten blijven, dan is doorgaan op vanilla eerlijker dan Paper installeren en daarna de helft weer terugdraaien. Kijk ook niet te snel verder naar de forks. Purpur voegt extra configuratie-opties en optionele features toe zoals berijdbare mobs en instelbare mob-AI, volledig compatibel met Paper-plugins, maar dat is een stap ná Paper; Pufferfish zit qua doel daartussenin. En Folia, het experimentele multithreaded Paper, is alleen zinvol bij zeer hoge spelersaantallen die verspreid over de kaart zitten en breekt de meeste bestaande plugins.

Veelgestelde vragen

Moet ik mijn wereld converteren als ik naar Paper overstap? Nee. Paper gebruikt hetzelfde wereldformaat als de vanilla-server, dus regionbestanden, level.dat en playerdata blijven ongewijzigd bruikbaar; je vervangt alleen de jar. Maak vooraf wel een handmatige back-up van de hele servermap.

Blijven mijn redstone-machines werken na de overstap? Meestal wel, maar schakelingen die op de exacte vanilla-updatevolgorde leunen kunnen anders lopen. Paper laat je via misc.redstone-implementation in config/paper-world-defaults.yml kiezen tussen de vanilla-implementatie en twee snellere alternatieven. Zet hem op vanilla als je klok of farm het niet meer doet.

Kan ik van Paper terug naar vanilla? Ja, meestal: jar terugzetten en opstarten, de wereld laadt gewoon. Je verliest wel alle plugins en hun functie, dus LuckPerms-rangen, EssentialsX-homes, GriefPrevention-claims en de rollback-geschiedenis van CoreProtect doen niets meer. Paper-specifieke data die plugins aan items of entiteiten hingen, komt niet terug.

Welke Minecraft-versie kies ik bij de migratie? Dezelfde die je nu draait. 1.21 "Tricky Trials" met de Trial Chambers, Vaults en de Mace is nog altijd de meest gespeelde versie op Nederlandse servers; daarna kwamen 26.1 "Tiny Takeover" en 26.2 "Chaos Cubed", en 26.3 zit nog in snapshots. Spring pas over als Paper stabiel draait.

Heb ik meer RAM nodig voor Paper dan voor vanilla? Nee, een Paper-server met plugins vraagt niet meer geheugen dan dezelfde vanilla-wereld. Echt zwaar wordt het pas bij modpacks: All the Mods 10 vraagt minimaal 10 GB, 12 GB voor een kleine groep en 14 tot 16 GB bij vijf of meer spelers.

Verder lezen

• Velocity of BungeeCord: een netwerk van servers bouwen
• Geyser en Floodgate: Bedrock-spelers op je Java-server
• WorldEdit en WorldGuard: bouwen en beschermen op je server