# Infinity Dungeons Stats<\/p>\n
 <\/p>\n
A comprehensive statistics and leaderboard system for the **Infinity Dungeons** map. Track player high scores, monster kills, and total playtime with in-game leaderboards and a powerful RESTful API for developers.<\/p>\n
—<\/p>\n
This plugin is designed to bring a competitive edge to your Infinity Dungeons rogue-like server. It adds a robust statistics system to:
\n* **Track Player Progress:** Automatically records each player’s highest dungeon level, total kills, and total playtime.
\n* **Foster Competition:** Display dynamic leaderboards in your world using floating text (holograms) to show off the top players.
\n* **Engage Your Community:** Players can check their own stats or compare themselves against the server’s best.
\n* **Provide Developer Tools:** A built-in RESTful API allows you to pull stats for use on websites, Discord bots, or other custom integrations.<\/p>\n
## \u2728 Features<\/p>\n
* **Player Statistics Tracking:** Monitors and saves crucial data for every player’s run in the dungeon.
\n * Highest Dungeon Level Reached
\n * Total Monster Kills
\n * Total Playtime
\n* **In-Game Leaderboards:**
\n * Highly configurable floating text displays (holograms) for top kills, playtime, and max level.
\n * Choose between a single, rotating hologram or multiple static ones.
\n * Customize titles, colors, and formats.
\n* **Player Commands:**
\n * `\/dun stats [player]` – View your own or another player’s statistics.
\n * `\/dun killtop` – Display the top players by monster kills in chat.
\n * `\/dun playtimetop` – Display the top players by playtime in chat.
\n * `\/dun maxleveltop` – Display the top players by max level in chat.
\n* **RESTful API:**
\n * An optional, built-in API server to expose player and server stats via simple HTTP requests. (Requires opening a port on your server).
\n* **Lightweight & Efficient:** Designed specifically for Infinity Dungeons to be as performant as possible.<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
The plugin is fully configurable via `config.yml`. You can enable\/disable features, set hologram locations, and customize all messages.<\/p>\n
“`yaml ## \ud83d\udd0c RESTful API Documentation<\/p>\n If `api-server.enabled` is set to `true`, the plugin will host a simple API server on the configured port. **This discloses game data to a remote server connection and must be firewalled appropriately if you do not want it to be public.**<\/p>\n ### GET \/players<\/p>\n Returns a list of online players and their current status.<\/p>\n **Example Response:** ### GET \/stats<\/p>\n Returns a log of completed dungeon runs. **Example Response:** ### GET \/playerstats<\/p>\n Returns the lifetime statistics for a single player. **Success Response:** **Error Responses:** “`json ### GET \/killtop<\/p>\n Returns the top 100 players by monster kills.<\/p>\n **Example Response:** ### GET \/playtimetop<\/p>\n Returns the top 100 players by total playtime.<\/p>\n **Example Response:** ### GET \/maxleveltop<\/p>\n Returns the top 100 players by highest dungeon level reached.<\/p>\n **Example Response:** ## \ud83d\udccb Installation<\/p>\n 1. Download the latest version of the plugin. ## \u2757 Dependencies<\/p>\n * **Required:** Your server must be running the **Infinity Dungeons** map. This plugin is specifically designed to work with its mechanics. A comprehensive statistics and leaderboard plugin for the “Infinity Dungeons” map on spigot servers.<\/p>\n","protected":false},"featured_media":59826,"template":"","meta":{"_minecraft_slug":"dungeonstats","_minecraft_project_id":"TaSY3cCz","_minecraft_author":"Steve3184","_minecraft_license":"MIT","_minecraft_downloads":113,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"dungeonstats.zip","_minecraft_size_bytes":288470,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:29:18.693244Z","_minecraft_date_created":"2025-08-15T04:40:18.532254Z","_minecraft_date_modified":"2025-08-14T06:04:13.273615Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/dungeonstats","_minecraft_icon_attachment_id":59826,"_minecraft_imported_at":"2026-06-03T09:56:40+00:00","_minecraft_import_hash":"d13749d5178bae7a6c60799922f4da6e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-59825","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n
\n# DungeonStats Plugin Configuration
\ndatabase: “data.yml”
\napi-server:
\n enabled: true
\n port: 8080
\nlog-checker:
\n enabled: true
\n interval-ticks: 100
\nholograms:
\n enabled: false
\n refresh-interval-seconds: 10
\n # ‘SINGLE’: Use one text_display entity, rotating between different leaderboards.
\n # ‘MULTIPLE’: Use a separate text_display entity for each leaderboard.
\n display-mode: ‘SINGLE’
\n single-display:
\n location: “world,0.5,100.5,0.5” # Format: “world_name,x,y,z”
\n # How long (in seconds) to display each leaderboard before switching to the next.
\n rotation-interval-seconds: 5
\n multiple-displays:
\n killtop:
\n location: “world,5.5,101.5,0.5”
\n playtimetop:
\n location: “world,0.5,101.5,5.5”
\n maxleveltop:
\n location: “world,-4.5,101.5,0.5”
\nmessages:
\n title-kills: “&6&l— Kills Leaderboard —”
\n title-playtime: “&6&l— Playtime Leaderboard —”
\n title-maxlevel: “&6&l— Max Level Leaderboard —”
\n # Available Placeholders: {rank}, {player_name}, {value}
\n rank-entry: “#{rank} &b{player_name}: &f{value}”
\n rank-color-1: “&e” # Gold for Rank 1
\n rank-color-2: “&f” # Silver for Rank 2
\n rank-color-3: “&6” # Bronze for Rank 3
\n rank-color-default: “&7” # Default color for other ranks
\n command-usage: “&cUsage: \/dun
\n command-player-not-found: “&cCould not find data for player {player_name}”
\n command-no-data: “&7No data available yet”
\n stats-title: “&6— Stats for {player_name} —”
\n stats-line-maxlevel: “&eHighest Dungeon Level: &f{value}”
\n stats-line-kills: “&eTotal Kills: &f{value}”
\n stats-line-playtime: “&eTotal Playtime: &f{value}”
\n“`<\/p>\nClick to view API Endpoints<\/b><\/summary>\n
\n“`json
\n[
\n {
\n “name”: “Steve3184”,
\n “status”: “waiting”,
\n “health”: 20.0,
\n “armor”: 0.0
\n },
\n {
\n “name”: “AdLambXD”,
\n “status”: “ingame”,
\n “health”: 15.0,
\n “armor”: 4.0
\n },
\n {
\n “name”: “Mark_Q”,
\n “status”: “spectator”,
\n “health”: 20.0,
\n “armor”: 0.0
\n }
\n]
\n“`<\/p>\n
\n* **Optional Query Parameter:** `limit` (e.g., `\/stats?limit=10`) – Sets the maximum number of records to return. Defaults to `0` (unlimited).<\/p>\n
\n“`json
\n[
\n {
\n “recordId”: 6,
\n “level”: 63,
\n “doorsOpened”: 63,
\n “enemiesKilled”: 203,
\n “bossesDefeated”: 9,
\n “durationSeconds”: 3686
\n }
\n]
\n“`<\/p>\n
\n* **Required Query Parameter:** `name` (e.g., `\/playerstats?name=Steve3184`)<\/p>\n
\n“`json
\n{
\n “playerName”: “Steve3184”,
\n “kills”: 6,
\n “playtimeSeconds”: 38,
\n “maxLevel”: 1
\n}
\n“`<\/p>\n
\n“`json
\n{
\n “error”: “Player not found.”
\n}
\n“`<\/p>\n
\n{
\n “error”: “Player name query parameter is required.”
\n}
\n“`<\/p>\n
\n“`json
\n[
\n {
\n “playerName”: “Steve3184”,
\n “kills”: 6
\n }
\n]
\n“`<\/p>\n
\n“`json
\n[
\n {
\n “playerName”: “Steve3184”,
\n “playtimeSeconds”: 38
\n }
\n]
\n“`<\/p>\n
\n“`json
\n[
\n {
\n “playerName”: “Steve3184”,
\n “maxLevel”: 1
\n }
\n]
\n“`<\/p>\n<\/details>\n
\n2. Place the `.jar` file into your server’s `plugins` folder.
\n3. Restart your server.
\n4. Configure the plugin by editing `plugins\/RougeStats\/config.yml`.
\n5. Restart the server again to apply changes.<\/p>\n
\n* **Holograms:** This plugin uses built-in `text_display` entities and does not require a separate hologram plugin.<\/p>\n","protected":false},"excerpt":{"rendered":"