Datastats

English Version

📊 Mod Name: Datastats

🌟 Introduction

Datastats is a statistics monitoring tool developed for Minecraft Forge 1.20.1. It allows players to track and manage various statistics such as kills, deaths, and damage dealt/taken across different mods. This mod provides detailed data analysis functionality for mod developers and server administrators.

🎯 Main Features

1. Mod Statistics Tracking

• Automatically tracks kill and death counts for each mod's entities

• Records total damage dealt and damage taken

• Organizes statistics by mod for easy analysis

2. Smart GUI Interface

• Mod Browser: Browse all loaded mods

• Monitored Mods: View mods added to the monitoring list

• Real-time Data Display: Shows detailed statistics for selected mods

• Pagination System: Supports browsing large numbers of mods

3. Data Management Functions

• Add/Remove Monitoring: Easily manage which mods to monitor

• Data Reset: Reset individual statistics (kills, deaths, damage, etc.)

• One-click Reset: Quickly clear all statistical data

• Data Export: Copy statistics to clipboard

4. Current Status Monitoring

• Alive Count: Shows the number of alive entities from the mod in the current world

• Total Health: Calculates the total health of all alive entities

• Level Classification: Categorizes entities into four levels (High, Medium, Normal, Low) based on health

• On-demand Refresh: Only refreshes current status when the interface is opened to avoid performance impact

5. Performance Optimization

• No Lag Design: Scans entities only when needed, doesn't affect game performance

• Smart Caching: 5-minute data cache to avoid repeated calculations

• Manual Refresh: Provides refresh button for player-controlled updates

• Optimized Search: Scans only within 128 blocks around the player for efficiency

🚀 How to Use

Basic Operations:

1. Open GUI: Press L key to open the statistics interface

2. Select Mod: Choose a mod to monitor in the mod browser

3. Add Monitoring: Click "Add Selected Mod" to start monitoring

4. View Statistics: Select monitored mods to view detailed data

5. Manage Data: Use reset buttons to clear unwanted data

Interface Description:

• Left Side: Mod list (with search and pagination support)

• Right Side: Detailed statistics for selected mod

• Bottom: Control buttons (Add, Reset, Copy, Refresh)

Command Support:

• /distanceTo addTarget - Add distance measurement target

• /distanceTo check - Check distance to target

⚙️ Technical Features

Hybrid Detection System:

• Mixin Injection: Uses ASM technology to inject statistical code at a low level

• Event Listening: Monitors entity damage and removal events

• NBT Storage: Uses Minecraft's native NBT system to save data

• Cross-world Support: Independent statistics for each world

Data Persistence:

• Auto Save: Data is saved with the world

• Secure Storage: Uses Minecraft's SavedData system

• Version Compatible: Data structure is backward compatible

🛡️ Important Notes

Performance Recommendations:

1. Do not monitor too many mods simultaneously (recommended: less than 20)

2. Regularly clean up unnecessary statistics

3. Use the "Refresh Status" button instead of frequently opening/closing the interface

Compatibility:

• Minecraft Version: 1.20.1

• Mod Loader: Forge

• Dependencies: No mandatory dependencies

• Compatibility: Compatible with most mods, doesn't modify core game logic

Troubleshooting:

• Statistics not updating: Ensure the mod has been added to the monitoring list

• GUI not showing: Check key bindings (default: L key)

• Performance issues: Reduce the number of simultaneously monitored mods

📁 Installation Requirements

Minimum Requirements:

• Minecraft 1.20.1

• Forge 47.0.0 or higher

• 4GB RAM or more

Recommended Requirements:

• 8GB RAM

• SSD storage

• Modern CPU (Intel i5 or equivalent)

💡 Use Cases

For Players:

• Understand the strength of different mods' entities

• Track personal combat performance

• Analyze balance between mods

For Server Administrators:

• Monitor mod activity on the server

• Analyze player behavior patterns

• Optimize server performance

For Mod Developers:

• Test balance of mod entities

• Collect player feedback data

• Optimize mod performance

🔄 Future Updates

Upcoming Features:

• Chart visualization of statistics

• Export data to files

• Scheduled automatic refresh

• Additional statistical dimensions

Improvement Plans:

• Optimize memory usage

• Add more filtering options

• Support mod grouping

📊 模组名称：数据统计 (Datastats)

🌟 简介

Datastats 是一个为 Minecraft Forge 1.20.1 开发的模组统计监控工具。它允许玩家跟踪和管理不同模组中生物的击杀、死亡、伤害等统计数据，为模组开发者和管理员提供了详细的数据分析功能。

🎯 主要功能

1. 模组统计追踪

• 自动追踪每个模组的生物击杀数、死亡数

• 记录造成伤害和受到伤害的总量

• 按模组分类统计数据，便于分析

2. 智能GUI界面

• 模组浏览器：浏览所有已加载的模组

• 已监控模组：查看已添加到监控列表的模组

• 实时数据显示：显示当前选中模组的详细统计数据

• 分页系统：支持大量模组的浏览

3. 数据管理功能

• 添加/移除监控：轻松管理要监控的模组

• 数据重置：支持单独重置击杀、死亡、伤害等数据

• 一键重置：快速清空所有统计数据

• 数据导出：将统计数据复制到剪贴板

4. 当前状态监控

• 存活数量：显示当前世界中该模组生物的存活数量

• 总生命值：计算所有存活生物的总生命值

• 等级分类：按生命值将生物分为高、中、普通、低四个等级

• 按需刷新：只在打开界面时刷新当前状态，避免性能影响

5. 性能优化

• 无卡顿设计：仅在需要时扫描实体，不会影响游戏性能

• 智能缓存：数据有5分钟缓存，避免重复计算

• 手动刷新：提供刷新按钮，玩家可控制刷新时机

• 优化搜索：只在玩家周围128格内扫描，提高效率

🚀 使用方法

基本操作：

1. 打开GUI：按 L 键打开统计界面

2. 选择模组：在模组浏览器中选择要监控的模组

3. 添加监控：点击"添加选中模组"开始监控

4. 查看统计：选择已监控的模组查看详细数据

5. 管理数据：使用重置按钮清理不需要的数据

界面说明：

• 左侧：模组列表（支持搜索和分页）

• 右侧：选中模组的详细统计数据

• 底部：控制按钮（添加、重置、复制、刷新）

命令支持：

• /distanceTo addTarget - 添加距离测量目标

• /distanceTo check - 检查到目标的距离

⚙️ 技术特点

混合检测系统：

• Mixin注入：使用 ASM 技术在底层注入统计代码

• 事件监听：监听实体伤害和移除事件

• NBT存储：使用 Minecraft 原生的 NBT 系统保存数据

• 跨世界支持：每个世界独立统计数据

数据持久化：

• 自动保存：数据随世界一起保存

• 安全存储：使用 Minecraft 的 SavedData 系统

• 版本兼容：数据结构向后兼容

🛡️ 注意事项

性能建议：

1. 不要同时监控过多模组（建议不超过20个）

2. 定期清理不需要的统计数据

3. 使用"刷新状态"按钮而不是频繁打开/关闭界面

兼容性：

• Minecraft版本：1.20.1

• Mod加载器：Forge

• 依赖：无强制依赖

• 兼容性：与大多数模组兼容，不会修改游戏核心逻辑

故障排除：

• 统计数据不更新：确保模组已被添加到监控列表

• GUI不显示：检查按键绑定（默认L键）

• 性能问题：减少同时监控的模组数量

📁 安装要求

最低配置：

• Minecraft 1.20.1

• Forge 47.0.0 或更高版本

• 4GB 内存或更高

推荐配置：

• 8GB 内存

• SSD 硬盘

• 现代 CPU（Intel i5 或同等）

💡 使用场景

对于玩家：

• 了解不同模组的生物强度

• 追踪自己的战斗表现

• 分析模组间的平衡性

对于服务器管理员：

• 监控服务器中模组的活跃度

• 分析玩家行为模式

• 优化服务器性能

对于模组开发者：

• 测试模组生物的强度平衡

• 收集玩家反馈数据

• 优化模组性能

🔄 更新计划

即将添加的功能：

• 图表可视化统计数据

• 导出数据到文件

• 定时自动刷新

• 更多统计维度

改进计划：

• 优化内存使用

• 添加更多过滤选项

• 支持模组分组