Merge configuration files and clean up option paths

Abierto
#14,304 9 comentarios 14 reacciones 1 asignado Ver en GitHub

Los mantenedores suelen responder en 1 día

@kennytv ya está trabajando en esto.

Desde el 25/9/2026.

Evaluación

Este issue todavía no se ha evaluado.

Descripción

for: future scope: configuration type: feature

https://github.com/PaperMC/Paper/tree/feature/config-merge contains the work on merging and upgrading the config, with a small number of renames and removals already.

Pending changes

Changed types

Option Change
commands.tab-completion Now a boolean
messages.send-command-parse-failure-message Now a boolean
messages.kick.*, messages.shutdown Now MiniMessage. {0} -> %s
misc.deprecated-verbose Now ON, OFF or DEFAULT
chunks.view-distance, chunks.simulation-distance, entities.spawning.trident-despawn-rate, seeds.mineshaft, seeds.stronghold A number, or default
attributes.overrides A map, so any ranged attribute can be capped

Removed unused options

settings.warn-on-overload, settings.plugin-profiling, settings.compatibility,
commands.replace-commands, world-settings.*.max-tick-time and world-settings.*.verbose.

Behavior changes

  • Spawn limits and spawn intervals are per world now: Set them in paper-world-defaults.yml
  • Auto-saving has two separate settings: misc.auto-save-interval covers server and player
    data; the world option chunks.auto-save-interval covers chunks
  • below-zero-generation-in-existing-chunks is global now: If a world in spigot.yml had a
    different value, that value is dropped
  • /spigot reload and /reload commands are removed: Use /paper reload to reload the same settings

Moved and renamed options

bukkit.yml → paper-global.yml
settings.world-container      -> initialization.world-container
settings.update-folder        -> initialization.update-folder
settings.allow-end            -> misc.enable-end
settings.permissions-file     -> misc.permissions-file
settings.connection-throttle  -> misc.connection-throttle
settings.query-plugins        -> misc.query-plugins
settings.deprecated-verbose   -> misc.deprecated-verbose
settings.minimum-api          -> misc.minimum-api
settings.use-map-color-cache  -> misc.use-map-color-cache
settings.shutdown-message     -> messages.shutdown
chunk-gc.period-in-ticks      -> chunk-system.plugin-ticket-timeout
ticks-per.autosave            -> misc.auto-save-interval
worlds.<world>.generator      -> world-generators.<world>.generator
worlds.<world>.biome-provider -> world-generators.<world>.biome-provider
aliases                       -> commands.aliases
bukkit.yml → paper-world-defaults.yml
ticks-per.autosave                          -> chunks.auto-save-interval
spawn-limits.monsters                       -> entities.spawning.spawn-limits.monster
spawn-limits.animals                        -> entities.spawning.spawn-limits.creature
spawn-limits.water-animals                  -> entities.spawning.spawn-limits.water_creature
spawn-limits.water-ambient                  -> entities.spawning.spawn-limits.water_ambient
spawn-limits.water-underground-creature     -> entities.spawning.spawn-limits.underground_water_creature
spawn-limits.axolotls                       -> entities.spawning.spawn-limits.axolotls
spawn-limits.ambient                        -> entities.spawning.spawn-limits.ambient
ticks-per.monster-spawns                    -> entities.spawning.ticks-per-spawn.monster
ticks-per.animal-spawns                     -> entities.spawning.ticks-per-spawn.creature
ticks-per.water-spawns                      -> entities.spawning.ticks-per-spawn.water_creature
ticks-per.water-ambient-spawns              -> entities.spawning.ticks-per-spawn.water_ambient
ticks-per.water-underground-creature-spawns -> entities.spawning.ticks-per-spawn.underground_water_creature
ticks-per.axolotl-spawns                    -> entities.spawning.ticks-per-spawn.axolotls
ticks-per.ambient-spawns                    -> entities.spawning.ticks-per-spawn.ambient
spigot.yml → paper-global.yml
settings.bungeecord                    -> proxies.bungee-cord.enabled
settings.debug                         -> logging.debug
settings.log-villager-deaths           -> logging.villager-deaths
settings.log-named-deaths              -> logging.named-living-entity-deaths
settings.timeout-time                  -> watchdog.timeout-seconds
settings.restart-on-crash              -> watchdog.restart-on-crash
settings.restart-script                -> watchdog.restart-script
settings.moved-wrongly-threshold       -> anticheat.moved-wrongly-threshold
settings.moved-too-quickly-multiplier  -> anticheat.moved-too-quickly-multiplier
settings.user-cache-size               -> players.user-cache-size
settings.save-user-cache-on-stop-only  -> players.save-user-cache-on-stop-only
settings.sample-count                  -> players.sample-count
settings.player-shuffle                -> players.connection-shuffle
settings.netty-threads                 -> misc.netty-threads
settings.attribute.<attribute>.max     -> attributes.overrides.minecraft:<attribute>.max
                                          (maxHealth -> max_health, ...)
messages.whitelist                     -> messages.kick.whitelist
messages.server-full                   -> messages.kick.server-full
messages.outdated-client               -> messages.kick.outdated-client
messages.outdated-server               -> messages.kick.outdated-server
messages.restart                       -> messages.kick.restart
messages.unknown-command               -> messages.send-command-parse-failure-message
commands.log                           -> logging.command-execution
commands.send-namespaced               -> commands.send-namespaced-commands
commands.tab-complete                  -> commands.tab-completion
commands.silent-commandblock-console   -> commands.silent-command-block-console
commands.spam-exclusions               -> spam-limiter.commands.exclusions
commands.enable-spam-exclusions        -> spam-limiter.commands.enabled
players.disable-saving                 -> unchanged
advancements.disable-saving            -> unchanged
advancements.disabled                  -> initialization.disabled-advancements
stats.disable-saving                   -> unchanged
stats.forced-stats                     -> stats.forced-custom-stat-values
world-settings.default.below-zero-generation-in-existing-chunks
                                       -> misc.below-zero-generation-in-existing-chunks
spigot.yml world-settings.<world> → paper-world-defaults.yml / paper-world.yml
view-distance                         -> chunks.view-distance
simulation-distance                   -> chunks.simulation-distance
unload-frozen-chunks                  -> chunks.unload-frozen-chunks
mob-spawn-range                       -> entities.spawning.mob-spawn-range
item-despawn-rate                     -> entities.spawning.item-despawn-rate
arrow-despawn-rate                    -> entities.spawning.arrow-despawn-rate
trident-despawn-rate                  -> entities.spawning.trident-despawn-rate
nerf-spawner-mobs                     -> entities.spawning.spawner-mobs.nerf
enable-zombie-pigmen-portal-spawns    -> entities.spawning.portal-zombified-piglins.enabled
zombie-aggressive-towards-villager    -> entities.behavior.zombie-aggressive-towards-villager
merge-radius.item                     -> entities.behavior.merge-radius.item
merge-radius.exp                      -> entities.behavior.merge-radius.experience
entity-tracking-range.<category>      -> entities.tracking-range.<category>
                                         (singular: players -> player, ...)
entity-activation-range.*             -> entities.activation-range.*
max-entity-collisions                 -> collisions.max-entity-collisions
thunder-chance                        -> environment.thunder-chance
hopper-amount                         -> hopper.amount
hopper-can-load-chunks                -> hopper.can-load-chunks
ticks-per.hopper-transfer             -> tick-rates.hopper-transfer
ticks-per.hopper-check                -> tick-rates.hopper-check
hanging-tick-frequency                -> tick-rates.hanging-tick-frequency
max-tnt-per-tick                      -> fixes.max-tnt-per-tick
<source>-sound-radius                 -> misc.sound-radius.<source>
                                         (dragon-death, wither-spawn, end-portal)
growth.<plant>-modifier               -> growth-modifiers.<plant>
                                         (dashes between words: netherwart -> nether-wart, ...)
seed-<structure>                      -> seeds.<structure>
                                         (dashes between words: endcity -> end-city, ...)
hunger.*                              -> unchanged
Within paper-global.yml
player-auto-save                        -> players.auto-save
misc.strict-advancement-dimension-check -> advancements.strict-dimension-check
Within paper-world-defaults.yml / paper-world.yml
entities.behavior.spawner-nerfed-mobs-should-jump -> entities.spawning.spawner-mobs.nerfed-should-jump
entities.behavior.nerf-pigmen-from-nether-portals -> entities.spawning.portal-zombified-piglins.nerf

For plugin developers

  • Server.Spigot#getConfig, #getBukkitConfig, #getSpigotConfig and #getPaperConfig are removed
  • Server#getSpawnLimit and Server#getTicksPerSpawns are deprecated for removal. They return the
    primary world's value. Use the World methods
  • World#setSpawnLimit with a negative value now falls back to the world's configured limit
  • Server#getWarnOnOverload always returns true
  • Bukkit#reloadCommandAliases is deprecated and does the same as /paper reload
Lenguaje dominante
Java
Estrellas
12.8k
Forks
3.6k
Merge medio
3 d 7 h
PR fusionados (30 d)
19

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de PaperMC/Paper

Todos los issues de PaperMC/Paper

Issues similares

Más issues de Java

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.