Голосовать

Безопасный плагин для прослушивания голосов для Hytale, который позволяет сайтам для голосования отправлять уведомления о голосовании на ваш сервер.

Особенности

• Протокол гибридного шифрования: Использование шифрования RSA + AES-256 для безопасной и гибкой передачи голоса
• Конфигурируемые действияВыполнять команды автоматически при получении голосов или присоединении игроков.
• Разработчик API: Запустите пользовательские события и интегрируйте обработку голосов в свои собственные плагины
• Защита от воспроизведенияВстроенная метка времени и проверка nonce предотвращает дублирование голосов
• Многопрофильный протокол ПоддержкаПоле версии позволяет будущим обновлениям протокола без нарушения существующих интеграций.

установка

1. Скачать последний релиз
2. Место Hyvote.jar в папке плагинов вашего сервера
3. Запустите свой сервер - Настройки.json будет генерироваться автоматически
4. Настройка ваших настроек (см. ниже)
5. Поделитесь своим публичным ключом RSA с сайтами для голосования (обнаружено в разделе WEB ) Ключи/public.pem)

конфигурация

Настройки хранятся в Настройки.json:

{
"порт": 2250,
"база данных": {
"тип": "склит",
"хозяин": "локальный"
"порт": 3306,
"имя пользователя": "hytale",
"password": "supersecretdatabasepassword",
"база данных": "hyvote"
?
"Действия":
{
"на": "голосовать",
"тип": "командный",
"Командир": "Скажи ${player} только что проголосовал за ${voteSite}!"
?
{
"на": "присоединиться",
"тип": "командный",
"Командир": "Скажи "Добро пожаловать назад"! Спасибо, что проголосовали на сайте.
?
]
?

Варианты конфигурации

порт: Порт TCP, к которому привязан слушатель голосования (по умолчанию: 2250)

база данных: Варианты конфигурации базы данных

действияМассив действий, которые необходимо выполнить, когда будут получены голоса

Свойства базы данных

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

• тип: Тип базы данных для использования (поддерживаемый - MySQL, MariaDB, SQLite, PostgreSQL)
• ведущий: Ведущий базы данных (игнорируется при использовании SQLite)
• порт: Порт, на котором прослушивается база данных (игнорируется при использовании SQLite)
• имя пользователя: Имя пользователя базы данных (игнорируется при использовании SQLite)
• пароль: Пароль для пользователя базы данных (игнорируется при использовании SQLite)
• база данных: База данных для использования (игнорируется при использовании SQLite)

Свойства действия

• на: Когда выполнять действие

  • голосовать - Сразу после голосования обрабатывается
  • присоединяться Когда игрок присоединяется (или сразу, если уже онлайн)

• типТип действия (в настоящее время только) командовать поддерживается)

• командовать: Командование выполнять. Поддерживает держателей мест:

  • ${игрок} - Имя пользователя избирателя
  • ${voteSite} - Название участка для голосования
  • ${uuid} UUID избирателя
  • ${timestamp} - Отметка времени голосования

Разработчик API

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

Слушать голоса

импорт uk.co.deveroonie.hyvote.api.VoteEventManager;
Импорт uk.co.deveroonie.hyvote.api.Vote событие;

Зарегистрируйте своего слушателя
VoteEventManager.registerListener (событие -> {)
Голосование = event.getVote();

// Доступ к данным голосования
Струнный игрок = vote.playerName;
Струнный сайт = vote.vote Сайт;
Давняя метка времени = vote.timestamp;

// Опционально отменить обработку по умолчанию
event.setCancelled (правда)

// Реализуйте свою собственную логику
myPlugin.giveCustomReward (игрок);
}

Голосование Объект

Общественный класс Голосование {
публичный Струнный uuid; // Player UUID
Публичный струнный игрок Имя пользователя / Player Username
Публичный струнный избирательный участок; // Идентификатор сайта голосования
public long timetamp; // Unix timetamp
публичный струнный nonce; // Replay protection nonce
?

Незарегистрированные слушатели

Избиратель myListener = event -> {/*...*/};
VoteEventManager.registerListener (myListener);

// Позже...
VoteEventManager.unregisterListener (myListener);

Спецификация протокола

Hyvote использует пользовательский бинарный протокол (HV01) для передачи голоса:

Формат сообщения

[4 байта] Магия: «HV01»
[4 байта] Зашифрованная длина ключа AES (big-endian int)
[N байтов] Зашифрованный ключ AES-256
[4 байта] Шифрованная длина полезной нагрузки (big-endian int)
[М байт] Зашифрованный AES Полезная нагрузка JSON

шифрование

1. Создайте случайный 256-битный ключ AES
2. Шифровать голос JSON с помощью AES-256-CBC (включает 16-байт IV, предварительно подготовленный к шифрованию)
3. Зашифровать ключ AES с помощью открытого ключа RSA сервера (PKCS1 или OAEP)
4. Упаковка и отправка в соответствии с форматом сообщения выше

Структура полезной нагрузки JON

{
"uuid": "player-uuid-here",
"Имя игрока": "Имя игрока",
"voteSite": "VotingSiteName",
"Табель времени": 1737000000000,
"nonce": "уникальная-случайная-струна"
?

Клиентские библиотеки

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

• Java
• JavaScript/Node.js

Безопасность

• Все данные голосования шифруются сквозным образом с использованием гибридного шифрования RSA + AES
• Атаки повтора смягчаются через nonces
• Неправильные сообщения отклоняются перед обработкой

Поддержка

Для вопросов, запросов функций или вопросов протокола, пожалуйста, посетите наш репозиторий GitHub.

Лицензия

МТИ