StatsMod

StatsMod - Comprehensive Server-Side Statistics

StatsMod brings in-depth player statistics to your Minecraft server! 🎮 This powerful server-side Fabric mod automatically tracks a wide array of player actions and provides a highly customizable system for viewing, ranking, and managing this data. From blocks broken to entities killed, time played to items crafted, StatsMod offers a rich statistical experience for players and robust administrative tools for server owners.

---

StatsSigns

Check out our addon mod, StatsSigns! Display dynamic player statistics on signs throughout your world.

📧 Contact Me & Support Information

💬 Primary Support Channel (Preferred)

All general questions, feature requests, and non-urgent bug reports should be posted in the appropriate channels on our Discord Server. We actively monitor the server and will respond as soon as possible. This ensures that the whole community can benefit from the discussion and solutions.

🆘 Urgent Private Messaging (PM) Policy

While we prefer all issues to be handled via the Discord server first, you are welcome to PM me directly under specific urgent circumstances:

• Allowed Reason: Your server is crashing or experiencing critical, game-breaking errors directly related to one of my mods/plugins.
• Requirement: You must be the owner of the server.
• Time Zone: I am operating in the (CET/CEST) Time Zone.
• PM Hours: Please only send private messages between 10:00 AM and 10:00 PM (Brussels Time).

I will endeavor to answer your PM as soon as I can to be helpful and see what I can do to resolve your urgent issue. However, please understand that immediate responses are not guaranteed, and private messaging is a professional courtesy, not an entitlement. Thank you for your understanding and cooperation!

---

Features

📊 Automatic & Detailed Stat Tracking

• Extensive Coverage: Automatically tracks statistics for:
  • Blocks broken and placed
  • Items picked up, crafted, smelted, brewed, enchanted, and used
  • Mobs and players killed
  • Deaths (with specific death reasons/killers)
  • Crops harvested
  • Animals bred
  • Items fished
  • Trades completed
  • Damage dealt and taken
  • Distance traveled (walked, sprinted, crouched, swum, flown, elytra)
  • Time played
  • Unique biomes visited
• Persistent Data: All player statistics are saved persistently, supporting both file-based (JSON) and SQLite database storage.
• Accuracy: Uses correct API and Yarn mappings for 100% working and accurate code.

⚙️ Highly Customizable Commands & Display

• Personal Profile (/profile): Players can view a summary of their key statistics, including totals and their top stat within various genres (e.g., "Most Mined", "Most Killed").
  • Example: %mining_top_display_name% and %mining_top_value% show the most mined block and its count.
  • Displays formatted playtime (e.g., "1d 2h 3m 4s").
• Genre-Specific Stats (/mining, /combat, etc.): View detailed statistics categorized by genres like Mining, Combat, Crafting, Farming, and more.
  • Configurable in genres.yml and genre_blocks.yml to define which blocks/items/entities belong to each genre.
  • Supports aliases for genre commands (e.g., /smelted for /smelting).
• Type-Specific Stats (/broken, /crafted, etc.): Dive into stats for specific action types across all relevant items/blocks/entities.
  • Configurable in types.yml.
• Detailed Biome List (/biomes): See a paginated list of all unique biomes a player has visited.
• Leaderboards (/top): Display server-wide rankings for:
  • Genres: Top players for an entire genre (e.g., /top mining).
  • Types: Top players for a specific stat type (e.g., /top broken, /top killed).
  • Individual Stats: Top players for any single stat key (e.g., /top played, /top deaths, /top broken:minecraft:stone).
• Interactive Text: All command outputs support Minecraft color codes, hex colors, formatting, hover text, and clickable actions (running commands, suggesting commands, opening URLs, copying to clipboard).
  • Configured in profile.yml, genres.yml, types.yml, and top.yml.
  • /stats command provides a clickable help menu.

🛠️ Admin & Debug Tools

• Reload Configs (/statsmod reload): Instantly apply changes to configuration files without a server restart.
• Debug Mode (/statsmod debug): Toggle verbose logging for troubleshooting.
• Manual Stat Editing (/statsmod set): Set a player's specific statistic to any value.
• Stat Resets (/statsmod reset):
  • Reset all stats for a specific player (/statsmod reset player <player>).
  • Reset stats for a specific genre for a player (/statsmod reset player <player> genre <genre_id>).
  • Reset stats for a specific genre for ALL players (/statsmod reset server genre <genre_id>).
  • Wipe all server stats (/statsmod reset server all).
• Data Migration (/statsmod migrate): Seamlessly transfer all player data from file storage to a configured database.

📜 Comprehensive Configuration

• settings.yml: General mod settings, including page sizes for commands and database connection details.
• genre_blocks.yml: Defines lists of blocks, items, entities, and death reasons for genre categorization.
• genres.yml: Configures display names, aliases, tracked blocks key, and command formatting for each genre.
• types.yml: Configures display names and command formatting for each statistic type.
• top.yml: Customizes header, line, and footer formats for /top commands.
• profile.yml: Defines the layout and content of the /profile command output.
• stats_command.yml: Configures the main /stats help command's content.
• README.yml: Automatically generated reference for all available placeholders.

---

Commands

• /statsmod, /sm - Displays the main help interface.
• /profile [player] - Displays a player's comprehensive stats profile.
• /top <identifier> - Displays server-wide leaderboards for genres, types, or specific stats.
• /<genre_id> [player] [page] - e.g., /mining, /combat. Displays detailed stats for a specific genre.
• /<type_id> [player] [page] - e.g., /broken, /crafted. Displays detailed stats for a specific stat type.
• /damaged [player] - Displays total damage dealt and taken.
• /flown [player] - Displays creative and elytra flight distances.
• /biomes [player] [page] - Lists all unique biomes visited by a player.

---

Permissions

This mod integrates with the Fabric Permissions API (v0). A permissions plugin like LuckPerms is required for these nodes to function. Admin commands require a higher OP level if no permissions plugin is present.

Click to view all permission nodes and their descriptions

• statsmod.player - Grants access to all non-administrative commands.
• statsmod.admins - Grants access to all admin commands.
• statsmod.command.base - Allows use of the base /statsmod and /sm commands. (Default: true)
• statsmod.command.stats - Allows use of the /stats command.
• statsmod.command.profile - Allows use of /profile for self.
• statsmod.command.profiles - Allows use of /profile for others.
• statsmod.command.others - Allows viewing other players' stats in various commands.
• statsmod.genres - Grants access to ALL genre commands (e.g., /mining).
• statsmod.types - Grants access to ALL type commands (e.g., /broken).
• statsmod.genre.<genre_id> - Allows access to a specific genre command (e.g., statsmod.genre.mining).
• statsmod.type.<type_id> - Allows access to a specific type command (e.g., statsmod.type.damaged).
• statsmod.admin.reload - Allows use of /statsmod reload.
• statsmod.admin.debug - Allows use of /statsmod debug.
• statsmod.admin.migrate - Allows use of /statsmod migrate.
• statsmod.admin.set - Allows use of /statsmod set.
• statsmod.admin.reset.player - Allows resetting all stats for a player.
• statsmod.admin.reset.genre - Allows resetting a genre's stats.
• statsmod.admin.reset.all - Allows wiping all server stats.

---

Available Placeholders

Click to view all available placeholders and their descriptions

Player Specific

• %player%: The name of the player.
• %played_formatted%: Formatted time played (e.g., '1d 2h 3m 4s').
• %mining_top_display_name%: Name of the most mined block.
• %mining_top_value%: Count of the most mined block.
• %combat_top_died_display_name%: Name of the entity the player has died to the most.
• %combat_top_died_value%: Count of deaths to the top entity.
• Other dynamic placeholders exist for other genres.
• Specific stat values: %broken_value%, %placed_value%, %killed_value%, etc.

Command Context Specific

• %display_name%: User-friendly name of the current item/block/entity.
• %stat_id%: Full statistic ID (e.g., 'broken:minecraft:stone').
• %item_id%: Minecraft ID of the current item (e.g., 'minecraft:stone').
• %value%: Numerical value of the stat being displayed.
• %rank%: Player's rank in a /top list.
• %genre_display_name% / %genre_id%: Display name and ID of the current genre.
• %type_display_name% / %type_id%: Display name and ID of the current type.
• Pagination: %current_page%, %total_pages%, %prev_page%, %next_page%.

Global Stat Totals

• %total_broken%, %total_placed%, %players_killed%, %deaths%, %total_crafted%, %total_smelted%, %total_brewed%, %total_enchanted%, %total_harvested%, %total_animals_bred%, %total_pickedup%, %total_fished%, %total_traded%, %damaged:dealt%, %damaged:taken%, %distance%, %biomes%, %flown%, %elytra%.
• Genre-specific totals: %genre_total_broken%, %genre_total_placed%, etc.

Utility

• %newline%: Forces a new line.

Modpack Policy

• You ARE PERMITTED to include StatsMod in any modpack.
• Credit is appreciated but not strictly required.
• Please do not modify the mod's JAR file directly.
• The modpack itself, or access to this mod within the modpack, must not be sold.