دليل إعداد إضافة One Query
تعلم كيفية إعداد إضافة One Query لعرض عدد اللاعبين في الوقت الفعلي واللاعبين المتصلين ومعلومات الخادم على قائمة Hylist الخاصة بك.
Supported Plugins
Hylist supports two query plugins. Install one of them (not both - they are mutually exclusive):
One Query
The recommended plugin with full feature support including plugin version and status info.
Hyvote
Alternative plugin with configurable exports. Lets you toggle exactly what data to expose.
Important: These plugins are mutually exclusive. Only install one of them - do not install both on the same server.
ما هي One Query؟
These plugins enable server status queries using UDP. They share your game server port, so no additional ports or firewall configuration is needed. This allows Hylist to fetch real-time data about your server, including:
- عدد اللاعبين الحالي والحد الأقصى
- قائمة اللاعبين المتصلين بأسمائهم ومعرفاتهم
- إصدار الخادم و MOTD
- قائمة الإضافات المثبتة
الخطوة 1: تثبيت الإضافة
Download and install either One Query or Hyvote on your Hytale server:
- قم بتحميل أحدث ملف JAR من صفحة إصدارات GitHub
- ضع ملف JAR في مجلد الإضافات بخادمك
- أعد تشغيل خادمك
لا حاجة لتكوين إضافي! تعمل الإضافة مباشرة باستخدام منفذ خادم اللعبة (5520).
الخطوة 2: إضافة منفذ الاستعلام في Hylist
قم بتكوين منفذ الاستعلام في لوحة تحكم Hylist:
- انتقل إلى صفحة تحرير خادمك في لوحة تحكم Hylist
- انتقل إلى قسم "منافذ الاستعلام"
- انقر على "إضافة منفذ استعلام"
- أدخل المنفذ 5520 (أو منفذ خادم اللعبة إذا كان مختلفاً)
- اختيارياً حدد وسماً لربط هذا المنفذ بوضع لعب
- احفظ تغييراتك
أوضاع لعب متعددة (شبكات البروكسي)
إذا كنت تشغل خوادم خلفية متعددة، يمكنك إضافة منافذ استعلام متعددة - واحد لكل وضع لعب:
Port 5520 -> No tag (Lobby) Port 5521 -> PvP Port 5522 -> Survival يحتاج كل خادم خلفي إلى نسخة خاصة من إضافة One Query. يساعد الوسم الزوار على فهم وضع اللعب الذي تنتمي إليه كل قائمة لاعبين.
التحقق من إعدادك
بعد تكوين كل شيء، تحقق من إعدادك:
- تأكد من أن خادمك متصل وإضافة One Query تعمل
- انتظر بضع دقائق ليستعلم Hylist عن خادمك
- قم بزيارة صفحة خادمك على Hylist
- يجب أن ترى عدد اللاعبين واللاعبين المتصلين والإصدار ومعلومات الإضافات
إذا كان كل شيء يعمل، سترى شارة "متصل" خضراء ومعلومات اللاعبين في الوقت الفعلي على صفحة خادمك!
استكشاف الأخطاء وإصلاحها
لا تظهر بيانات على Hylist؟
- تحقق من وجود ملف JAR الخاص بإضافة One Query في مجلد الإضافات
- تحقق من سجلات خادمك بحثاً عن أخطاء الإضافة
- تأكد من تطابق رقم المنفذ في Hylist مع منفذ خادمك (الافتراضي: 5520)
- انتظر 5-10 دقائق ليقوم Hylist بتحديث بيانات الخادم
عدد اللاعبين أو المعلومات غير صحيحة؟
- تأكد من أن منفذ الاستعلام يشير إلى الخادم الصحيح
- إذا كنت تستخدم خوادم متعددة، تأكد من أن لكل خادم منفذه الخاص مُعدّاً
Why Server Query Matters for Your Listing
Adding server query to your Hytale server listing significantly improves your visibility and credibility on Hylist. Here's how real-time server data impacts your server's performance on the platform.
Higher Search Ranking
Servers with active query data appear higher in filtered searches. When players filter by "online only" or sort by player count, your server will only appear if query data is available. Without it, you're invisible to a significant portion of potential players.
Player Trust
Displaying real-time player counts and server status builds trust with potential players. A server showing "42 players online" is far more compelling than one with no data. Players are more likely to join and vote for servers they can verify are active.
Analytics Insights
Query data feeds into your server's analytics dashboard, showing player count trends over time. You can identify peak hours, track growth, and measure the impact of promotional campaigns or content updates.
Discord Integration
The Hylist Discord bot uses query data to display live player counts and server status in your Discord server. Without query configured, these stat channels will show limited information.