Note: %life_bar% supports multiline hearts, so looks great in scoreboards & GUIs that support newlines.

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!"~~~~

Create heart-based gameplay systems:

• Heart shops
• Quest rewards
• Boss heart drops
• PvP systems
• Craftable hearts
• Economy conversion

Maven

<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

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    compileOnly 'com.github.jollyjoee:LifeEconomy:[1.0,)'
}

API Usage Example

import com.jolly.lifeEconomy.LifeEconomyAPI;
import com.jolly.lifeEconomy.LifeEconomy;
import org.bukkit.entity.Player;

public class Example {
  public static LifeEconomyAPI api;
  @Override
    public void onEnable() {
      if (!Bukkit.getPluginManager().isPluginEnabled("LifeEconomy")) {
            getLogger().severe("❌ LifeEconomy not found! Disabling plugin.");
            Bukkit.getPluginManager().disablePlugin(this);
            return;
        }
        LifeEconomy lifeEconomyPlugin = (LifeEconomy) getServer().getPluginManager().getPlugin("LifeEconomy");
        if (lifeEconomyPlugin == null) {
            getLogger().severe("LifeEconomy is not installed!");
            getServer().getPluginManager().disablePlugin(this);
            return;
        }
        api = lifeEconomyPlugin.getAPI();
        if (api == null) {
            getLogger().severe("Failed to get LifeEconomy API instance!");
            getServer().getPluginManager().disablePlugin(this);
            return;
        }
        getLogger().info("✅ Successfully hooked into LifeEconomy API!");
    }
}

Api Methods

// +1 heart and heal
api.giveHealth(player, 2.0, true);

// remove half a heart
api.takeHealth(player, 1.0);

// set exact health
api.setHealth(player, 40.0);

// get health
double health = api.getHealth(player)