From 3d65f40c33e889cdf945bb3eb2445bf157749213 Mon Sep 17 00:00:00 2001 From: tastybento Date: Mon, 7 Sep 2026 10:49:00 -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/bskyblock/Settings.java | 10 ++++++++-- src/main/resources/config.yml | 10 ++++++++-- 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/src/main/java/world/bentobox/bskyblock/Settings.java b/src/main/java/world/bentobox/bskyblock/Settings.java index 2f7342e..6d65181 100644 --- a/src/main/java/world/bentobox/bskyblock/Settings.java +++ b/src/main/java/world/bentobox/bskyblock/Settings.java @@ -475,18 +475,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 %bskyblock_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 ae156f1..df820e2 100644 --- a/src/main/resources/config.yml +++ b/src/main/resources/config.yml @@ -485,12 +485,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 %bskyblock_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. # Added since 1.6.0. reset-on-new-island: true protection: