How to Modify Paper Configuration (paper.yml)

If you are running a PaperMC Minecraft server, there are a variety of options in a configuration file named “paper.yml”. This file generally works in conjunction with the Bukkit configuration file, “bukkit.yml”, and the Spigot configuration file, “spigot.yml”.

Note: You should only change configuration options for your server if you know what you are doing. If you are not sure what something does, it is best to leave it at its default setting. You can also open a ticket in the client area if you need help understanding what a setting does.

In this guide, we will discuss how to configure your server's Paper Config and some of the configuration options available to you in the server control panel, without needing to directly and manually modify the paper.yml file!


HOW TO ACCESS THE PAPER CONFIG IN MULTICRAFT

To access the PaperMC configuration for your server using Multicraft, navigate to “Files” and then “Config Files” using the left sidebar. Choose the “PaperMC Config” file from the list of files.

The following table describes some of the options you may be interested in changing, but if you would like a full list of options and a description of each option, the PaperDocs has a detailed article on all the configuration options.

OPTION DESCRIPTION DEFAULT / POSSIBLE VALUES
settings:
  max-player-auto-save-per-tick
Controls the number of players that may have their data saved per tick.  It's recommended to change this to 5 or less. Default: -1 (disabled)
settings:
  player-auto-save-rate
Controls the delay between auto player data saves. Default: -1 (disabled)
settings:
  load-permissions-yml-before-plugins
Controls whether or not Bukkit’s permissions.yml file is loaded before plugins. If you're using a permissions plugin you can choose to enable or disable this.

Default: true
Options: truefalse

settings:
  sleep-between-chunk-saves
Controls whether the server should sleep the chunk after each chunk save.

Default: false
Options: truefalse

settings:
  region-file-cache-size
Controls the size of the region file cache. Default: 256
settings:
  save-empty-scoredboard-teams
Controls whether or not empty scoreboard teams are saved.

Default: false
Options: truefalse

world-settings:
  default:
    optimize-explosions
Controls whether or not the server caches entity lookups during an explosion. It is recommended to set this to "true" for a minor performance improvement. Default: false
Options: true, false.
world-settings:
  default:
    queue-light-updates
Controls whether or not the server queues up lighting updates to the end of the tick, instead of running them when scheduled.  It is recommended to set this to "true" for a minor performance improvement. Default: false
Options: truefalse.
world-settings:
  default:
    max-auto-save-chunks-per-tick
Controls the maximum number of chunks saved per tick. It is recommended to set this to  6 for a large performance improvement. Default: 24
world-settings:
  default:
    max-chunks-gen-per-tick
Controls the maximum number of chunks generated per tick.  Default: 10
world-settings:
  default:
    keep-spawn-loaded
Controls whether or not the spawn chunks are always loaded. It's a good idea to keep this enabled if you have a lot of players logging in and out of the server at spawn. Default: true
Options: truefalse.
world-settings:
  default:
    keep-spawn-loaded-range
Controls the number of chunks around spawn to keep loaded. Reduce this number if you have a smaller spawn for a minor performance improvement. Default: 8
world-settings:
  default:
    auto-save-interval
Controls the auto-save internal for the world. Default uses Bukkit’s default value.  If you have this or Bukkit's autosave enable, disable the Multicraft autosave feature in your control panel for a minor performance improvement. Default: -1
timings:
  enabled
Controls whether the timings feature is enabled on the server. Keep this enabled so that you can use /timings on and /timings paste commands to identify lag causes on your server. Default: true
Options: truefalse.
If you require any further assistance, please contact our support at: https://shockbyte.com/billing/submitticket.php

Mitchell Smith

Managing Director @ Shockbyte

  • configure paper server, Minecraft Java Edition, Minecraft server, server type, PaperMC, Paper config, paper.yml
  • 19 Users Found This Useful
Was this answer helpful?

Related Articles

How to Configure Autosaving of Your Minecraft World

Minecraft servers have the ability to automatically save world data periodically. By default,...

How to Create a Flat World for Your Minecraft Server

We have a video tutorial for creating a flat world:   A flat or superflat world in Minecraft...

How to Disable Player Advancement Announcements

Advancement is a feature available exclusively on Minecraft Java Edition wherein players can...

How to Download Your Minecraft Server World

We have a video tutorial on downloading your Minecraft server world: If you want to use your...

How to Hide Autosave Messages

We have a video tutorial on how to disable world saved messages on your  Minecraft server:...