Плагін Votifier для Hytale

Сучасний плагін голосування для серверів Hytale від Top-Games. Автоматично винагороджуйте гравців при голосуванні з налаштовуваною системою рівнів.

Завантажити SimpleVotifier Вихідний код

Сумісний з Hytale

Auth HMAC-SHA256

10 мов

Вбудовані винагороди

Вимоги

Важливо: Це налаштування вимагає сервер Hytale з встановленим плагіном WebServer.

Працюючий сервер Hytale
Java 25 або вище
Плагін WebServer встановлено (плагін рекомендований Hytale)
Доступ до файлів конфігурації сервера

Встановлення SimpleVotifier

Завантажити SimpleVotifier

Завантажте останню версію плагіна з Modtale.

Завантажити на Modtale

Встановити плагін

Скопіюйте файл SimpleVotifier.jar у папку mods/ вашого сервера Hytale.

mods/SimpleVotifier.jar

Перевірити WebServer

Переконайтеся, що плагін WebServer (плагін рекомендований Hytale) встановлено та працює.

Запустити сервер

Запустіть ваш сервер Hytale, щоб SimpleVotifier автоматично згенерував свою конфігурацію.

Налаштувати плагін

Відредагуйте згенерований файл конфігурації згідно з вашими потребами (див. розділ Конфігурація).

Конфігурація

Після першого запуску SimpleVotifier автоматично створює файл конфігурації mods/SimpleVotifier/config.json.

Конфігурація за замовчуванням

mods/SimpleVotifier/config.json

{
  "language": "ua",
  "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 для активації підключення.

Налаштування 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"]
      }
    ]
  }
}

Доступний плейсхолдер: Використовуйте {player} у ваших командах - буде замінено на ім'я гравця.

Команди гравця

Команда	Опис
`/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
    }
}

Примітка: Коли модуль VoteRewards увімкнено, він автоматично керує винагородами. Вимкніть його (rewards.enabled: false) якщо хочете повний контроль через власний плагін винагород.

Рейтинг (опціонально)

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 для дати останнього скидання
Скидання спрацьовує при першому голосі нового місяця

Інформація

Тип: Плагін Hytale

Сумісність: Сервер Hytale

Java: Java 25+

Протокол: HMAC-SHA256 + HTTP

Мови: 10 підтримуваних мов

Функціональність

Безпечна автентифікація HMAC-SHA256
Вбудована система винагород
Підтримка 10 мов
Оголошення голосів всім гравцям
Щомісячне скидання голосів
Подієве API для сторонніх плагінів
Endpoint рейтингу (HTML/JSON)

Резюме конфігурації

Встановити плагін WebServer
Встановити SimpleVotifier
Налаштувати config.json
Налаштувати в Top-Games
Протестувати з'єднання
Налаштувати винагороди
Налаштувати рейтинг

Підтримка

Потрібна допомога з налаштуванням SimpleVotifier? Наша команда готова допомогти вам.

Зв'язатися з нами Повідомити про помилку

Відкрийте для себе сервери Hytale

Досліджуйте наш рейтинг найкращих серверів Hytale та приєднуйтесь до спільноти!

Переглянути сервери Hytale