GlymeraFakePlayers - Realistic Fake Player Simulation

Populate your server with fake players: real player skins, NPC wandering, chat messages, tab list, and built-in server query support for all major protocols. Fully configurable with realistic day/night player count curves.

What is GlymeraFakePlayers?

GlymeraFakePlayers makes your server look alive — even when no one is online. It generates fake players with randomized player skins (using Hytale's character creator system), shows them in the tab list, sends realistic chat messages, and reports inflated player counts to every major server list protocol. Optionally, it spawns physical NPCs that walk around with player models and custom names.

A configurable 24-hour day curve automatically adjusts the number of online fake players — low at night, peak in the evening — with smooth transitions and random fluctuation for a natural feel.

All commands are OP-only.

Features

Fake Player Identities

• Randomly selected names from a configurable pool (110 default names)
• Each fake player gets a unique UUID for consistent identification
• Names appear in tab list, chat, and server query responses

Player Skins (Character Creator)

• NPCs use Hytale's full character customization system (hair, clothing, face, etc.)
• Every fake player gets a unique randomized appearance
• Skins are generated using CosmeticsModule.generateRandomSkin() — same system as real players

Physical NPCs (Optional)

• Spawnable player-model NPCs that walk around with realistic wander behavior
• Custom names above their heads (Nameplate system)
• Physical body (new in v7): walking into them gently pushes you apart, just like a real player — configurable (soft / hard / off)
• Invulnerable — players cannot kill them (no damage, no knockback, no hurt reaction)
• Configurable spawn location (/fp setspawn) and spawn radius
• NPC count is independent from tab list count (e.g. 50 in tab, 5 NPCs)
• NPCs are automatically despawned on server shutdown (prevents world corruption)

Chat Simulation

• Random chat messages from configurable pool (100 default messages)
• Messages use Hytale's native chat format — indistinguishable from real player chat
• Configurable interval (default: 45–180 seconds between messages)
• Only active fake players send messages

Tab List

• Fake players appear in the server's player list with realistic ping values
• Ping values vary randomly (25–110ms) on each update cycle
• Players are added/removed from tab list as the day curve adjusts

Server Query Protocols (Built-in)

No additional query plugin needed! GlymeraFakePlayers responds to all 5 major protocols:

All protocols report the same inflated player count (real + fake players).

Realistic Day/Night Curve

• 24-hour player count curve with configurable hourly percentages
• Cosine interpolation between hours for smooth, step-free transitions
• Random fluctuation (default ±5%) for natural variation
• Automatic adjustment every 60 seconds (1–2 players at a time)
• Server startup instantly applies the correct count for the current time

Default Curve (EU gaming pattern):

Commands

Configuration

All settings are in mods/de.glymera_GlymeraFakePlayers/config.json (auto-generated on first start):

Setup Examples

Minimal: Just inflate player count (no NPCs, no chat)

{
  "maxFakePlayers": 50,
  "spawnNPCs": false,
  "chatEnabled": false
}

Populated spawn area

{
  "maxFakePlayers": 80,
  "maxSpawnedNPCs": 15,
  "npcSpawnLocation": [100, 65, 200],
  "npcSpawnRadius": 10
}

High-population server feel

{
  "maxFakePlayers": 200,
  "maxSpawnedNPCs": 25,
  "chatIntervalMin": 15,
  "chatIntervalMax": 60
}

Important Notes

• Names pool size: Must contain at least as many names as maxFakePlayers. If the pool is smaller, the fake player count is capped to the number of available names.
• NPC world corruption prevention: All NPCs are automatically despawned when the server shuts down. This prevents corrupted model references in saved chunks.
• Map visibility: Fake players do NOT appear as position markers on the world map. They appear in the tab list sidebar only.
• Safe config editing: A config.json with a syntax error is never overwritten. The plugin keeps running on its previous values, logs the exact error to the server console, and leaves your file untouched so you can fix it and /fp reload.
• Upgrading from older versions: Data is migrated automatically from plugins/GlymeraFakePlayers/ to mods/de.glymera_GlymeraFakePlayers/ on first start — your config is adopted unchanged.
• Query protocol compatibility: The built-in query handler replaces the need for HyQuery, OneQuery, or PingProtocol plugins. If you run one of those alongside this plugin, both will respond to queries.

Version

v7.0.0 — Includes asset pack (IncludesAssetPack: true) for the NPC role definition.