Плагин - YoPayment - плагин на оплату с ЮКассы

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

1.16
1.17
1.18
1.19
1.20
1.21

Ядра и Прокси

Paper

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

Исходный код: https://github.com/noloverme/YoPayment

YoPayment — это мощный плагин для Minecraft серверов, который интегрирует платёжную систему ЮKassa. Позволяет администраторам создавать и управлять платёжными ссылками прямо из игры, а также отслеживать статус платежей в реальном времени.

YoPayment предоставляет полнофункциональное решение для работы с платежами:

Создание платёжных ссылок — быстро генерируйте ссылки для оплаты через ЮKassa
Отслеживание платежей — автоматическая проверка статуса платежей
Система донатов — гибкая конфигурация товаров и цен
Множество БД — поддержка H2, MySQL и PostgreSQL
PlaceholderAPI — встроенная интеграция с популярным плагином
Поддержка цветов — HEX и стандартный формат Minecraft цветов

Для начала работы вам потребуется установить плагин на сервер и настроить конфигурацию.

Поместите JAR файл в папку plugins, отредактируйте config.yml с вашими данными ЮKassa, и перезагрузите сервер командой /restart.

Требования:

Minecraft сервер — Paper 1.16+
Java — 17+
ЮKassa аккаунт — с действительными shop-id и secret-key

Шаги установки:

1. Скачайте JAR файл плагина
2. Поместите его в папку /plugins
3. Перезагрузите сервер: /restart
4. Отредактируйте конфиг: /plugins/YoPayment/config.yml
5. Перезагрузите конфиг: /yopayment reload

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

Используйте /yopayment create <item> для создания ссылки для себя, /yopayment create <item> <player> для создания ссылки для другого игрока, /yopayment reload для перезагрузки конфигурации и /yopayment list для просмотра платежей.

Примеры использования:

Код:

/yopayment create premium
/yopayment create vip_pass @nickname
/yopayment reload
/yopayment list
/yopayment list @nickname

Алиасы: /yp и /yopay — это сокращённые версии команды /yopayment.

Плагин использует YAML файлы для настройки всех параметров работы.

Основной файл config.yml содержит данные ЮKassa, параметры проверки платежей и выбор типа базы данных. Файл donates.yml определяет доступные товары с названиями и ценами. Файл messages.yml позволяет кастомизировать сообщения.

Конфигурация config.yml:

YAML:

yookassa:
  shop-id: "000000"
  secret-key: "test_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
  return-url: "https://pay.noloverme.xyz/"

check-interval: 5
payment-timeout: 10
message-format: "&7[&#00bfffОплата&7] &fТовар: &#00bfff{display_name}\n&fЦена: &#00bfff{price}₽\n&fСсылка для оплаты: &#00bfff{url}"
silent-mode: true

database:
  type: h2
  h2:
    file: "yopayment"
  mysql:
    host: "localhost"
    port: 3306
    database: "yopayment"
    username: "root"
    password: ""
    pool-size: 10
  postgresql:
    host: "localhost"
    port: 5432
    database: "yopayment"
    username: "postgres"
    password: ""
    pool-size: 10

Конфигурация donates.yml:

YAML:

donates:
  vip:
    display-name: "VIP"
    price: 30.0
    description: "Покупка привилегии VIP"
    commands:
      - "lp user %player% parent add vip"
      - 'tellraw @a [{"text":"[","color":"gray"},{"text":"Покупка","color":"green"},{"text":"] ","color":"gray"},{"text":"Игрок ","color":"white"},{"text":"%player%","color":"green"},{"text":" купил привилегию ","color":"yellow"},{"text":"VIP","color":"yellow"},{"text":" на сайте ","color":"white"},{"text":"example.com","color":"yellow","underlined":true,"clickEvent":{"action":"open_url","value":"https://example.com"}},{"text":".","color":"white"}]'

  premium:
    display-name: "Premium"
    price: 60.0
    description: "Покупка привилегии Premium"
    commands:
      - "lp user %player% parent add premium"

  100_points:
    display-name: "100 поинтов"
    price: 100.0
    description: "Покупка 100 поинтов"
    commands:
      - "p give %player% 100"
      - "bc Оплата прошла успешно!"

YoPayment полностью совместим с PlaceholderAPI. Используйте плейсхолдеры в других плагинах для вывода информации о платежах.

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

Доступные плейсхолдеры:

%YoPayment_Link% — показывает последнюю рабочую ссылку для оплаты игрока. Если ссылки нет — выводит "N/A".

%YoPayment_Custom:{format}% — кастомный плейсхолдер с информацией о платеже. Поддерживает переменные: {display_name}, {item}, {price}, {description}, {link}, {status}, {created_at}.

Примеры:

Код:

%YoPayment_Custom:&#00bfffПоследняя покупка: {display_name} ({price})%
%YoPayment_Custom:&cСтатус: &e{status}%
%YoPayment_Custom:{description} - {price} руб.%

Плагин поддерживает три типа баз данных для максимальной гибкости.

Выбор типа базы данных осуществляется в config.yml параметром database.type. Каждый тип имеет свои преимущества и требования к настройке подключения.

H2 — встроенная база данных, идеальна для маленьких серверов. Не требует установки и конфигурации.

MySQL — мощная реляционная БД для больших проектов. Требует отдельной установки и настройки подключения.

PostgreSQL — продвинутая альтернатива MySQL с дополнительными возможностями. Подходит для высоконагруженных систем.

Конфигурация H2:

YAML:

database:
  type: h2
  h2:
    file: "yopayment"

Конфигурация MySQL:

YAML:

database:
  type: mysql
  mysql:
    host: "localhost"
    port: 3306
    database: "yopayment"
    username: "root"
    password: ""
    pool-size: 10

Конфигурация PostgreSQL:

YAML:

database:
  type: postgresql
  postgresql:
    host: "localhost"
    port: 5432
    database: "yopayment"
    username: "postgres"
    password: ""
    pool-size: 10

Система прав доступа позволяет контролировать, какие игроки могут использовать функции плагина.

Все права по умолчанию выданы операторам сервера. Вы можете настроить их в plugin.yml для предоставления доступа определенным группам пользователей через систему прав вашего сервера.

yopayment.create — разрешает игроку создавать ссылки для себя (по умолчанию: OP)

yopayment.create.others — разрешает создавать ссылки для других игроков (по умолчанию: OP)

yopayment.reload — доступ к команде перезагрузки конфига (по умолчанию: OP)

yopayment.list — просмотр своих платежей (по умолчанию: OP)

yopayment.list.others — просмотр платежей других игроков (по умолчанию: OP)

Проект написан на Java 17 с использованием Paper API для Minecraft 1.16+.

Код организован по слоям: API клиент для работы с ЮKassa, слой БД с поддержкой нескольких типов, обработчики команд, конфигурация и задачи для асинхронной проверки платежей. Вся система работает на базе YAML конфигов для максимальной гибкости.

Для сборки проекта требуется Maven и Java 17.

Используйте команду mvn clean package для сборки. JAR файл будет расположен в папке target/YoPayment-1.0b.jar и готов к использованию на сервере.

Зависимости проекта:

Paper API 1.21.4 — Minecraft сервер API
HikariCP 7.0.2 — Пулинг подключений к БД
H2 2.4.240 — Встроенная база данных
MySQL Connector 9.7.0 — MySQL драйвер
PostgreSQL 42.7.11 — PostgreSQL драйвер
Gson 2.14.0 — JSON парсер
PlaceholderAPI 2.12.2 — Интеграция PlaceholderAPI

Статусы платежей:

pending —

платёж ожидает обработки

succeeded —

платёж успешно завершён

canceled —

платёж отменён пользователем или истёк срок

Если у вас возникли проблемы с работой плагина, начните с проверки конфигурации и логов.

Ссылка не создаётся? Проверьте shop-id и secret-key в config.yml, убедитесь, что интернет соединение активно, и проверьте логи с silent-mode: false.

Платежи не отслеживаются:

1. Убедитесь, что check-interval > 0
2. Проверьте права доступа в БД
3. Перезагрузите плагин: /yopayment reload

PlaceholderAPI не работает:

1. Установите PlaceholderAPI плагин
2. Убедитесь, что YoPayment загружен после PlaceholderAPI
3. Перезагрузите сервер

Перед развертыванием на продакшене используйте PostgreSQL или MySQL вместо встроенной H2 базы данных.

Убедитесь, что secret-key и shop-id правильно скопированы из личного кабинета ЮKassa и хранятся в безопасности. Настройте регулярное резервное копирование базы данных и протестируйте все команды на тестовом сервере перед запуском на продакшене.

YoPayment предоставляет полнофункциональное решение для интеграции платежей ЮKassa в ваш Minecraft сервер. С поддержкой нескольких БД, гибкой конфигурацией и интеграцией с популярными плагинами, это идеальный выбор для любого проекта, требующего системы платежей.

Спасибо за использование YoPayment и удачи с вашим проектом!

Зависимости: PlaceholderAPI (опционально)

Команды и права: yopayment.create — разрешает игроку создавать ссылки для себя (по умолчанию: OP)

yopayment.create.others — разрешает создавать ссылки для других игроков (по умолчанию: OP)

yopayment.reload — доступ к команде перезагрузки конфига (по умолчанию: OP)

yopayment.list — просмотр своих платежей (по умолчанию: OP)

yopayment.list.others — просмотр платежей других игроков (по умолчанию: OP)

Плагин YoPayment - плагин на оплату с ЮКассы 2026-06-22

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

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