Плагин EconomyAPI (Nukkit) | Добавляет деньги, экономику

Помощь в создании сервера (Клик)

Подпишись на наш Telegram!

Присоединяйся к нашему каналу и получи эксклюзивную возможность выиграть iPhone 16 Pro

Подписаться

Реклама закроется через 8 секунд

0%

Лайков

EconomyAPI – это мощный плагин для серверов Nukkit, предоставляющий полноценную экономическую систему. Он позволяет управлять виртуальной валютой на сервере, предоставляя игрокам и администраторам удобные команды, а разработчикам – гибкое API для интеграции экономики в другие плагины.

Основные возможности

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

Команды

Плагин предоставляет следующие команды для управления экономикой:

• /mymoney (алиасы: /money, /bal, /seemoney, /balance)
  Показывает текущий баланс игрока.
• /givemoney (алиас: /deposit)
  Добавляет указанную сумму на счёт игрока (только для операторов).
• /takemoney (алиас: /cashdraw)
  Снимает указанную сумму со счёта игрока (только для операторов).
• /setmoney (алиасы: /setbal, /setbalance)
  Устанавливает точную сумму на счёте игрока (только для операторов).
• /topmoney (алиасы: /baltop, /balancetop)
  Показывает рейтинг игроков по количеству валюты.
• /pay
  Позволяет переводить валюту другому игроку.

Разрешения

Для использования команд EconomyAPI требуются определённые разрешения. Вот список доступных разрешений:

• economyapi – основное разрешение для плагина.
• economyapi.command – доступ ко всем командам плагина.
• economyapi.command.mymoney – доступ к команде /mymoney.
• economyapi.command.seemoney – доступ к просмотру баланса других игроков.
• economyapi.command.givemoney – доступ к команде /givemoney (по умолчанию только для операторов).
• economyapi.command.takemoney – доступ к команде /takemoney (по умолчанию только для операторов).
• economyapi.command.setmoney – доступ к команде /setmoney (по умолчанию только для операторов).
• economyapi.command.topmoney – доступ к команде /topmoney.
• economyapi.command.pay – доступ к команде /pay.

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

EconomyAPI предоставляет удобное API для интеграции экономической системы в ваши плагины. Вот основные методы, доступные в Java:

// Получение текущего баланса игрока
EconomyAPI.getInstance().myMoney(player);

// Уменьшение баланса игрока
EconomyAPI.getInstance().reduceMoney(player, amount);

// Добавление валюты на счёт игрока
EconomyAPI.getInstance().addMoney(player, amount);

// Установка точного значения баланса
EconomyAPI.getInstance().setMoney(player, amount);

Коды возврата API

При использовании методов API возвращаются следующие коды:

• -3 = EconomyAPI.RET_NO_ACCOUNT – аккаунт игрока не найден.
• -2 = EconomyAPI.RET_CANCELLED – операция была отменена.
• -1 = EconomyAPI.RET_NOT_FOUND – игрок не найден.
• 0 = EconomyAPI.RET_INVALID – некорректные данные.
• 1 = EconomyAPI.RET_SUCCESS – операция выполнена успешно.

Подключение через Maven

Для использования EconomyAPI в вашем проекте добавьте следующий репозиторий и зависимость в ваш pom.xml:

<repository>
    <id>nukkitx-repo</id>
    <url>https://repo.nukkitx.com/snapshot</url>
</repository>

<dependency>
    <groupId>me.onebone</groupId>
    <artifactId>economyapi</artifactId>
    <version>2.0.2</version>
    <scope>provided</scope>
</dependency>

Скачать плагин

Вопрос/Ответ

• Плагин работает на Nukkit-MOT — Да
• Какая Java нужна? Тестировалось на Java 17-23.
• На какой версии работает? Тестировалось на 1.20 — 1.21
• Плагин без вирусов? Плагин с официального сайта., проверен на вирусы, их нет.
• Нужно ставить другие плагины на экономику с этим? Только если вы хотите добавить доп валюту такую как коины.
• Нет крашей? — На Nukkit/Nukkit-MOT не обнаружено.