Logo
MINECRAFTBIBLE
Items
Items

All game items

Blocks
Blocks

Building blocks

Mobs
Mobs

Creatures & monsters

Biomes
Biomes

World biomes

Structures
Structures

Generated structures

Recipes
Recipes

Crafting guides

Advancements
Advancements

Achievements

Loot Tables
Loot Tables

Drop rates

Tags
Tags

Item groupings

All Versions
View all data →
Capes
Cape ArchiveNEW

Browse rare Minecon capes, OptiFine capes, and custom capes from players worldwide

Browse

Player Database
Player DatabasePopular

Search any player

Skin Browser
Skin Browser

Browse & download skins

Cape Gallery
Cape GalleryNEW

Minecon & OptiFine capes

Seed Vault
Seed Vault

Curated seeds

Learn

Guides
GuidesNew

Tutorials & tips

Blog
Blog

News & updates

Community

Community Hub
Community HubHub

Posts, discussions & more

All Versions
View community →
Seed Analyzer
Seed Analyzer

World seed analysis

Loot Explorer
Loot Explorer

Drop rates

Crafting Calculator
Crafting Calculator

Material planning

Enchant Calculator
Enchant Calculator

Probability math

Redstone Lab
Redstone Lab

Signal timing

Trading Profit
Trading Profit

Villager ROI

All Versions
View all tools →
Mods
Mods

Browse all mods

Plugins
Plugins

Server plugins

Resource Packs
Resource Packs

Textures & sounds

Shaders
Shaders

Visual enhancements

Datapacks
Datapacks

World logic

Scanner
Mod Intelligence

Scan & analyze any mod

All Versions
View all mods →
Loading...
IntroductionIntroductionVersion HistoryVersion HistoryGuidesGuidesBlog & NewsBlog & News
ItemsItemsBlocksBlocksMobsMobsRecipesRecipesBiomesBiomesStructuresStructuresAdvancementsAdvancementsLoot TablesLoot TablesTagsTags
ModsModsPluginsPluginsResource PacksResource PacksShadersShadersDatapacksDatapacks

MinecraftBible

The Ultimate Wiki

Logo
MINECRAFTBIBLE

The ultimate Minecraft reference. Every item, block, mob, and recipe documented with precision.

Community

  • Skin Browser
  • Cape Gallery
  • Seed Vault
  • Blog
  • Guides

Database

  • Items
  • Blocks
  • Mobs
  • Recipes
  • Biomes
  • Structures

Tools

  • Seed Analyzer
  • Mod Intelligence
  • Crafting Calculator
  • Enchant Calculator

Mods & Packs

  • Mods
  • Plugins
  • Resource Packs
  • Shaders
  • Datapacks

Site & Legal

  • About
  • Authors
  • Editorial Policy
  • Corrections
  • Contact
  • Privacy Policy
  • Terms of Service
  • DMCA
  • Sitemap

© 2026 MinecraftBible. Not affiliated with Mojang or Microsoft.

PrivacyTermsContact
StatsMod
ModLicenseRef-All-Rights-Reserved

StatsMod

Track many Stats for your players

1.1K
Downloads
8
Followers
4 months ago
Updated
📦
6
Versions
game-mechanicslibrarymanagementfabric
Download Latestv2.0View on Modrinth

📖About 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.

👥 Team & Contributors

official.andy
official.andyOwner

⚙️ Compatibility

Environment
❓ Unknown
Loaders
fabric
Minecraft Versions
1.21.11

🔗 Links

Modrinth Page