One Query پلگ ان سیٹ اپ گائیڈ

اپنی Hylist لسٹنگ پر ریئل ٹائم پلیئر کاؤنٹ، آن لائن کھلاڑیوں اور سرور کی معلومات دکھانے کے لیے One Query پلگ ان کو سیٹ اپ کرنا سیکھیں۔

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:

  • موجودہ پلیئر کاؤنٹ اور زیادہ سے زیادہ کھلاڑی
  • آن لائن کھلاڑیوں کی فہرست ان کے ناموں اور UUIDs کے ساتھ
  • سرور ورژن اور MOTD
  • انسٹال شدہ پلگ انز کی فہرست

مرحلہ 1: پلگ ان انسٹال کریں

Download and install either One Query or Hyvote on your Hytale server:

  1. GitHub ریلیز پیج سے تازہ ترین JAR ڈاؤن لوڈ کریں
  2. JAR فائل کو اپنے سرور کی plugins ڈائریکٹری میں رکھیں
  3. اپنا سرور ری سٹارٹ کریں

کسی اضافی کنفیگریشن کی ضرورت نہیں! پلگ ان آپ کے گیم سرور کے پورٹ (5520) کا استعمال کرتے ہوئے فوری طور پر کام کرتا ہے۔

مرحلہ 2: Hylist میں کوئری پورٹ شامل کریں

Hylist ڈیش بورڈ میں اپنا کوئری پورٹ کنفیگر کریں:

  1. Hylist ڈیش بورڈ میں اپنے سرور کے ایڈٹ صفحے پر جائیں
  2. "کوئری پورٹس" سیکشن تک سکرول کریں
  3. "کوئری پورٹ شامل کریں" پر کلک کریں
  4. پورٹ 5520 درج کریں (یا اپنے گیم سرور کا پورٹ اگر مختلف ہو)
  5. اختیاری طور پر اس پورٹ کو گیم موڈ سے جوڑنے کے لیے ایک ٹیگ منتخب کریں
  6. اپنی تبدیلیاں محفوظ کریں

متعدد گیم موڈز (پراکسی نیٹ ورکس)

اگر آپ متعدد بیک اینڈ سرورز چلاتے ہیں، تو آپ متعدد کوئری پورٹس شامل کر سکتے ہیں - ہر گیم موڈ کے لیے ایک:

Port 5520 -> No tag (Lobby)
Port 5521 -> PvP
Port 5522 -> Survival

ہر بیک اینڈ سرور کو اپنے One Query پلگ ان انسٹینس کی ضرورت ہے۔ ٹیگ زائرین کو سمجھنے میں مدد کرتا ہے کہ کون سی پلیئر لسٹ کس گیم موڈ سے ہے۔

اپنا سیٹ اپ تصدیق کرنا

سب کچھ کنفیگر کرنے کے بعد، اپنا سیٹ اپ تصدیق کریں:

  1. یقینی بنائیں کہ آپ کا سرور آن لائن ہے اور One Query پلگ ان چل رہا ہے
  2. Hylist کو آپ کا سرور کوئری کرنے کے لیے چند منٹ انتظار کریں
  3. Hylist پر اپنے سرور کا صفحہ ملاحظہ کریں
  4. آپ کو پلیئر کاؤنٹ، آن لائن کھلاڑی، ورژن اور پلگ ان کی معلومات نظر آئیں گی

اگر سب کچھ کام کر رہا ہے، تو آپ کو اپنے سرور کے صفحے پر ایک سبز "آن لائن" بیج اور ریئل ٹائم پلیئر کی معلومات نظر آئیں گی!

مسائل کا حل

Hylist پر ڈیٹا نہیں دکھ رہا؟

  • تصدیق کریں کہ One Query پلگ ان JAR آپ کے plugins فولڈر میں ہے
  • پلگ ان کی خرابیوں کے لیے اپنے سرور لاگز چیک کریں
  • یقینی بنائیں کہ Hylist میں پورٹ نمبر آپ کے سرور پورٹ سے میل کھاتا ہے (ڈیفالٹ: 5520)
  • Hylist کو سرور ڈیٹا ریفریش کرنے کے لیے 5-10 منٹ انتظار کریں

غلط پلیئر کاؤنٹ یا معلومات؟

  • یقینی بنائیں کہ کوئری پورٹ صحیح سرور کی طرف اشارہ کر رہا ہے
  • اگر متعدد سرورز استعمال کر رہے ہیں، تو یقینی بنائیں کہ ہر ایک کا اپنا پورٹ کنفیگر ہے

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.

Frequently Asked Questions

How often does Hylist query my server?
Hylist queries your server approximately every 60 seconds. This provides near real-time data while keeping the network overhead minimal. The query is lightweight and should have no noticeable impact on your server's performance.
Does the query plugin affect server performance?
The query plugins (One Query and Hyvote) are extremely lightweight. They respond to incoming query requests with basic server information (player count, version, MOTD). The CPU and memory overhead is negligible. The plugin simply listens on a port and responds to UDP/TCP queries when asked.
Can I use One Query and Hyvote at the same time?
No, these plugins are mutually exclusive. You should only install one of them. Both provide the same query functionality. Hyvote includes additional features (like Votifier2 integration), while One Query is a standalone query-only plugin. Choose the one that best fits your setup.