Начало разработки интеграций
Что такое разработка интеграций?
Разработка интеграций позволяет создавать бесшовные соединения между сторонними плагинами Minecraft и веб-платформой Pano. Используя API Pano MC Plugin, вы можете:
- Синхронизировать данные между игрой и вебом в режиме реального времени.
- Отправлять запросы из вашего плагина Minecraft на веб-платформу Pano.
- Получать и обрабатывать сообщения от Pano.
- Запускать веб-действия на основе игровых событий.
- Создавать единый пользовательский опыт на обеих платформах.
Предварительные требования
Перед началом разработки интеграций убедитесь, что у вас есть:
- Java Development Kit (JDK 11+) — необходим для разработки плагинов.
- Знание Java или Kotlin — вы можете использовать любой из этих языков с API Pano MC Plugin.
- Опыт разработки плагинов Minecraft — понимание Spigot/Paper/Bukkit API.
- Pano MC Plugin API — репозиторий GitHub.
- Запущенный экземпляр Pano — для тестирования вашей интеграции.
- Тестовый сервер Minecraft — сервер Spigot, Paper или Folia для разработки.
Примечание: Все примеры в этом руководстве приведены как на Kotlin, так и на Java для вашего удобства.
Обзор архитектуры
Система интеграции Pano состоит из трех основных компонентов:
┌─────────────────────┐ ┌──────────────────────┐ ┌─────────────────┐
│ Ваш MC плагин │ ◄─────► │ Pano MC Plugin │ ◄─────► │ Бэкенд Pano │
│ (Интеграция) │ │ (API связи) │ │ (Веб-платформа)│
└─────────────────────┘ └──────────────────────┘ └─────────────────┘
(Хуки плагина) (Безопасный WebSocket API) (API платформы)Поток данных
- Ваш плагин → API Pano MC Plugin: Вы используете API для отправки запросов или сообщений.
- Pano MC Plugin → Бэкенд Pano: Безопасная зашифрованная связь через WebSocket (RSA + AES-256).
- Бэкенд Pano → Ваш плагин: Pano автоматически обрабатывает соединения и направляет сообщения обратно.
- Бэкенд Pano → Веб: Данные синхронизируются и отображаются на веб-сайте.
Важно: НЕ делайте форк Pano MC Plugin. Вместо этого создайте свой отдельный плагин и используйте API Pano MC Plugin.