Merge configuration files and clean up option paths

Đang mở
#14,304 9 bình luận 14 reaction 1 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@kennytv đang làm issue này rồi.

Từ ngày 25/9/2026.

Đánh giá

Issue này chưa được đánh giá.

Mô tả

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
Ngôn ngữ chính
Java
Star
12.8k
Fork
3.6k
Merge trung bình
3 ngày 7 giờ
Pull request đã merge (30 ngày)
19

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của PaperMC/Paper

Tất cả issue của PaperMC/Paper

Issue tương tự

Thêm issue về Java

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.