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. --- ## (https://modrinth.com/mod/statssigns) !(https://cdn.modrinth.com/data/cached_images/b330284d9220c5230c1c747eb7769824d72fad0b.png) Check out our addon mod, StatsSigns! Display dynamic player statistics on signs throughout your world. <details> <summary>📧 Contact Me & Support Information</summary> ### 💬 Primary Support Channel (Preferred) **All general questions, feature requests, and non-urgent bug reports should be posted in the appropriate channels on our (https://discord.gg/48sZCbdHzJ).** 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! </details> --- ## 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>`). *