Hytale server analytics, plugin by plugin.

The plugin reads ticks per second and milliseconds per tick against the 33 ms budget (30 TPS), sessions and playtime, the address each player joined through and store purchases.

See who joins and stays after every update, which plugin is eating your tick at 30 TPS, and which store items sell. Built on Hytale's server plugin API.

Free for one server. No card needed.

Questions it answers for Hytale servers

What the demo dashboard answers for this game.

Are new players sticking after the update?

Day-1, day-7 and day-30 retention for every week of new players.

Which plugin is eating my tick?

Every tick over 67 ms is captured and named by plugin, so you fix the right one.

Which address or creator brings players who stay?

Joins, 7-day return and spend for every address and campaign link.

Did the server stay up?

Uptime, restarts and an alert in Discord when it goes down.

What sells per player-hour?

Store revenue matched to playtime, with top items and refunds.

When are my players online?

Players online through the day and week, so you schedule events and restarts at the right time.

What ServerStats tracks on Hytale servers

One plugin in the server's mods/ folder, built on Hytale's official server API. Players install nothing.

Performance

  • TPS and tick time for every world against the 33.3 ms budget (30 TPS)
  • Every tick over 67 ms, per world, with the mod or server area (NPCs, world generation, chunks, saves) that took the time
  • Chunks loaded and generated, entities and NPCs per world, active instances
  • JVM heap and garbage collection, process and host CPU and memory

Players

  • Players online per world, sessions and playtime per world
  • New and returning players, D1, D7 and D30 retention
  • The address each player joined through, for campaign and creator links
  • Ping per world, connect time, rejected connections and disconnect reasons

Gameplay

  • Deaths by cause, PvP kills, kills by and of NPCs by role
  • Blocks broken and placed, crafting by recipe and bench
  • Zones discovered, instances and portals entered, NPC interactions

Store

  • Tebex, PayNow and CraftingStore revenue (Operator)
  • No currency tracking yet: Hytale has no official economy API, so use the SDK for custom economy events

No install yet? Hytale has no built-in query, so basic mode needs a Steam-query plugin such as G-PORTAL's hytale-plugin-query (5521 by default). Check any Hytale server with the free server status checker.

Plugin-specific payment and gamemode integrations for Hytale are planned. The general dashboard and payments log work today.

The number that matters: TPS per world

33.3ms
The tick budget: 30 ticks a second
Target
30 TPS
Tick over 33 ms
Sampler starts
Tick over 67 ms (two missed ticks)
Lag spike, mod named
Profiled
Up to 8 worlds

Hytale ticks each world on its own thread, 30 times a second, so each tick has 33.3 ms. One busy world doesn't slow the others down, which is why ServerStats reports TPS and tick time per world rather than one number for the server.

When a world's tick runs past 33 ms, the plugin reads that world thread's stack every 5 ms. A tick over 67 ms, two missed ticks, becomes a lag spike charged to the mod whose code was running, by the name Hytale gives each mod's class loader.

Every 5 minutes it also records where ordinary tick time goes, so a mod that is slowly getting heavier shows up before it causes spikes.

One plugin. About five minutes.

Works with

  • Hytale dedicated server
  • Java server plugin API
  • Tebex-style stores
  • Discord
  • Connects out only. No ports to open on your server.
  • A one-time claim code, then the agent signs everything it sends with its own key. No reusable secret is stored on your server or ours.
  • Player IDs are keyed hashes in analytics. Player IP addresses are never sent to us.
mods/ServerStats_ServerStats/config.yml
# Put the jar into the server's mods/ folder and start once, then:
claim-code: "SS-XXXX-XXXX-XXXX"
server-name: "survival"

# or in the console: /serverstats claim <code>

Hytale questions

What is a good TPS for a Hytale server?

30. Hytale servers tick 30 times a second by default, so each tick has about 33 ms. Below 30 TPS a world is falling behind. ServerStats measures every world separately and counts a tick over 67 ms as a lag spike.

How do I find which mod is lagging my Hytale server?

ServerStats reads the world thread when a tick runs long and names the mod whose code was running, with the method. Each lag spike shows its top three causes, and a 5-minute profile shows which mods use the most tick time.

Do players need a mod on their client?

No. ServerStats runs only on your server and players never download anything.

Will it lag my server?

It's built not to. On an empty test world its world-thread work averaged 0.28 µs a tick, and /serverstats status shows its cost per world on yours.

Can I see which creator or address brings players?

Yes. With acquisition.track-hostnames on (the default) the plugin records the address each player typed, so you can compare joins, return rate and spend per creator code or subdomain.

Can I check a Hytale server without installing the plugin?

Only if it runs a Steam-query plugin: Hytale has no built-in query. With one, basic mode shows players, version and uptime.

Is it free?

Free covers one server with 24 hours of history, forever, with no card. Operator is $9.99 a month for 10 servers and 90 days of history, which you need for week-on-week trends and D7 or D30 retention. Yearly billing gives two months free.

Related games

One ServerStats account covers every game you run.

Start with one Hytale server, free

Install it and see your first numbers today.