Panduan Setup Plugin One Query

Pelajari cara mengatur plugin One Query untuk menampilkan jumlah pemain real-time, pemain online, dan info server di listing Hylist Anda.

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.

Apa itu 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:

  • Jumlah pemain saat ini dan maksimum pemain
  • Daftar pemain online dengan nama dan UUID mereka
  • Versi server dan MOTD
  • Daftar plugin yang terinstal

Langkah 1: Instal Plugin

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

  1. Unduh JAR terbaru dari halaman rilis GitHub
  2. Letakkan file JAR di direktori plugins server Anda
  3. Restart server Anda

Tidak diperlukan konfigurasi tambahan! Plugin langsung berfungsi menggunakan port game server Anda (5520).

Langkah 2: Tambahkan Query Port di Hylist

Konfigurasi query port Anda di dashboard Hylist:

  1. Buka halaman edit server Anda di dashboard Hylist
  2. Gulir ke bawah ke bagian "Query Ports"
  3. Klik "Tambah Query Port"
  4. Masukkan port 5520 (atau port game server Anda jika berbeda)
  5. Opsional pilih tag untuk mengasosiasikan port ini dengan mode game
  6. Simpan perubahan Anda

Multiple Game Mode (Jaringan Proxy)

Jika Anda menjalankan beberapa server backend, Anda dapat menambahkan beberapa query port - satu untuk setiap mode game:

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

Setiap server backend memerlukan instance plugin One Query sendiri. Tag membantu pengunjung memahami mode game mana yang dimiliki setiap daftar pemain.

Memverifikasi Setup Anda

Setelah mengkonfigurasi semuanya, verifikasi setup Anda:

  1. Pastikan server Anda online dengan plugin One Query berjalan
  2. Tunggu beberapa menit agar Hylist mengquery server Anda
  3. Kunjungi halaman server Anda di Hylist
  4. Anda akan melihat jumlah pemain, pemain online, versi, dan informasi plugin

Jika semuanya berfungsi, Anda akan melihat badge "Online" hijau dan informasi pemain real-time di halaman server Anda!

Troubleshooting

Tidak ada data yang muncul di Hylist?

  • Verifikasi JAR plugin One Query ada di folder plugins Anda
  • Periksa log server Anda untuk error plugin
  • Pastikan nomor port di Hylist sesuai dengan port server Anda (default: 5520)
  • Tunggu 5-10 menit agar Hylist memperbarui data server

Jumlah pemain atau info salah?

  • Pastikan query port mengarah ke server yang benar
  • Jika menggunakan beberapa server, pastikan masing-masing memiliki port yang dikonfigurasi sendiri

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.
Kembali ke Server Saya