From 7c58bb7056929e535f49ad10d832c20a9dfcacdc Mon Sep 17 00:00:00 2001 From: tastybento Date: Mon, 7 Sep 2026 10:49:03 -0700 Subject: [PATCH] docs: clarify which deaths settings affect Level 2.29.0 island levels Level 2.29.0 tracks deaths per island itself. Update the config comments so admins can see that team-join-reset and reset-on-new only affect BentoBox's own death counter and placeholder, while counted and max still gate what Level records. Co-Authored-By: Claude Fable 5.1 Claude-Session: https://claude.ai/code/session_01SxX9oscerhv1nsozPbT5aX --- src/main/java/world/bentobox/boxed/Settings.java | 10 ++++++++-- src/main/resources/config.yml | 10 ++++++++-- 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/src/main/java/world/bentobox/boxed/Settings.java b/src/main/java/world/bentobox/boxed/Settings.java index 420269c..b0f5cd7 100644 --- a/src/main/java/world/bentobox/boxed/Settings.java +++ b/src/main/java/world/bentobox/boxed/Settings.java @@ -441,18 +441,24 @@ public class Settings implements WorldSettings { // Deaths @ConfigComment("Whether deaths are counted or not.") + @ConfigComment("If false, BentoBox does not count deaths and the Level addon does not record deaths against areas.") @ConfigEntry(path = "area.deaths.counted") private boolean deathsCounted = true; @ConfigComment("Maximum number of deaths to count. The death count can be used by add-ons.") + @ConfigComment("Since Level 2.29.0 this also caps how many deaths each member can contribute to an area's death penalty.") @ConfigEntry(path = "area.deaths.max") private int deathsMax = 10; - @ConfigComment("When a player joins a team, reset their death count") + @ConfigComment("When a player joins a team, reset their death count.") + @ConfigComment("This only affects BentoBox's own per-player death count, used by the %boxed_deaths% placeholder.") + @ConfigComment("Since Level 2.29.0, area levels use per-area death tracking and are not affected by this setting.") @ConfigEntry(path = "area.deaths.team-join-reset") private boolean teamJoinDeathReset = true; - @ConfigComment("Reset player death count when they start a new area or reset an area") + @ConfigComment("Reset player death count when they start a new area or reset an area.") + @ConfigComment("This only affects BentoBox's own per-player death count.") + @ConfigComment("Since Level 2.29.0 the Level addon clears an area's own death record automatically when it is reset or deleted.") @ConfigEntry(path = "area.deaths.reset-on-new-area") private boolean deathsResetOnNewIsland = true; diff --git a/src/main/resources/config.yml b/src/main/resources/config.yml index d8951dd..50f4aa0 100644 --- a/src/main/resources/config.yml +++ b/src/main/resources/config.yml @@ -474,12 +474,18 @@ area: require-confirmation: true deaths: # Whether deaths are counted or not. + # If false, BentoBox does not count deaths and the Level addon does not record deaths against areas. counted: true # Maximum number of deaths to count. The death count can be used by add-ons. + # Since Level 2.29.0 this also caps how many deaths each member can contribute to an area's death penalty. max: 10 - # When a player joins a team, reset their death count + # When a player joins a team, reset their death count. + # This only affects BentoBox's own per-player death count, used by the %boxed_deaths% placeholder. + # Since Level 2.29.0, area levels use per-area death tracking and are not affected by this setting. team-join-reset: true - # Reset player death count when they start a new area or reset an area + # Reset player death count when they start a new area or reset an area. + # This only affects BentoBox's own per-player death count. + # Since Level 2.29.0 the Level addon clears an area's own death record automatically when it is reset or deleted. reset-on-new-area: true protection: # Geo restrict mobs.