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](https://modrinth.com/mod/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](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! --- ## 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 `). * Reset stats for a specific genre for a player (`/statsmod reset player genre `). * Reset stats for a specific genre for ALL players (`/statsmod reset server genre `). * **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 ` - Displays server-wide leaderboards for genres, types, or specific stats. * `/ [player] [page]` - e.g., `/mining`, `/combat`. Displays detailed stats for a specific genre. * `/ [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.` - Allows access to a specific genre command (e.g., `statsmod.genre.mining`). * `statsmod.type.` - 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**.