RTN`s Economy Library

🇬🇧 English Version

💰 RTN EcoLib — Economy & Money For Killing Mobs

RTN EcoLib is an all-in-one economy mod and library for NeoForge 1.21.1 — a spiritual analogue of Bukkit/Spigot plugins like Vault and XConomy, with a built-in Money From Mobs system. Install it on both client and server; all data is stored only on the server. ⚔️ Earn Money From Mobs

Kill mobs — get paid! Works out of the box with any modded mobs and bosses, no entity lists required:

🐄 Passive mobs (cows, sheep, chickens...) — 1 ®
💀 Hostile mobs (creepers, skeletons, zombies...) — 5 ®
🐉 Bosses (Ender Dragon, Wither, modded bosses) — 100 ®

Boss detection is automatic: any mob with high max health counts as a boss, so bosses from other mods are rewarded properly. You can also fine-tune everything in the config:

entityOverrides — exact price for any entity: "minecraft:ender_dragon=500", "cataclysm:ignis=300"
bossEntities — force any modded entity to count as a boss

🔥 Combo System

Kill mobs fast to multiply your income!

After the first kill a 5-second timer starts
Kill the next mob in time — your combo grows: x1 → x2 → x3
Income is multiplied by the current combo
Miss the window — combo resets
Everything is beautifully displayed in the action bar in real time: +10 ® | Combo x2 | Session: 35 ®

📊 Stats & Tops

Command	Description
/mfm info	personal stats: mobs killed, total earned
/mfm top	top-10 hunters (cache rebuilt hourly)
/baltop	top-10 richest players

Stats survive server restarts

🎮 Commands

Command	Description
/balance, /bal, /money	Your balance
/baltop, /moneytop, /balancetop	Top-10 richest players
/pay <player> <amount>	Send money to a player

Admin commands (permission level 3):

Command	Description
/balance <player>	Check someone's balance
/balset <player> <amount>	Set a balance
/balgive <player> <amount>	Give money (negative = take)
/balreload	Reload config + force save + rebuild tops
/mfm multiplier add <mult> <seconds>	Temporary global income multiplier, e.g. add 2.0 60 doubles all income for 1 minute (announced to all players!)
/mfm multiplier remove	Reset the multiplier to x1.0
/баланс, /бал, /балтоп, /баланстоп	Russian command aliases

🔐 Secure Server-Side Storage

Balances are stored encrypted (AES-256-GCM) in the server's rtnecolib/ folder
Encryption key is generated automatically on first start
Periodic async-friendly saving (default: every 5 minutes) — no server lag
Atomic writes + automatic .bak backup

⚙️ Configuration

Everything is configurable in config/rtnecolib-common.toml: currency symbol (default ®), starting balance, rewards, boss health threshold, combo window & max, save interval, top rebuild interval and more.

🧩 For Developers — Public API

RTN EcoLib is designed as a library: add it as a compileOnly dependency and use a clean, Vault-style API:

Java

RTNEconomyAPI eco = RTNEconomyProvider.get();
eco.deposit(playerUuid, 100.0, "quest reward");
eco.withdraw(playerUuid, 50.0, "shop purchase");
eco.transfer(from, to, 25.0, "trade");
eco.setGlobalMultiplier(2.0, 300); // x2 event for 5 minutes

Events on the API bus for other mods:

BalanceChangeEvent — audit, modify or cancel any transaction
MobRewardEvent — set custom rewards / boss flags for your own mobs

Perfect base for shops, quests, jobs, auctions and any money-driven mods.

• Dependencies: None (fully standalone mod)
• Sides: client + server (data server and client-side)
• Site RTN Project: click.

My mods in ecosystem:

• [RTN`s PALM Auth](https://www.curseforge.com/minecraft/mc-mods/rtn-s-palm-auth)
• Random Loot Mob Drops (RLMD)
• PocketGrove

-------------------------------------=======########=======-------------------------------------

🇷🇺 Русская версия:

💰 RTN EcoLib — Экономика и деньги за убийство мобов

RTN EcoLib — мод-библиотека экономики «всё в одном» для NeoForge 1.21.1: аналог плагинов Vault и XConomy со Spigot, со встроенной системой Money From Mobs. Ставится на клиент и сервер; все данные хранятся только на сервере. ⚔️ Деньги за мобов

Убивай мобов — получай монеты! Из коробки работает с любыми мобами и боссами из других модов, без списков сущностей:

🐄 Мирные мобы (коровы, овцы, куры...) — 1 ®
💀 Монстры (криперы, скелеты, зомби...) — 5 ®
🐉 Боссы (Дракон Края, Визер, модовые боссы) — 100 ®

Определение боссов автоматическое: любой моб с большим запасом здоровья считается боссом, поэтому боссы из других модов оплачиваются корректно. Всё тонко настраивается в конфиге:

entityOverrides — точная цена за любую сущность: "minecraft:ender_dragon=500", "cataclysm:ignis=300"
bossEntities — пометить любого модового моба как босса

🔥 Система комбо

Убивай мобов быстро, чтобы увеличить доход!

После первого убийства запускается таймер на 5 секунд
Успел убить следующего — комбо растёт: x1 → x2 → x3
Доход умножается на текущее комбо
Не успел — комбо сбрасывается
Всё красиво отображается над инвентарём (Action Bar) в реальном времени: +10 ® | Комбо x2 | За серию: 35 ®

📊 Статистика и топы

Command	Description
/mfm info	личная статистика: убито мобов, всего заработано
/mfm top	топ-10 охотников (кэш обновляется раз в час)
/baltop	топ-10 богачей

Статистика не пропадает при перезагрузке сервера

🎮 Команды Команда Описание

Command	Description
/balance, /bal, /money, /баланс, /бал	Свой баланс
/baltop, /moneytop, /balancetop, /балтоп, /баланстоп	Топ-10 богачей
/pay <ник> <сумма>	Перевод денег игроку
/mfm info / /mfm top	Статистика MFM / топ охотников

Команды для админов:

Command	Description
/balance <player>	Посмотреть чужой баланс
/balset <player> <amount>	Установить баланс
/balgive <player> <amount>	Выдать деньги (отрицательная сумма — снять)
/balreload	Перезагрузка конфига + сохранение + пересчёт топов
/mfm multiplier add <mult> <seconds>	Временный глобальный множитель дохода. Пример: add 2.0 60 — удвоит доход со всех мобов на 1 минуту (с объявлением в чат всем игрокам!)
/mfm multiplier remove	Сброс множителя до x1.0

🔐 Безопасное хранение на сервере

Балансы хранятся в зашифрованном виде (AES-256-GCM) в папке rtnecolib/ на сервере
Ключ шифрования генерируется автоматически при первом запуске
Периодическое сохранение (по умолчанию раз в 5 минут) — без нагрузки на сервер
Атомарная запись + автоматический бэкап .bak

⚙️ Настройка

Всё настраивается в config/rtnecolib-common.toml: символ валюты (по умолчанию ®), стартовый баланс, награды, порог здоровья босса, окно и максимум комбо, интервал сохранения, период обновления топа и другое.

🧩 Разработчикам — публичный API

RTN EcoLib создан как библиотека: подключайте через compileOnly и используйте чистый API в стиле Vault:

Java

RTNEconomyAPI eco = RTNEconomyProvider.get();
eco.deposit(playerUuid, 100.0, "quest reward");
eco.withdraw(playerUuid, 50.0, "shop purchase");
eco.transfer(from, to, 25.0, "trade");
eco.setGlobalMultiplier(2.0, 300); // ивент x2 на 5 минут

События на шине API для других модов:

BalanceChangeEvent — аудит, изменение или отмена любой транзакции
MobRewardEvent — своя цена / флаг босса для ваших мобов

Идеальная база для магазинов, квестов, работ, аукционов и любых модов с деньгами.

• Зависимости: Отсутствуют (полностью автономный мод)
• Стороны: клиент + сервер (данные — сохранение на сервере и в одиночной игре)
• Сайт RTN Project: click.

Другие мои моды из экосистемы:

• [RTN`s PALM Auth](https://www.curseforge.com/minecraft/mc-mods/rtn-s-palm-auth)
• Random Loot Mob Drops (RLMD)
• PocketGrove