Gabay sa Pag-setup ng One Query Plugin

Alamin kung paano i-setup ang One Query plugin para ipakita ang real-time na bilang ng manlalaro, mga online na manlalaro, at impormasyon ng server sa iyong Hylist listing.

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.

CurseForge GitHub

Hyvote

Alternative plugin with configurable exports. Lets you toggle exactly what data to expose.

CurseForge GitHub

Important: These plugins are mutually exclusive. Only install one of them - do not install both on the same server.

Ano ang 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:

  • Kasalukuyang bilang ng manlalaro at maximum na manlalaro
  • Listahan ng mga online na manlalaro kasama ang kanilang mga pangalan at UUID
  • Bersyon ng server at MOTD
  • Listahan ng mga naka-install na plugin

Hakbang 1: I-install ang Plugin

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

  1. I-download ang pinakabagong JAR mula sa GitHub releases page
  2. Ilagay ang JAR file sa plugins directory ng iyong server
  3. I-restart ang iyong server

Hindi na kailangan ng karagdagang configuration! Gumagana agad ang plugin gamit ang port ng iyong game server (5520).

Hakbang 2: Magdagdag ng Query Port sa Hylist

I-configure ang iyong query port sa Hylist dashboard:

  1. Pumunta sa edit page ng iyong server sa Hylist dashboard
  2. Mag-scroll pababa sa "Query Ports" section
  3. I-click ang "Magdagdag ng Query Port"
  4. Ilagay ang port 5520 (o ang port ng iyong game server kung iba)
  5. Opsyonal na pumili ng tag para i-associate ang port na ito sa isang game mode
  6. I-save ang iyong mga pagbabago

Maraming Game Mode (Proxy Networks)

Kung nagpapatakbo ka ng maraming backend server, maaari kang magdagdag ng maraming query port - isa para sa bawat game mode:

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

Bawat backend server ay nangangailangan ng sariling One Query plugin instance. Ang tag ay tumutulong sa mga bisita na maunawaan kung aling game mode ang kabilang sa bawat listahan ng manlalaro.

Pag-verify ng Iyong Setup

Pagkatapos i-configure ang lahat, i-verify ang iyong setup:

  1. Siguraduhin na ang iyong server ay online at ang One Query plugin ay tumatakbo
  2. Maghintay ng ilang minuto para ma-query ng Hylist ang iyong server
  3. Bisitahin ang pahina ng iyong server sa Hylist
  4. Makikita mo ang bilang ng manlalaro, mga online na manlalaro, bersyon, at impormasyon ng plugin

Kung gumagana ang lahat, makikita mo ang berdeng "Online" badge at real-time na impormasyon ng manlalaro sa iyong server page!

Troubleshooting

Walang data na lumalabas sa Hylist?

  • I-verify na ang One Query plugin JAR ay nasa iyong plugins folder
  • Suriin ang iyong server logs para sa anumang plugin error
  • Siguraduhin na ang port number sa Hylist ay tumutugma sa port ng iyong server (default: 5520)
  • Maghintay ng 5-10 minuto para ma-refresh ng Hylist ang server data

Maling bilang ng manlalaro o impormasyon?

  • Siguraduhin na ang query port ay tumuturo sa tamang server
  • Kung gumagamit ng maraming server, siguraduhin na bawat isa ay may sariling naka-configure na port

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.
Bumalik sa Mga Server Ko