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+

Verified on the latest builds. 1.2.1 is checked against Spigot 26.2, Paper 26.2 build 121, and Purpur 26.2 build 2627 — including the build-qualified version string Paper and Purpur now report (26.2.build.2627-stable), which the version detection reads correctly and the test suite pins in place.

On economy plugins. EconomyMachina only calls the standard Vault Economy interface, so it should also run under VaultUnlocked, the maintained Vault-compatible successor that keeps that interface. That is an API-level expectation rather than a tested setup — releases are tested against Vault itself.

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 59-test suite in CI before it ships.