src Плагин GUI Магазин NGVKTownySell [1.1]

NGVKtownysell — Аддон для торговли городами в Towny​

NGVKtownysell — это плагин для серверов с Towny и Vault, который добавляет систему покупки и продажи городов через графические интерфейсы. Торговля реализована на основе прямых предложений (офферов) между игроками.

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

• Управление через GUI: Все этапы (просмотр рынка, настройка цены продажи, просмотр входящих предложений, выбор параметров объединения) происходят в инвентарях.
• Система предложений: Покупатели предлагают свою цену через чат, выбирая город на рынке. Мэр города получает уведомление и может принять или отклонить предложение в специальном меню.
• Слияние городов: Если покупатель уже является мэром другого города, при успешной покупке открывается меню. В нем покупатель выбирает, какой город останется главным, а какой будет присоединен в качестве аванпоста.
• Налогообложение: В плагин встроена настраиваемая комиссия сервера — процент, который удерживается из итоговой суммы при передаче денег от покупателя продавцу.
• Ограничения и защиты:
  • Запрет на продажу городов, имеющих отрицательный баланс в банке Towny.
  • Блокировка возможности отправлять предложения о покупке собственного города.
  • Кулдаун на перепродажу (Anti-Flip), запрещающий выставлять город на продажу заданное количество часов после его покупки.
  • Автоматическое удаление неактуальных предложений при удалении или переименовании города.
  • Проверка транзакций через EconomyResponse (Vault) для защиты от ошибок начисления средств.
• Кастомизация интерфейсов: Полная настройка предметов, слотов, названий, описаний и CustomModelData в файле guis.yml.
• Поддержка HEX: Поддержка современных форматов цветов (&#RRGGBB и <#RRGGBB>) во всех конфигурационных файлах.

Команды и Права​

Для игроков и мэров (права выдаются автоматически на основе статуса в Towny):

• /t buy (или /town buy) — Открыть рынок со всеми продающимися городами.
• /t selling on (или /town selling on) — Открыть меню для выставления своего города на продажу.
• /t selling off (или /town selling off) — Снять свой город с продажи.
• /t offers (или /town offers) — Открыть меню входящих предложений о покупке.

Для администрации:

• /ngvktownysell reload — Перезагрузить конфигурацию (config.yml, guis.yml и базу offers.yml). Требуется право ngvktownysell.admin.

Процесс проведения сделки​

1. Размещение: Мэр вводит /t selling on, нажимает на иконку установки цены, вводит сумму в чат и подтверждает публикацию в GUI. Город появляется в общем списке рынка.
2. Предложение: Заинтересованный игрок вводит /t buy, кликает по нужному городу и пишет в чат сумму, за которую готов его купить.
3. Рассмотрение: Мэр продаваемого города получает уведомление в чат. Он вводит /t offers и видит поступившее предложение. Левый клик по предмету принимает предложение, правый — отклоняет.
4. Завершение: При принятии предложения плагин проверяет наличие средств у покупателя, списывает их, вычитает серверную комиссию и переводит остаток продавцу. Права на город (статус мэра) передаются покупателю. Все остальные активные предложения по этому городу автоматически аннулируются, а город снимается с продажи.