From ed7e59634ecbb7d32c4233fe731b69a3528dcb79 Mon Sep 17 00:00:00 2001 From: tastybento Date: Mon, 7 Sep 2026 10:49:13 -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/poseidon/Settings.java | 10 ++++++++-- src/main/resources/config.yml | 10 ++++++++-- 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/src/main/java/world/bentobox/poseidon/Settings.java b/src/main/java/world/bentobox/poseidon/Settings.java index 687ef5d..e696ac4 100644 --- a/src/main/java/world/bentobox/poseidon/Settings.java +++ b/src/main/java/world/bentobox/poseidon/Settings.java @@ -567,18 +567,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 realms.") @ConfigEntry(path = "realm.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 realm's death penalty.") @ConfigEntry(path = "realm.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 %poseidon_deaths% placeholder.") + @ConfigComment("Since Level 2.29.0, realm levels use per-realm death tracking and are not affected by this setting.") @ConfigEntry(path = "realm.deaths.team-join-reset") private boolean teamJoinDeathReset = true; - @ConfigComment("Reset player death count when they start a new realm or reset and realm") + @ConfigComment("Reset player death count when they start a new realm or reset a realm.") + @ConfigComment("This only affects BentoBox's own per-player death count.") + @ConfigComment("Since Level 2.29.0 the Level addon clears a realm's own death record automatically when it is reset or deleted.") @ConfigEntry(path = "realm.deaths.reset-on-new-realm") private boolean deathsResetOnNewIsland = true; diff --git a/src/main/resources/config.yml b/src/main/resources/config.yml index 0be2f28..022ef62 100644 --- a/src/main/resources/config.yml +++ b/src/main/resources/config.yml @@ -608,12 +608,18 @@ realm: 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 realms. 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 realm'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 %poseidon_deaths% placeholder. + # Since Level 2.29.0, realm levels use per-realm death tracking and are not affected by this setting. team-join-reset: true - # Reset player death count when they start a new realm or reset and realm + # Reset player death count when they start a new realm or reset a realm. + # This only affects BentoBox's own per-player death count. + # Since Level 2.29.0 the Level addon clears a realm's own death record automatically when it is reset or deleted. reset-on-new-realm: true customranks: {} protection: