This repository provides optimized configurations for Spigot and Paper Minecraft servers. The configurations are aimed at reducing lag, improving server performance, and ensuring a secure default setup.
These optimizations are based on:
This repository is intended to be used with the Docker Minecraft Server Image, offering lag-reducing configurations specifically tailored for Minecraft 1.21.x servers.
- Optimized Paper, Spigot, and Purpur files to minimize lag and maximize performance.
- Security Best Practices: RCON is disabled by default, and
server.propertiesis cleaned of insecure passwords. - Consistent & Clean: All versions are checked for consistency. No spam links or 3rd party ads in configs.
- Docker compatibility for easy deployment with the
itzg/docker-minecraft-serverimage. - Community-driven improvements: Contributions are welcome! See Contributing Guidelines to submit your improvements and configurations.
To ensure optimal performance, using the correct Java startup flags is crucial.
For a detailed guide on JVM Flags, RAM allocation, and Hardware recommendations, please read our dedicated guide:
👉 JVM Optimization & Flags Guide
This repository currently supports the Minecraft 1.21.x series, including:
- 1.21.1 to 1.21.4 (Fully Tested & Optimized)
- 1.21.5 to 1.21.11 (Generated based on stable 1.21.4 configs,
disable-teleportation-suffocation-checkremoved for compatibility)
If you would like to contribute configurations for older Minecraft versions, they must be thoroughly tested. Please submit a Pull Request (PR) with detailed notes. All contributions should follow the guidelines outlined in the CONTRIBUTING.md file.
- Clone this repository.
- Select the directory matching your Minecraft version (e.g.,
1.21.11). - Replace the configuration files in your Minecraft server's directory with the ones provided.
- Restart your server for the changes to take effect.
We welcome contributions from the community! If you'd like to add new configurations or optimize existing ones:
- Thoroughly test your changes.
- Open a PR with detailed descriptions of your modifications.
- Ensure your contributions follow the Contributing Guidelines.
Let's work together to create the best-optimized Minecraft server experience!
If these configurations helped your server run smoother, please consider giving this repository a ⭐ Star!
It helps other players and server owners find these optimizations and improve their gameplay experience. Every star counts!
If you really love the project and want to support its maintenance, you can also buy me a coffee:
I've written a detailed post on Buy Me a Coffee explaining how to set up a Docker Compose environment with all these optimized configurations out of the box. It's a great starting point if you want to get a server running quickly and efficiently!
👉 Read the Full Guide on Buy Me a Coffee
- Author - Tomás Alegre
