Merge configuration files and clean up option paths
I maintainer di solito rispondono entro 1 giorno
@kennytv ci sta già lavorando.
Dal 25/9/2026.
Valutazione
Questa issue non è ancora stata valutata.
Descrizione
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
- Lingua principale
- Java
- Stelle
- 12.8k
- Fork
- 3.6k
- Merge medio
- 3g 7h
- PR unite (30g)
- 19
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Nessun modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di PaperMC/Paper
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 77/100
I maintainer di solito rispondono entro 1 giorno
-
Add .getIgniter() to ExplosiveMinecartForse già presa @WouterGritter l’ha presa 61 giorni fa. Apertastatus: needs triage
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
PaperMC/Paper#14097 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno
-
BlockType#isOccluding is incorrectly handledForse già presa @ryoji-ikeda l’ha presa 205 giorni fa. Apertastatus: accepted
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
PaperMC/Paper#13790 · 5 commenti ·
I maintainer di solito rispondono entro 1 giorno
-
status: needs triage
Difficoltà 4/5 3-5 giorni Idoneità per principianti 43/100
PaperMC/Paper#14492 · 2 commenti ·
I maintainer di solito rispondono entro 1 giorno
-
[Checkstyle] Ignore check for javadocs into method-local classesForse già presa @Machine-Maker l’ha presa 2 giorni fa. Apertastatus: accepted
PaperMC/Paper#14490 · 1 assegnatario ·
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di PaperMC/Paper
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 65/100
I maintainer di solito rispondono entro 2 giorni
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 66/100
tchiotludo/akhq#3438 ·
I maintainer di solito rispondono entro 1 giorno
-
bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 66/100
Paul-Austin-Oswego-CSC480-HCI521/gift-app#266 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 85/100
ome/bioformats#4509 ·
I maintainer di solito rispondono entro 2 giorni
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
I maintainer di solito rispondono entro 1 giorno