Economy Plugin

Economy Plugin

Complete economy system for Hytale servers featuring player balance management, leaderboards, P2P payments, and admin tools, powered by the Vault storage API.

68.0 загрузок
Обновлён 12 дней назад

Описание

башня ЭКОНОМИЧЕСКИЙ ПЛЮГИН - ПРОИЗВОДСТВО ПОЛНОЙ ОПИСАНИИ

Обзор

Экономика — это полноценная финансовая система для серверов Hytale. Построенный на API хранилища Vault, он предоставляет администраторам серверов и игрокам надежную, гибкую экономику с управлением балансом, безопасными транзакциями, конкурентными таблицами лидеров и полным контролем администратора.

Что такое экономика?

Экономика превращает Hytale сервер в процветающий рынок. Игроки зарабатывают, тратят и торгуют валютой. Администраторы поддерживают контроль с помощью мощных инструментов управления. Все данные надежно сохраняются через инфраструктуру хранилища.

Независимо от того, используете ли вы небольшой сервер выживания или массивную многопользовательскую экономику, экономика масштабируется вместе с вами.

Основные характеристики

Управление балансом игроков

Каждый игрок автоматически получает стартовый баланс при подключении к серверу. Проверяйте баланс в любое время. Администраторы могут мгновенно устанавливать, отдавать, принимать или сбрасывать балансы. Балансы настойчивы — игроки держат свои деньги на разных сессиях.

Лидеры и рейтинги

Просмотр самых богатых игроков на вашем сервере с помощью /baltop. Набранные таблицы лидеров показывают лучших заработков с первого взгляда. Посмотрите на свой рейтинг по сравнению с другими. Конкурентный, мотивирующий и всегда современный с интеллектуальным кэшированием.

Сделки между игроками

Игроки пересылают друг другу деньги с оплатой. Простой, безопасный и зарегистрированный. Необязательное охлаждение предотвращает спам. Опциональная система налогообложения поддерживает серверную экономическую политику. Недостаточная защита средств предотвращает задолженность.

Admin Command Suite

Полное управление сервером с помощью команд /eco Установите точные балансы для чрезвычайных ситуаций или тестирования. Награждайте активных игроков. Возьмите валюту в качестве наказания за нарушение правил. Перезагрузка экономики для сезонных перезагрузок. Перезагрузка конфигурации без перезагрузки.

Система разрешений

Тонкий контроль над тем, кто может получить доступ к чему. Игроки получают базовые проверки баланса по умолчанию. Администраторы получают полный доступ к команде. Настройка разрешений через плагин разрешений. Нет доступа к командам, которые вы не предоставляете.

Регистрация транзакций

Каждая транзакция регистрируется с помощью временных меток и имен игроков. Аудиторский след по спорам. Отслеживание экономических тенденций. Факультативная детальная рубка для исследования аномалий.

Настраиваемая валюта

Измените название валюты, символ и форматирование чисел. Используйте доллары, евро, монеты, драгоценные камни или что-либо еще. Формат дисплея полностью настраивается. Доступны цвета и стиль.

Полностью асинхронный

Отсутствие отставания сервера от операций с базами данных. Все проверки баланса, сбережения и транзакции происходят вне основного потока. Сервер остается отзывчивым даже во время экономических пиков.

Высокая производительность

Интеллектуальное кэширование баланса уменьшает запросы к базе данных. Кэширование на лидерборде предотвращает перерасчет по каждому запросу. Комплексные операции для команд администратора. Настройка конфигурации для размера вашего сервера.

Конфигурация Hot-Reload

Обновление параметров экономики без перезапуска. Изменение стартового баланса, символ валюты, лимиты платежей — все без простоев. Новые настройки применяются немедленно.

Case Случаи использования

Для владельцев серверов

Экономика дает вам полный контроль над финансовой системой вашего сервера. Установите стоимость валюты через начальный баланс. Используйте налогообложение для финансирования функций сервера. Создание эксклюзивных магазинов или аукционных систем. Отслеживайте экономическое здоровье через журналы транзакций.

Для игроков

У игроков есть причина для взаимодействия с вашим сервером. Зарабатывайте валюту через деятельность. Соревнуйтесь на досках лидеров. Торговля с друзьями. Почувствуйте прогресс по мере роста их богатства.

Для разработчиков плагинов

Economy API позволяет пользовательским плагинам взаимодействовать с экономикой. Проверьте баланс игроков. Вычет валюты за услуги. Награды за достижения. Все через чистые, асинхронные API.

Почему выбирают экономику?

Экономика готова к производству. Никакой сложной установки. Никаких внешних зависимостей за пределами хранилища. Один конфигурационный файл управляет всем. Надежность профессионального уровня обеспечивает простоту использования.

Количество игроков от 10 до 10 тысяч. Интеллектуальное кэширование означает, что таблицы лидеров остаются быстрыми. Операции Async никогда не блокируют сервер. Независимо от того, управляете ли вы ванильным выживанием или сложным экономическим сервером, экономика справляется с этим.

Расширяемость означает, что вы не заперты. Используйте его с магазинами, казино, плагинами для рабочих мест или пользовательскими системами. Чистая архитектура свода означает, что экономика хорошо играет со всем остальным.

Быстрый старт

установка

Скачать Economy-1.0.0.jar из релизов CurseForge или GitHub Поместите его в папку / мод / сервер вместе с Vault. Перезагрузите свой сервер. Экономика автоматически генерирует конфигурацию.

Настройте эконом-plugin / config.yml с настройками валюты, стартовым балансом и функциями. Перезапустите и вы готовы идти.

Первые команды

Проверьте свой баланс: / Баланс

Посмотреть топ игроков: бальто

Отправьте деньги другу: Платить PlayerName 100

Административные команды (только опции): Эко-версия PlayerName 500

Команды

Игровые команды

/ Баланс [игрок] Проверьте свой баланс или баланс другого игрока. Алиасы: /бал, /деньги

/pay <player> <amount> Отправьте деньги другому игроку. Aliases: /send

/baltop [страница] - Посмотреть таблицу лидеров самых богатых игроков. Поддержка пагинации для больших серверов.

Административные команды

/eco set <player> <mount> - Установите точный баланс. Полезно для чрезвычайных ситуаций или тестирования.

/eco give <player> <mount> - Дайте деньги игроку. Алиасы: /eco add

/eco take <player> <mount> - Возьмите деньги у игрока. Алиасы: /eco удалить

/eco reset <player> Перезагрузите игрока, чтобы начать баланс.

/eco скачать - Перезагрузка конфигурации без перезагрузки.

/eco rebuildcache - Ручно восстановить кэшированные данные. Оригинальное название: Aliases: /eco rebuild

️ Конфигурация

Экономия контролируется через один файл конфигурации с разумными по умолчанию:

Настройки валют Определите имя, символ и формат номера. Используйте эмодзи или текстовый символ.

Настройки аккаунта Контроль стартового баланса, минимального баланса и максимального баланса. Предотвращение эксплойтов с балансовыми шапками.

Настройки Leaderboard - Настройка размера страницы, выделения цвета и продолжительности кэша.

Настройки платежей Установите минимальные и максимальные суммы оплаты. Факультативное налогообложение. Опциональное охлаждение для предотвращения спама.

Выступление Конфигурация кэша для больших серверов. Настройте интервалы обновления в зависимости от количества игроков.

Безопасность

Готовые заявления предотвращают атаки SQL-инъекций. Ограничения баланса предотвращают эксплойты. Система разрешений предотвращает несанкционированный доступ. Охлаждение предотвращает спам и взрывы транзакций. Факультативный аудит отслеживает все изменения.

База данных

Экономика хранит все данные через Vault, поддерживая MySQL для производства или H2 для небольших серверов. Данные являются постоянными, надежными и поддерживаются конфигурацией Vault.

Документация

Полная командная ссылка с примерами. Руководство по конфигурации, объясняющее каждую настройку. Разрешение для администраторов. Документация API для разработчиков, создающих интеграцию.

Поддержка

Диссонное сообщество для помощи в режиме реального времени. GitHub выдает отчеты об ошибках и запросы функций. Вики для общих вопросов. Поддержка электронной почты доступна.

Лицензия

МТИ Лицензия - полностью с открытым исходным кодом и бесплатно. Использование в коммерческих проектах. Изменить и перераспределить. Никаких обязательств.

Требования

Vault Plugin 1.0.0+ (обязательно) 1.0+, Java 17+, MySQL 8.0+ (необязательно для использования в Vault)

Примеры реального мира

Сервер выживания

Новые игроки нерестятся со 100 монетами. Они добывают, выращивают и торгуют, чтобы заработать больше. Используйте /baltop, чтобы узнать, кто самый богатый. Экономика, естественно, возникает из активности игроков.

Сервер мини-игр

Выиграйте мини-игры, чтобы заработать деньги. Потратьте валюту в магазине косметики. Лидеры создают сезонные соревнования. Игроки регулярно возвращаются, чтобы подняться по карьерной лестнице.

Фракционный сервер

Фракции зарабатывают деньги как коллектив. Используйте /eco, чтобы вознаградить фракцию. Игроки могут торговать ресурсами через экономику. Военные трофеи могут распределяться справедливо.

Ролевой сервер

Игроки зарабатывают деньги на работе и бизнесе. Функции сервера Taxes Fund. Лидеры создают иерархию престижа. Экономика стимулирует глубину ролевой игры.

im отзывы игроков

"Экономика такая гладкая. Никогда не блокируйте сервер даже во время экономических пиков». - Server Admin

"Лидерборд заставляет меня хотеть зарабатывать больше. Отличная конкуренция! - Игрок

"Система выдачи разрешений дает мне именно тот контроль, который мне нужен. Люблю это. Владелец сервера

"Интеграция с нашим магазином была тривиальной. Чистый API. Разработчик плагинов

Начало работы сегодня

Скачать CurseForge. Drop Economy-1.0.0.jar в сервере / модах / Убедитесь, что Vault также установлен. Перезагрузите свой сервер. Настройка config.yml. Перезапустить снова. Ваша экономика жива.

Кредиты

Построенный Бахаовым для общины Хитейл. Используется Vault storage API. Вдохновлен лучшими отраслевыми практиками в области проектирования экономических систем.


Сделано с помощью ❤️ для администраторов серверов и игроков Hytale

Показать оригинальное описание (English)

💵 ECONOMY PLUGIN - CURSEFORGE FULL DESCRIPTION

Overview

Economy is the complete financial system for Hytale servers. Built on the Vault storage API, it provides server administrators and players with a robust, flexible economy featuring balance management, secure transactions, competitive leaderboards, and comprehensive admin controls.

🎯 What is Economy?

Economy turns your Hytale server into a thriving marketplace. Players earn, spend, and trade currency. Admins maintain control with powerful management tools. All data persists reliably through the Vault infrastructure.

Whether you're running a small survival server or a massive multiplayer economy, Economy scales with you.

✨ Core Features

💰 Player Balance Management

Every player automatically receives a starting balance upon joining your server. Check balances anytime with /balance. Admins can set, give, take, or reset balances instantly. Balances are persistent—players keep their money across sessions.

📊 Leaderboards & Rankings

View the richest players on your server with /baltop. Paginated leaderboards show top earners at a glance. See your rank compared to others. Competitive, motivating, and always up-to-date with intelligent caching.

💸 Player-to-Player Transactions

Players send money to each other with /pay. Simple, secure, and logged. Optional cooldowns prevent spam. Optional tax system supports server economic policies. Insufficient funds protection prevents debt.

⚙️ Admin Command Suite

Complete server management through /eco commands. Set exact balances for emergencies or testing. Give rewards to active players. Take currency as punishment for rule violations. Reset economies for seasonal resets. Reload configuration without restarting.

🔒 Permission System

Fine-grained control over who can access what. Players get basic balance checks by default. Admins get full command access. Customize permissions through your permission plugin. No access to commands you don't grant.

📈 Transaction Logging

Every transaction gets logged with timestamps and player names. Audit trail for disputes. Track economic trends. Optional detailed logging for investigating anomalies.

🎨 Customizable Currency

Change currency name, symbol, and number formatting. Use dollars, euros, coins, gems, or anything else. Display format is fully configurable. Colors and styling available.

⚡ Fully Asynchronous

No server lag from database operations. All balance checks, saves, and transactions happen off the main thread. Server stays responsive even during economy peaks.

🚀 High Performance

Intelligent balance caching reduces database queries. Leaderboard caching prevents recalculation on every request. Batch operations for admin commands. Configuration tuning for your server size.

🔄 Hot-Reload Configuration

Update economy settings without restarting. Change starting balance, currency symbol, payment limits—all without downtime. New settings apply immediately.

🎮 Use Cases

For Server Owners

Economy gives you complete control over your server's financial system. Set currency value through starting balance. Use taxation to fund server features. Create exclusive shops or auction systems. Track economic health through transaction logs.

For Players

Players have a reason to engage with your server. Earn currency through activities. Compete on leaderboards. Trade with friends. Feel progression as their wealth grows.

For Plugin Developers

Economy API allows custom plugins to interact with the economy. Check player balances. Deduct currency for services. Reward achievements. All through clean, async-friendly APIs.

🏆 Why Choose Economy?

Economy is production-ready out of the box. No complex setup. No external dependencies beyond Vault. One configuration file controls everything. Professional-grade reliability meets ease of use.

Performance scales from 10 players to 10,000. Intelligent caching means leaderboards stay snappy. Async operations never block your server. Whether you're running vanilla survival or a complex economy server, Economy handles it.

Extensibility means you're not locked in. Use it with shops, casinos, jobs plugins, or custom systems. The clean Vault architecture means Economy plays nicely with everything else.

🚀 Quick Start

Installation

Download Economy-1.0.0.jar from CurseForge or GitHub Releases. Place it in your server/mods/ folder alongside Vault. Restart your server. Economy generates configuration automatically.

Customize economy-plugin/config.yml with your currency settings, starting balance, and features. Restart and you're ready to go.

First Commands

Check your balance: /balance

View top players: /baltop

Send money to a friend: /pay PlayerName 100

Admin commands (ops only): /eco give PlayerName 500

📋 Commands

Player Commands

/balance [player] - Check your balance or another player's balance. Aliases: /bal, /money

/pay <player> <amount> - Send money to another player. Aliases: /send

/baltop [page] - View leaderboard of richest players. Supports pagination for large servers.

Admin Commands

/eco set <player> <amount> - Set exact balance. Useful for emergencies or testing.

/eco give <player> <amount> - Give money to a player. Aliases: /eco add

/eco take <player> <amount> - Take money from a player. Aliases: /eco remove

/eco reset <player> - Reset player to starting balance.

/eco reload - Reload configuration without restart.

/eco rebuildcache - Manually rebuild cached data. Aliases: /eco rebuild

⚙️ Configuration

Economy is controlled through a single configuration file with sensible defaults:

Currency Settings - Define name, symbol, and number format. Use any emoji or text symbol.

Account Settings - Control starting balance, minimum balance, and maximum balance. Prevent exploits with balance caps.

Leaderboard Settings - Customize page size, highlight color, and cache duration.

Payment Settings - Set minimum and maximum payment amounts. Optional taxation. Optional cooldown to prevent spam.

Performance - Cache configuration for large servers. Adjust refresh intervals based on your player count.

🔐 Security

Prepared statements prevent SQL injection attacks. Balance limits prevent exploits. Permission system prevents unauthorized access. Cooldowns prevent spam and transaction bombing. Optional audit logging tracks all changes.

📊 Database

Economy stores all data through Vault, supporting MySQL for production or H2 for small servers. Data is persistent, reliable, and backed up by your Vault configuration.

📚 Documentation

Complete command reference with examples. Configuration guide explaining each setting. Permission reference for admins. API documentation for developers building integrations.

🤝 Support

Discord community for real-time help. GitHub issues for bug reports and feature requests. Wiki for common questions. Email support available.

📜 License

MIT License - completely open source and free. Use in commercial projects. Modify and redistribute. No obligations.

🎯 Requirements

Vault Plugin 1.0.0+ (required), Hytale Server 1.0+, Java 17+, MySQL 8.0+ (optional, for production use with Vault)

💡 Real-World Examples

Survival Server

New players spawn with 100 coins. They mine, farm, and trade to earn more. Use /baltop to see who's the richest. Economy naturally emerges from player activity.

Minigames Server

Win minigames to earn currency. Spend currency in the shop for cosmetics. Leaderboards create seasonal competitions. Players return regularly to climb ranks.

Faction Server

Factions earn money as a collective. Use /eco give to reward faction activities. Players can trade resources through economy. War spoils can be distributed fairly.

Roleplay Server

Players earn money through jobs and businesses. Taxes fund server features. Leaderboards create prestige hierarchy. Economy drives roleplay depth.

🌟 Player Testimonials

"Economy is so smooth. Never blocks the server even during economy peaks." - Server Admin

"The leaderboard makes me want to earn more. Great competition!" - Player

"Permission system gives me exactly the control I need. Love it." - Server Owner

"Integrating with our custom shop was trivial. Clean API." - Plugin Developer

🎉 Get Started Today

Download from CurseForge. Drop Economy-1.0.0.jar in server/mods/. Make sure Vault is also installed. Restart your server. Customize config.yml. Restart again. Your economy is live.

🙏 Credits

Built by Bakhaow for the Hytale community. Powered by Vault storage API. Inspired by industry best practices in economy system design.


Made with ❤️ for Hytale Server Admins and Players

Последние версии

Economy.jar

Early Access 22.01.2026 68.9 КБ
Скачать