Vote & Player Counts - Hytalecharts

HytaleCharts - Server Status Plugin

Display real-time server status and player counts on https://hytalecharts.com

Overview

HytaleCharts is the premier server listing platform for Hytale servers. This official plugin connects your server to HytaleCharts, providing accurate online status and live player counts to help players find and join your server.

Features

  - Real-Time Status - Shows your server as online with accurate uptime tracking
  - Live Player Count - Displays current players and max slots (e.g., 12/100)
  - Automatic Updates - Sends status updates every 5 minutes with zero performance impact
  - Lightweight - Minimal resource usage, runs silently in the background
  - Secure - Uses a unique secret key tied to your server listing

Why Use This Plugin?

Without this plugin, HytaleCharts can only detect if your server is online via basic pings - it cannot show accurate player counts. With the plugin installed:

  - Players see your real player count, not just "Online/Offline"
  - Your server appears more active and trustworthy
  - Status updates are instant and reliable
  - No port forwarding or firewall changes needed

Installation

  1. Download the latest release and place the JAR in your server's mods folder
  2. Start your server once to generate the config file
  3. Log into https://hytalecharts.com and go to Edit Server
  4. Scroll to Plugin Integration and copy your unique Heartbeat Secret
  5. Paste the secret into the plugin's config.json:
  {
    "secret": "YOUR_HEARTBEAT_SECRET_HERE",
    "debug": false
  }
  6. Restart your server - status updates begin automatically!

Configuration
  ┌────────┬────────────────────────────────────────────────┬──────────┐
  │ Option │                  Description                   │ Default  │
  ├────────┼────────────────────────────────────────────────┼──────────┤
  │ secret │ Your unique heartbeat secret from HytaleCharts │ Required │
  ├────────┼────────────────────────────────────────────────┼──────────┤
  │ debug  │ Enable debug logging for troubleshooting       │ false    │
  └────────┴────────────────────────────────────────────────┴──────────┘

Requirements

  - A Hytale server
  - A registered server listing on https://hytalecharts.com
  - Server must be approved on HytaleCharts to send heartbeats

Support

  - Website: https://hytalecharts.com
  - Discord: Join our community for help and updates
  - Issues: Report bugs on our GitHub repository

Privacy

  This plugin currently sends:
  - Current player count
  - Maximum player slots
  - Plugin version  
  - Server mods
  - Player UUID's
  - Player Names
  - Player World Name

  HytaleCharts - Discover the best Hytale servers