Papyrus Options

Fork-specific settings beyond standard Paper configuration.

Entity random source

File: config/paper-global.yml

performance:
  entity-random-source: SHARED   # or VANILLA
  apply-runtime-jvm-defaults: true # Netty buffer caps, JNA nosys
  netty-threads: -1                # -1 = auto (4–8 based on CPU)

Value	Behavior	Use when
SHARED	All entities share one random source (Paper default, faster)	Performance matters; enchantment seed manipulation is not needed
VANILLA	Each entity gets RandomSource.create() like vanilla	Speedrunners, enchantment seed manipulation, or vanilla-like RNG

Paper's shared RNG breaks predictability that vanilla players rely on for enchantment table seed cycling.

JVM and Netty defaults

Key	Default	Effect
apply-runtime-jvm-defaults	true	Sets Netty buffer caps and jna.nosys at startup
netty-threads	-1 (auto)	Scales Netty event-loop threads (4–8) when not set in spigot.yml

performance.netty-threads sets io.netty.eventLoopThreads when spigot.yml does not override Netty thread count. Set either one, not both, unless you need different values.

Experience orbs

File: config/paper-world-defaults.yml or <world>/paper-world.yml

environment:
  experience-orb-despawn-rate: 6000   # ticks (vanilla: 6000)
  experience-orb-pickup-radius: 8.0   # blocks (vanilla: 8)

entities:
  spawning:
    experience-orb-merge-radius: 1.0    # merge search radius in blocks
  behavior:
    disable-experience-orb-merge: false

Lower experience-orb-pickup-radius to reduce orb lag on grinder servers. Set disable-experience-orb-merge: true if you want orbs to stay separate.

Redstone implementation

File: config/paper-world-defaults.yml or <world>/paper-world.yml

misc:
  redstone-implementation: VANILLA   # VANILLA | EIGENCRAFT | ALTERNATE_CURRENT
  alternate-current-update-order: HORIZONTAL_FIRST_OUTWARD   # only for ALTERNATE_CURRENT

Engine	Speed	Vanilla parity
VANILLA	Baseline	Full — same update order as Minecraft
EIGENCRAFT	~95% fewer wire updates on depower	Different update order; fixes MC-11193
ALTERNATE_CURRENT	Fastest in most benchmarks	Different update order; configurable direction

Default is VANILLA. Switch to EIGENCRAFT or ALTERNATE_CURRENT only on redstone-heavy technical servers.

See Redstone Presets for copy-paste configs.

Chunk system I/O threads

File: config/paper-global.yml

chunk-system:
  io-threads: -1      # auto-detect from CPU count (recommended)
  worker-threads: -1  # auto-detect from CPU count (recommended)

Papyrus auto-scales I/O threads to min(4, max(1, cpu_cores / 4)) when set to -1 or 0. Paper previously pinned this to a single I/O thread.

Integrated anticheat engine

See Papyrus README for server-side checks (x-ray heuristics, fast place/break, reach, movement, timer).

File: config/paper-global.yml → anticheat.engine

Client integrity (Papyrus Client)

Requires players to use Papyrus Client or the papyrus-shield Fabric mod. The client reports all installed mods to the server.

File: config/paper-global.yml

anticheat:
  client-integrity:
    enabled: true
    require-papyrus-client: true
    require-shield-mod: true
    download-url: https://docs.sushii.dev/papyrus-client/download
    banned-mod-ids:
      - meteor-client
      - wurst

Option	Description
enabled	Kick players without a valid integrity report
download-url	Shown on disconnect
banned-mod-ids	Substrings matched against reported mod ids

Bypass permission: papyrus.client.bypass

Full docs: Papyrus Client server setup