Платно - Плагин - hClansBankAddon [1.21.X-26.X] | Аддон для плагина hClans

Поддерживаемые версии

1.21
26

Ядра и Прокси

Bukkit
Spigot
Paper

Минимальная версия Java: 21

hClansBankAddon
Полноценный банк кланов для hClans

Clan Bank • GUI • Deposits • Withdrawals • History • Limits • Taxes • Webhooks

hClansBankAddon — это аддон для hClans, который добавляет полноценную казну клана. Игроки могут открывать банк через меню клана, пополнять общий баланс, снимать деньги при наличии прав, просматривать историю операций, а владелец сервера может гибко настроить лимиты, комиссии, роли, уровни клана, уведомления и Discord webhooks.

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

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

Банк клана через GUI — удобное меню казны прямо внутри системы hClans.
Пополнение казны — игрок может внести деньги из личного баланса в банк клана.
Снятие из казны — участники с нужной ролью могут выводить деньги из кланового банка.
Ввод суммы через чат — после клика по кнопке игрок вводит нужную сумму в чат.
Отмена ввода — можно настроить слова для отмены операции, например “отмена”.
Таймаут ввода суммы — если игрок не ввёл сумму вовремя, операция отменяется.
История операций — в GUI отображаются последние пополнения и снятия.
Фильтр истории — можно переключать историю: все операции, только пополнения или только снятия.
Пагинация истории — поддержка страниц для списка операций.
Лимиты по уровням клана — разные ограничения для разных уровней клана.
Лимиты по ролям — можно ограничить максимальное снятие для owner, soowner и других ролей.
Комиссия операций — отдельная комиссия на пополнение и снятие.
Подтверждение крупных снятий — отдельное меню подтверждения для больших сумм.
Кулдаун операций — защита от спама банковскими действиями.
Минимальный уровень клана — можно разрешить банк только с определённого уровня.
Автоматическое начисление процентов — опциональная система процентов на баланс казны.
Уведомления о крупных операциях — участники клана могут получать сообщения о больших пополнениях и снятиях.
Discord webhooks — отправка логов пополнений и снятий в Discord.
PlaceholderAPI через hClans expansion — вывод данных банка в плейсхолдерах hClans.
Автоочистка данных — при удалении клана данные его банка удаляются.
Гибкая настройка GUI — меню, предметы, слоты, названия, лор, головы, действия и приоритеты настраиваются через YAML.

Как работает банк клана?

Игрок открывает меню командой:

Код:

/clan bank

В меню отображается информация о казне:

текущий баланс клана;
максимальный баланс по уровню;
уровень клана;
сколько всего было пополнено;
сколько всего было снято;
дата последнего изменения;
доступные лимиты пополнения и снятия;
история последних операций.

После клика по кнопке пополнения или снятия игрок вводит сумму в чат. Плагин проверяет права, роль, уровень клана, лимиты, кулдаун, баланс игрока, баланс казны и только после этого выполняет операцию через Vault.

GUI банка

В комплекте есть готовое главное меню банка.

В GUI доступны:

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

Также в коде поддерживаются дополнительные типы кнопок:

Код:

deposit
withdraw
depositAll
depositPercent
summary
history
historyDeposit
historyWithdraw
historyFilter
previousPage
nextPage
confirmWithdraw
cancelWithdraw

Это позволяет собрать меню под стиль вашего сервера.

Пополнение казны

Пополнение работает через Vault-экономику.

Можно настроить:

минимальную сумму пополнения;
максимальную сумму пополнения;
количество пополнений за период;
комиссию на пополнение;
лимит максимального баланса казны;
кто из ролей клана может пополнять банк;
уведомление при крупном пополнении;
Discord webhook при крупном пополнении.

По умолчанию пополнять банк могут все участники клана, но это можно изменить в конфиге через роли hClans.

Снятие из казны

Снятие из банка можно строго контролировать.

Можно настроить:

минимальную сумму снятия;
максимальную сумму снятия;
количество снятий за период;
общий лимит суммы снятий за период;
комиссию на снятие;
роли, которым разрешено снимать деньги;
отдельный лимит снятия для каждой роли;
подтверждение снятия через отдельное меню;
минимальную сумму, с которой требуется подтверждение;
уведомления участникам клана о крупных снятиях;
Discord webhook при снятии.

По умолчанию снятие доступно ролям:

Код:

owner
soowner

Для ролей можно задать отдельные лимиты. Например, owner может снимать больше, а soowner — меньше.

Лимиты по уровням клана

hClansBankAddon поддерживает разные настройки банка для разных уровней клана.

Для каждого уровня можно задать:

максимальный баланс казны;
минимальную сумму пополнения;
максимальную сумму пополнения;
лимит количества пополнений;
минимальную сумму снятия;
максимальную сумму снятия;
лимит количества снятий;
общий лимит суммы снятий.

По умолчанию в конфиге уже настроены уровни с 1 по 5. Чем выше уровень клана, тем больше лимиты банка.

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

История операций

Плагин хранит историю банковских действий.

В истории отображается:

ник игрока;
тип операции;
сумма;
дата операции.

В GUI можно переключать фильтр истории:

все — все операции;
пополнения — только внесение денег;
снятия — только вывод денег.

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

Комиссии

В конфиге можно отдельно настроить комиссию:

Код:

depositPercent
withdrawPercent

Пример:

комиссия на пополнение — 0%;
комиссия на снятие — 3%.

При снятии деньги списываются из казны полностью, а игрок получает сумму с учётом комиссии.

Подтверждение снятия

Для крупных снятий можно включить отдельное меню подтверждения.

Например, если игрок снимает сумму от 25 000, плагин открывает меню, где нужно подтвердить или отменить операцию.

В меню подтверждения можно показать:

сумму снятия;
комиссию;
сколько игрок получит на руки;
кнопку подтверждения;
кнопку отмены.

Это снижает риск случайного снятия большой суммы из казны.

Автоматические проценты

В плагине есть опциональная система процентов на баланс казны.

Можно настроить:

включена ли система процентов;
интервал начисления;
процент от текущего баланса;
минимальный баланс для начисления;
максимальную сумму одного начисления.

По умолчанию проценты выключены, поэтому они не повлияют на экономику сервера, пока вы сами их не включите.

Уведомления и Discord webhooks

hClansBankAddon может уведомлять участников клана о крупных операциях.

Настраивается отдельно:

минимальная сумма крупного пополнения;
минимальная сумма крупного снятия;
сообщения игрокам;
включение или выключение уведомлений.

Также есть поддержка Discord webhooks.

Webhook можно настроить для:

пополнений;
снятий.

В webhook.yml можно изменить:

URL webhook;
имя webhook-бота;
аватар webhook-бота;
content;
embeds;
title;
description;
color;
timestamp;
author;
thumbnail;
image;
footer;
fields;
allowed mentions.

Это удобно для логирования крупных операций администрации или модерации.

Плейсхолдеры

Плейсхолдеры выводятся через hClans expansion.

Основные плейсхолдеры:

Код:

%hclans_bank_clan%
%hclans_bank_level%
%hclans_bank_balance%
%hclans_bank_totalDeposited%
%hclans_bank_totalWithdrawn%
%hclans_bank_updatedAt%

Их можно использовать в табе, scoreboard, holograms, меню и других плагинах, которые работают с PlaceholderAPI.

Также внутри GUI, действий и webhook доступны внутренние плейсхолдеры:

Код:

{player}
{actor}
{clan}
{balance}
{maxBalance}
{totalDeposited}
{totalWithdrawn}
{updatedAt}
{clanLevel}
{playerBalance}
{depositMin}
{depositMax}
{withdrawMin}
{withdrawMax}
{depositOperations}
{withdrawOperations}
{withdrawAmountLimit}
{canWithdraw}
{amount}
{taxAmount}
{resultAmount}
{promptType}
{promptAction}
{historyFilter}
{currentPage}
{nextPage}
{hasNextPage}
{cooldownLeft}

Система действий

Плагин использует ActionExecutor из hClans. Это значит, что сообщения и реакции можно настраивать через actions.

В конфиге уже используются и поддерживаются такие типы действий:

Код:

[MESSAGE]
[ACTIONBAR]
[TITLE]
[SOUND]
[BOSSBAR]
[CONSOLE]
[PLAYER]
[EFFECT]

И другие действия, которые поддерживает hClans.

Actions можно настроить для разных ситуаций:

нет клана;
недостаточный уровень клана;
нет прав;
успешное пополнение;
успешное снятие;
недостаточно денег;
достигнут лимит банка;
достигнут лимит операций;
кулдаун;
ошибка экономики;
ошибка базы;
отмена ввода суммы;
админ-действия.

Команды

Команды добавляются как сабкоманды hClans.

Код:

/clan bank

Открыть банк клана.

Дополнительные алиасы для bank можно задать в config.yml:

Код:

settings.aliases

Админ-команды:

Код:

/clan bankadmin info <clan>

Посмотреть информацию о банке клана.

Код:

/clan bankadmin set <clan> <amount>

Установить баланс казны.

Код:

/clan bankadmin add <clan> <amount>

Добавить деньги в казну.

Код:

/clan bankadmin take <clan> <amount>

Забрать деньги из казны.

Код:

/clan bankadmin reset <clan>

Сбросить банк клана.

Важно: в текущей сборке доступ к bankadmin проверяется через Bukkit permission:

Код:

Права и роли

hClansBankAddon регистрирует права в API hClans и привязывает их к ролям клана.

По умолчанию:

Код:

hclansbank.open

Открытие банка. Доступно всем участникам клана.

Код:

hclansbank.deposit

Пополнение казны. Доступно всем участникам клана.

Код:

hclansbank.withdraw

Снятие из казны. По умолчанию доступно ролям owner и soowner.

Роли можно изменить в config.yml:

Код:

settings.permissions.open.roles
settings.permissions.deposit.roles
settings.permissions.withdraw.roles

Также можно настроить лимиты снятия по ролям:

Код:

settings.roleLimits

Хранение данных

Плагин использует database API из hClans и создаёт собственные таблицы для банка.

Хранятся:

название клана;
баланс казны;
всего пополнено;
всего снято;
время последнего изменения;
история транзакций;
ник игрока, который выполнил операцию;
тип операции;
сумма операции;
дата операции.

Если клан удаляется, данные его банка также очищаются.

Что можно настроить?

название и размер главного GUI;
название и размер confirm-меню;
все предметы меню;
слоты кнопок;
материалы, головы BASEHEAD, amount, customModelData;
названия и lore предметов;
приоритеты предметов;
actions при клике;
алиасы команды bank;
минимальный уровень клана для банка;
таймаут ввода суммы;
слова отмены операции;
окно лимита операций;
кулдаун операций;
комиссию пополнения;
комиссию снятия;
лимиты по уровням клана;
лимиты снятия по ролям;
подтверждение крупных снятий;
автоматические проценты;
уведомления о крупных операциях;
Discord webhooks;
тексты сообщений;
формат пустых значений;
тексты boolean-плейсхолдеров;
фильтр истории.

Зависимости

Обязательные:

Java 21
Paper/Purpur 1.21.x
hClans совместимая версия
Vault
любой Vault-совместимый экономический плагин

Для плейсхолдеров:

PlaceholderAPI, если вы хотите выводить hClans placeholders в сторонних плагинах.

Зависимости: Vault (Обязательно)

Команды и права: Всё выше написано

Платно Плагин hClansBankAddon [1.21.X-26.X] | Аддон для плагина hClans v1.0

Другие ресурсы пользователя He3HaukaX

Поделиться ресурсом

Мы ценим вашу конфиденциальность