Skip to main content

Vanilla-like Experience

Due to the way the Bukkit API is implemented in Paper, the gameplay experience between Vanilla and Paper can have inconsistencies. This can be furthered by efforts to fix bugs present in Vanilla Minecraft. Whilst many people may not notice the inconsistencies, there are situations where they become problematic. One example is that technical players may struggle getting their machines to work like they should. This page aims to provide a starting point for players who want to get as close to Vanilla as possible.

info

This page is inspired by Earthcomputer's collection of Vanilla breaking changes.

warning

This guide will only help you to get as close to Vanilla as possible. Unfortunately, it currently is not possible to get a 100% Vanilla experience in Paper.

paper-world-defaults.yml

chunks:
collisions:
entities:
behavior:
spawning:
duplicate-uuid:
fixes:
hopper:
maps:
unsupported-settings:

paper-global.yml

commands:
item-validation:
book:
book-size:
misc:
unsupported-settings:
Unsupported Settings

The following settings are provided by Paper, but are not officially supported. They may be removed at any time, so use them at your own risk.

spigot.yml

world-settings:
default:
merge-radius:
entity-activation-range:

Further considerations

  • settings.timeout-time in spigot.yml mirrors the watchdog setting in the server.properties file. Keep in mind that the spigot.yml setting is in seconds while the default setting is in milliseconds.
  • watchdog in paper-global.yml controls the watchdog early warning. While this is only a warning, you might want to disable it as it can get annoying.