From 2e93a9e44f6fbb411ee6077aae372a773aeb9687 Mon Sep 17 00:00:00 2001 From: tastybento Date: Mon, 7 Sep 2026 10:49:08 -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/aoneblock/Settings.java | 10 ++++++++-- src/main/resources/config.yml | 10 ++++++++-- 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/src/main/java/world/bentobox/aoneblock/Settings.java b/src/main/java/world/bentobox/aoneblock/Settings.java index 0652386..0de952e 100644 --- a/src/main/java/world/bentobox/aoneblock/Settings.java +++ b/src/main/java/world/bentobox/aoneblock/Settings.java @@ -616,18 +616,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 islands.") @ConfigEntry(path = "island.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 island's death penalty.") @ConfigEntry(path = "island.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 %aoneblock_deaths% placeholder.") + @ConfigComment("Since Level 2.29.0, island levels use per-island death tracking and are not affected by this setting.") @ConfigEntry(path = "island.deaths.team-join-reset") private boolean teamJoinDeathReset = true; - @ConfigComment("Reset player death count when they start a new island or reset an island") + @ConfigComment("Reset player death count when they start a new island or reset an island.") + @ConfigComment("This only affects BentoBox's own per-player death count.") + @ConfigComment("Since Level 2.29.0 the Level addon clears an island's own death record automatically when it is reset or deleted.") @ConfigEntry(path = "island.deaths.reset-on-new-island") // , since = "1.6.0") private boolean deathsResetOnNewIsland = true; diff --git a/src/main/resources/config.yml b/src/main/resources/config.yml index c366d19..4fffa1d 100644 --- a/src/main/resources/config.yml +++ b/src/main/resources/config.yml @@ -560,12 +560,18 @@ island: 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 islands. 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 island'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 %aoneblock_deaths% placeholder. + # Since Level 2.29.0, island levels use per-island death tracking and are not affected by this setting. team-join-reset: true - # Reset player death count when they start a new island or reset an island + # Reset player death count when they start a new island or reset an island. + # This only affects BentoBox's own per-player death count. + # Since Level 2.29.0 the Level addon clears an island's own death record automatically when it is reset or deleted. reset-on-new-island: true protection: # Geo restrict mobs.