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.
server.properties
pause-when-empty-seconds=60#
How many seconds have to pass after no player has been online before the server is paused. This is disabled by default because it is incompatible with what plugins expect and might do with no players online.
paper-world-defaults.yml
chunks:
collisions:
entities:
behavior:
only-merge-items-horizontally: true#
Prevents merging items that are not on the same y level, preventing potential visual artifacts.
phantoms-do-not-spawn-on-creative-players: false#
Disables spawning of phantoms on players in creative mode
phantoms-only-attack-insomniacs: false#
Prevents phantoms from attacking players who have slept
cooldown-failed-beehive-releases: false#
Adds a cooldown to bees being released after a failed release, which can occur if the hive is blocked or it being night.
spawning:
count-all-mobs-for-spawning: true#
Determines whether spawner mobs and other misc mobs are counted towards the global mob limit
duplicate-uuid:
mode: NOTHING#
Specifies the method the server uses to resolve entities with duplicate UUIDs. This can be one of the following values:
- SAFE_REGEN: Regenerate a UUID for the entity, or delete it if they are close.
- DELETE: Delete the entity.
- NOTHING: Does nothing, not printing logs.
- WARN: Does nothing, printing logs
filter-bad-tile-entity-nbt-from-falling-blocks: false#
Instructs the server to remove certain NBT data from falling blocks. Note: Some adventure maps may require this to be turned off to function correctly, but we do not recommend turning it off on a public server
filtered-entity-tag-nbt-paths: []#
A list of NBT tags that will be removed from the EntityTag tag on items which spawn entities. The format of these strings follows the same format used to select NBT tags in Vanilla commands. If the spawning was directly caused by a player and the player has the minecraft.nbt.place permission, the filter list will be ignored. The defaults are set to prevent entities from spawning or moving to a place other than the location they were placed. For example, if Pos wasn’t included, a spawn egg could place an entity at any location. Note: Some adventure maps may require this to be an empty list to function correctly, but we do not recommend turning it off on a public server
per-player-mob-spawns: false#
Determines whether the mob limit (in bukkit.yml) is counted per player or for the entire server. Enabling this setting results in roughly the same number of mobs, but with a more even distribution that prevents one player from using the entire mob cap and provides a more single-player like experience
hopper:
cooldown-when-full: false#
Instructs the server to apply a short cooldown when the hopper is full, instead of constantly trying to pull new items
maps:
item-frame-cursor-limit: 2147483647#
The number of cursors (markers) allowed per map. A large number of cursors may be used to lag clients
scoreboards:
use-vanilla-world-scoreboard-name-coloring: true#
Instructs the server to use the Vanilla scoreboard for player nickname coloring. Useful when playing on adventure maps made for the Vanilla server and client
unsupported-settings:
paper-global.yml
commands:
item-validation:
display-name: 2147483647#
The maximum length of an item’s display name in characters
lore-line: 2147483647#
The maximum length of a lore line in characters
resolve-selectors-in-books: true#
Whether to resolve selectors in books. With this enabled, players given creative mode will be able to crash the server in yet another way
book:
book-size:
page-max: disabled#
The max number of bytes a single page in a book can contribute to the allowed byte total for a book, or “disabled” to disable non-vanilla restrictions on the book size.
misc:
max-joins-per-tick: 2147483647#
Sets the maximum amount of players that may join the server in a single tick. If more players join, they will be postponed until later ticks to join but not kicked. This is not related to connection throttling found in bukkit.yml
packet-limiter:
spam-limiter:
incoming-packet-threshold: 2147483647#
Sets the threshold at which the server will consider incoming packets spam and ignore them
unsupported-settings:
allow-headless-pistons: true#
Whether the server should allow the creation of headless pistons. These are often used to break permanent blocks
allow-permanent-block-break-exploits: true#
Whether unbreakable blocks can be broken with Vanilla exploits. This includes bedrock, end portal frames, end portal blocks, and more
allow-piston-duplication: true#
Whether to allow duplication of TNT, carpets, and rails. This does not control sand duplication
perform-username-validation: false#
Whether the server should validate usernames. While this may allow users with special characters in their name to join, it can also cause issues with commands and plugins
allow-unsafe-end-portal-teleportation: true#
This setting allows for exploits related to end portal teleportation to be possible, for example sand duplication. This setting is not recommended to be enabled, but is provided for those who wish to use it.
skip-tripwire-hook-placement-validation: true#
This setting allows for exploits related to tripwire hook duping to be enabled.
update-equipment-on-player-actions: false#
This setting controls if equipment should be updated when handling certain player actions. If set to false this will allow players to exploit attributes by e.g. switching equipment before using it.
spigot.yml
world-settings:
default:
entity-activation-range:
animals: 0#
The entity activation range for animals.
flying-monsters: 0#
The entity activation range for flying monsters.
misc: 0#
The entity activation range for misc entities.
monsters: 0#
The entity activation range for monsters.
raiders: 0#
The entity activation range for raiders.
villagers: 0#
The entity activation range for villagers.
water: 0#
The entity activation range for water mobs.
max-tnt-per-tick: -1#
How many TNT to process per server tick. Set to 0 or less to disable.
Further considerations
settings.timeout-timeinspigot.ymlmirrors the watchdog setting in theserver.propertiesfile. Keep in mind that thespigot.ymlsetting is in seconds while the default setting is in milliseconds.watchdoginpaper-global.ymlcontrols the watchdog early warning. While this is only a warning, you might want to disable it as it can get annoying.