# \u2764\ufe0f LifeEconomy \u2014 Hearts as Currency. Real SMP Stakes.<\/p>\n
Ever wanted to use **hearts as a currency**?
\nEver wanted players to **bleed power**, fight for hearts, and flex HP like an economy stat?<\/p>\n
Welcome to **LifeEconomy** \u2014 a **lifesteal-inspired heart economy system** for SMPs where:<\/p>\n
– Hearts are **money**
\n– Deaths have **real consequences**
\n– PvP is **profit**
\n– Survival = **strategy**<\/p>\n
Turn your server into a **true high-stakes SMP economy** where players literally grind blood for wealth.<\/p>\n
—<\/p>\n
## \u2705 Features<\/p>\n
– Persistent hearts (DB) \u2705
\n– Lose hearts on death \u2705
\n– Steal hearts on kill \u2705
\n– Minimum heart safety \u2705
\n– Folia compatible \u2705
\n– SQLite \u2705
\n– MySQL \u2705
\n– Action Bar hearts display \u2705
\n– Configurable everything \u2705
\n– Developer API \u2705
\n– Leaderboard \ud83d\udd1c
\n– PlaceholderAPI \u2705
\n– Heart items \u274c (Direct health economy, no drops)<\/p>\n
—<\/p>\n
**LifeEconomy is a Core-plugin, it’s features are limited if installed by itself. To enhance your LifeEconomy experience, consider adding these add-ons to your server.**<\/p>\n
## \ud83d\uddf3\ufe0f Available add-ons
\n– LifeEconomy-Shop
\n– _Other developers are welcome to send me their add-ons on my discord server! (Click the link on the page’s sidebar)_<\/p>\n
—<\/p>\n | Placeholder | Description | Example Output | > **Note:** `%life_bar%` supports **multiline hearts**, so looks great in scoreboards & GUIs that support newlines.<\/p>\n<\/details>\n —<\/p>\n “`yaml cost: #1 heart = 2.0 settings: #hearts-display appear on damage messages: —<\/p>\n ## \ud83d\udc51 Commands * \/health pay —<\/p>\n Create heart-based gameplay systems:<\/p>\n * Heart shops ### Maven<\/p>\n “`xml ### Gradle<\/p>\n “`gradle dependencies { ### API Usage Example public class Example { \/\/ remove half a heart \/\/ set exact health \/\/ get health —<\/p>\n ## \ud83d\udd79\ufe0f Perfect For<\/p>\n * Lifesteal SMPs —<\/p>\n ## \ud83d\udd25 Why LifeEconomy?<\/p>\n Unlike typical lifesteal plugins, this is a **true health-based economy system** designed to expand \u2014 not imitate.<\/p>\n Competitive. Scarce. Grindable. Tradable. Let the blood economy rise. \ud83e\ude78\ud83d\udc51<\/p>\n —<\/p>\n ## \u2699\ufe0f Installation Steps<\/p>\n 1. Download LifeEconomy Reward your PvP gods with an economy plugin that uses player health as a status of wealth! Lifesteal inspired!<\/p>\n","protected":false},"featured_media":93666,"template":"","meta":{"_minecraft_slug":"lifeeconomy","_minecraft_project_id":"GwM22ecb","_minecraft_author":"JollyJoe","_minecraft_license":"MIT","_minecraft_downloads":128,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"lifeeconomy.zip","_minecraft_size_bytes":105319,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T19:10:30.497812Z","_minecraft_date_created":"2025-11-05T07:52:39.689867Z","_minecraft_date_modified":"2025-11-04T04:35:07.071587Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/lifeeconomy","_minecraft_icon_attachment_id":93666,"_minecraft_imported_at":"2026-06-05T08:35:58+00:00","_minecraft_import_hash":"d7a48be81476fedde36838a9680f12bc","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,88,125,89,127,129,92],"mod_loader":[130,131,132,134],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-93665","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-equipment","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n\ud83d\udcca PlaceholderAPI Placeholders (click to expand)<\/summary>\n
\n|————|————-|—————-|
\n| `%life_health%` | Shows the player’s **raw health value** (internal HP, not hearts) | `36.0` |
\n| `%life_hearts%` | Shows the player’s **hearts count** | `18` |
\n| `%life_hearts_formatted%` | Displays hearts with a symbol & multiplier | `\u2764 x18` |
\n| `%life_percentage%` | Player health as a **percentage of default (20 HP)** | `180%` |
\n| `%life_min_health%` | Minimum health configured in the plugin | `2.0` |
\n| `%life_can_lose%` | How many hearts the player can lose before reaching minimum | `16` |
\n| `%life_is_min_health%` | Returns `true` if the player is at minimum health | `false` |
\n| `%life_bar%` | Heart bar UI across **multiple lines** (10 hearts per row, MiniMessage \u2192 Legacy converted)** | `\u2764\u2764\u2764\u2764\u2764\u2764\u2764\u2764\u2764\u2764`
`\u2764\u2764\u2764\u2764\u2764\u2764\u2764\u2764\u2764\u2764` |
\n| `%life_rank%` | Placeholder for upcoming leaderboard support | `Coming soon` |
\n| `%life_top_1%` | Placeholder for upcoming top player name support | `Coming soon` |
\n| `%life_top_1_hearts%` | Placeholder for upcoming top player hearts support | `Coming soon` |<\/p>\n\u2699\ufe0f Config Preview (click to expand)<\/summary>\n
\ndatabase: #use mysql to sync hearts across different servers on a proxy network
\n type: sqlite # or “mysql” use sqlite if you haven’t set up a mysql server
\n # SQLite options
\n file: hearts.db
\n # MySQL options (used only if type = mysql)
\n host: localhost
\n port: 3306
\n database: life_economy
\n username: root
\n password: “”
\n useSSL: false
\n pool-size: 10<\/p>\n
\n minimum-health: 2.0 #Minimum player health, no death will cause health to go below this (I suggest not changing this, 2.0 is 1 heart)
\n random-death: 2.0 #Just deletes 1 heart when a player dies from any other causes that’s not a player.
\n death-to-player: 2.0 #1 heart cost if they die to a player (gets transferred to killer)<\/p>\n
\n heal-on-kill: true
\n hearts-display: ACTION_BAR #type none if you don’t want a hearts display. ACTION_BAR is the only supported display for now
\n display-timeout: 4 #Seconds before display disappears<\/p>\n
\n no-hearts-lost: “
\n no-hearts-gained: “
\n pay: “
\n player-not-found: “
\n pay-more-than-minimum: “
\n pay-more-than-health: “
\n“`
\n<\/details>\n
\n* All \/life commands – (life.admin)
\n* \/life give
\n* \/life take
\n* \/life set
\n* \/life reload – Reload config<\/p>\n
\n> \u26a0\ufe0f 1 heart = 2 health points.<\/p>\n\ud83e\udde0 Developer API<\/summary>\n
\n* Quest rewards
\n* Boss heart drops
\n* PvP systems
\n* Craftable hearts
\n* Economy conversion<\/p>\n
\n
\n
\n
\n
\n <\/repository>
\n<\/repositories><\/p>\n
\n
\n
\n
\n
\n<\/dependency>
\n“`<\/p>\n
\nrepositories {
\n maven { url ‘https:\/\/jitpack.io’ }
\n}<\/p>\n
\n compileOnly ‘com.github.jollyjoee:LifeEconomy:[1.0,)’
\n}
\n“`<\/p>\n
\n“`java
\nimport com.jolly.lifeEconomy.LifeEconomyAPI;
\nimport com.jolly.lifeEconomy.LifeEconomy;
\nimport org.bukkit.entity.Player;<\/p>\n
\n public static LifeEconomyAPI api;
\n @Override
\n public void onEnable() {
\n if (!Bukkit.getPluginManager().isPluginEnabled(“LifeEconomy”)) {
\n getLogger().severe(“\u274c LifeEconomy not found! Disabling plugin.”);
\n Bukkit.getPluginManager().disablePlugin(this);
\n return;
\n }
\n LifeEconomy lifeEconomyPlugin = (LifeEconomy) getServer().getPluginManager().getPlugin(“LifeEconomy”);
\n if (lifeEconomyPlugin == null) {
\n getLogger().severe(“LifeEconomy is not installed!”);
\n getServer().getPluginManager().disablePlugin(this);
\n return;
\n }
\n api = lifeEconomyPlugin.getAPI();
\n if (api == null) {
\n getLogger().severe(“Failed to get LifeEconomy API instance!”);
\n getServer().getPluginManager().disablePlugin(this);
\n return;
\n }
\n getLogger().info(“\u2705 Successfully hooked into LifeEconomy API!”);
\n }
\n}
\n“`
\n### Api Methods
\n“`java
\n\/\/ +1 heart and heal
\napi.giveHealth(player, 2.0, true);<\/p>\n
\napi.takeHealth(player, 1.0);<\/p>\n
\napi.setHealth(player, 40.0);<\/p>\n
\ndouble health = api.getHealth(player)
\n“`
\n<\/details>\n
\n* Hardcore economy servers
\n* PvP arenas with stakes
\n* Factions\/Clans with power tied to health
\n* Custom survival RPG SMPs<\/p>\n
\nHeart wealth = power.<\/p>\n
\n2. Download [PlaceholderAPI for Folia
\n3. Install LifeEconomy.jar and PlaceholderAPI.jar into your plugins folder<\/p>\n","protected":false},"excerpt":{"rendered":"