Skip to main content

Configurations

note

Only changes to the server default configurations are documented here but, there are many different configurations that may affect mechanics and gameplay.

Feel free to review the following configuration file references linked below to further understand what Paper/Purpur can and does change.

Spigot

What is Spigot?
  • Paper is a fork of Spigot which is orginally a fork of CraftBukkit. Read this for more info.
  • All you need to know is that Paper does use Spigot and CraftBukkit configuration files which is why its present here.

merge-radius

Reduces the performance impact of having a large amount of dropped items on the ground.

  • description: Controls the range - in blocks - which experience orbs and items will "group" together when on the ground.
  • value(s): [item: -1, exp: -1]

Paper World Configs

experience-merge-max-value

  • description: Instructs the server to put a maximum value on experience orbs, preventing them all from merging down into 1 single orb. A value of -1 instructs the server to use no max value, allowing them to merge down into a single orb. This is especially noticeable when defeating boss monsters.
  • value(s): 1

disable-unloaded-chunk-enderpearl-exploit

  • description: Prevent enderpearls from storing the thrower when in an unloaded chunk.
  • value(s): false

fix-climbing-bypassing-cramming-rule

  • description: Sets whether climbing should bypass the entity cramming limit(maxEntityCramming game rule). If set to true, climbing entities will also be counted towards the entity cramming limit so that they can take suffocation damage.
  • value(s): true

disable-chest-cat-detection

  • description: Allows you to open chests even if they have a cat sitting on top of them.
  • value(s): true

prevent-moving-into-unloaded-chunks

  • description: Sets whether the server will prevent players from moving into unloaded chunks or not.
  • value(s): true

redstone-implementation

alternate-current implementation is more efficient but come with possible behavioral changes.

  • description: Specifies the redstone implementation that the server uses.
  • value(s): alternate-current

treasure-maps

villager-trade

Setting to true will reduce the performance impact of treasure maps. (map will no longer try to find undiscovered treasure instead returns the nearest one).

  • description: Instructs the server to target the first treasure location found for maps obtained via trading with villagers.
  • value(s): true

entity-per-chunk-save-limit

Prevents the server from stalling when attempting to load a chunk that contains a large amount of these projectile entities.

  • description: Limits the number of any type of entity that will be saved/loaded per chunk.
  • value(s):
  entity-per-chunk-save-limit:
    area_effect_cloud: 8
    arrow: 16
    dragon_fireball: 3
    egg: 8
    ender_pearl: 8
    experience_bottle: 3
    experience_orb: 16
    eye_of_ender: 8
    fireball: 8
    firework_rocket: 8
    llama_spit: 3
    potion: 8
    shulker_bullet: 8
    small_fireball: 8
    snowball: 8
    spectral_arrow: 16
    trident: 16
    wither_skull: 16

alt-item-despawn-rate

The value is in ticks which means a value of 20 equals to 1 second of server time. Items despawn in 5 minutes by default.

  • description: Determines how long each respective item despawns in ticks.
  • value(s):
  alt-item-despawn-rate:
    enabled: true
    items:
      arrow: 900
      blaze_rod: 1200
      bone: 1200
      bone_meal: 1200
      cactus: 900
      cobbled_deepslate: 1200
      cobblestone: 1200
      cod: 1200
      dirt: 1200
      egg: 1200
      ender_pearl: 300
      feather: 900
      gunpowder: 1200
      ink_sac: 900
      leather: 900
      netherrack: 1200
      phantom_membrane: 1200
      rotten_flesh: 1200
      salmon: 1200
      sand: 1200
      snowball: 120
      spider_eye: 1200
      string: 1200

lootables

lootables:
  auto-replenish: true
  max-refills: -1
  refresh-max: 2d
  refresh-min: 12h
  reset-seed-on-fill: true
  restrict-player-reloot: false

Paper Global Configs

allow-headless-pistons

  • description: Whether the server should allow the creation of headless pistons. These are often used to break permanent blocks
  • value(s): true

allow-piston-duplication

  • description: Whether to allow duplication of TNT, carpets, and rails. This does not control sand duplication.
  • value(s): true

Purpur

tps-catchup

  • description: Control tps catch-up.
  • value(s): true
note

TPS catchup makes the server tick faster than 20 TPS after any period of time that is below 18. This is an attempt at keeping the average TPS as close to 20 as possible, but does come with its own set of side effects, an example being when players get insta-killed by mobs during a lag spike.

Mobs

Riding

The following mobs are now rideable or had their ride abilities changed.

donkey:
  ridable-in-water: true
trader_llama:
  ridable: true
  ridable-in-water: true
skeleton_horse:
  ridable-in-water: true
  can-swim: true
mule:
  ridable-in-water: true
mooshroom:
  ridable: true
  ridable-in-water: true
llama:
  ridable: true
  ridable-in-water: true
horse:
  ridable-in-water: true
wolf:
  ridable: true
polar_bear:
  ridable: true
trader_llama:
  ridable: true
panda:
  ridable: true
zombie_horse:
  ridable-in-water: true
  can-swim: true

Tweaks

Enderman
  • Can no longer pick up blocks.
  • Despawns even if block is in hands.
Villager
  • Can be lured with Emerald Blocks.
  • Can be put on a leash.
  • Clerics farm nether warts.
  • Lobotomizes the villager if it cannot move (Does not disable trading)
  • Will wait until a villager has been traded with before lobotomizing
Wolf
  • Are twice their size
  • Default collar color is purple, the best color.
Axolotl
  • Can be bred with tropical fish. PurpurPack
  • Will longer hunt passive mobs like tropical fish, squid, and tadpoles. PurpurPack
  • Instead of hunting them down like a psycho. Aquariums, rejoice!
Config Values
enderman:
  allow-griefing: false
  can-despawn-with-held-block: true
wolf:
  attributes:
    scale: 2.0
  default-collar-color: PURPLE
villager:
      follow-emerald-blocks: true
      can-be-leashed: true
      clerics-farm-warts: true
      cleric-wart-farmers-throw-warts-at-villagers: true
      lobotomize:
        enabled: true
        wait-until-trade-locked: true

Blocks

Dispensers

  • Can now place anvils.

Anvils

  • Can now use color codes in Anvils for naming purposes including MiniMessage tags.

Chests

  • Can be opened even with a block on top of it now.

Dragon Eggs

  • No longer teleports when hit.

Raw Ore Blocks

  • Can be smelted in a furnance or blast furnance, however takes nine times as long to smelt. PurpurPack

Dyes & Re-Dye

  • Added a recipe crafting dyed carpet and wool with 1 dye per 8 wool/carpet. PurpurPack
  • Added a recipe crafting concrete powder from other colors of concrete powder. PurpurPack
  • Added a recipe crafting colors of glass and glass pane to be re-dyed into a different color. PurpurPack
  • Added a recipe crafting dyed terracotta from any color of terracotta, not just plain. PurpurPack

Farmland Blocks

  • Entities no longer trample crops
  • Fences and Walls no longer trample farmland when placed underneath the block.

Grindstones

  • If player has books in their inventory while disenchanting item in a grindstone, books will be consumed to return the enchantments removed from the item to the player. No exp will drop when doing this.

Signs

  • Signs can have colored text.

Spawners

  • Can be deactivated with redstone
  • Fixes spawners not spawning water animals correctly. MC-238526

Barrels and Ender Chests

  • Now has six rows for storage.

Crying Obsidian

  • Can now be used to make nether portals.

Beehives

  • Can now house six bees instead of three.

Turtle Eggs

  • Can no longer be destroyed by mobs, exp orbs, items, and minecarts.

Budding Amethyst

  • Can now be harvested by Silk Touch enchantments.PurpurPack

Mobs Don't Target Player

  • Players having target.bypass.<mojang_mob_name> permission won't be targetted by that type of mob.

Config Values

chest:
  open-with-solid-block-on-top: true
dragon_egg:
  teleport: false
farmland:
  use-alpha-farmland: true
  disable-trampling: true
sign:
  allow-colors: true
spawner:
  deactivate-by-redstone: true
  fix-mc-238526: true
barrel:
  rows: 6
ender_chest:
  six-rows: true
crying_obsidian:
  valid-for-portal-frame: true
beehive:
  max-bees-inside: 6
turtle_egg:
  break-from-exp-orbs: false
  break-from-items: false
  break-from-minecarts: false
  bypass-mob-griefing: true
dispenser:
  place-anvils: true
anvil:
  allow-colors: true
  use-mini-message: true

purpur-extras:
  use-notarget-permissions: true
  grindstone:
    gives-enchants-back: true

Gameplay Mechanics

Lightning

  • allows new transformations when configured entities are struck by lightning.

Tile Entities

  • Now persists names and lore when broken.
    • ex. named custom player heads retain their name

Mending Enchant

  • Now repairs the most damaged equipment first.

Day and Night Cycle

  • Daylight is now 15 minutes
  • Nightime is still set to 10 minutes

Bows

  • Infinity enchant on bows no longer require having an arrow in inventory.

Config Values

use-better-mending: true
daylight-cycle-ticks:
  daytime: 18000
  nighttime: 12000
infinity-bow:
  works-without-arrows: true
persistent-tileentity-lore: true
persistent-tileentity-display-name: true

purpur-extras:
  lightning-transforms-entities:
    entities:
      villager: witch
      pig: zombie_piglin
      rabbit: killer_bunny
      sheep: jeb_sheep
      horse: zombie_horse
      donkey: skeleton_horse
    enabled: true

Items

Netherite Armor and Tools

  • No longer require a template to be upgraded! Purpurpacks (1,2)

Beehives

  • Shows number of bees and level of honey when in inventory.

Snowballs

  • Can now extinguish fire, candles, and campfires.

Halloween

  • Certain mobs have a chance to spawn with pumpkin heads.

Armorstands

  • Now placed with arms by default.

Tool Effectivness

  • Axes are now effective in removing skull blocks PurpurPack
  • Hoes are now effective in removing froglights and cactus Purpurpacks (1,2)
  • Pickaxes are now effective in removing reinforced deesplate, glass, and various light source blocks Purpurpacks (1,2,3)

Config Values

snowball:
  extinguish:
    fire: true
    candles: true
    campfires: true
halloween:
  force: true
  head-chance: 0.25
armorstand:
  place-with-arms-visible: true

purpur-extras:
  beehive-lore:
    bees: '<reset><gray>Bees: <bees>/<maxbees>'
    honey: '<reset><gray>Honey level: <honey>/<maxhoney>'
    enabled: true

Player

AFK

  • No longer kicked if AFK.
  • Count AFK player as sleeping.

Totem of Undying

  • No longer needs to be equipped to activate.

Sleep

  • You can now sleep even if mobs are nearby.

Config Values

idle-timeout:
  kick-if-idle: false
  count-as-sleeping: true
totem-of-undying-works-in-inventory: true
sleep-ignore-nearby-mobs: true

Enchantment

Incompatible & Inapplicable Enchants

  • Allows applying enchantments together that are normally incompatible.
  • Allows applying enchantments on tools or armour that are normally not applicable.

Enchanting Table

  • Chiseled bookshelves provide power to an enchant table, like a normal bookshelf. PurpurPack
  • Transparent blocks in the enchantment are will not lower the enchantment power. PurpurPack

Looting

  • Looting Enchantment can now be placed on shears to harvest more items.

Config Values

allow-incompatible-enchants: true
allow-inapplicable-enchants: true
allow-looting-on-shears: true
Last updated on
Edit this page