Merge configuration files and clean up option paths
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ả
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
- 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
- Không có Dockerfile hay tệp Docker Compose
- Không có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- 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.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của PaperMC/Paper
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 77/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Add .getIgniter() to ExplosiveMinecartCó thể đã có người làm @WouterGritter đã nhận 61 ngày trước. Đang mởstatus: needs triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
PaperMC/Paper#14097 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
BlockType#isOccluding is incorrectly handledCó thể đã có người làm @ryoji-ikeda đã nhận 205 ngày trước. Đang mởstatus: accepted
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
PaperMC/Paper#13790 · 5 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
status: needs triage
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 43/100
PaperMC/Paper#14492 · 2 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
[Checkstyle] Ignore check for javadocs into method-local classesCó thể đã có người làm @Machine-Maker đã nhận 2 ngày trước. Đang mởstatus: accepted
PaperMC/Paper#14490 · 1 người được giao ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của PaperMC/Paper
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 65/100
Maintainer thường phản hồi trong vòng 2 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 66/100
tchiotludo/akhq#3438 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 66/100
Paul-Austin-Oswego-CSC480-HCI521/gift-app#266 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 85/100
ome/bioformats#4509 ·
Maintainer thường phản hồi trong vòng 2 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày