Merge configuration files and clean up option paths

未关闭
#14,304 9 条评论 14 个 reaction 已指派 1 人 在 GitHub 查看

维护者通常 1 天内回复

@kennytv 已经在做这个了。

开始于 2026年9月25日。

评估

这个 Issue 还没有评估数据。

描述

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
主要语言
Java
星标
12.8k
派生
3.6k
平均合并
3 天 7 小时
30 天内合并 PR
19

环境准备

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 阅读贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

PaperMC/Paper 的其他 Issue

查看 PaperMC/Paper 的全部 Issue

相似的 Issue

更多 Java Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。