Посібник з налаштування нагород за голосування

Дізнайтеся, як налаштувати ігрові нагороди для гравців, які голосують за ваш сервер на Hylist.

Що таке Votifier2?

Votifier2 — це протокол, який дозволяє сайтам зі списками серверів, таким як Hylist, надсилати сповіщення про голоси безпосередньо на ваш ігровий сервер. Коли гравець голосує за ваш сервер, Hylist надсилає захищене повідомлення на ваш сервер, який потім може автоматично нагородити гравця.

Вимоги

  • Плагін, сумісний з Votifier2, встановлений на вашому сервері
  • Відкритий порт для слухача Votifier (за замовчуванням: 8192)
  • Плагін нагород для видачі предметів/привілеїв голосуючим (необов'язково, але рекомендується)

Крок 1: Встановіть плагін Votifier2

Спочатку вам потрібно встановити плагін, сумісний з Votifier2, на вашому сервері Hytale. Ми рекомендуємо:

Завантажити Hytale Votifier

Дотримуйтесь інструкцій зі встановлення плагіна, щоб додати його на свій сервер.

Крок 2: Увімкніть ігрові нагороди в Hylist

Увімкніть ігрові нагороди в панелі керування Hylist, щоб отримати токен Votifier.

  1. Перейдіть на сторінку редагування сервера в панелі керування Hylist
  2. Увімкніть "Увімкнити ігрові нагороди"
  3. Встановіть порт Votifier (за замовчуванням: 8192)
  4. Збережіть зміни
  5. Скопіюйте токен Votifier для наступного кроку

Крок 3: Налаштуйте плагін

Вставте токен Votifier з Hylist у файл конфігурації вашого плагіна.

Приклад конфігурації (config.json):

{
  "BindHost": "0.0.0.0",
  "BindPort": 8192,
  "DisableV1Protocol": false,
  "RewardCommands": [
    "gm adventure %player%"
  ],
  "RewardMessages": [
    "<gray>Thanks for your vote on <gold>%from%</gold>!"
  ],
  "Tokens": {
    "Hylist.io": "<YOUR_TOKEN_FROM_HYLIST>"
  }
}

Необов'язково: Конфігурація команди голосування (voteCommand.json):

{
  "Enabled": true,
  "OpenCustomGui": true,
  "SendChatMessage": true,
  "ChatMessageHeader": [
    "<gold><b>Vote for our server!</b></gold>"
  ],
  "ChatMessageTemplate": "<yellow><click:%link%>%name% (Click)</click></yellow>",
  "VoteLinks": {
    "Hylist.io": "https://hylist.io/vote/<YOUR_SERVER_SLUG>"
  }
}

Замініть <YOUR_SERVER_SLUG> на slug вашого сервера (напр. "my-awesome-server"). Ви можете знайти його в URL вашого сервера на Hylist.

Порада: Попереднє заповнення імені користувача для кращого UX

Ви можете додати ?username=ІмяГравця до URL голосування, щоб автоматично заповнити ім'я гравця:

https://hylist.io/vote/your-server?username=PlayerName

Примітка: Для цього потрібна підтримка спеціального плагіна, оскільки більшість плагінів не підтримують це за замовчуванням.

Крок 4: Відкрийте порт

Переконайтеся, що порт Votifier відкритий і доступний з інтернету.

Переконайтеся, що порт відкритий у брандмауері вашого сервера. Якщо ви використовуєте хостинг-провайдера, вам може знадобитися налаштувати переадресацію портів.

Тестування налаштування

Щоб перевірити, що все працює:

  1. Переконайтеся, що ваш сервер онлайн і плагін Votifier працює
  2. Проголосуйте за свій сервер на Hylist і введіть своє ігрове ім'я
  3. Перевірте консоль сервера на наявність сповіщень про голоси
  4. Переконайтеся, що ви отримали налаштовані нагороди в грі

Поради з безпеки

Ніколи не діліться своїм токеном Votifier публічно! Будь-хто з доступом до вашого токена може надсилати фальшиві сповіщення про голоси на ваш сервер.

  • Тримайте токен Votifier приватним і захищеним
  • Негайно перегенеруйте токен, якщо підозрюєте, що його скомпрометовано
  • Якщо можливо, відкрийте порт Votifier лише для довірених IP-адрес

Вирішення проблем

Не отримуєте голоси?

  • Переконайтеся, що порт відкритий і доступний з інтернету
  • Перевірте, що IP-адреса вашого сервера правильна в Hylist
  • Переконайтеся, що плагін Votifier працює (перевірте логи сервера)
  • Переконайтеся, що токен точно збігається (без зайвих пробілів)

Голоси отримано, але нагород немає?

  • Переконайтеся, що гравець онлайн, коли голос обробляється
  • Перевірте, що ім'я користувача написано правильно (чутливо до регістру!)
  • Переконайтеся, що плагін нагород налаштований правильно

Важливо: Ім'я користувача чутливе до регістру

Гравці повинні вводити своє ім'я точно так, як воно відображається в грі, включаючи правильний регістр. Наприклад, "Player123" і "player123" розглядаються як різні користувачі.

Best Practices for Voting Rewards

Setting up voting rewards is just the first step. To maximize the impact on your server's ranking and player retention, follow these proven strategies that top-ranked Hytale servers use.

Choose Meaningful Rewards

Give rewards that players actually want but can't easily get otherwise. Exclusive cosmetics, bonus currency, or temporary boosters work better than common items. The goal is to make voting feel rewarding without making it mandatory for progression.

Create Vote Streaks

Consider implementing escalating rewards for consecutive daily votes. For example, voting 7 days in a row could unlock a special reward. This encourages habitual voting and dramatically increases your monthly vote count.

Announce Rewards In-Game

When a player receives a vote reward, broadcast it to the server. A message like "[Player] voted and received 500 coins!" reminds other players that voting rewards exist and encourages them to vote too.

Use Discord Reminders

Set up the Hylist Discord bot to post your server's vote link in a dedicated channel. Players who see a daily reminder are significantly more likely to vote consistently. You can also pin your vote link for easy access.

Frequently Asked Questions

What happens if my server is offline when a player votes?
The vote is still counted toward your server's ranking. However, the Votifier2 notification cannot be delivered while your server is offline, so the player won't receive their in-game reward immediately. Most Votifier2 plugins queue missed notifications and deliver them when the server comes back online, but this depends on your plugin's configuration.
Can I give different rewards to different players?
Yes, through your rewards plugin configuration. Most plugins support permission-based rewards, where players with certain ranks or groups receive different rewards. You can configure your voteCommand.json to run different commands based on player permissions or implement rank-based reward tiers.
Is Votifier2 compatible with proxy networks (BungeeCord/Velocity)?
Yes. Install the Votifier2 plugin on your proxy server (BungeeCord or Velocity) and configure it to forward vote notifications to backend servers. The vote port should be opened on the proxy machine. Most reward plugins support receiving forwarded votes from the proxy.
How do I test if voting rewards are working?
After setting up Votifier2 and enabling rewards in your Hylist dashboard, simply vote for your own server. Join your game server and check if you receive the configured reward. If the reward doesn't arrive, check your server console for Votifier2 connection logs and ensure the port is open and the token matches.
Назад до Моїх серверів