Treasury

Treasury

Простой API экономики и поинтов для модов Minecraft.
Вдохновлён плагином Bukkit Vault.
Это не реализация экономики.
Вместо этого, как и Vault, другие моды предоставляют реализации экономики/поинтов, а Treasury выступает в роли связующего слоя. *Нам нужен хороший логотип, лол, мой арт отстой —— автор*

Что он умеет?

• Хранить экономику сервера (поддержка нескольких валют)
• Доступ к поинтам / премиум-валюте
• Позволять модам взаимодействовать с системой экономики без зависимости от конкретных реализаций

Как это работает

Treasury определяет два основных типа провайдеров:

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

Реестр

Экономика

• Хранится в EconomyServiceRegistry
• Поддерживает несколько провайдеров
• Один провайдер выбирается как основной Правила выбора:

1. Используется primaryEconomy, указанный в конфиге, если он задан
2. В противном случае используется первый зарегистрированный провайдер

Поинты

• Хранится в PointsServiceRegistry
• Разрешён только один провайдер Регистрация ещё одного провайдера вызовет исключение.

Регистрация провайдеров

Экономика

Treasury.economy().register(new ExampleEconomyProvider());

Поинты

Treasury.points().register(new ExamplePointsProvider());

Примечания:

• Разрешён только один провайдер поинтов
• Пожалуйста, регистрируйте во время инициализации мода

Fabric Entrypoints

Treasury поддерживает регистрацию провайдеров через Fabric entrypoints:

• treasury-economy
• treasury-points Пример:

{
  "entrypoints": {
    "treasury-economy": [
      "com.example.mod.ExampleEconomyProvider"
    ],
    "treasury-points": [
      "com.example.mod.ExamplePointsProvider"
    ]
  }
}

Использование

Экономика

if (Treasury.economy().hasPrimary()) {
    EconomyProvider economy = Treasury.economy().getPrimary();
    double balance = economy.getBalance(playerUuid);
}

Поинты

if (Treasury.points().isRegistered()) {
    PointsProvider points = Treasury.points().get();
    int balance = points.getBalance(playerUuid);
}

Команды

• /treasury info
• `/treasury balance Требуемый уровень прав: 2`

Требования

• Fabric: Minecraft 1.20.1+, любая версия Fabric, Fabric API не требуется
• NeoForge: Minecraft 1.20.4+, любая версия NeoForge
• Java: 17 или выше Не просите Forge!

Сборка

./gradlew build

Подключение

dependencies {
    compileOnly("io.github.lijinhong11:treasury:VERSION")
}