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 | Send money to a player

Admin commands (permission level 3):
| Command | Description |
| :— | :— |
| /balance | Check someone’s balance
| /balset | Set a balance
| /balgive | Give money (negative = take)
| /balreload | Reload config + force save + rebuild tops
| /mfm multiplier add | 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.

————————————-=======########=======————————————-

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

_💰 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 | Посмотреть чужой баланс
| /balset | Установить баланс
| /balgive | Выдать деньги (отрицательная сумма — снять)
| /balreload | Перезагрузка конфига + сохранение + пересчёт топов
| /mfm multiplier add | Временный глобальный множитель дохода. Пример: 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.