CannaTaleЭкономика

CannaTaleEconomy является основой экономики экосистемы серверов CannaTale Hytale. Он обеспечивает постоянный Поддерживаемый SQLite система баланса, команды игрока и администратора, настраиваемая система оплаты труда (включая VIP-уровень) и Публичный API Это могут назвать другие модифицированные.

Особенности

ядро

• Постоянные балансы, хранящиеся в SQLite ()Экономика.db)
• Валюта в целом (длинный) избегать вопросов округления с плавающей точкой
• Атомная передача с использованием операций с базами данных
• Руководящие вопросы для бальто

командование

• Игрок: / Баланс, бальто, платить, /payck
• Админ: /money set | дать | взять (единый узел разрешения)

Система оплаты труда (VIP Override)

• Конфигурируемый интервал и количества
• Узел VIP-разрешения: cannatale.economy.vip
• VIP-игроки получают только Платежная система AmountVip при использовании /payck нормально зарплата Сумма игнорируется.

Публичный API Hooks

• Другие модели могут вызывать Экономика Апи читать / изменять балансы, переводы, таблицы лидеров, форматирование и требования к зарплате
• Предназначен для вызова из серверная нить (То же, что команды/события)

установка

1. Постройте баночку плагина (см. строить раздел).
2. Копировать необычный баночка из сборка/либс/ в папку модов вашего сервера (пример: HytaleServer/Mods/).
3. Запустите сервер.
4. В первом беге, Экономика будет генерировать свои файлы данных в каталоге данных плагина:
   • config.json
   • Экономика.db

Конфигурация ()config.json)

Экономика создает config.json В первом беге.

Текущие ключи конфигурирования:

• начинать Баланс (Долго)
  Начало баланса для новых игроков.

• зарплата Сумма (Долго)
  Сумма чека по умолчанию (не VIP).

• Платежная система AmountVip (Долго)
  VIP-сумма зарплаты. Используется только в том случае, если игрок cannatale.economy.vip.

• Обсуждение IntervalMinutes (Долго)
  Охлаждение общей зарплаты (минуты) для обоих уровней.

• balTopLimit (Внутри)
  Количество записей, показанных в бальто.

• схемаВерсия (Внутри)
  Внутренняя версия для будущих миграций.

VIP поведение

Если игрок имеет cannatale.economy.vip, /payck платить только Платежная система AmountVip Игнорировать зарплата Сумма.

Разрешения

Админ (все/денежные команды)

• cannatale.economy.admin

VIP уровень зарплаты

• cannatale.economy.vip

командование

Корневая помощь

• /экономика
• /ec/ (алиас)

Показывает отформатированный список команд.

Командование игрока

/ Баланс

Показывает ваш баланс.

/ Баланс [игрок]

Показывает баланс другого игрока.

Примеры:

• / Баланс
• / Баланс Xion28080

бальто

Показывает верхние балансы (дефолт 10, настраиваемый через balTopLimit).

Пример:

• бальто

/pay <player> <amount>

Платит другой игрок.

• Сумма должна быть > 0
• Отправитель должен иметь достаточный баланс
• Трансфер является атомным

Пример:

• Платить Боб 250

/payck

Требует зарплату.

• Исполнитель: cooldown: Обсуждение IntervalMinutes
• VIP-игроки получают Платежная система AmountVip только

Пример:

• /payck

Если вы не готовы, вы увидите сообщение, показывающее оставшееся время до следующего заявления.

Административные команды (требуется) cannatale.economy.admin)

/money set <player> <mount>

Установите баланс игрока.

/money give <player> <mount>

Добавляет к балансу игрока.

/money take <player> <mount>

Снимается с баланса игрока (деньги удаляются, а не передаются).

• 0 (отсутствует отрицательный баланс)

Примеры:

• Деньги Боб 1000
• Деньги дают Бобу 250
• Деньги берут Боб 500

Онлайн-игровая заметка (ArgTypes.PLAYER_REF)

Несколько команд используют ArgTypes.PLAYER_REFкоторая, как правило, решает Игроки онлайн:

• платить
• /money set | дать | взять
• /balance-player=<имя (если аргумент решен как PLAYER_REF)

Если вам нужна поддержка в автономном режиме (настройка / проверка игроков, которые не находятся в Интернете), экономия может быть расширена для решения UUID через профильный магазин или имя. Кэш UUID.

База данных

Файл SQLite:

• Экономика.db

Схема (концептуальная):

• Столик баланс
  • uuid (Следующий первичный ключ)
  • имя (Текст)
  • баланс (ИНТЕГЕР)
  • last_paycheck_claim_ms (ИНТЕГЕР)

Примечания:

• Суммы хранятся как целые числа (длинные)
• Переводы используют транзакцию, чтобы избежать частичных обновлений.

Public API Hooks (объявлено)

Где живет API

Пакет:

• org.omeganode.cannataleeconomy.api

Основной интерфейс:

• Экономика Апи

Реестр:

• Экономика ApiRegistry

Как другие моды получают API

Импорт org.omeganode.cannataleeconomy.api.EconomyApiRegistry

val econ = EconomyApiRegistry.get() ?: return // Экономика не загружена / не зарегистрирована

Экономика Api — Methods and Hooks (точная версия)

Все суммы в валюте являются целыми числами. длинный ценностей.

Большинство методов принимают Оригинальное название:ForCreate Таким образом, счет может быть создан по требованию, если отсутствует.

пакет org.omeganode.cannataleeconomy.api

Импорт org.omeganode.cannataleeconomy.data.EconomyConfig
Импорт org.omeganode.cannataleeconomy.db.TopBalanceEntry
Импорт org.omeganode.cannataleeconomy.services.PaycheckService
Импорт java.util. UUID

Интерфейс экономики Апи {
Развлечения GetConfig(): EconomyConfig

fun ensure(uuid: UUID, имя) Исполнитель: String

/** Возвращает стартовый баланс, если учетная запись не существует (не создает учетную запись). *
GetBalance (uuid: UUID): длинный

/** Возврат баланса и создание счета при необходимости. *
GetBalance(uuid: UUID, название) Оригинальное название: Long: Long

Веселый сетBalance(uuid: UUID, nameForCreate: String, amount: Long)

Название: UUID (Uuid: UUID) ForCreate: Струна, количество: Длинная

/**
* Занимает до [суммы] от баланса игрока (зажимается на 0).
@return the new balance after the take.
*
fun take(uuid: UUID, название) ForCreate: Струна, количество: Длинный: Длинный

/**
Передача [суммы] от одного игрока к другому.
* @return true if success, false if sender lacks funds or amount <= 0.
*
Веселый трансфер (от Uuid: UUID, от Name: String, до Uuid: UUID, до Name: String, сумма: Long): Булевый

fun top (limit: Int): List<TopBalanceEntry>

/** Формирует номер с запятыми, используя локальные правила сервера, используемые Экономикой. *
Развлекательный формат (сумма: Длинная): Струна

** Заявление о выплате зарплаты. Если это Vip=true, используйте только paycheckAmountVip. *
Забавное заявление Paycheck(uuid: UUID, имя) ForCreate: String, isVip: Boolean: PaycheckService.
?

API Примеры других модов

Читать баланс (без создания счета)

val bal = econ.getBalance

Прочитайте баланс (создайте счет, если он отсутствует)

val bal = econ.getBalance (playerUuid, playerName)

Дай/бери/настрой

econ.give (playerUuid, playerName, 500)
val newBal = econ.take (playerUuid, playerName, 250)
Econ.setBalance (игрок) Uuid, PlayerName, 1000

передача

val ok = econ.transfer (от Uuid, от Name, до Uuid, до Name, 200)

Руководитель

val top = econ.top(10)

форматирование

val formated = econ.format(1234567) // "1,234,567"

Paycheck claim (VIP-aware)

val isVip = sender.hasPermission ("cannatale.economy.vip")
val result = econ.claimPaycheck (playerUuid, playerName, isVip)

устранение неполадок

Ошибка драйвера SQLite во время выполнения

Если вы видите: Не найден подходящий драйвер для jdbc:sqlite:

Вы, вероятно, развернули не ту банку.

Исправить:

• Развернуть необычный баночка из сборка/либс/
• Удалить старых Экономные банки из папки модов сервера
• Перезагрузить сервер