Перейти к содержимому
Mineforgian

LamDeathPenalties

Soul-point death system. Die too often, soul drains, penalties scale from item drops to health loss. Paper/Folia 1.21+.

Загрузки
114
Подписчики
2
Обновлён
5 апреля 2026 г.
Лицензия
GPL-3.0-only

Опубликован 10 октября 2025 г.

Die too often and your soul drains. Each death costs a soul point, and the lower your soul gets, the harsher the penalties: item drops, lost hearts, lost money, custom commands. Points come back on their own, on wall-clock time or active playtime.

How it works

  1. Players start with 10 soul points (configurable).
  2. Death costs 1 point. The new tier's penalties apply immediately.
  3. Each tier (0–10) defines its own penalties.
  4. Points regenerate in real time or per hour of playtime.
  5. Tiers you leave undefined inherit from the next higher defined tier, so you only configure the levels you care about.

How it works

Per-tier penalties

  • Item drops: drop percentage per tier, with separate hotbar and armor exposure toggles
  • Hearts: remove hearts as punishment, or grant bonus hearts at high soul as a reward
  • Vault money: flat or percent loss. PvP deaths transfer the money to the killer (configurable 0–100%); natural deaths burn it
  • Commands: run anything console can dispatch at a tier — titles, sounds, kicks

PvP has a long-term cost

Each player also has a personal max soul capacity. Killing another player lowers the killer's max, and it only regenerates back over time. Repeat killers walk around with a permanently shallow soul pool.

Commands

Command Permission
/lmdp — your soul points default
/lmdp check <player> lmdp.check.others
/lmdp preview — penalty table for every tier default
/lmdp set|give|take <player> <amount> lmdp.admin
/lmdp setmax|givemax|takemax <player> <amount> lmdp.admin
/lmdp reload lmdp.admin

Aliases: /dp, /deathpenalties, /soulpoints. Players with lmdp.bypass skip all penalties.

PlaceholderAPI

Expansion identifier is soulpoints:

  • %soulpoints_current% / %soulpoints_max%7 / 10
  • %soulpoints_progress_bar%███████░░░
  • %soulpoints_recovery_time%2h 15m 30s

Full placeholder list on GitHub.

Developer API

Service-provider API via Bukkit's ServicesManager. SoulPointsChangeEvent is cancellable before the change; SoulPointsChangedEvent fires after. Examples on GitHub.

Requirements

  • Paper or Folia 1.21+, Java 21
  • YskLib 1.8.0+ (required)
  • Vault (optional, money penalties) · PlaceholderAPI (optional)

Full config reference and YAML examples on GitHub.

Support: Discord · Issues

Ченджлог

0.8.0Бета1.21.9, 1.21.10, 1.21.11 · 5 апреля 2026 г.

0.8.0

  • Tier title/subtitle commands now fire after respawn instead of behind the death screen
  • Retuned defaults: "Low" → tier 5 (was 9), "Critical" → tier 2 (was 5)
  • Removed an unreliable Folia workaround

Upgrading: existing config.yml is preserved. If you want the new tier defaults, move your commands: blocks from tier 9 → 5 and tier 5 → 2.

Pure Folia caveat: PlayerRespawnEvent doesn't fire (Folia#105) so the post-respawn title + max-health reapply don't work there. Canvas/Paper unaffected.

0.6.4Бета1.21.9, 1.21.10, 1.21.11 · 29 января 2026 г.

New Features:

  • Max soul points system (lose max capacity for killing players)
  • PvP money transfer (killer receives money from victim)
  • Soulbound item support
  • New commands: /lmdp setmax, /lmdp givemax, /lmdp takemax

Important Fixes:

  • Thread safety for Folia servers
  • Prevents data loss on crashes
  • Config validation with auto-correction
0.5.2Бета1.21.8, 1.21.9, 1.21.10 · 10 октября 2025 г.

Initial Test Version

Комментарии

Загружаем…