EconomyAPI

The best economy api for your hytale server! Have all your mods work together❤

1.0 тысяча загрузок

Обновлён 6 дней назад

Библиотека Утилиты

Скачать последнюю версию (38.7 КБ)

Описание

ЭкономикаAPI

Легкий, удобный для разработчиков экономичный хребет для серверов Hytale.

EconomyAPI является основной утилитой, предназначенной для управления «тяжелым подъемом» валютного менеджмента. Он обеспечивает централизованную систему хранения, извлечения и изменения балансов игроков, позволяя другим модам сосредоточиться на таких функциях, как магазины, аукционы или земельные претензии, не беспокоясь о централизованной денежной системе. Но он также действует как мост, так что моды, сделанные с использованием этого API, также могут работать с другими экономическими системами.

для игроков

Сам по себе этот мод является Библиотека/зависимость. Он не добавляет элементы или блоки в игровой мир. Скорее всего, вам это нужно, потому что другой мод, который вам нравится (например, мод магазина или трейдинга), использует его для управления деньгами.

Доступные команды:

Командование	Описание	Разрешение
/Баланс (игрок) баль	Проверьте баланс кого-то	`economyapi.user.command.balance`
платить	Платить кому-то	`economyapi.user.command.pay`
бальто	5 самых богатых игроков на вашем сервере	`economyapi.user.command.baltop`
/экономияпи /экономика Эко	Проверьте кредиты для этого мода	`economyapi.user.command.economy`
/setbalance <player> <mount> сетбал	Устанавливает баланс игрока на определенную величину.	`economyapi.admin.command.setbalance`

Вы можете заработать деньги, убивая толпу.

Установка

Скачать EconomyAPI.jar.
Поместите его на свой сервер мод папка.
Перезагрузите сервер.

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

{
"валютный префикс": "$",
"logRetentionDays": 7,
«стартовый баланс»: 500,0,
«bridgeMode»: «noone» // См. Мостовые режимы
?

Мостовые режимы:

Моды, использующие этот API

SimpleGambler - Добавляет азартные игры
SimpleBanker - Добавляет физические монеты и купюры
Давай сюда свой мод! Просто Отправить сообщение.

для разработчиков

Перестаньте изобретать колесо! Использовать ЭкономикаAPI Это единственный источник истины для вашей валюты.

Зачем использовать этот API?

Постоянное хранение: Автоматическая экономия до a Балансы.json Файл в папке данных плагина.
Безопасное изменение имени: Использует Hytale's UUID Система гарантирует сохранение данных, даже если игроки меняют имена.
Легкий доступ: Простая интеграция через наш Api

Пример осуществления:

импорт com.sennecoolgames.economyapi.EconomyAPI; 

EconomyAPI - EconomyAPI.getAPI();

// Найти баланс
Двойной кошелек = eco.getBalance(player.getUuid());
playerRef.sendMessage(Message.raw("Баланс:" + eco.getEcoPrefix() + кошелек);

// Установить баланс
eco.setBalance(player.getUuid(), сумма, факультативныйРазум);

// депозит (добавить деньги)
eco.deposit(player.getUuid(), сумма, факультативныйРазум);

Вывод (удаление денег) (выводы ложные, если у пользователя недостаточно денег)
если (eco.withdraw(playerRef.getUuid(), сумма, опция)) {
    CommandContext.sendMessage(Message.raw("Вы сняли" + eco.formatShort(amount) + "(" + eco.format(amount)+")));
Другое дело {
    CommandContext.sendMessage (Message.raw («У вас недостаточно денег!»));
?

eco.format(сумма); // 1к, 1м, 1т
eco.formatShort(количество); // 1.000,00 или 1000,00

// Получите имя пользователя игрока из своего uuid (полезно для оффлайн-игроков)
eco.getCacheUsername(uuid);

// Получить экономический префикс (по умолчанию: $)
eco.getEcoPrefix();

// Получите другие значения конфигурирования
eco.getConfig (configKey);

Скоро придет

Магазин

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

EconomyAPI

A lightweight, developer-friendly economy backbone for Hytale servers.

EconomyAPI is a core utility designed to handle the "heavy lifting" of currency management. It provides a centralized system for storing, retrieving, and modifying player balances, allowing other mods to focus on features like shops, auctions, or land claims without worrying about a centeralized money system. But it also acts like a bridge so that mods made using this API can also work with other economy systems.

🎮 For Players

By itself, this mod is a Library/Dependency. It doesn't add items or blocks to the game world. You likely need this because another mod you enjoy (like a Shop or Trading mod) uses it to manage money.

Available Commands:

Command	Description	Permission
/balance (player) /bal	Check someones balance	`economyapi.user.command.balance`
/pay	Pay someone	`economyapi.user.command.pay`
/baltop	Check the 5 richest players on your server	`economyapi.user.command.baltop`
/economyapi /economy /eco	Check the credits for this mod	`economyapi.user.command.economy`
/setbalance <player> <amount> /setbal	Sets a player's balance to a specific value.	`economyapi.admin.command.setbalance`

You can gain money by killing mobs.

📦 Installation

Download the EconomyAPI.jar.
Place it into your server's mods folder.
Restart the server.

⚙️Configuration

{
"currencyPrefix": "$",
"logRetentionDays": 7,
"startingBalance": 500.0,
"bridgeMode": "none" // See Bridge Modes
}

Bridge Modes:

💿Mods using this API

SimpleGambler - Adds gambling games
SimpleBanker - Adds physical coins and bills
Get your mod on here! Just send me a message.

👨‍💻 For Developers

Stop reinventing the wheel! Use EconomyAPI as your server's single source of truth for currency.

Why use this API?

Persistent Storage: Automatically saves to a balances.json file in the plugin data folder.
Namechange-Safe: Uses Hytale's UUID system to ensure data persists even if players change names.
Easy Access: Simple integration via our api

Implementation Example:

import com.sennecoolgames.economyapi.EconomyAPI; 

EconomyAPI eco = EconomyAPI.getAPI();

// get balance
double wallet = eco.getBalance(player.getUuid());
playerRef.sendMessage(Message.raw("Balance: " + eco.getEcoPrefix() + wallet);

// set balance
eco.setBalance(player.getUuid(), amount, optionalReason);

// deposit (add money)
eco.deposit(player.getUuid(), amount, optionalReason);

// withdraw (remove money) (Outputs false if the user doesn't have enough money)
if (eco.withdraw(playerRef.getUuid(), amount, optionalReason)) {
    commandContext.sendMessage(Message.raw("You withdrew " + eco.formatShort(amount) + "(" + eco.format(amount) + ")" ));
} else {
    commandContext.sendMessage(Message.raw("You don't have enough money!"));
}

eco.format(amount);      // 1k, 1m, 1t
eco.formatShort(amount); // 1.000,00 or 1,000.00

// Get a players username from their uuid (useful for offline players)
eco.getCacheUsername(uuid);

// Get economy prefix (default: $)
eco.getEcoPrefix();

// Get other config values
eco.getConfig(configKey);