StatsMod - 全面的服务器端统计
StatsMod 为你的 Minecraft 服务器带来了深入的玩家统计数据!? 这款强大的服务端 Fabric 模组会自动追踪大量玩家行为,并提供一个高度可定制的系统和工具,用于查看、排名和管理这些数据。从破坏的方块到击杀的生物,从游戏时长到制作的物品,StatsMod 为玩家提供了丰富的统计体验,并为服务器管理员提供了强大的管理工具。
来看看我们的附属模组 StatsSigns!在世界的各个告示牌上显示动态的玩家统计数据。
? 联系我 & 支持信息
? 主要支持渠道(推荐)
所有一般性问题、功能请求和非紧急的错误报告,都应发布在我们的 Discord 服务器 的相关频道中。 我们会积极监控该服务器并尽快回复。这能确保整个社区都能从讨论和解决方案中受益。
? 紧急私聊 (PM) 政策
虽然我们倾向于所有问题都优先通过 Discord 服务器处理,但在特定的紧急情况下,欢迎直接私信我:
- 允许的理由: 你的服务器正在崩溃或出现与我其中一个模组/插件直接相关的严重、导致游戏无法进行的错误。
- 要求: 你必须是服务器的所有者。
- 时区: 我处于 (CET/CEST) 时区。
- 私信时间: 请在 上午 10:00 至晚上 10:00(布鲁塞尔时间) 之间发送私信。
我将尽力尽快回复你的私信以提供帮助,并看看我能做些什么来解决你的紧急问题。但是,请理解我们无法保证即时回复,且私聊是一种专业礼仪,而非一种权利。感谢你的理解与配合!
功能特性
? 自动且详细的统计追踪
- 广泛覆盖: 自动追踪以下统计数据:
- 破坏和放置的方块
- 拾取、制作、熔炼、酿造、附魔和使用过的物品
- 击杀的生物和玩家
- 死亡次数(包含具体的死亡原因/击杀者)
- 收获的作物
- 繁殖的动物
- 钓起的物品
- 完成的交易
- 造成的伤害和受到的伤害
- 移动距离(步行、疾跑、潜行、游泳、飞行、鞘翅滑翔)
- 游戏时长
- 访问过的独特生物群系
- 持久化数据: 所有玩家统计数据都会持久保存,支持基于文件(JSON)和 SQLite 数据库的存储方式。
- 准确性: 使用正确的 API 和 Yarn 映射,确保代码 100% 正常运行且数据准确。
⚙️ 高度可定制的命令与显示
- 个人档案 (
/profile): 玩家可以查看其关键统计数据的摘要,包括总数以及各类别中的最高统计数据(例如“挖掘最多”、“击杀最多”)。
- 示例:
%mining_top_display_name% 和 %mining_top_value% 分别显示挖掘最多的方块及其数量。
- 显示格式化后的游戏时长(例如:“1天 2小时 3分钟 4秒”)。
- 类别特定统计 (
/mining, /combat 等): 查看按类别(如采矿、战斗、制作、农业等)分类的详细统计数据。
- 可在
genres.yml 和 genre_blocks.yml 中进行配置,以定义哪些方块/物品/生物属于哪个类别。
- 支持类别命令的别名(例如,
/smelted 对应 /smelting)。
- 类型特定统计 (
/broken, /crafted 等): 深入了解针对所有相关物品/方块/生物的特定动作类型的统计数据。
- 详细生物群系列表 (
/biomes): 查看玩家访问过的所有独特生物群系的分页列表。
- 排行榜 (
/top): 显示全服排名,包括:
- 类别: 某个完整类别的顶级玩家(例如
/top mining)。
- 类型: 某种特定统计类型的顶级玩家(例如
/top broken, /top killed)。
- 单项统计: 任何单个统计键值的顶级玩家(例如
/top played, /top deaths, /top broken:minecraft:stone)。
- 交互式文本: 所有命令输出均支持 Minecraft 颜色代码、十六进制颜色、格式设置、悬停文本和可点击操作(运行命令、建议命令、打开 URL、复制到剪贴板)。
- 配置位于
profile.yml、genres.yml、types.yml 和 top.yml 中。
/stats 命令提供可点击的帮助菜单。
?️ 管理员与调试工具
- 重载配置 (
/statsmod reload): 无需重启服务器即可立即应用配置文件中的更改。
- 调试模式 (
/statsmod debug): 切换详细日志记录以便进行故障排除。
- 手动编辑统计 (
/statsmod set): 将玩家的特定统计数据设置为任意值。
- 重置统计 (
/statsmod reset):
- 重置特定玩家的所有统计(
/statsmod reset player <player>)。
- 重置玩家特定类别的统计(
/statsmod reset player <player> genre <genre_id>)。
- 重置所有玩家特定类别的统计(
/statsmod reset server genre <genre_id>)。
- 清除所有服务器统计(
/statsmod reset server all)。
- 数据迁移 (
/statsmod migrate): 无缝地将所有玩家数据从文件存储传输到已配置的数据库中。
? 全面配置
settings.yml: 模组通用设置,包括命令分页大小和数据库连接详情。
genre_blocks.yml: 定义用于类型分类的方块、物品、实体及死亡原因列表。
genres.yml: 配置每种类型的显示名称、别名、追踪方块键以及命令格式。
types.yml: 配置每种统计类型的显示名称和命令格式。
top.yml: 自定义 /top 命令的页眉、行和页脚格式。
profile.yml: 定义 /profile 命令输出的布局和內容。
stats_command.yml: 配置主 /stats 帮助命令的内容。
README.yml:: 自动生成所有可用占位符的参考文档。
命令
/statsmod, /sm - 显示主帮助界面。
/profile [player] - 显示玩家的综合统计数据档案。
/top <identifier> - 显示服务器范围内的类型、类别或特定统计数据的排行榜。
/<genre_id> [player] [page] - 例如 /mining, /combat。显示特定类型的详细统计数据。
/<type_id> [player] [page] - 例如 /broken, /crafted。显示特定统计类型的详细数据。
/damaged [player] - 显示造成的总伤害和受到的总伤害。
/flown [player] - 显示创造模式和鞘翅飞行距离。
/biomes [player] [page] - 列出玩家访问过的所有独特生物群系。
权限
本模组集成了 Fabric Permissions API (v0)。需要安装权限插件(如 LuckPerms)才能使这些节点生效。如果没有安装权限插件,管理员命令需要更高的 OP 等级。
点击查看所有权限节点及其描述
statsmod.player - 授予所有非管理命令的访问权限。
statsmod.admins - 授予所有管理命令的访问权限。
statsmod.command.base - 允许使用基础 /statsmod 和 /sm 命令。(默认:true)
statsmod.command.stats - 允许使用 /stats 命令。
statsmod.command.profile - 允许对自己使用 /profile。
statsmod.command.profiles - 允许对他人使用 /profile。
statsmod.command.others - 允许在各种命令中查看其他玩家的统计数据。
statsmod.genres - 授予所有类型命令的访问权限(例如 /mining)。
statsmod.types - 授予所有类别命令的访问权限(例如 /broken)。
statsmod.genre.<genre_id> - 允许访问特定的类型命令(例如 statsmod.genre.mining)。
statsmod.type.<type_id> - 允许访问特定的类别命令(例如 statsmod.type.damaged)。
statsmod.admin.reload - 允许使用 /statsmod reload。
statsmod.admin.debug - 允许使用 /statsmod debug。
statsmod.admin.migrate - 允许使用 /statsmod migrate。
statsmod.admin.set - 允许使用 /statsmod set。
statsmod.admin.reset.player - 允许重置某个玩家的所有统计数据。
statsmod.admin.reset.genre - 允许重置某类统计数据。
statsmod.admin.reset.all - 允许清除服务器所有统计数据。
可用占位符
点击查看所有可用占位符及其描述
玩家专属
%player%: 玩家名称。
%played_formatted%: 格式化后的游戏时间(例如 '1d 2h 3m 4s')。
%mining_top_display_name%: 被挖掘最多的方块名称。
%mining_top_value%: 被挖掘最多方块的次数。
%combat_top_died_display_name%: 导致玩家死亡最多的实体名称。
%combat_top_died_value%: 死于该顶级实体的次数。
- 其他类型也存在动态占位符。
- 特定统计数据值:
%broken_value%, %placed_value%, %killed_value% 等。
命令上下文专属
%display_name%: 当前物品/方块/实体的友好显示名称。
%stat_id%: 完整的统计 ID(例如 'broken:minecraft:stone')。
%item_id%: 当前物品的 Minecraft ID(例如 'minecraft:stone')。
%value%: 正在显示的统计数据的数值。
%rank%: 玩家在 /top 排行榜中的排名。
%genre_display_name% / %genre_id%: 当前类型的显示名称和 ID。
%type_display_name% / %type_id%: 当前类别的显示名称和 ID。
- 分页:
%current_page%, %total_pages%, %prev_page%, %next_page%。
全局统计总计
%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_total_broken%, %genre_total_placed% 等。
实用工具
整合包政策
- 你 可以 将 StatsMod 包含在任何整合包中。
- 请注明出处,但这并非强制要求。
- 请勿直接修改模组的 JAR 文件。
- 整合包本身,或通过该整合包访问此模组的行为,不得出售。
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.
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧