How to Install and Use Folia on a Minecraft Server

Overview

Vanilla Minecraft servers are easy to run, but many communities eventually want plugins, quality-of-life tools, or performance improvements. Spigot and Paper are common choices for that job, since they support Bukkit-style plugins and provide extra configuration. For larger servers, though, even Paper can begin to struggle when many players, chunks, entities, and addons are active at once.

Folia is one answer to that problem. It is a fork of Paper built around regionized multithreading, which allows different areas of the world to tick at the same time instead of forcing the whole server through one main thread. That can improve responsiveness for busy worlds, especially when players are spread across many locations. It is not magic, sadly. You still need sensible settings, compatible plugins, and enough hardware.

This guide explains what Folia changes, how to install it through a server panel, and what to expect once it is running on a HolyHosting Minecraft server.

What Folia Changes

Folia is designed for dedicated Minecraft servers that need better scaling than a traditional single-threaded tick loop can provide. Instead of treating the entire world as one ticking unit, Folia divides the world into regions and processes those regions separately. When players are far apart, those regions can tick simultaneously, which can reduce lag and help the server stay closer to 20 TPS.

The biggest benefits usually appear on larger servers. If only two players are building in the same village, Folia may not feel dramatically different from Paper. If many players are exploring different dimensions, loading chunks, and using plugins across the map, the difference can be much easier to notice.

Folia is still experimental in many environments, so treat it carefully. Builds can change, bugs can appear, and plugin support is much narrower than Paper or Spigot. Before switching an existing server, create a backup of your worlds and important files. Backups are not glamorous, but neither is rebuilding spawn from memory.

Installing Folia

Folia can be selected from the server software or game file menu when it is available in your hosting panel. The exact layout may vary, but the process is generally straightforward.

1. Open your HolyHosting server panel and find the Game File or server software section.

1. Select the current server software option to open the dropdown menu.

1. Search for Folia, then choose it from the list.

1. Accept any warning about experimental software, then choose to create a new world if prompted.

1. Restart the server and wait for the Folia files to finish loading.

1. Join the server once it is online to confirm that the installation worked.

For existing servers, a new world is often the safest route when testing Folia. You can migrate more carefully later after confirming that your plugins, version, and files are compatible.

First Launch

After joining, the server should still feel like Minecraft. Blocks break, mobs move, and players continue finding creative ways to fall from tall places. The main difference is under the hood: region ticks and server responsiveness are handled differently from Spigot or Paper.

On small servers, the improvement may be subtle. On busier servers, Folia can help with startup behavior, chunk activity, and TPS stability when players are spread out. It is especially useful for communities that have outgrown a typical Paper setup but still want a plugin-based server rather than a full mod loader such as Forge or Fabric.

Performance Benefits

Folia's headline feature is regionized multithreading. In practical terms, this means separated areas of the world can tick independently. If one group of players is mining thousands of blocks away from another group building farms, Folia can process those areas more efficiently than a standard single-main-thread server.

This can help with:

• Maintaining a steadier 20 TPS under player load
• Faster startup or restart behavior in some setups
• Better responsiveness when chunks and entities are spread across the world
• Reduced pressure from one busy area affecting every other area

The results depend on your server size, CPU, world layout, installed plugins, and player behavior. Folia is most useful when the server has enough CPU resources for parallel work and when players are not all clustered in the same region.

Limits and Compatibility

Folia's design also creates the largest drawback: many plugins built for Bukkit, Spigot, or Paper are not safe to run on it. Plugins often assume that server tasks happen on one main thread. Folia breaks that assumption by processing regions independently, so plugins need to be written or updated with Folia support in mind.

Before installing any addon, check the plugin page, documentation, issue tracker, or release notes for Folia compatibility. Some plugins may load but behave incorrectly. Others may refuse to start at all. Popular projects may add support over time, but do not assume every Paper plugin will work just because Folia is related to Paper.

Configuration is also more limited. Folia may still expose familiar Bukkit, Spigot, and Paper configuration files, but it does not necessarily provide a separate Folia-specific settings file for every behavior you might want to adjust. Any setting that affects ticking, scheduling, chunks, or async behavior should be changed carefully.

Gameplay Feel

From a player's view, Folia should not change the rules of Minecraft. The server still runs the same game version, and normal survival or creative gameplay remains intact. The difference is how quickly the server responds when many things are happening at once.

Block updates, chunk loading, and interactions may feel smoother on large servers, especially when compared directly with a stressed Paper server. The advantage is less about adding new gameplay features and more about making existing gameplay hold up under pressure.

Adding Plugins

Plugin support is the area where Folia requires the most caution. Use only plugins that specifically state Folia support, or test them on a separate server before adding them to a live community. If a plugin is important to your server, check whether the developer has a Folia branch, compatibility notes, or an open issue discussing support.

A practical testing flow is:

1. Start with a clean Folia server.
2. Add one plugin at a time.
3. Restart after each install.
4. Check the console for warnings or errors.
5. Test the plugin in-game before adding the next one.

This takes longer than dropping in a full plugins folder, but it makes broken addons much easier to identify.

Editing Configuration Files

Folia does not always include a dedicated configuration file for Folia-only options, but you can still adjust supported Bukkit, Spigot, and Paper files from the file manager or FTP area. Changes should be made one at a time when possible, especially on an experimental server type.

1. Open the file access or FTP section from your server panel.

1. Log in with your panel password or file access credentials.

1. Find the configuration file you want to edit. Paper-related options are commonly located in a config directory.

1. Open the file editor, make the needed changes, and save the file.

1. Return to the main server panel and restart the server so the edits apply.

For performance troubleshooting, operators can also use the `/jfr start` and `/jfr stop` commands when supported. These Java Flight Recorder reports can help identify deeper server issues, though they are most useful if you already know what you are looking for.

Common Problems

If players cannot join, first confirm the server address, port, or subdomain. A wrong connection address causes plenty of false alarms. Next, verify that everyone is using the Minecraft version supported by the Folia build installed on the server. Version mismatches can prevent connections even when the server itself is healthy.

If the server fails to start, check the console logs. Common causes include an incompatible world, a Minecraft version mismatch, or plugins that are not designed for Folia. Remove recently added plugins first, then restart and test again. If you switched from a newer world version to an older Folia-supported version, create a fresh world instead of trying to downgrade the map.

If a plugin claims Folia support but does not work correctly, read its documentation for required settings. Some plugins need different configuration values before they behave properly. If problems continue, remove the plugin and contact the developer with logs and version details.

Useful Links

• Official Folia GitHub
• Becoming a Minecraft server operator
• How to find Minecraft plugins
• Adding plugins to a Minecraft server