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

Stats survive server restarts

🎮 Commands

Admin commands (permission level 3):

🔐 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 ®

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

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

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

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

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

Балансы хранятся в зашифрованном виде (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.