From e6a98dd193fd7a93a68d0009bf92c5112b941641 Mon Sep 17 00:00:00 2001 From: tastybento Date: Mon, 7 Sep 2026 10:49:06 -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/caveblock/Settings.java | 10 ++++++++-- src/main/resources/config.yml | 10 ++++++++-- 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/src/main/java/world/bentobox/caveblock/Settings.java b/src/main/java/world/bentobox/caveblock/Settings.java index 6dd6abd..ca7f7a2 100644 --- a/src/main/java/world/bentobox/caveblock/Settings.java +++ b/src/main/java/world/bentobox/caveblock/Settings.java @@ -533,18 +533,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 caves.") @ConfigEntry(path = "cave.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 a cave's death penalty.") @ConfigEntry(path = "cave.deaths.max") private int deathsMax = 10; - @ConfigComment("Reset player death count when they start a new cave or reset a cave") + @ConfigComment("Reset player death count when they start a new cave or reset a cave.") + @ConfigComment("This only affects BentoBox's own per-player death count.") + @ConfigComment("Since Level 2.29.0 the Level addon clears a cave's own death record automatically when it is reset or deleted.") @ConfigEntry(path = "cave.deaths.reset-on-new") private boolean deathsResetOnNewIsland = true; - @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 %caveblock_deaths% placeholder.") + @ConfigComment("Since Level 2.29.0, cave levels use per-cave death tracking and are not affected by this setting.") @ConfigEntry(path = "cave.deaths.team-join-reset") private boolean teamJoinDeathReset = true; diff --git a/src/main/resources/config.yml b/src/main/resources/config.yml index 041bd39..b53a161 100644 --- a/src/main/resources/config.yml +++ b/src/main/resources/config.yml @@ -405,12 +405,18 @@ cave: 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 caves. 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 a cave's death penalty. max: 10 - # Reset player death count when they start a new cave or reset a cave + # Reset player death count when they start a new cave or reset a cave. + # This only affects BentoBox's own per-player death count. + # Since Level 2.29.0 the Level addon clears a cave's own death record automatically when it is reset or deleted. reset-on-new: true - # 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 %caveblock_deaths% placeholder. + # Since Level 2.29.0, cave levels use per-cave death tracking and are not affected by this setting. team-join-reset: true protection: # Geo restrict mobs.