CraftHub
PermanentHearts

PermanentHearts

A PaperMC plugin targeting Minecraft 1.20.1 - 1.20.6 that implements a persistent health penalty system, reducing a player’s maximum health by one heart upon each death.

32 downloads

<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/6-XU_NPxbs4" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

PermanentHearts is a Paper plugin that adds a persistent death penalty system to your server. Each time a player dies, they permanently lose 1 heart from their maximum health. Their reduced max health is saved automatically and remains after relogging and server restarts.

The plugin can also reward PvP kills by giving the killer 1 heart back, making combat feel more meaningful while still keeping death punishing. A minimum health limit is enforced so players can never drop below 1 heart.

Features

  • Lose 1 heart on every death
  • Reduces true max health, not just current health
  • Health loss is saved automatically
  • Works across relogging and server restarts
  • Minimum health floor of 1 heart
  • Optional PvP reward: killers regain 1 heart
  • Simple configuration
  • Admin commands for adding, setting, and checking hearts

Commands

/permanenthearts add <hearts> Adds hearts to yourself.

/permanenthearts add <player> <hearts> Adds hearts to another online player.

/permanenthearts set <hearts> Sets your total max hearts.

/permanenthearts set <player> <hearts> Sets another online player’s total max hearts.

/permanenthearts check Shows your current max hearts.

/permanenthearts check <player> Shows another online player’s current max hearts.

Alias: /phearts

Permissions

permanenthearts.admin Allows use of all admin commands. Default: op

Configuration

Default config:

enabled: true
restore-killer-heart-on-player-kill: true