Knowledgebase

Minecraft

a minecraft icon

Minecraft

210 Articles
Dive into our Minecraft knowledgebase articles, where you'll learn everything about Minecraft server hosting! Whether you're a beginner or an experienced player, our guides will teach you how to set up, optimize, and manage your server.

Optimizing spigot.yml To Reduce Lag

If you’re running a Spigot server, you have a handful of options you can use to optimize your server to ensure optimal performance. This guide will show you the settings offered by Spigot that you can take advantage of to optimize your server’s performance. ::ProseNote{title="Note" description="This article is specifically for Minecraft Java Edition servers, and depends on Spigot or Paper to work." appearance="default"} :: Below is a list of settings from the and their recommended values for optimal performance in the order of most impact to least impact on performance. For help editing this file, reference our guide on modifying your Spigot configuration. For more detailed and advanced options you can adjust, feel free to check out this useful server optimization GitHub guide by YouHaveTrouble and contributors. | Option | Description | Default | Optimized / Recommended | |--------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------|--------------------------| | save-user-cache-on-stop-only | Prevents constant saving of user data while online. Improves performance, but may risk data loss if the server crashes. Make backups and stop the server regularly. | false | true | | entity-activation-range | Controls how close entities must be to players to activate AI. | animals: 16<brmonsters: 24<brraiders: 48<brmisc: 8 | (same as default) | | merge-radius | Increases how close items/XP must be to merge, reducing ticking entities. Too high values may cause bugs (e.g. teleporting through blocks). | item: 4.0<brexp: 6.0 | (same as default) | | nerf-spawner-mobs | Disables AI for mobs from spawners, improving performance on spawner-heavy servers. | false | true | | max-tick-time | Controls max tick time before skipping logic. Setting it to 1000 disables the feature to avoid breaking gameplay. | tile: 50<brentity: 50 | 1000 (disabled) | | mob-spawn-range | Sets how far (in chunks) from a player mobs can spawn. Keep lower than view distance to ensure effectiveness. | 8 | 6 | | arrow-despawn-rate | Controls how long survival arrows stay before despawning. Reduces entity lag. (300 ticks = 15s) | 1200 | 300 | | item-despawn-rate | Sets how long items stay on the ground before despawning. Reducing helps performance but may annoy players. (4000 ticks = 3.3 minutes) | 6000 | 4000 | | tick-inactive-villagers | Prevents ticking of villagers outside activation range. Greatly improves performance in 1.14+ servers. | true | false | You can further improve performance on your Spigot server by optimizing Bukkit and Paper. Learn more about how to optimize your Bukkit configuration with our guide on optimizing Bukkit’s bukkit.yml here.

Zach Lowery
September 11, 2024

Mismatched Mod Channel List - How to Fix Client and Server Mod Differences

When running or updating a modded Forge server, you can sometimes run into issues with mods or configs being different between the server and the client. While your server can sometimes automatically fix this issue, mainly in the case of configs being different, this can lead to players being unable to connect to the server. You can fix this issue by manually re-synchronizing the mods and configurations on your server with the ones on your client, ensuring that they are the same. --- Prevention Methods To prevent running into mod mismatch errors, there are a few suggestions we have to avoid the potential of these occurring. - Using official modpacks from our Minecraft modpack installer These are mod packs that are already made by other players, which you can install on your client with programs such as CurseForge or the FTP app. When doing this, please ensure that the version of the modpack matches both on the client & server. - Manually installing server packs. Our Minecraft modpack installer may not have the modpack/version you desire, so you may be required to install the server pack. Please be aware that not all modpacks have an available server pack, therefore, we would recommend avoiding installing these on servers as it's very likely to contain many client-side mods that will break your server. --- Resolving a Mod Mismatch To resolve a mod mismatch, please follow the steps below. 1. Access your Control Panel and Shut Down your server. 2. Create a backup of your server prior to making any file edits. You can read our guide on how to do this here: How to Manually Backup Your Minecraft Server. 3. Click the Files tab. 4. Delete both the mods and config folders from your server. These are the two main folders that can lead to mods being mismatched; configs for mods also need to be synchronized for connections to be successful. 5. Locate the modpack install folder for the modpack you are using. If you are using a modpack provided by an external launcher such as Curseforge, you will be able to find the install folder according to this guide: How to Locate Your Minecraft Modpack Folder If you are using a self-made modpack that you installed manually, this will be in the folder wherever you installed the game. This varies per operating system and install, but should look something like this, depending on your platform: Windows: MacOS: Linux: 6. After locating your modpack install folder, open it and upload both the mods and config folders to your server. 7. Once the uploads are complete, Start your server. --- It's important to remember that some mods, such as OptiFine, only work on the client and not the server. While Forge tries its best to disable these mods by detecting that they're client-only, sometimes this doesn't work and will result in your server crashing while loading. If this happens to be the case, simply remove any mods that are client-side only, or contact our support team for assistance! We're always on hand to help you resolve server issues.

Jay Miller
September 11, 2024

Minecraft Server Types

There is a range of server types available to Minecraft server owners. Each server type has its own set of features, rules, and capabilities. Whether you're interested in vanilla gameplay, extensive modding, or creating a network of connected servers, choosing the appropriate server type is an essential step in building the perfect Minecraft experience for your players. ::ProseNote{title="Note" description="All server types are compatible with our services. We support all server types and all modpacks, even if they aren't listed below. You can find out how to change your server type here." appearance="default"} :: --- Vanilla & Plugin Support It is possible to host a completely vanilla server using the server file provided by Mojang. Server owners commonly opt to install a modified version of this server type that supports plugins such as PaperMC, Craftbukkit or Spigot. These server types do not require client modifications, making them easily accessible for players. | Server Type | Description | | ----- | ----- | | Vanilla | The unmodified, default version of Minecraft as provided by Mojang. | | PaperMC (Recommended) | An optimized version of Craftbukkit/Spigot. It is the most popular server type and typically what we recommend users use. | | Craftbukkit/Spigot | Common server types that have support for server-side modifications (plugins). | | Bedrock/MCPE | Support for Bedrock Edition, catering to various gameplay modes and features. | --- Forge & Mod Support Server owners who want access to a larger range of customization may opt to install a server type that supports mods. This will commonly be in the form of Forge or Fabric; these are used as the base for many popular modpacks. Both of these server types will also require players to have the same mods installed on their local client. | Server Type | Description | | ----- | ----- | | Forge | The most popular modded server type. Requires the Forge client for running mods and connecting to Forge-modded servers. | | NeoForge | A fork of Forge, with a bigger focus on being modern. It has its own mod compatibility, and mods are not cross-compatible. | | Fabric | A lightweight, flexible modding platform that allows for extensive customization. Requires the Fabric mod loader and compatible mods. | | Magma | A Forge modification enabling Craftbukkit plugins; however, very unstable. We recommend this for advanced server owners only. | | SpongeForge | Functions as a mod for Forge servers, allowing installation of Sponge plugins on modded servers. | --- Proxy Server Types Proxy server types act as an intermediary between players and the server. These are commonly used by server networks to allow players to access multiple servers through a single IP address or to allow Bedrock and Java players to play on the same server. These server types all require at least one other server for players to actively play on. | Server Type | Description | | ----- | ----- | | Velocity (Recommended) | A modern, optimized, proxy server type that is actively maintained and documented by the PaperMC team. We highly recommend using this option for network server setups. | | Bungeecord | A unique proxy server for connecting multiple servers into a network. It bridges connections between players and other servers. | | GeyserMC | A proxy allowing Bedrock edition players to join Java/PC edition servers. GeyserMC also offers mod and plugin versions of the software that do not require a standalone server. | | Waterfall | A BungeeCord fork designed for better performance and stability. Ideal for network setups. | Our support extends to all server types and modpacks, including custom-built setups. If you're ever unsure about which server type to choose, feel free to reach out to our support team for guidance.

Zach Lowery
September 11, 2024

Minecraft Java Log4j RCE 0-Day Vulnerability

On the 9th of October 2021, a zero-day exploit affecting Minecraft Java servers and clients using versions 1.7 to 1.18.1 was discovered. This allows malicious users to execute commands on your server without needing to be an operator, through methods such as chat, which can affect your client as well. Mojang has released a client-sided fix that will be automatically applied by restarting your launcher. Servers however, need to be updated to the latest version, or manually secured. You can find a list of server type versions we have patched so far, or ways to secure your server type below. --- Patched Versions The following versions have been secured and are safe to play as normal (Note: These are only safe to play if selected from our panel. Using custom jars may not be protected). Bungeecord Paper Waterfall Paper Velocity (Using the latest version of the official website) CraftBukkit 1.18.2 Fabric 1.18.2 Fabric 1.18 Fabric 1.17.1 Fabric 1.17 Fabric 1.16.5 Fabric 1.16.4 Forge 1.18.2 Forge 1.18 Forge 1.17.1 Forge 1.16.5 Forge 1.15.2 Forge 1.14.4 Forge 1.13.2 Forge 1.12.2 Forge 1.10.2 Forge 1.8.9 Forge 1.7.10 Paper 1.18.2 Paper 1.18.1 Paper 1.18 Paper 1.17.1 Paper 1.16.5 Paper 1.15.2 Paper 1.14.4 Paper 1.13.2 Paper 1.12.2 Paper 1.10.2 Spigot 1.18.2 Spigot 1.18.1 Spigot 1.18 Spigot 1.17.1 Spigot 1.17 Spigot 1.16.5 Spigot 1.15.2 Spigot 1.14.4 Spigot 1.13.2 Spigot 1.12.2 Spigot 1.11.2 Spigot 1.10.2 Spigot 1.9.4 Spigot 1.8.8 Vanilla 1.7 - 1.18.2 --- Unpatched Versions ::ProseNote{title="Warning" description="The following versions have not been automatically secured and will require manual adjustments in order to be safe to play." appearance="error"} :: CraftBukkit 1.7-1.18 Custom Jar: Check the current patch status of the server jar you are using and follow the developer's instructions where needed. Spigot 1.17 Spigot 1.16-1.16.4 Spigot 1.15-1.15.1 Spigot 1.14-1.14.3 Spigot 1.13-1.13.1 Spigot 1.12-1.12.1 Spigot 1.11-1.11.1 Spigot 1.10-1.10.1 Spigot 1.9-1.9.3 Spigot 1.8-1.8.7 Spigot 1.7-1.7.10

Zach Lowery
September 11, 2024

IP Forwarding in Waterfall (BungeeCord Proxy Servers)

Waterfall is a fork of the well-known Bungeecord, a proxy server used to teleport players between multiple Minecraft servers whilst using a single IP address. By default, servers connected under Waterfall will not display the IP of the player, but rather the IP of the Waterfall server. This is due to Waterfall acting as a proxy and is the barrier between the player and the server they are connected to. For the server to correctly identify the player's IP address, IP forwarding must be enabled on the Waterfall server in the configuration settings. --- Enabling IP Forwarding on your BungeeCord Server 1. Navigate to your Control Panel and Shut Down your server. 2. Navigate to the Files tab. 3. Open the file. This file is the primary configuration file for your proxy server, and we will be using it to enable IP Forwarding. 4. Enable the IP Forwarding setting. This may be located near the bottom of the file and is called ip\forward. 5. Save the file, then Start your server. Enable BungeeCord on Connected Servers The next step required is to go to each of the servers that are connected to your proxy and enable BungeeCord on each of them. 1. Access each of your connected servers, and Stop them. For example, these might be your Creative, Towny and Skyblock servers. 2. Navigate to the Files tab. 3. Open the file. You will be able to find this file on any server type that extends Spigot, such as Paper. 4. Enable the Bungeecord setting. This may be located around line 34, and needs to be set to true. 5. Click Save & Exit, then Start your server. --- Once the above steps have been completed, you can start up all your servers, and you have successfully IP forwarded your Waterfall proxy server! If you see the error , this would suggest you are connecting directly to the Spigot server rather than the Proxy server.

Jay Miller
September 11, 2024

Introduction to BungeeCord: How Network Proxys Work

BungeeCord is a server type for Minecraft that allows you to connect several servers together, so players can transfer between them without having to disconnect from the server. In modern times, BungeeCord is an outdated, poorly optimized software, and it is highly recommended to use a modern alternative like Waterfall or Velocity. ::ProseNote{title="BungeeCord Compatability" description="This article is written with the context of the modern Waterfall proxy, which should still be fully compatible with BungeeCord. However, there may be slight format differences found in config.yml." appearance="default"} :: How Waterfall Servers Work Since Waterfall is technically not Minecraft software and does not run any of the Minecraft code - worlds and players cannot actually exist on a proxy instance. As mentioned before, Waterfall is not a Minecraft server; rather, it's a proxy that simply bridges the connection between the player and server. Its only purpose is to forward you to one of the Minecraft servers you configure under the network. If no servers are connected to the Waterfall instance, the player will simply be disconnected upon joining, as there is no Minecraft server under the network for them to actually play on. Multiple Servers Required A proxy server requires a minimum of 3 separate Minecraft servers. This is because the proxy is not actually a playable instance of the game; it's a standalone software which links two or more servers together. As the proxy needs a minimum of 2 servers to connect, this means you will need a minimum of 3 servers to boot up your own server network. --- Network Plugins and Compatibilities Waterfall and other Minecraft proxies are not plugins; they're an entirely unique server type called a proxy. This means Spigot plugins are not compatible with your proxy. Proxy servers do support plugins, but only plugins that have been specifically developed for BungeeCord or Waterfall are compatible.

Kobe Plane
September 11, 2024

java.lang.IllegalArgumentException: ChunkNibbleArrays should be 2048 bytes not: 0

If your server is crashing with the error , it means that your world has become corrupt. This error usually occurs when switching between server versions (such as between 1.12.2 and 1.13.2) or server types (such as between Forge and Spigot/Vanilla). It is especially likely when downgrading to a lower version or switching between vastly different versions. Luckily, we have a guide providing more information and steps on how to fix corrupted world chunks. So you can either fix the corrupted chunks manually, or you can generate an entirely new world.

Kobe Plane
September 11, 2024
Join Discord