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 DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix Now×
Skip to content
World desk11 min

How to Install a Custom Server JAR on a Minecraft Server

A practical guide to replacing a Minecraft Java server JAR on a local machine or hosting panel, with exact startup commands, Java compatibility tables, Fabric and Paper requirements, and rollback troubleshooting.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To install a custom Minecraft: Java Edition server JAR, stop the server, back up its world and settings, upload the correct server software to the server directory, and configure the startup command or hosting panel to use the file’s exact name. Then run it with the Java version required by that software, complete the first-launch EULA step, and verify the log before allowing players to connect.

This process works for vanilla, Paper, Fabric, and other Java Edition server software, but the files and compatibility rules differ. A Paper JAR is not a Fabric installation, and a Fabric installation may include a launcher, a vanilla server JAR, libraries, and properties files rather than one self-contained file.

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 “custom server JAR” means

A server JAR is the Java program that runs a Minecraft server. “Custom” normally means replacing the default vanilla server program with another server implementation or loader, such as Paper for plugin-focused servers or Fabric for modded servers. It can also mean using a differently named vanilla JAR, a specific build for a particular Minecraft release, or a launcher supplied by a project.

The filename itself is not the important part. The startup command or panel must point to the file that is actually present in the server directory. If the file is named paper-1.21.10-123.jar, a command that still references paper.jar will fail unless you rename the file or change the command.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.

The instructions below are for Minecraft: Java Edition. Mojang states that a compatible Java Runtime Environment is required to launch the server JAR. If people outside the machine or local network must connect, firewall and, where applicable, router port-forwarding settings are separate networking tasks that must also be configured.

Check these details before changing anything

Write down the target configuration before downloading a file. This prevents a common mistake: installing software for one Minecraft release while the world, plugins, or mods were created for another.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Minecraft version: Record the exact release the server should run, including whether it is an older or newer point release.
  • Server software: Decide whether the target is vanilla, Paper, Fabric, or another loader.
  • Extensions: List the plugins or mods that must load. Plugins and mods are not interchangeable.
  • Java requirement: Check the software project’s compatibility table before starting the server.
  • Host rules: Confirm whether the panel allows a custom JAR, requires a particular filename, or provides a separate server-type selector.
  • Access method: Have the panel file manager, upload tool, or SFTP access ready. For a local server, identify the directory containing the current startup script and world.

Do not delete the existing installation while experimenting. A backup gives you a way back if the new software cannot read the world or an extension is incompatible.

Choose the right server software

Software Typical use Java compatibility stated by the project Files and launch model World and extension considerations
Vanilla Official, unmodified Java Edition server A compatible Java Runtime Environment is required; use the requirement published for the selected Minecraft release. Usually one official server JAR, launched from the server directory. Does not provide the plugin or mod systems supplied by third-party server software.
Paper Plugin-oriented server software that can replace a vanilla JAR Paper’s table lists Java 21 for Minecraft 1.20–1.21.11 and Java 25 for Minecraft 26.1 and newer. Runnable JAR; the filename in the command must match the downloaded file. Paper can replace vanilla, but it cannot load Fabric or Forge worlds containing mod-added blocks, items, or other data.
Fabric Mod-loader installation for Fabric-compatible mods Java 17 for Minecraft 1.17–1.20.4; Java 21 for Minecraft 1.20.5 and newer. The executable Fabric Server Launcher can be a drop-in replacement for a vanilla JAR on supported hosts, panels, and scripts. Manual installations can also require a vanilla server.jar, libraries, and properties files. Use the Fabric loader and its complete file set for worlds and content that depend on Fabric mods.

These choices are not interchangeable. Select the software that matches the world and the extensions you intend to use, not simply the one with the shortest command.

Install a custom JAR on a local or self-managed server

1. Back up the complete installation

Stop making changes while the server is running and copy the world directories, configuration files, extension directories, and startup script or panel settings. Include any loader-specific files and libraries. A useful backup is one you can restore as a complete directory, not just a copy of the main JAR.

2. Stop the server cleanly

Use the panel’s Stop control or issue the server’s normal stop command in the console. Wait until the process has exited and the console is no longer writing saves. Paper specifically warns that replacing a JAR in a running server is unsafe. Never overwrite the program while Java still has it open.

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.
Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

3. Download software for the exact Minecraft version

Get the file from the project that publishes the software. Mojang provides the official Java Edition server download, Paper publishes runnable server JARs, and Fabric provides an executable server launcher. Check the release and loader versions shown by the download page before saving the file.

Do not assume that a newer JAR will safely upgrade an existing world. World format changes, plugin APIs, and mod dependencies can all make a version change an operational migration rather than a simple replacement.

4. Put the file in the server directory

For a local installation, copy the downloaded file into the directory that contains the world and the current startup script. For a remote machine, use the host’s file manager, upload control, or SFTP. Keep the original file until the replacement has been tested; you can move it to a backup location if the panel requires only one active server JAR.

Fabric’s launcher documentation describes placing the launcher in a local or remote server directory. A manual Fabric installation is different: the launcher expects a vanilla server.jar and creates supporting files. In that case, treat the launcher, vanilla JAR, libraries directory, and server.properties as one coordinated installation.

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

5. Set the exact filename

Choose one of these approaches:

  • Keep the downloaded name and change the startup command to that exact name.
  • Rename the file to the name already used by the script or panel, then verify that the extension remains .jar.
  • In a panel, select its custom-JAR option and enter or select the exact uploaded filename.

Names are commonly case-sensitive on Linux servers. A command referring to Paper.jar will not necessarily find paper.jar. Avoid relying on a graphical label that differs from the real filename shown in the file list.

6. Run it with the required Java version

Use the Java runtime documented by the project. The following are the official-style examples supplied by the projects; replace the placeholder or example filename with the file you actually installed.

Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by

For a Fabric launcher:

java -Xmx2G -jar <fabric server launcher jar file name> nogui

For Paper:

java -Xms4G -Xmx4G -jar paper.jar --nogui

If your Paper download has a different filename, substitute that exact name. The memory values in these examples are command-line examples, not a universal allocation rule; a host panel may expose the same settings in separate memory fields.

Run the command from the server directory, or use an absolute path to the JAR. If several Java installations exist, make sure the java executable in the script is the one whose version satisfies the software’s table.

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

7. Complete the first-launch EULA step

On a first run, the server creates setup files and stops or refuses to continue until the EULA requirement has been completed. Follow the EULA instructions generated by the official setup process, then start the server again. Do not treat a process that exits after creating setup files as a successful startup.

8. Validate before inviting players

Watch the console from the first complete start. Confirm all of the following:

  • The process stays running instead of exiting with a Java or file error.
  • The expected Minecraft version is shown in the startup log.
  • The intended world opens and its normal dimensions and data are present.
  • Required plugins or mods load without dependency errors.
  • A local client can connect and perform basic actions.

Only after the local test succeeds should you address outside access. Check the server bind and address, host firewall, and router port forwarding where players connect over the internet. Mojang notes that outside connections may require firewall or port-forwarding configuration.

Change the JAR in a hosting panel

Panel names vary, but the safe sequence is consistent. Do not upload a new file and press Start while the old process is still running.

Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.
  1. Open the server console and choose Stop. Wait for the process to finish.
  2. Open the panel’s file manager or upload area and make a backup of the world and configuration directories.
  3. Upload the custom JAR to the server’s main directory. If the panel has a dedicated server-type or custom-JAR selector, leave the file in the directory specified by that panel.
  4. Open Startup, Server type, or the equivalent settings page.
  5. Select Custom JAR or the panel’s equivalent option. Enter or choose the uploaded filename exactly, including capitalization and the .jar extension.
  6. Set the Java version exposed by the panel to the requirement for the selected software. For Fabric, use Java 17 for Minecraft 1.17–1.20.4 or Java 21 for 1.20.5 and newer. For Paper, use Java 21 for 1.20–1.21.11 or Java 25 for 26.1 and newer.
  7. Review the generated startup command. It must point to the same filename you saw in the file manager and must start in the directory containing that file.
  8. Start the server, monitor the live log, and complete the EULA step if this installation has not done so already.

Some panels replace the command automatically when you choose a server type; others expose a text field. In either case, the final command is the authority. If it references an old filename, correct the setting before restarting.

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

Fabric installation details

Simple launcher method

Fabric’s simple method downloads an executable server launcher with the selected Minecraft and loader versions built into it. Place that launcher in the server directory and run it with the required Java version, for example:

java -Xmx2G -jar <fabric server launcher jar file name> nogui

Fabric documents that its launcher can act as a drop-in replacement for a vanilla server JAR when used with supported Minecraft hosts, administration panels, or start scripts. The panel still has to invoke the actual launcher filename.

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

Manual installation method

Manual Fabric setup expects a vanilla server.jar and creates or uses additional support files. A remote upload may therefore need all of these items:

  • The Fabric server launcher.
  • The vanilla server.jar expected by the launcher.
  • The generated or supplied server.properties.
  • The libraries directory and its contents.

Do not rename one file, remove the libraries directory, and assume the installation is complete. Upload the coordinated file set produced by the Fabric installation process, then use the launcher’s filename in the startup command.

Fabric Java selection

Use Java 17 for Minecraft 1.17 through 1.20.4 and Java 21 for Minecraft 1.20.5 and later, according to Fabric’s documented recommendations. If the host offers several Java images, select the one matching the Minecraft version before diagnosing any mod problem.

Paper installation and migration details

Replacing vanilla with Paper

Paper’s migration guidance is to download the appropriate Paper build and replace the vanilla server JAR. You can either retain Paper’s downloaded filename and change the command or rename it to the name already used by your script. Paper’s short launch example is:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
java -Xms4G -Xmx4G -jar paper.jar --nogui

Replace paper.jar in that example when the downloaded file has another name.

Paper’s Java table

Paper lists Java 21 for Minecraft 1.20 through 1.21.11 and Java 25 for Minecraft 26.1 and newer. A Java mismatch can prevent the server from starting even when the JAR upload and filename are correct.

World compatibility warning

Paper cannot load Fabric or Forge worlds when those systems have added blocks, items, or other game data that Paper does not understand. If the existing world depends on such content, keep the backup and use the original loader rather than attempting a Paper migration. A successful JAR launch does not prove that the world is compatible.

How to diagnose a failed startup

Symptom Likely cause Action
UnsupportedClassVersionError The Java runtime is too old or otherwise does not match the server software. Check the software’s official Java table and select the required runtime. Fabric requires Java 17 for 1.17–1.20.4 and Java 21 for 1.20.5+; Paper lists Java 21 for 1.20–1.21.11 and Java 25 for 26.1+.
Unable to access jarfile The working directory is wrong, the filename is different, or capitalization does not match. List the server directory, copy the exact filename, and update the command or panel field. Confirm that the file ends in .jar.
EULA-related stop or failure The first-launch EULA requirement has not been completed. Open the EULA file generated by the setup process, follow its acceptance instructions, save it, and restart.
Missing mods, libraries, or loader files Only one part of a multi-file installation was uploaded. Restore or upload the complete loader set. A manual Fabric installation may require the launcher, vanilla server.jar, libraries, and server.properties.
World fails after switching to Paper The world contains Fabric- or Forge-added content. Stop the server, restore the backup, and use the loader that created the world and its data.
Players cannot connect Address binding, firewall, or port-forwarding configuration is preventing access. Test locally first, then check the server bind/address, host firewall, and router forwarding required for remote players.

Safe updates and rollback

Every future JAR change should follow the same stop-backup-replace-validate sequence. Keep the previous JAR until the new build has completed a full startup and a test connection. Save a fresh copy of the world before an update, especially when changing Minecraft versions or moving between server implementations.

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

If the new process fails, stop it rather than repeatedly restarting with unknown changes. Record the first meaningful error in the log, restore the previous JAR and matching startup setting, and confirm that the backup world opens. If the problem is a Java mismatch, changing only the runtime may be sufficient; if the problem is world data or missing loader files, return to the original software and file set.

For a managed Minecraft hosting plan, verify its custom-JAR policy before purchasing or migrating. Some services expose a custom-JAR field, while others restrict server software choices or require a specific directory. The same technical requirements still apply: exact filename, compatible Java, complete supporting files, backups, and a stopped server during replacement.

Final pre-launch checklist

  • The target Minecraft release and server software are written down.
  • The world, configurations, extensions, and startup settings are backed up.
  • The old server process is fully stopped.
  • The downloaded JAR or launcher came from the relevant project and matches the target version.
  • All required supporting files are present, especially for manual Fabric installations.
  • The panel or command uses the exact, case-sensitive filename.
  • The Java runtime matches the software’s documented requirement.
  • The EULA step is complete.
  • The log shows a sustained successful startup.
  • The expected world and plugins or mods load correctly.
  • Local connectivity works before firewall and port-forwarding changes are tested for remote players.

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
Windows Errors? Fix Them Before They SpreadFree repair scan
Outdated Drivers Are Slowing You DownFree scan - exact matches

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.