Плагин Votifier для Hytale
Современный плагин голосования для серверов Hytale от Top-Games. Автоматически награждайте игроков при голосовании с настраиваемой системой уровней.
Требования
- Работающий сервер Hytale
- Java 25 или выше
- Плагин WebServer установлен (плагин рекомендованный Hytale)
- Доступ к файлам конфигурации сервера
Установка SimpleVotifier
Установить плагин
Скопируйте файл SimpleVotifier.jar в папку mods/ вашего сервера Hytale.
mods/SimpleVotifier.jar
Проверить WebServer
Убедитесь, что плагин WebServer (плагин рекомендованный Hytale) установлен и работает.
Запустить сервер
Запустите ваш сервер Hytale, чтобы SimpleVotifier автоматически сгенерировал свою конфигурацию.
Настроить плагин
Отредактируйте сгенерированный файл конфигурации согласно вашим потребностям (см. раздел Конфигурация).
Конфигурация
После первого запуска SimpleVotifier автоматически создаёт файл конфигурации mods/SimpleVotifier/config.json.
Конфигурация по умолчанию
mods/SimpleVotifier/config.json
{
"language": "ru",
"token": "AbCdEfGh123456789XyZ0123",
"allowedIps": [],
"logVotes": true,
"broadcastVotes": true,
"rewards": {
"enabled": false,
"monthlyReset": true,
"everyVoteCommands": [
"give {player} Plant_Crop_Carrot_Item"
],
"tiers": [
{
"votesRequired": 10,
"commands": ["give {player} Container_Bucket"]
},
{
"votesRequired": 50,
"commands": ["give {player} Armor_Iron_Head"]
},
{
"votesRequired": 100,
"commands": ["give {player} Rock_Gem_Diamond"]
}
]
},
"leaderboard": {
"enabled": true,
"format": "html",
"showVoteSites": true
},
"voteSites": [
{
"service": "Top-Games",
"url": "https://top-games.net/hytale/my-server"
}
]
}
Параметры конфигурации
| Параметр | Тип | Описание |
|---|---|---|
language |
string | Код языка (en, fr, es, de, it, pt, ru, uk, zh, ja) |
token |
string | Безопасный токен для аутентификации HMAC (генерируется автоматически) |
allowedIps |
array | Белый список IP (пустой = разрешить все) |
logVotes |
boolean | Отображать голоса в консоли |
broadcastVotes |
boolean | Объявлять голоса всем игрокам |
Настройка Top-Games
Получить ваш токен
SimpleVotifier автоматически генерирует токен, который вы должны получить из файла конфигурации.
mods/SimpleVotifier/config.json
Настроить в Top-Games
Перейдите в вашу панель Top-Games, раздел "Votifier" вашего сервера Hytale.
- Активируйте "SimpleVotifier"
- Введите IP вашего сервера
- Порт: по умолчанию, порт сервера + 3 (пример:
5523) - Введите ваш токен из config.json
Протестировать соединение
Используйте кнопку "Тест" в вашей панели Top-Games чтобы проверить, что связь работает корректно.
Система наград (опционально)
SimpleVotifier включает встроенную систему наград с командами за каждый голос и уровнями наград.
Конфигурация наград
config.json (rewards section)
{
"rewards": {
"enabled": true,
"monthlyReset": true,
"everyVoteCommands": ["give {player} Plant_Crop_Carrot_Item"],
"tiers": [
{
"votesRequired": 10,
"commands": ["give {player} Container_Bucket"]
},
{
"votesRequired": 50,
"commands": ["give {player} Armor_Iron_Head"]
},
{
"votesRequired": 100,
"commands": ["give {player} Rock_Gem_Diamond"]
}
]
}
}
Команды игрока
| Команда | Описание |
|---|---|
/rewards |
Получить ожидающие награды за голосование |
/vote |
Показать настроенные ссылки для голосования |
/voteinfo |
Посмотреть статистику голосования и прогресс уровней |
API для разработчиков
Сторонние плагины могут слушать события голосования через EventBus Hytale.
MyPlugin.java
import com.hypixel.hytale.server.core.HytaleServer;
import net.top_games.hytale.plugins.simplevotifier.VoteEvent;
public class MyPlugin extends JavaPlugin {
@Override
protected void setup() {
HytaleServer.get().getEventBus()
.listenFor(VoteEvent.class, null)
.listen(this::onVote);
}
private void onVote(VoteEvent event) {
String username = event.getUsername();
String service = event.getServiceName();
getLogger().atInfo().log(username + " voted on " + service);
// Add your custom logic here
}
}
Рейтинг (опционально)
SimpleVotifier включает endpoint рейтинга для отображения лучших голосующих на вашем сервере.
Конфигурация рейтинга
config.json (leaderboard section)
{
"leaderboard": {
"enabled": true,
"format": "html",
"showVoteSites": true
}
}
Параметры рейтинга
| Параметр | Тип | Описание |
|---|---|---|
enabled |
boolean | Включить/отключить endpoint рейтинга (отключён по умолчанию) |
format |
string | Формат вывода по умолчанию: "html" или "json" (html по умолчанию) |
showVoteSites |
boolean | Показать/скрыть раздел сайтов голосования на рейтинге |
Endpoint рейтинга
GET https://your-server:port/Top-Games/SimpleVotifier/leaderboard
Устранение неполадок
- Проверьте, что плагин WebServer установлен
- Проверьте логи сервера на сообщения об ошибках
- Проверьте, что подпись HMAC генерируется корректно
- Проверьте конфигурацию allowedIps
- Проверьте логи сервера на сообщения об ошибках
- Убедитесь, что rewards.enabled установлен в true
- Проверьте синтаксис команд в конфигурации
- Проверьте, что игрок онлайн или используйте /rewards для получения
- Подтвердите, что monthlyReset включён
- Проверьте файл last_reset.txt для даты последнего сброса
- Сброс срабатывает при первом голосе нового месяца
Информация
Функциональность
- Безопасная аутентификация HMAC-SHA256
- Встроенная система наград
- Поддержка 10 языков
- Объявления голосов всем игрокам
- Ежемесячный сброс голосов
- Событийное API для сторонних плагинов
- Endpoint рейтинга (HTML/JSON)
Резюме конфигурации
- Установить плагин WebServer
- Установить SimpleVotifier
- Настроить config.json
- Настроить в Top-Games
- Протестировать соединение
- Настроить награды
- Настроить рейтинг
Поддержка
Нужна помощь с настройкой SimpleVotifier? Наша команда готова помочь вам.
Откройте для себя серверы Hytale
Изучите наш рейтинг лучших серверов Hytale и присоединяйтесь к сообществу!
Просмотреть серверы Hytale