October 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 NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
VGSources
Blog

Aikar’s Flags for Minecraft Servers: What They Are and How to Use Them

A practical guide to Aikar’s flags: what they change in G1GC, how to choose Java and heap values, copy the current PaperMC string, configure Linux or Windows startup scripts, and diagnose problems flags cannot fix.
Length10 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Aikar’s flags are Java Virtual Machine (JVM) startup arguments that tune the G1 garbage collector for Minecraft Java servers, especially Paper and Spigot-family software. They are intended to reduce long garbage-collection pauses that appear to players as lag spikes. They do not add CPU capacity, RAM, or a faster network, so they cannot rescue a server that is fundamentally undersized.

The safe way to use them is to copy the current flag set from the official PaperMC Aikar’s flags page, run a Java version compatible with your Minecraft release, set -Xms and -Xmx to the same value, and reserve memory for the operating system. The exact string changes over time; treat the PaperMC page as the authority rather than copying an old guide.

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 Aikar’s flags change

Minecraft constantly creates and discards Java objects while it loads chunks, processes entities, handles plugins and mods, and serves players. Java’s garbage collector eventually reclaims those objects. With default G1GC settings, a busy server can occasionally spend several seconds collecting memory. During that stop, the main server thread cannot keep up with ticks, and players experience rubber-banding, delayed block updates, or a sudden drop in responsiveness.

Aikar’s flags adjust G1GC’s heap layout, pause target and object-promotion behavior for this allocation pattern. They are startup options, not a plugin and not a setting inside the Minecraft server console. The flags are associated with PaperMC contributor Daniel Ennis, known as Aikar, and are primarily used with Paper and other Spigot-family servers.

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.

They should be viewed as a garbage-collection configuration baseline. A healthy result is steadier behavior under allocation pressure, not a guaranteed increase in average TPS. No independent primary-source study establishing a universal TPS-percentage improvement was identified, so claims of a fixed “TPS boost” should be treated as marketing rather than a measured promise.

Before you install them

Match Java to the Minecraft release

Use a Java runtime supported by the exact Minecraft and server version you run. Java compatibility is a prerequisite: flags cannot correct an incompatible or outdated runtime. One third-party guide recommends Java 21 for Minecraft 1.20.5 through 1.21.x and Java 25 beginning with Minecraft 26.1, but that recommendation was not confirmed by a primary source. Check the release notes for your server software and the Java requirement for your Minecraft version before changing runtimes.

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

After installing Java, verify which executable your startup script will use:

java -version

Run this in the same account and environment that starts the server. If it reports a different Java installation than the one you intended, use the full path to the desired executable in your script or correct the system PATH first.

Confirm that the server software is appropriate

Aikar’s flags are designed around the allocation behavior of Minecraft Java servers and are most commonly documented for Paper and Spigot-family software. They are not a universal recipe for every Java game server. Confirm that your server’s documentation supports G1GC and these arguments before applying them to a different implementation.

Plan RAM for the whole machine

The heap is only one consumer of memory. The operating system, Java’s native memory, file caches, map tools, databases, monitoring agents and other services also need headroom. The PaperMC Aikar’s flags page has stated a broad recommendation of at least 6–10 GB of RAM regardless of player count; the value came from a search snippet and may change as the page is revised, so verify the current wording when you size a new server.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed

An older PaperMC documentation revision mirrored on GitHub advises reducing the values you would otherwise give the heap by about 1,000–1,500 MB to avoid an operating-system out-of-memory kill. That is a practical headroom guideline, not a guarantee for every machine. Leave more room if the host runs a graphical desktop, containers, backups or other services.

How to obtain the current flag string

Do not treat a blog post or a generated command as canonical. Open PaperMC’s Aikar’s flags documentation and copy the complete, current string for your server’s Java and memory setup. Flag names and values can change as Minecraft, Java and Paper evolve.

Third-party guides sometimes add system properties such as -Dusing.aikars.flags or -Daikars.new.flags, or differ by a small option. Those additions are not evidence that the string is current. Compare every argument with the PaperMC page and remove anything you cannot explain or verify.

Set heap values correctly

-Xms sets the initial Java heap and -Xmx sets its maximum. Set both to the same amount so the JVM does not repeatedly resize the heap while the server is running. Choose a value that fits after reserving operating-system headroom; do not assign all physical RAM to -Xmx.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Setting Meaning Safe practice
-Xms Heap size reserved when Java starts Make it equal to -Xmx
-Xmx Maximum Java heap Reduce it to leave roughly 1,000–1,500 MB or more for the operating system and other processes, depending on the host
Physical RAM Total memory installed or assigned to the machine Never assume all of it is available to the Minecraft heap

For example, a machine with 16 GB of physical RAM should not automatically receive -Xmx16G. A smaller equal pair such as -Xms14G -Xmx14G may still be too aggressive if other services are active; the correct number depends on the complete workload. The numbers in this example illustrate the relationship between the options, not a universal sizing rule.

Linux setup: a repeatable startup script

Keep the server jar, world data and script in one directory, and make a backup before changing startup options. The following structure keeps the flag string in one variable so it can be replaced when PaperMC updates the recommended set:

Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)
#!/usr/bin/env bash
set -euo pipefail

JAVA_BIN="java"
HEAP="8G"
AIKAR_FLAGS="paste-the-current-string-from-PaperMC-here"

exec "$JAVA_BIN" -Xms"$HEAP" -Xmx"$HEAP" $AIKAR_FLAGS -jar paper.jar --nogui

In this example, replace the value of AIKAR_FLAGS with the arguments copied from the official page; do not include another -Xms or -Xmx in that variable. If the official string already includes memory options, remove those duplicates and keep one equal pair in your script.

  1. Save the file as start.sh in the server directory.
  2. Give it execute permission with chmod +x start.sh.
  3. Run it with ./start.sh and watch the first lines of output for Java errors or unrecognized options.
  4. Stop the server normally, then restart it once more to confirm that the same script is used after a reboot.

Shell quoting matters. The official string is a sequence of separate JVM arguments, so do not wrap the entire string in one pair of quotes. If your distribution uses a service manager, put the same command in that service’s documented startup field rather than running a second copy from a terminal.

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

Windows setup

On Windows, create a start.bat file in the server directory. Keep the heap values equal and paste the current PaperMC arguments after them:

@echo off
set "HEAP=8G"
set "AIKAR_FLAGS=paste-the-current-string-from-PaperMC-here"
java -Xms%HEAP% -Xmx%HEAP% %AIKAR_FLAGS% -jar paper.jar --nogui
pause

Open the batch file from the server directory so relative paths resolve to the correct jar and world. If Windows reports that an option is unrecognized, check for a typo, an argument copied from a different Java version, or a stale flag set from an older guide. Keep a copy of the previous working script so you can restore it quickly.

What the commonly listed options do

The following options are frequently associated with Aikar’s configuration in third-party explanations. Their presence and exact values must be checked against the current PaperMC page before use; the table is an explanation of purpose, not a replacement for the official string.

Option Purpose Important qualification
-XX:MaxGCPauseMillis=200 Gives G1GC a target pause time in milliseconds. The value is a target, not a promise that every collection will finish within 200 ms.
-XX:+AlwaysPreTouch Touches the requested heap pages during startup so memory is committed before normal play. Startup can take longer, and the machine must have enough available memory.
-XX:+DisableExplicitGC Prevents application code from directly requesting a full System.gc() collection. It does not stop normal automatic garbage collection.
-XX:MaxTenuringThreshold=1 Controls how many collection cycles an object may survive before promotion. Changing the value independently can alter allocation behavior; use the tested set rather than tuning one flag in isolation.
-XX:G1HeapRegionSize=8M Sets the size of G1 heap regions. Region sizing interacts with total heap size, so verify that the value is still recommended for your release.

Do not add an option merely because its name appears in an old command. G1GC has evolved with the JDK, and a flag that was useful for one Java release may be unnecessary, ignored or rejected in another.

Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

First launch checks

After starting the server with the new command, verify the basics before inviting players:

  • The console reaches the normal “Done” state without an “Unrecognized VM option” or startup failure.
  • The reported Java version is the one you intended to use.
  • The process stays within the machine’s memory budget instead of pushing the operating system into swapping or an out-of-memory kill.
  • The server can load the world, enable plugins or mods, and save normally.
  • Your monitoring shows that the heap is not permanently at its limit during ordinary activity.

Always test with the same world, plugins, mods and view distance that create the real workload. A quiet test server can start successfully while a production server still lacks CPU time or memory.

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

Diagnosing problems after applying the flags

The JVM will not start

Read the first error line, not only the final shutdown message. An unrecognized option usually means the copied string targets another Java release or contains a typographical error. Remove the new arguments, confirm that the unmodified server starts, then compare the current PaperMC string option by option. Do not mix fragments from several guides.

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.

The machine runs out of memory

Lower both -Xms and -Xmx by the same amount and retain operating-system headroom. Check for other Java processes, map renderers, backups, containers and desktop services. A larger heap is not automatically better: if the host cannot keep it resident, the resulting swapping or kill is worse than a smaller, stable heap.

Lag continues despite successful startup

Garbage collection is only one possible source of lag. Profile the server’s tick time and inspect CPU saturation, entity counts, chunk generation, redstone activity, plugin behavior, mod requirements and network conditions. Aikar’s flags cannot compensate for an undersized CPU, insufficient total RAM or player and mod loads beyond what the machine can sustain.

Startup is noticeably slower

An option such as -XX:+AlwaysPreTouch can make Java touch a large heap before the server accepts connections. That trades some startup time for more predictable memory commitment during operation. Do not interrupt startup simply because it takes longer; check whether the process eventually reaches the normal ready state and whether the host has enough free memory.

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.

Large heaps and alternative collectors

Some third-party guides describe a variant with a larger young generation for servers above 12 GB. That is not a universal rule and should not be adopted without checking the current PaperMC documentation and measuring the result on your workload.

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.

Other guides compare G1GC with generational ZGC, particularly for heavily modded servers or very large heaps. Those comparisons are third-party advice, not a guarantee that ZGC will outperform G1GC on your machine. Changing collectors changes the tuning model and should be treated as a controlled experiment: back up the server, change one variable, reproduce the same workload, and compare pause behavior, tick time and memory pressure. If the result is worse, return to the documented configuration that was stable.

How to keep the configuration current

Flag strings and Java recommendations are version-sensitive. Recheck the official PaperMC page when you upgrade Minecraft, switch Paper builds, change Java major versions or move to a machine with a different memory size. A practical review interval is at least every six months, and immediately after a major Minecraft or Java release.

  • Record the Minecraft version, Paper build, Java version and heap values beside your startup script.
  • Keep the previous script and a recent world backup before changing arguments.
  • Copy the complete current string instead of appending new options to an old one.
  • Remove duplicate memory settings and any property whose purpose you cannot verify.
  • Re-test during the busiest expected workload, not only during an empty-server startup.

Generators and calculators can produce a starting command from a RAM value, but they are secondary references. Use them only to understand formatting, then compare their output with the official PaperMC documentation. No generator can know your CPU limits, plugin behavior, mod mix or the memory required by other services.

What Aikar’s flags can—and cannot—solve

Situation Likely effect of the flags What you still need to address
Long pauses caused by G1GC collecting many short-lived objects They can provide a more suitable G1GC policy and reduce avoidable pause behavior. Measure pauses and tick time under the real workload.
Not enough physical RAM They cannot create memory; an oversized heap can trigger an operating-system kill. Reduce the heap or add capacity, while preserving headroom.
CPU saturation or slow single-thread performance They do not make the server thread faster. Reduce expensive activity, improve hardware or adjust player and mod limits.
A plugin or mod causing excessive work They do not repair faulty application behavior. Profile, update or remove the offending component.
Network congestion or a distant connection They do not reduce latency on the network path. Investigate routing, bandwidth and client-side conditions.

Bottom line for server owners

Use Aikar’s flags as a documented G1GC baseline, not as a magic lag fix. Match Java to Minecraft, copy the current arguments from PaperMC, set equal -Xms and -Xmx values, reserve roughly 1,000–1,500 MB or more for the rest of the machine, and verify the result under real player and mod loads. When lag remains, investigate CPU, memory pressure and server workload instead of adding more undocumented JVM options.

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

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 quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver 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.