Merge configuration files and clean up option paths
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
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
- https://github.com/PaperMC/Paper/pull/13877/ as a rich message with proper default
- Create a better system for pre-registry config field loading
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-intervalcovers server and player
data; the world optionchunks.auto-save-intervalcovers chunks below-zero-generation-in-existing-chunksis global now: If a world inspigot.ymlhad a
different value, that value is dropped/spigot reloadand/reload commandsare removed: Use/paper reloadto 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,#getSpigotConfigand#getPaperConfigare removedServer#getSpawnLimitandServer#getTicksPerSpawnsare deprecated for removal. They return the
primary world's value. Use theWorldmethodsWorld#setSpawnLimitwith a negative value now falls back to the world's configured limitServer#getWarnOnOverloadalways returnstrueBukkit#reloadCommandAliasesis 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
- Sin Dockerfile ni archivo de Docker Compose
- Sin plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de PaperMC/Paper
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 77/100
Los mantenedores suelen responder en 1 día
-
Add .getIgniter() to ExplosiveMinecartPosiblemente ocupada @WouterGritter la tomó hace 61 días. Abiertostatus: needs triage
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
PaperMC/Paper#14097 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
BlockType#isOccluding is incorrectly handledPosiblemente ocupada @ryoji-ikeda la tomó hace 205 días. Abiertostatus: accepted
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
PaperMC/Paper#13790 · 5 comentarios ·
Los mantenedores suelen responder en 1 día
-
status: needs triage
Dificultad 4/5 3-5 días Aptitud para principiantes 43/100
PaperMC/Paper#14492 · 2 comentarios ·
Los mantenedores suelen responder en 1 día
-
[Checkstyle] Ignore check for javadocs into method-local classesPosiblemente ocupada @Machine-Maker la tomó hace 2 días. Abiertostatus: accepted
PaperMC/Paper#14490 · 1 asignado ·
Los mantenedores suelen responder en 1 día
Todos los issues de PaperMC/Paper
Issues similares
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
Los mantenedores suelen responder en 2 días
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 66/100
tchiotludo/akhq#3438 ·
Los mantenedores suelen responder en 1 día
-
bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 66/100
Paul-Austin-Oswego-CSC480-HCI521/gift-app#266 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 85/100
ome/bioformats#4509 ·
Los mantenedores suelen responder en 2 días
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
Los mantenedores suelen responder en 1 día