Economy Machina

[1.1.0] — 2026-03-12

Added

• Milestone rewards — one-time coin bonuses for crossing stat thresholds (MOB_KILLS, FISH_CAUGHT, ANIMALS_BRED, and any UNTYPED Bukkit statistic). Milestones are claimed once per player and persisted to disk.
• Daily login streak — players who log in on consecutive days earn escalating streak rewards. Streak day and last-login date are tracked per-player and survive server restarts.
• Lifetime stats — every player now has a persistent lifetimeEarned and lifetimeLost record, saved to playerdata.yml and autosaved every 5 minutes.
• Top earners leaderboard — async-refreshed top-10 list cached every 5 minutes. Zero main-thread overhead.
• PlaceholderAPI expansion — %economymachina_balance%, %economymachina_lifetime_earned%, %economymachina_lifetime_lost%, %economymachina_streak%, %economymachina_rank%, %economymachina_top_N_name%, %economymachina_top_N_amount% (N = 1–10). Registers automatically if PlaceholderAPI is installed.
• Sound feedback — configurable sounds for earn, penalty, milestone, and streak events. Each sound is independently togglable with volume and pitch control.
• New misc triggers — LEVEL_UP (XP level up), RECIPE_DISCOVER (recipe unlock), WORLD_CHANGE (dimension travel). All configurable with chance and cooldown.
• Donor & rank bonus system — permission nodes economymachina.bonus.chance.<n> and economymachina.bonus.multiplier.<n> grant VIPs higher reward chance and coin multipliers. Highest node wins; no stacking abuse possible.
• Split exempt permissions — economymachina.exempt.earn and economymachina.exempt.penalty are now independent. economymachina.exempt is a parent node that grants both.
• Adventure/MiniMessage messaging — all player-facing messages now use MiniMessage format with brand color tags <paper> and <forest>. Full hex color and gradient support.

Changed

• Action bar notifications replace chat messages for all reward and penalty feedback.
• Primary command changed to /em (aliases: economymachina, machina).
• api-version bumped to 1.20 to opt out of legacy Paper shims.

Fixed & Optimized

• BonusResolver now caches per-player bonus lookups — single permission scan on first reward, O(1) map lookups for all subsequent rewards in the same session. Cache is invalidated on join and cleared on quit.
• CooldownManager.clearPlayer() is now called on quit — previously cooldown entries accumulated in memory for the lifetime of the server.
• Async autosave timer now calls saveAll() directly rather than scheduling a second async task.
• Progression event handler uses EventPriority.NORMAL (was MONITOR) — reward-granting logic must not run at monitor priority.
• All command feedback uses MessageUtil.send() — no remaining ChatColor legacy code.