دليل إعداد مكافآت التصويت

تعلم كيفية إعداد مكافآت داخل اللعبة للاعبين الذين يصوتون لخادمك على 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"). يمكنك العثور عليه في رابط خادمك على Hylist.

نصيحة: ملء اسم المستخدم مسبقاً لتجربة أفضل

يمكنك إضافة ?username=اسم_اللاعب إلى رابط التصويت لملء اسم المستخدم تلقائياً:

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.
العودة إلى خوادمي