EconomyMachina

Your players are already doing the work. Pay them for it.

EconomyMachina turns everyday gameplay into a living economy. Mine a diamond, catch a fish, tame a horse, survive a creeper — every action has a chance to pay out. No commands to learn, no tasks to complete. Just play.

---

What It Does

Players earn coins automatically as they explore, build, fight, and craft. A clean action bar notification lets them know when they get paid — no chat spam, no popups. It feels like a natural part of the game, because it is.

Deaths cost coins. Player kills have a cooldown per victim. Mob farm abuse is blocked with randomized reward windows. Everything is tunable — or just use the defaults and go.

---

Features

• Coins for mining, fishing, crafting, enchanting, taming, combat, farming and more
• 30+ individual triggers — each with its own chance and optional cooldown
• Rewards shown in the action bar — subtle, non-intrusive, with sound feedback
• Death penalty to add stakes
• Anti-abuse cooldowns on loopable actions (mob farms, vehicles, reconnects)
• Donor & rank bonuses — give VIPs a higher chance or bigger payouts, no config needed
• Milestone rewards — one-time bonuses for stat thresholds (kill 100 mobs, catch 50 fish, etc.)
• Daily login streak — escalating rewards for players who keep coming back
• Lifetime stats — track total coins earned and lost per player, persisted to disk
• Top earners leaderboard — async-refreshed top-10 cached every 5 minutes
• PlaceholderAPI support — surface stats in scoreboards, tab lists, holograms, and more
• Typo-proof config — every material and entity name is checked against your server at load. A typo gets a clear console warning instead of silently never paying out, and legacy names like PIG_ZOMBIE auto-correct
• Hot reload — change the config and /em reload, no restart needed
• One jar, every server since 1.20 — through the latest 26.2 (Chaos Cubed) drop
• Works with any Vault economy — EssentialsX, CMI, and more

---

Setup

1. Install Vault and an economy plugin (EssentialsX recommended)
2. Drop EconomyMachina.jar into your plugins/ folder
3. Restart your server
4. Tweak config.yml to your liking
5. Run /em reload to apply changes live

Optional: Install PlaceholderAPI to use %economymachina_*% placeholders anywhere. On Minecraft 26.x servers, PlaceholderAPI 2.12.3 or newer is required (older releases fail to parse the new server version format).

---

Configuration

Every action has a chance (0–100%) and an optional cooldown. Low chance means rewards feel like a lucky drop. High chance means the action itself is the limiter. You control the pace.

actions:
  blocksMined:
    DIAMOND_ORE:
      chance: 70.0
      reward: 1

  combat:
    killMonster:
      reward: 1
      cooldown:
        min: 3
        max: 8

  misc:
    fish:
      chance: 15.0
      reward: 1

milestones:
  enabled: true
  MOB_KILLS:
    50:  5
    100: 10
    500: 50

streak:
  enabled: true
  rewards:
    3:  5
    7:  15
    14: 30
    30: 75

The full config ships with comments on every section — no guessing. And if something is off anyway, you'll know: every material, entity, statistic, and sound name is validated when the config loads, with a console warning naming the exact bad entry.

---

PlaceholderAPI Placeholders

Placeholder	Returns
%economymachina_balance%	Player's current coin balance
%economymachina_lifetime_earned%	Total coins earned all-time
%economymachina_lifetime_lost%	Total coins lost all-time
%economymachina_streak%	Current daily login streak
%economymachina_rank%	Leaderboard rank (1–10, or empty)
%economymachina_top_N_name%	Name of rank N player (N = 1–10)
%economymachina_top_N_amount%	Coins earned by rank N player

---

Donor & Rank Bonuses

Give donators a better experience without touching the config. Just assign a permission node in LuckPerms (or any permissions plugin) and EconomyMachina handles the rest.

Chance bonus — increases the probability of earning on every action:

economymachina.bonus.chance.10   → +10% chance (Donor)
economymachina.bonus.chance.25   → +25% chance (Donor+)
economymachina.bonus.chance.50   → +50% chance (VIP)

Reward multiplier — increases how many coins are earned when a reward fires:

economymachina.bonus.multiplier.25   → 1.25x coins (Donor)
economymachina.bonus.multiplier.50   → 1.5x  coins (Donor+)
economymachina.bonus.multiplier.100  → 2x    coins (VIP)

Mix and match freely. If a player has multiple nodes (e.g. from overlapping rank groups), the highest value always wins — no stacking abuse.

---

Commands

Command	What it does
/em reload	Reload config live
/em give <player> <amount>	Give coins to a player
/em take <player> <amount>	Remove coins from a player
/em balance [player]	Check a player's balance

---

Permissions

Node	Default	Description
economymachina.balance	everyone	Check your own balance
economymachina.balance.others	op	Check any player's balance
economymachina.give	op	Give coins to a player
economymachina.take	op	Remove coins from a player
economymachina.reload	op	Hot-reload the config
economymachina.exempt	false	Never earns or loses coins
economymachina.exempt.earn	false	Never earns coins
economymachina.exempt.penalty	false	Never loses coins on death
economymachina.bonus.chance.<n>	false	+n% chance on all rewards
economymachina.bonus.multiplier.<n>	false	×(1+n/100) coins on all rewards
economymachina.*	false	Everything

---

Requirements

• Spigot / Paper / Purpur 1.20 – 26.2
• Java 17+ (26.x servers already run Java 25, which is fully compatible)
• Vault + any economy provider
• On Minecraft 26.x servers using placeholders: PlaceholderAPI 2.12.3+

Compatible Minecraft versions: 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

---

MIT-licensed. Every release passes a 54-test suite in CI before it ships.