LifeEconomy

# ❤️ LifeEconomy — Hearts as Currency. Real SMP Stakes. Ever wanted to use **hearts as a currency**? Ever wanted players to **bleed power**, fight for hearts, and flex HP like an economy stat? Welcome to **LifeEconomy** — a **lifesteal-inspired heart economy system** for SMPs where: - Hearts are **money** - Deaths have **real consequences** - PvP is **profit** - Survival = **strategy** Turn your server into a **true high-stakes SMP economy** where players literally grind blood for wealth. --- ## ✅ Features - Persistent hearts (DB) ✅ - Lose hearts on death ✅ - Steal hearts on kill ✅ - Minimum heart safety ✅ - Folia compatible ✅ - SQLite ✅ - MySQL ✅ - Action Bar hearts display ✅ - Configurable everything ✅ - Developer API ✅ - Leaderboard 🔜 - PlaceholderAPI ✅ - Heart items ❌ (Direct health economy, no drops) --- **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.** ## 🗳️ Available add-ons - (https://modrinth.com/plugin/lifeeconomy-shop) - _Other developers are welcome to send me their add-ons on my discord server! (Click the link on the page's sidebar)_ --- <details> <summary>📊 PlaceholderAPI Placeholders (click to expand)</summary> | Placeholder | Description | Example Output | |------------|-------------|----------------| | `%life_health%` | Shows the player's **raw health value** (internal HP, not hearts) | `36.0` | | `%life_hearts%` | Shows the player's **hearts count** | `18` | | `%life_hearts_formatted%` | Displays hearts with a symbol & multiplier | `❤ x18` | | `%life_percentage%` | Player health as a **percentage of default (20 HP)** | `180%` | | `%life_min_health%` | Minimum health configured in the plugin | `2.0` | | `%life_can_lose%` | How many hearts the player can lose before reaching minimum | `16` | | `%life_is_min_health%` | Returns `true` if the player is at minimum health | `false` | | `%life_bar%` | Heart bar UI across **multiple lines** (10 hearts per row, MiniMessage → Legacy converted)** | `❤❤❤❤❤❤❤❤❤❤`<br>`❤❤❤❤❤❤❤❤❤❤` | | `%life_rank%` | Placeholder for upcoming leaderboard support | `Coming soon` | | `%life_top_1%` | Placeholder for upcoming top player name support | `Coming soon` | | `%life_top_1_hearts%` | Placeholder for upcoming top player hearts support | `Coming soon` | > **Note:** `%life_bar%` supports **multiline hearts**, so looks great in scoreboards & GUIs that support newlines. </details> --- <details> <summary>⚙️ Config Preview (click to expand)</summary> ```yaml database: #use mysql to sync hearts across different servers on a proxy network type: sqlite # or "mysql" use sqlite if you haven't set up a mysql server # SQLite options file: hearts.db # MySQL options (used only if type = mysql) host: localhost port: 3306 database: life_economy username: root password: "" useSSL: false pool-size: 10 cost: #1 heart = 2.0 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) random-death: 2.0 #Just deletes 1 heart when a player dies from any other causes that's not a player. death-to-player: 2.0 #1 heart cost if they die to a player (gets transferred to killer) settings: #hearts-display appear on damage heal-on-kill: true hearts-display: ACTION_BAR #type none if you don't want a hearts display. ACTION_BAR is the only supported display for now display-timeout: 4 #Seconds before display disappears messages: no-hearts-lost: "<red>You didn't lose any hearts.</red>" no-hearts-gained: "<red>You didn't gain any hearts.</red>" pay: "<gray>You gave <gold>{target}</gold><green> {amount} <red>health" player-not-found: "<red>That player does not exist or is not online!" pay-more-than-minimum: "<red>Cannot send if it results in you having less than {minimum} health!" pay-more-than-health: "<red>You're trying to pay more than what you have!"~~~~ ``` </details> --- ## 👑 Commands * All /life commands - (life.admin) * /life give <player> <health> - Give health * /life take <player> <health> - Remove health * /life set <player> <health> - Set health * /life reload - Reload config * /health pay <amount> <player> - Give another player your health. (life.health) > ⚠️ 1 heart = 2 health points. --- <details> <summary>🧠 Developer API</summary> Create heart-based gameplay systems: * Heart shops * Quest rewards * Boss heart drops * PvP systems * Craftable hearts * Economy conversion ### Maven ```xml <repositories> <repository> <id>jitpack.io</id> <url>https://jitpack.io</url> </repository> </repositories> <dependency> <groupId>com.github.jollyjoee</groupId> <artifactId>LifeEconomy</artifactId> <version>[1.0,)</version> <!-- always use newest >= 1.0 --> <scope>provided</scope> </dependency> ``` ### Gradle ```gradle repositories { maven { url 'https://jitpack.io' } }