LamDeathPenalties

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.

!(https://cdn.modrinth.com/data/cached_images/2058eba411ece3bef31c413ed1c234c85b2f40f1.png)

## 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 ` | `lmdp.check.others` | | `/lmdp preview` — penalty table for every tier | default | | `/lmdp set\|give\|take ` | `lmdp.admin` | | `/lmdp setmax\|givemax\|takemax ` | `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 (https://github.com/LamaliaNetwork/LamDeathPenalties).

## 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
• (https://github.com/YusakiDev/YskLib/releases) 1. 8. 0+ (required)
• Vault (optional, money penalties) · PlaceholderAPI (optional)

Full config reference and YAML examples on (https://github.com/LamaliaNetwork/LamDeathPenalties).

Support: (https://discord.gg/AjEh3dMPfq) · (https://github.com/LamaliaNetwork/LamDeathPenalties/issues)