Plugin documentation
SMP Lifesteal commands and configuration
SMP Lifesteal commands, permissions, storage defaults and heart-death settings for survival servers.
Documentation and contents
What it does
SMP Lifesteal is a lifesteal core built around lives, heart items, withdrawal, and rebirth. On player death, the attacker gains a life by default. If the attacker is already at maximum, the heart drops instead. Entity and natural deaths can also drop hearts. First-join protection defaults to 10m.
The repository also ships compatibility grammar for ZelSteal and LifeStealZ command shapes, plus PlaceholderAPI expansions named smplifesteal and zelsteal. It is not a general economy or punishment suite.
Requirements
- Bukkit/Spigot/Paper/Purpur/Folia.
plugin.ymldeclaresfolia-supported: true. - Minecraft
1.8.8through1.21.x, as stated inREADME.md. - Java 8 source/target in the POM. That is a build target, not a runtime guarantee.
- Optional soft dependencies: PlaceholderAPI, WorldGuard, Vault, AxAuctions.
- A storage backend: local YAML files, SQLite, or MySQL. MySQL can use local YAML as a shadow and fallback.
Build and storage
README.md documents:
mvn test
mvn -DskipTests package
The output is target/smplifesteal-1.1.5.jar. The README calls SQLite the default at plugins/SMPLifesteal/storage.db, but the bundled settings.yml sets database-type: yml. The SQLite path applies only after you switch the type. settings.yml also sets fallback.use-local-yml-when-sql-down: true, while allow-default-player-when-sql-down-and-no-local-file stays false.
Storage values are yml, sqlite, and mysql. With local-yml.shadow-sql-storage: true, SQL-backed installs also write local YAML copies.
Configure
A minimal excerpt of real keys:
Database-Settings:
database-type: sqlite
sqlite:
file: data/storage.db
Lives-Settings:
default-lives: 10
default-max-lives: 20
withdraw:
min-lives-after-withdraw: 1
default-amount: 1
rebirth:
lives-to-reset-to: 10
Related defaults in the same file:
health-points-per-life: 2.0, withclamp-health-on-apply: true.ban-time: 1w. Life bans are checked at pre-login by default.withdraw.max-amount-per-command: 64;drop-if-inventory-full: false.rebirth.max-rebirths: 10andmax-life-increase: 1.- Death rewards:
by-player.enabled: true,attacker-gains-life: true,drop-when-attacker-maxed: true. Entity and natural drops are also enabled. - Same-victim reward cooldowns default to
15mfor player, entity, and natural deaths. Anti-Alt-Settings.enabled: true. Replace the shippedip-hash-saltplaceholder with a unique random value before you enable detection in production.Anti-Dupe-Settings.enabled: false. Enabling it prevents heart reuse but disables heart stacking, per the file’s own comment.
Cross-Server.enabled is false. Redis is needed only when cross-server sync is on.
Commands
Root command /lifesteal has aliases smplifesteal, lives, and live:
/withdraw [amount]converts lives into heart items./rebirthresets lives and adds permanent maximum lives when eligible./lifesteal admin reload/lifesteal admin info [player]/lifesteal admin setlives|addlives|removelives <player> <amount>/lifesteal admin setmaxlives|addmaxlives|removemaxlives <player> <amount>/lifesteal admin setrebirths <player> <amount>/lifesteal admin ban <player> [duration]andunban <player>/lifesteal admin giveheart <player> [type]/lifesteal admin convert <source> [--dry-run|--apply]
ZelSteal-shaped commands such as /zelsteal lives and /zelsteal withdraw map onto the same operations.
Permissions
Player nodes default to true: lifesteal.use, lifesteal.withdraw, lifesteal.rebirth. lifesteal.view.others defaults to op.
Admin nodes default to op: lifesteal.admin plus reload, setlives, addlives, removelives, setmaxlives, addmaxlives, setrebirths, ban, unban, giveheart, info, and convert.
Notification nodes lifesteal.antialt.notify and lifesteal.antidupe.notify default to op. The descriptor also declares parallel smplifesteal.* and zelsteal.* nodes for compatibility. It also declares lifesteal.bypass.firstjoin, antialt, antidupe, and life-ban nodes, all defaulting to op.
Troubleshooting
- Placeholders render literally. Restart after installing the expansion, confirm PlaceholderAPI is present, and run
/papi reload. - WorldGuard hook missing. Check startup for the hook line and load order. On Folia, confirm the scheduler bridge initialized.
- SQL unavailable. The plugin falls back to local YAML when
use-local-yml-when-sql-downis true. Check credentials and connectivity rather than deleting data. - Duplicate heart message. Expected while anti-dupe is enabled, because hearts are single-use records. It ships disabled, which also permits stacking.
- Anti-alt misses accounts. Change the salt from the placeholder and confirm players arrive with consistent IPs. VPNs can create false relations.
- Folia scheduler warnings. Update the plugin and review
Advanced-Settings.scheduler-pool-size.