StatsMod

Minecraft 版本： 1.21.11

平台： fabric

标签： game-mechanics library management

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](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 <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.` - 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.