Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan Now×
Skip to content
World desk13 min

How to Switch Your Minecraft Server to Paper or PaperSpigot Safely

Learn the safe way to replace Vanilla, Spigot or CraftBukkit with Paper, handle the Minecraft 26.1 migration boundary, choose the right Java version, preserve worlds and plugins, and verify the server before players return.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Switching from Vanilla, Spigot, or CraftBukkit to Paper is usually a JAR-and-startup change, not a world reset. The safe sequence is: stop the server cleanly, make a complete copy of its directory, confirm the Paper build and Java version for your Minecraft release, replace the server JAR while preserving the startup filename, then test every world and plugin before players return.

Paper is commonly called “PaperSpigot” in older guides and community conversations. The important choice is the Paper build that matches your exact Minecraft version. A mismatched build, an unsupported Java runtime, or an incomplete backup can leave a server unable to start or make a migration difficult to reverse.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What changes when you switch to Paper?

Paper is a server implementation in the Bukkit ecosystem. It is designed as a drop-in replacement for CraftBukkit and Spigot, so Bukkit- and Spigot-format plugins generally continue to work without rewriting the world or changing player addresses. Paper also adds its own configuration and performance controls, which means you should inspect settings after the first launch rather than assuming every behavior is identical.

For a Vanilla server, Paper handles the required world-storage conversion automatically during the documented migration. A Spigot or CraftBukkit server is more version-sensitive because those implementations modify the Vanilla world-directory structure. Paper’s current documentation says a direct Spigot/CraftBukkit migration is fundamentally impossible from Minecraft 26.1 onward; those servers must pass through a Vanilla migration first. Fabric and Forge use the Vanilla world structure, but their mods are not Paper plugins and cannot simply be carried over.

#1 Best Overall
Minecraft | Java & Bedrock Deluxe Collection | Windows Digital Code
  • DELUXE COLLECTION — Includes Minecraft: Java & Bedrock Edition, three Bedrock add-ons, three exclusive Character Creator items, and 700 Minecoins.
  • CREATE YOUR WORLD — Build whatever you imagine in an infinite world that’s unique in every playthrough.
  • EXPLORE AND CRAFT — Discover biomes, resources, and mobs, then craft your way through a sandbox world filled with surprises.
  • SURVIVE THE ADVENTURE — Face mysterious foes, travel across exciting landscapes, and venture into perilous dimensions.
  • PLAY TOGETHER — Play cross-platform with friends in Bedrock Edition on console, mobile, and PC, or join community servers in Java Edition on PC, Mac, and Linux. Online console multiplayer requires a platform-specific subscription (sold separately).
Starting software Normal route Important limitation
Vanilla Back up, replace the Vanilla JAR with the matching Paper JAR, and start Paper. Paper performs the documented world-storage conversion automatically.
Spigot or CraftBukkit, before 26.1 A JAR replacement may be sufficient for the matching version. Check the version-specific Paper migration guidance before changing anything.
Spigot or CraftBukkit, 26.1 and later Spigot/CraftBukkit → Vanilla of the target version → Paper. Paper documents direct migration as impossible because the world directory was modified.
Fabric or Forge Use the Vanilla-to-Paper procedure for the world files. Fabric and Forge mods do not load as Paper plugins; modded content needs a replacement plan.

Changing the server software does not automatically change your IP address, port, whitelist, operator list, or player UUIDs. Those values live in the server files and hosting configuration, which is why a complete directory backup matters.

Prepare the server before touching the JAR

  1. Announce a maintenance window. Tell players when the server will stop and avoid making changes while anyone is still connected.
  2. Stop the server cleanly. Use the console’s normal stop command or the hosting panel’s stop control. Wait until the process exits and the panel no longer reports the server as running. Paper’s update guidance specifically warns not to replace a JAR in a running server.
  3. Copy the entire server directory. Store the copy outside the live directory and label it with the date, Minecraft version, and starting software. Include every world folder, custom dimensions, server.properties, whitelist and operator files, banned-player files, eula.txt, plugin folders, plugin configuration, scheduled-task data, logs, and the current server JAR.
  4. Check free disk space. A full copy temporarily requires roughly the size of the live directory again. Leave additional space for Paper’s first startup, logs, and world conversion.
  5. Record the current startup command. Note the JAR filename, memory values, JVM flags, working directory, and any panel setting that selects the server software. Paper can be downloaded with a long build filename, but the startup command must point to the name that actually exists.
  6. Inventory plugins and mods. Write down which plugins provide permissions, economy, maps, backups, portals, chat, scheduled jobs, or custom commands. For Fabric or Forge, make a separate list of blocks, items, entities, dimensions, and other modded data that Paper cannot provide.
  7. Confirm the target build and Java runtime. Download Paper for the exact Minecraft version, not merely the newest file. Verify that the host or machine can run the required Java major version before scheduling the migration.

Keep the original JAR and this backup untouched until the Paper server has survived a normal play session. A backup on the same disk is useful for quick recovery, but a second disk or remote copy protects you from disk failure as well.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Java versions Paper requires

Java compatibility depends on the Minecraft release. Paper’s 2026 documentation lists these minimum Java major versions:

Minecraft versions Java version listed by Paper
1.7.10–1.11 Java 8
1.12–1.16.4 Java 11
1.16.5 Java 16
1.17–1.19 Java 17
1.20–1.21.11 Java 21
26.1 and later Java 25

Use the Java version required by the Paper build you selected. On a machine with several Java installations, check the runtime that the service or panel actually uses rather than relying on the version in your interactive shell. A Java error before the Paper banner appears usually means the selected runtime is too old or the executable path is wrong.

Switch a Vanilla server to Paper

This is the most straightforward migration because Paper’s documented Vanilla procedure accounts for the world-storage conversion.

  1. Stop Vanilla and complete the backup. Do not copy only the world folder; preserve the configuration and startup files too.
  2. Download the Paper build for the exact Minecraft version. Keep the downloaded file in the server directory or upload it through your host’s file manager.
  3. Choose the JAR filename. Either rename the Paper file to the name used by your existing startup command, or edit the command to use the Paper filename. Matching these two names prevents “unable to access jarfile” errors.
  4. Leave the world and configuration files in place. Do not delete world, world_nether, world_the_end, custom world folders, server.properties, or player-data directories. Your server may use different world names, so preserve every folder referenced by the configuration.
  5. Start Paper from the server directory. A basic command from Paper’s getting-started guidance is:
java -Xms4G -Xmx4G -jar paper.jar --nogui

Adjust the memory values to suit the machine and workload; 4 GB is an example, not a universal requirement. Run the command in the directory containing paper.jar and the world files. If you normally use a service file, script, or panel, update that launch target instead of starting a second process manually.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Minecraft | Java & Bedrock Ultimate Collection | Windows Digital Code
  • ULTIMATE COLLECTION — Includes Minecraft: Java & Bedrock Edition, five Bedrock add-ons, five exclusive Character Creator items, and 1000 Minecoins.
  • CREATE YOUR WORLD — Build whatever you imagine in an infinite world that’s unique in every playthrough.
  • EXPLORE AND CRAFT — Discover biomes, resources, and mobs, then craft your way through a sandbox world filled with surprises.
  • SURVIVE THE ADVENTURE — Face mysterious foes, travel across exciting landscapes, and venture into perilous dimensions.
  • PLAY TOGETHER — Play cross-platform with friends in Bedrock Edition on console, mobile, and PC, or join community servers in Java Edition on PC, Mac, and Linux. Online console multiplayer requires a platform-specific subscription (sold separately).
  1. Accept the EULA if required. A first launch can stop and ask you to set eula=true in eula.txt. Make that change only after reading and accepting Mojang’s EULA, then start the server again.
  2. Wait for the ready message. The first Paper launch can take longer while files are converted or caches are created. Do not kill the process during world conversion.
  3. Stop Paper once it is ready and inspect the files. Confirm that all expected dimensions and player data are present before allowing connections. Then start it again for testing.

Paper’s automatic conversion does not make a backup unnecessary. If a conversion is interrupted or a plugin changes data on first launch, the untouched copy is your reliable rollback point.

Switch Spigot or CraftBukkit to Paper

Versions before Minecraft 26.1

Paper describes itself as a drop-in replacement for CraftBukkit and Spigot. For older Minecraft releases, replacing the server JAR with the matching Paper build may be sufficient, but “older” does not mean risk-free. Stop the server, preserve the complete backup, confirm the exact version, and follow the migration notes for that release. Keep the old JAR available until worlds, plugins, permissions, and scheduled tasks have been tested.

Minecraft 26.1 and later

Do not make a direct Spigot/CraftBukkit-to-Paper swap for 26.1 or newer. Paper’s current migration guidance states that Spigot and CraftBukkit modify the Vanilla world-directory structure, making direct migration from 26.1 fundamentally impossible. Use this staged route instead:

  1. Stop Spigot or CraftBukkit and make a full, restorable copy.
  2. Use the target Minecraft version’s Vanilla server as the intermediate software, following Paper’s documented Spigot/CraftBukkit-to-Vanilla procedure.
  3. Start the Vanilla intermediate on the copied data and allow it to complete its conversion. Stop it cleanly after it reaches a ready state.
  4. Replace the Vanilla JAR with the matching Paper build and complete the normal Vanilla-to-Paper steps.
  5. Check every dimension and custom world before reconnecting players.

Do not improvise by copying only region files or by merging directories from different versions. The intermediate step exists specifically to normalize the world structure; skipping it can produce missing dimensions, unreadable data, or a server that appears to start while silently omitting content.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Switch a Fabric or Forge server to Paper

Fabric and Forge use the Vanilla world-directory structure, so the Vanilla migration sequence can be used for the world files. The software ecosystems are not interchangeable, however. Paper does not support Fabric or Forge mods.

Rank #3
Minecraft | Standard Edition | XBOX Digital Code
  • CREATE YOUR WORLD — Build whatever you imagine in an infinite world that is unique in every playthrough.
  • EXPLORE AND CRAFT — Discover biomes, resources, and mobs, then craft your way through a sandbox world full of surprises.
  • SURVIVAL ADVENTURES — Face mysterious foes, travel across varied landscapes, and venture into perilous dimensions.
  • PLAY TOGETHER — Play solo or join friends in local split-screen and cross-platform play across console, mobile, and PC. Online multiplayer supports up to 8 players.
  • COMMUNITY PLAY — Connect with players on community servers, or subscribe to Realms Plus (sold separately) to play with up to 10 friends on a private server.

Any mod that added blocks, items, entities, dimensions, inventories, machines, or custom data requires special attention. Paper cannot load those features merely because the world folder is present. Before migration, identify the modded content players rely on and decide whether a Paper plugin can replace it, whether the affected content can be removed safely, or whether that world must remain on Fabric or Forge.

Test the migration on a copy first. If a modded block or item is removed during conversion, restoring the original backup is safer than attempting to reconstruct the data after the fact.

Changing the JAR in a managed hosting panel

Panels use different labels, but the operational requirements are the same. The host must permit a custom server JAR or provide Paper as a selectable server type, and you must be able to select a compatible Java runtime.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Stop the server from the panel and wait for its status to show that the process has exited.
  2. Use the panel’s file manager, SFTP, or upload tool to place the Paper JAR in the server’s root directory.
  3. Set the startup-JAR field, server-type selector, or startup command to the exact filename you uploaded. If the panel generates a command automatically, verify that it no longer points to the old Vanilla or Spigot file.
  4. Choose the Java major version required by your Minecraft release. If the panel does not offer that version, contact the host before proceeding rather than forcing an older runtime.
  5. Take or download the host’s backup, then retain your own complete copy as well.
  6. Start the server and keep the console open. Stop immediately if the log shows a world-loading, Java, or plugin failure that you do not understand.

Some panels regenerate files when you change server type. Read the panel’s warning before confirming and make sure it will not overwrite worlds, plugin folders, or configuration. If custom JAR uploads are prohibited, the practical choices are the panel’s supported Paper installation or a host that allows the required file and Java controls.

Plugin compatibility and configuration checks

Bukkit and Spigot plugins generally fit Paper’s plugin ecosystem, but “generally” is not a guarantee for every release. A plugin compiled for a different Minecraft version can fail to load, disable itself, or behave incorrectly after the server starts.

Rank #4
Minecraft
  • Skins! We have biome settlers, city folk, town folk, and more!
  • The Nether and all its inhabitants. Fight Ghasts and make friends with Pigmen
  • Cross platform play for up to five players between Pocket Edition and Windows 10
  • Revamped touch controls, controller support, and a controller mapping screen
  • Enhanced Weather effects! Accumulating snow and more
  • Use plugin releases that explicitly support the target Minecraft and Paper/Spigot API version.
  • Read the startup log for messages identifying disabled plugins, missing dependencies, invalid commands, or configuration migrations.
  • Do not copy a plugin’s old configuration over a newly generated file until you understand version changes. Preserve the old file in the backup, then merge settings deliberately.
  • Verify permission groups, operator status, economy balances, homes, claims, warps, inventories, and player statistics.
  • Check plugins that run on timers: backups, restarts, announcements, map rendering, database exports, and scheduled commands.
  • Test commands from both an operator account and an ordinary player account. A command that works as an operator may still fail because a permission node changed.

Paper-specific settings can affect behavior even when the plugin itself loads. Review the generated Paper configuration after the first successful startup and change one setting at a time, keeping a copy of the known-good files.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Post-switch verification before reopening the server

Use a private maintenance test with at least one operator account and one normal player account. Work through the checks below rather than relying only on the console’s final “done” message.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Startup health: the process reaches a ready state without Java exceptions, repeated restarts, or unresolved plugin dependencies.
  • Worlds and dimensions: the main world, Nether, End, and every custom world appear with the expected names and terrain. Visit portals in both directions.
  • Player data: test an existing player’s inventory, location, advancements, statistics, ender chest, homes, claims, and permissions.
  • Gameplay mechanics: break and place blocks, use containers, trade, travel through portals, use command blocks if enabled, and test redstone or other mechanics central to your community.
  • Commands and permissions: check essential commands as an administrator and as a restricted player. Confirm the whitelist, operator list, bans, and chat controls.
  • Scheduled work: wait for or manually trigger one backup, restart task, announcement, database job, or map update that the server depends on.
  • Networking: connect from a client using the usual address and port. Confirm that the firewall, query settings, and proxy configuration still point to the same process.
  • Logs and storage: verify that logs are being written, the server can create new region files, and the disk is not approaching capacity.

Observe the server through a normal play session before deleting the old JAR or treating the migration as complete. Keep the backup and rollback files until you have confirmed that routine backups can be restored.

Troubleshoot the most common failures

“Unable to access jarfile” or the panel starts the old software

The startup command and uploaded filename do not match, or the working directory is wrong. List the files in the server directory, correct the JAR field or command, and ensure the process starts from the directory containing the JAR.

Java reports an unsupported class version

The selected Java runtime is older than the Paper build requires. Select the Java major version from Paper’s compatibility table for your Minecraft release, then restart. If the host cannot provide it, do not downgrade the Paper JAR at random; choose a supported hosting runtime or machine.

Best Value
Minecraft - Bedrock Edition PS4
  • Play and share with friends on console, mobile and Windows 10
  • discover community creations in the new in-game store
  • access new mini games and game modes through servers

The server stops immediately after launch

Read the first error before the shutdown message. Common causes include an unaccepted EULA, a missing dependency, a corrupted upload, insufficient disk space, or a plugin compiled for another version. Restore the backup on a separate test directory if you need to isolate the cause.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A plugin is disabled or throws errors

Confirm that the plugin supports the target Minecraft/Paper version and that every required dependency is present. Remove only the offending plugin from the live test copy, not from your backup, and retest. Replacing a plugin may require migrating its configuration or database.

A world, dimension, or player appears missing

Stop the server and compare the live directory with the backup. Check the configured world name and all dimension folders. For a Spigot/CraftBukkit server on 26.1 or later, verify that you completed the required Vanilla intermediate migration; a direct swap is not a supported recovery path.

Modded blocks or items disappeared

This is expected when Fabric or Forge content has no Paper equivalent. Stop the test server, restore the original modded backup, and decide on plugin replacements or a separate modded server before attempting another conversion.

Players can connect but gameplay behaves differently

Compare plugin versions and Paper configuration, then test one change at a time. Record each adjustment so you can revert it. Do not apply unrelated performance flags while diagnosing a migration; first establish that the worlds and plugins are intact.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Rollback and future updates

To roll back, stop Paper cleanly, move the Paper directory aside, restore the untouched pre-migration copy, and start the original server software with its original Java requirement. Do not point an old server at files that Paper has already modified unless the software’s documentation explicitly says that downgrade is safe. If players have made new progress on Paper, those changes may not be representable in the old copy; this is why the backup must be taken before the first Paper launch.

For later Paper updates, repeat the same discipline: confirm the Minecraft version and Java requirement, read the release-specific notes, back up first, stop the process, replace the JAR while it is offline, and inspect logs and gameplay after startup. Never overwrite a running JAR.

Quick Recap

Bestseller No. 4
Minecraft
Minecraft
Skins! We have biome settlers, city folk, town folk, and more!; The Nether and all its inhabitants. Fight Ghasts and make friends with Pigmen
$6.99
Bestseller No. 5
Minecraft - Bedrock Edition PS4
Minecraft - Bedrock Edition PS4
Play and share with friends on console, mobile and Windows 10; discover community creations in the new in-game store
$42.98

Choosing between Vanilla, Spigot, and Paper for this migration

Decision factor What to verify
Migration path Vanilla is direct; older Spigot/CraftBukkit may allow a replacement; Spigot/CraftBukkit 26.1+ requires a Vanilla intermediate; Fabric/Forge requires a mod-replacement plan.
Java Use the Java major version required for the exact Minecraft/Paper release, from Java 8 through Java 25 as listed above.
Extensions Bukkit/Spigot plugins generally transfer; Fabric and Forge mods do not transfer as Paper plugins.
World data Preserve every world and dimension folder. Paper handles the documented Vanilla conversion; version-sensitive Spigot/CraftBukkit conversions need the correct intermediate route.
Recovery Keep a complete offline backup, the original JAR, and a recorded startup command until normal play and backup restoration have been tested.
Hosting controls Confirm that the panel allows custom JARs or Paper selection, the required Java runtime, file uploads, and reliable backups.
Performance expectations Paper’s configuration and implementation target server efficiency, but no universal performance percentage applies. Results depend on hardware, view distance, plugins, world size, and player activity.

The safe sequence in one checklist

  1. Schedule maintenance and stop the current server cleanly.
  2. Copy the complete server directory and preserve the current JAR.
  3. Match Paper and Java to the exact Minecraft version.
  4. Use the direct Vanilla procedure, the version-appropriate older Spigot/CraftBukkit procedure, or the required Vanilla intermediate for 26.1+.
  5. Keep the startup filename aligned with the command or hosting-panel setting.
  6. Start Paper offline, read the full log, and resolve Java or plugin errors.
  7. Verify worlds, dimensions, player data, permissions, portals, scheduled jobs, backups, and network access.
  8. Only reopen to players after a normal test session, and retain the backup for rollback.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.