Skip to content

docs: Update optimisation intro (Server JARs) #225

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ukdaaan merged 2 commits into from
Jul 22, 2025
Merged

docs: Update optimisation intro (Server JARs) #225

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2d5294a
Update optimisation intro (Server JARs)
goosBanny Jul 22, 2025
a50775e
added new meta tags
ukdaaan Jul 22, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 11 additions & 5 deletions src/content/docs/guides/Minecraft/Optimisation/intro.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,25 +2,31 @@
description: This section of setup.md goes in-depth for server optimisation
slug: guides/optimisation
title: Introduction
lastUpdated: 2025-07-22
sidebar:
order: 1
---

A section for optimising Minecraft servers. Optimising your server means to improve the performance of the server by implementing tweaks without heavily modifying desired mechanics. Advanced optimisation is only recommended for large servers suffering from poor performance.

### Spark Profiler
You should use the Spark Profiler for monitoring server performance e.g. vanilla mechanics, plugins, GC pauses and cycles, memory usage etc.
Use the Spark Profiler for monitoring server performance e.g. vanilla mechanics, plugins, GC pauses and cycles, memory usage etc.
Spark is also able to profile all threads generated by your server using the `--thread *` flag. You may use this to diagnose high CPU usage, for example.

<div>
<a class="button button--outline button--primary" href="https://spark.lucko.me/">Spark Website</a>
</div>

### Server JAR
[https://pufferfish.host/downloads](https://pufferfish.host/downloads) is currently the fastest, most stable free Paper fork available. Another alternative would be [Purpur](https://purpurmc.org/downloads), which provides additional mechanics for players at the expense of rather negligible performance loss against Pufferfish.
As for proxies, [Velocity](https://papermc.io/software/velocity) is easily the best option. Although it doesn't have as many plugins as Bungeecord, it is far more stable and secure by default. Most popular plugins have already added support for Velocity.
JAR | Summary
------------ | -------
[Pufferfish](https://pufferfish.host/downloads) | Free and completely stable Paper fork primarily focusing on entity optimizations. Recommended for most smaller networks.
[UniverseSpigot](https://discord.universespigot.com) | Extremely powerful paid fork. Best for the largest networks, being able to hold more than 600 players with ease.
[Leaf](https://github.com/Winds-Studio/Leaf) | Free Pufferfish fork. Contains patches similar to UniverseSpigot, though it is not as performant. It's stability has been called into question, but has worked fine in our testing.
[Purpur](https://purpurmc.org/downloads) | Paper fork which contains lots of Quality of Life options.

You may also want to take a look at [UniverseSpigot](https://polymart.org/resource/universespigot-1-20-1.4805). Highly recommended for servers with player counts exceeding 200 (and experiencing lag, of course). It's $70 price tag is certainly worth it. Do be careful with what settings you change as they can drastically affect gameplay.

Topic | Summary
------------ | -------
Basic Optimisation | Tweaks that will likely suffice for small to medium-sized servers (< 100 Players) assuming that they have sufficient CPU & memory resources.
Advanced Optimisation | Tweaks made for larger servers with at least 150 players.
Advanced Optimisation | Tweaks made for servers that need every drop of performance they can get.