PlayerLogger

A Hytale server plugin that tracks player statistics with cloud sync and web dashboard.

---

Features

• Player Tracking - Playtime, online status, session history
• Combat Stats - PvP kills, mob kills, deaths, damage dealt
• Block Stats - Blocks placed and broken
• Cloud Sync - View stats at hytaletravelers.com/stats
• In-Game Dashboard - Interactive UI with sorting and search
• Discord Webhooks - Real-time notifications
• Server Browser - Get discovered at hytaletravelers.com/servers

---

Quick Start

1. Download from CurseForge
2. Place in your server's mods folder
3. Start your server

Stats are tracked and synced automatically.

---

Commands

Command	Description
/list	Open the stats dashboard
/players	Alias for /list
/pl ui	Open the stats dashboard
/pl help	Show available commands

Admin Commands

Command	Permission	Description
/pl wipe <player>	playerlogger.command.wipe	Remove a player's data
/pl wipe all	playerlogger.command.wipe	Wipe all player data
/pl reset <category>	playerlogger.command.reset	Reset stats for all players
/pl reset <category> <player>	playerlogger.command.reset	Reset stats for one player

Categories: all, combat, blocks, playtime, kills, deaths, damage

---

Configuration

Edit config.json in the plugin's data folder:

{
  "pushEnabled": true,
  "pushUrl": "https://api.hytaletravelers.com",
  "pushIntervalSeconds": 30,
  "serverName": "",
  "publicListing": true,
  "webEnabled": false,
  "webPort": 8080,
  "webhookEnabled": false,
  "webhookUrl": ""
}

Discord Webhooks

{
  "webhookEnabled": true,
  "webhookUrl": "https://discord.com/api/webhooks/...",
  "webhookPlayerJoin": true,
  "webhookPlayerLeave": true,
  "webhookPlayerDeath": true,
  "webhookPlayerKill": true,
  "webhookDailyLeaderboard": true,
  "webhookDailyLeaderboardHour": 12
}

API

See API.md for the public REST API documentation.

Local API

Enable webEnabled in config to host your own JSON API:

• GET /api/players - List all players with stats
• GET /api/stats - Server-wide statistics

---

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

---

Support

• Discord: discord.gg/CnJuHve8gn
• Issues: GitHub Issues

---

License

MIT License - see LICENSE for details.

---

Made by HytaleTravelers