Votifier
A Votifier-style plugin for Hytale that receives vote notifications from voting websites via webserver and fires events for other plugins to handle rewards.
Описание

HytaleVotifier
Вознаграждайте игроков за поддержку сервера!
HytaleVotifier - это мощный плагин Votifier для серверов Hytale, который позволяет легко отслеживать голоса, вознаграждать игроков и повышать активность вашего сервера. Совместим со всеми основными сайтами голосования, которые поддерживают протокол Votifier (V1 и V2 / NuVotifier)!
Особенности
- Поддержка двойного протокола V1 (шифрование RSA) и V2 (HMAC-SHA256) для максимальной совместимости
- V2 Socket Server Выделенный сокет TCP с аутентификацией ответа на вызов
- Пользовательские сообщения чата Отправка персонализированных благодарственных сообщений игрокам после голосования
- Серверные трансляции - Объявлять голоса на весь сервер, когда кто-то голосует
- Автоматические награды Запускайте команды автоматически, когда приходят голоса
- Уведомления на экране Красивые тостовые всплывающие окна для мгновенной обратной связи
- Кликабельные ссылки для голосования -
/голосоватьКоманда показывает кликабельные ссылки на ваши сайты голосования - Острые награды - Установите случайные награды (обычные, редкие, легендарные капли!)
- Напоминания о голосовании Напомните игрокам голосовать за присоединение, если они не голосовали в последнее время.
- Отслеживание голосов Постоянные треки хранения SQLite, когда игроки в последний раз голосовали
- Автообновления - Уведомляться, когда доступны новые версии
Быстрый старт
- скачать последней страницы или GitHub выпустили
- Бросить джар на ваш сервер
модс/папка - Начните свой сервер Ключи RSA генерируются автоматически при первом запуске
- Настройте свои сайты для голосования - Поделитесь своим
публичный ключс сайтами голосования (V1) или токенами обмена (V2) - Настройка наград Редактировать
config.jsonНастройка сообщений и вознаграждений
Вот так! Ваш сервер готов к голосованию.
Цветовое форматирование
Использование HytaleVotifier TaleMessage Красивые цветные сообщения.
Доступные цвета:
<black>, <dark_blue>, <dark_green>, <dark_aqua>, <dark_red>, <dark_purple>, <gold>, <gray>, <blue>, <aqua>, <red>, <yellow>, <white>, <orange>
Пример:
<gray>Спасибо за ваш голос по <orange></orange>. <green>Наслаждайтесь наградами!</green>
Кликабельный текст:
<click:https://exmple.com>Click Здесь!</click>
конфигурация
Ваш конфигурационный файл находится в Моды/Hyvote_HytaleVotifier/config.json
Пример настройки
{
"отладка": ложная,
"keyPath": "ключи",
"Голосование": {
"Включено": правда,
«Послание»: «Голосование получено!»,
"ОписаниеПослание": "Спасибо за ваш голос по [от]!",
"iconItem": "Ore_Gold"
?
"трансляция": {
"Включено": правда,
«Послание»: «{имя пользователя} проголосовало за [от]!»
?
"Командование вознаграждения":
{
"Включено": правда,
"command": "give {username} Ingredient_Stick",
"случайность": 1.0
?
{
"Включено": правда,
"командир": "дайте имя пользователя Ingredient_Bar_Gold",
"случайность": 0,25
?
{
"Включено": правда,
"команд": "дайте имя пользователя" Weapon_Longsword_Adamantite_Saurian,
"случайность": 0,05
?
]
"Голосование": {
"Токены": {
"TopHytaleSites": "ваш секрет-токен-здесь",
«Hyvote»: «Another-secret-token»
?
?
"socketServer": {
"Включено": правда,
"порт": 8192
?
"Внутренний HTTP-сервер":
"Включено": правда,
«Порт»: 8080
?
"Протоколы": {
"v1Enabled": правда,
"v2Enabled": правда
?
"Команда по голосованию": {
"Включено": правда,
Голосуйте за наш сервер! ★★★★
"siteTemplate": "➤{name}",
"футер": Спасибо, что поддержали нас!
"Сайты":
{
"имя": "Hyvote.org",
"url": "https://hyvote.org/servers/my-server"
?
{
"имя": "TopHytaleSites",
"url": "https://tophytalesites.com/vote/my-server"
?
]
?
"Напоминание": {
"Включено": правда,
"SendOnJoin": правда,
"voteExpiryInterval": 24,
"Вторая задержка": 60,
"Хранение": {
"тип": "склит",
"filePath": "votes.db",
"CleanupIntervalHours": 6
?
"Сообщение": {
"Включено": правда,
Текст: Вы сегодня не голосовали! Вы можете голосовать каждый день, чтобы получить бесплатное вознаграждение!
?
"уведомление": {
"Включено": правда,
Заголовок сообщения: "Вы сегодня не голосовали",
«Послание»: «Вы можете голосовать каждый день за бесплатное вознаграждение!»
"iconItem": "Upgrade_Backpack_2"
?
?
?
Варианты конфигурации
| Вариант | Описание |
|---|---|
отладка |
Включить глагольную отладку |
KeyPath |
Подкаталог ключей RSA (относительно каталога данных плагинов) |
сообщение |
Настройки оповещения о тосте для избирателя |
трансляция |
Серверные настройки объявлений |
Вознаграждение команды |
Приказы исполняются при получении голосов |
места голосования |
Токены службы протокола V2 (название службы → общий секрет) |
SocketServer |
Настройки сервера сокетов V2 TCP (порт 8192 по умолчанию) |
внутренний HttpServer |
Настройки HTTP-сервера Fallback (используются при недоступности Nitrado:WebServer) |
протоколы |
Включить/отключить протоколы V1 (RSA по HTTP) и V2 (HMAC-SHA256) |
руководитель голосования |
Настройки для /голосовать Команда с кликабельными ссылками на сайт |
Напоминание |
Настройки для напоминания игрокам голосовать за присоединение |
держатели мест
| владелец | Описание |
|---|---|
{имя пользователя} |
Имя игрока в игре |
{из} |
Название сайта для голосования |
{имя} |
Имя отображения сайта голосования (в команде голосования) |
{ссылка} |
URL сайта голосования (в команде голосования) |
Вознаграждение
Настройка шанс от 0,0 до 1,0 для создания захватывающих многоуровневых наград:
1.0100% шанс (гарантированный)0,2525% шанс (необычный)0,055% вероятность (редко)
Напоминания о голосовании
HytaleVotifier может напоминать игрокам голосовать, когда они присоединяются к серверу. Система напоминания включает в себя:
- чат сообщения - Прямое сообщение игроку
- Оригинальное название Большой текст на экране
- Тостовые уведомления - Всплывающие уведомления
- Звуковые эффекты - Аудиокнига
конфигурировать ГолосованиеExpiryInterval Установить, сколько часов до голосования истекает и напоминания возобновляются (по умолчанию: 24 часа).
Протоколы голосования
HytaleVotifier поддерживает два протокола для максимальной совместимости:
| Протокол | аутентификация | Транспорт | Используйте |
|---|---|---|---|
| V1 | RSA 2048-битное шифрование | HTTP | Классическая совместимость Votifier |
| V2 | Подписи HMAC-SHA256 | HTTP или TCP сокет | Совместимость NuVotifier |
V1 Настройка: Поделитесь своим публичный ключ Файл с сайтами для голосования.
V2 Настройка: Обмен секретными токенами с сайтами для голосования и добавление их в Издательство:Sites.tokens в твоей конфигурации.
Подробную документацию по протоколу см. GitHub читать.
Тестирование вашей настройки
Используйте /testvote Команда для проверки вашей конфигурации без необходимости фактического голосования:
/testvote PlayerName
Прохождение PlayerName MySite
Разрешение: Голосование.admin.testvote
Разрешения
| Разрешение | Описание |
|---|---|
Голосование.admin.testvote |
Используйте /testvote командовать |
votifier.admin |
Получить уведомления об обновлении о присоединении |
votifier.admin.update_notifications |
Альтернативное разрешение только на обновление уведомлений |
Местоположение файлов
Моды/Hyvote_HytaleVotifier/
Исполнитель: Config.json #Конфигурация
Голосование.db База данных отслеживания голосов (SQLite)
─ ─ ключи/
Public.key # Поделиться с сайтами голосования (V1)
─ ─ Частный. Ключ # secret Держите это в секрете!
Поддержка
- Разногласия: раздор
- Bug Reports: Проблемы GitHub
- Полная документация: GitHub читать
- Разработчик API: GitHub Docs
У вас проблемы с конфигурацией? Подтвердите свой JSON hytaletools.org
Показать оригинальное описание (English)

HytaleVotifier
Reward your players for supporting your server!
HytaleVotifier is a powerful Votifier plugin for Hytale servers that makes it easy to track votes, reward players, and boost your server's activity. Compatible with all major voting sites that support the Votifier protocol (V1 and V2/NuVotifier)!
Features
- Dual Protocol Support — V1 (RSA encryption) and V2 (HMAC-SHA256) for maximum compatibility
- V2 Socket Server — Dedicated TCP socket with challenge-response authentication
- Custom chat messages — Send personalized thank-you messages to players after they vote
- Server broadcasts — Announce votes to the entire server when someone votes
- Automatic rewards — Run commands automatically when votes come in
- On-screen notifications — Beautiful toast popups for instant feedback
- Clickable vote links —
/votecommand shows clickable links to your voting sites - Tiered rewards — Set up chance-based rewards (common, rare, legendary drops!)
- Vote reminders — Remind players to vote on join if they haven't voted recently
- Vote tracking — Persistent SQLite storage tracks when players last voted
- Auto-updates — Get notified when new versions are available
Quick Start
- Download the latest JAR from this page or GitHub Releases
- Drop the JAR into your server's
mods/folder - Start your server — RSA keys are generated automatically on first run
- Configure your voting sites — Share your
public.keywith voting sites (V1) or exchange tokens (V2) - Customize rewards — Edit
config.jsonto set up messages and rewards
That's it! Your server is ready to receive votes.
Color Formatting
HytaleVotifier uses TaleMessage for beautiful colored messages.
Available colors:
<black>, <dark_blue>, <dark_green>, <dark_aqua>, <dark_red>, <dark_purple>, <gold>, <gray>, <blue>, <green>, <aqua>, <red>, <yellow>, <white>, <orange>
Example:
<gray>Thanks for your vote on <orange>{from}</orange>. <green>Enjoy your rewards!</green>
Clickable text:
<click:https://example.com>Click here!</click>
Configuration
Your config file is located at mods/Hyvote_HytaleVotifier/config.json
Example Setup
{
"debug": false,
"keyPath": "keys",
"voteMessage": {
"enabled": true,
"titleMessage": "Vote Received!",
"descriptionMessage": "Thanks for your vote on {from}!",
"iconItem": "Ore_Gold"
},
"broadcast": {
"enabled": true,
"message": "{username} voted on {from}!"
},
"rewardCommands": [
{
"enabled": true,
"command": "give {username} Ingredient_Stick",
"chance": 1.0
},
{
"enabled": true,
"command": "give {username} Ingredient_Bar_Gold",
"chance": 0.25
},
{
"enabled": true,
"command": "give {username} Weapon_Longsword_Adamantite_Saurian",
"chance": 0.05
}
],
"voteSites": {
"tokens": {
"TopHytaleSites": "your-secret-token-here",
"Hyvote": "another-secret-token"
}
},
"socketServer": {
"enabled": true,
"port": 8192
},
"internalHttpServer": {
"enabled": true,
"port": 8080
},
"protocols": {
"v1Enabled": true,
"v2Enabled": true
},
"voteCommand": {
"enabled": true,
"header": "★★★ Vote for our server! ★★★",
"siteTemplate": "➤ {name}",
"footer": "Thank you for supporting us!",
"sites": [
{
"name": "Hyvote.org",
"url": "https://hyvote.org/servers/my-server"
},
{
"name": "TopHytaleSites",
"url": "https://tophytalesites.com/vote/my-server"
}
]
},
"voteReminder": {
"enabled": true,
"sendOnJoin": true,
"voteExpiryInterval": 24,
"delayInSeconds": 60,
"storage": {
"type": "sqlite",
"filePath": "votes.db",
"cleanupIntervalHours": 6
},
"message": {
"enabled": true,
"text": "You haven't voted today! You can '/vote' every day to receive free rewards!"
},
"notification": {
"enabled": true,
"titleMessage": "You haven't voted today",
"descriptionMessage": "You can /vote every day for free rewards!",
"iconItem": "Upgrade_Backpack_2"
}
}
}
Configuration Options
| Option | Description |
|---|---|
debug |
Enable verbose debug logging |
keyPath |
Subdirectory for RSA keys (relative to plugin data directory) |
voteMessage |
Toast notification settings for the voter |
broadcast |
Server-wide announcement settings |
rewardCommands |
Commands to execute when votes are received |
voteSites |
V2 protocol service tokens (service name → shared secret) |
socketServer |
V2 TCP socket server settings (port 8192 by default) |
internalHttpServer |
Fallback HTTP server settings (used when Nitrado:WebServer is unavailable) |
protocols |
Enable/disable V1 (RSA over HTTP) and V2 (HMAC-SHA256) protocols |
voteCommand |
Settings for the /vote command with clickable site links |
voteReminder |
Settings for reminding players to vote on join |
Placeholders
| Placeholder | Description |
|---|---|
{username} |
Player's in-game name |
{from} |
Name of the voting site |
{name} |
Voting site display name (in vote command) |
{link} |
Voting site URL (in vote command) |
Tiered Rewards
Set chance between 0.0 and 1.0 to create exciting tiered rewards:
1.0= 100% chance (guaranteed)0.25= 25% chance (uncommon)0.05= 5% chance (rare)
Vote Reminders
HytaleVotifier can remind players to vote when they join the server. The reminder system includes:
- Chat messages — Direct message to the player
- Title display — Large text on screen
- Toast notifications — Popup notifications
- Sound effects — Audio cues
Configure voteExpiryInterval to set how many hours before a vote "expires" and reminders resume (default: 24 hours).
Vote Protocols
HytaleVotifier supports two protocols for maximum compatibility:
| Protocol | Authentication | Transport | Use Case |
|---|---|---|---|
| V1 | RSA 2048-bit encryption | HTTP | Classic Votifier compatibility |
| V2 | HMAC-SHA256 signatures | HTTP or TCP socket | Modern NuVotifier compatibility |
V1 Setup: Share your public.key file with voting sites.
V2 Setup: Exchange shared secret tokens with voting sites and add them to voteSites.tokens in your config.
For detailed protocol documentation, see the GitHub README.
Testing Your Setup
Use the /testvote command to test your configuration without needing an actual vote:
/testvote PlayerName
/testvote PlayerName MySite
Permission: votifier.admin.testvote
Permissions
| Permission | Description |
|---|---|
votifier.admin.testvote |
Use the /testvote command |
votifier.admin |
Receive update notifications on join |
votifier.admin.update_notifications |
Alternative permission for update notifications only |
File Locations
mods/Hyvote_HytaleVotifier/
├── config.json # Your configuration
├── votes.db # Vote tracking database (SQLite)
└── keys/
├── public.key # 📤 Share with voting sites (V1)
└── private.key # 🔒 Keep this secret!
💬 Support
- Discord: Discord
- Bug Reports: GitHub Issues
- Full Documentation: GitHub README
- Developer API: GitHub Docs
Having trouble with your config? Validate your JSON at hytaletools.org
Информация
Версии игры:
Создан: 14.01.2026