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
  • 14 Users Found This Useful
Was this answer helpful?

Related Articles

How to Modify Bukkit Configuration (bukkit.yml)

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

How to Configure Your Minecraft Server (server.properties)

We have a video tutorial on how to configure your Minecraft server:   The server.properties...

Adding Extra Control Panel Users

We have a video tutorial on how to add users on Multicraft:   You can give a friend or server...

Adjusting View Distance on Your Minecraft Server

View Distance is a configuration option for Minecraft servers that sets the number of chunks...

Changing Your Minecraft Game Mode

Minecraft servers have 5 game modes to choose from: Survival, Creative, Hardcore, and...