How to Modify Paper Configuration (paper-global.yml)

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

Note: You should only change configuration options for your server if you know what you are doing. If you are not sure what a setting achieves, it is best to leave it at its default setting.

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-global.yml file.


HOW TO ACCESS THE PAPER CONFIG IN MULTICRAFT

To access the PaperMC configuration using Multicraft, navigate to Files > Config Files > Paper Global Config.

The following table describes some of the options you may be interested in changing.

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.

For more information on the settings found, you can check out their official documentation here.

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 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 Modify Spigot Configuration (spigot.yml)

The Spigot Config file has many options and settings that can be modified to change the behavior...

How to Reset The Nether on Your Minecraft Server

With the drastic change to the nether in the latest 1.16 update, many players may want to reset...