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:

Open GUI: Press L key to open the statistics interface
Select Mod: Choose a mod to monitor in the mod browser
Add Monitoring: Click "Add Selected Mod" to start monitoring
View Statistics: Select monitored mods to view detailed data
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:

Do not monitor too many mods simultaneously (recommended: less than 20)
Regularly clean up unnecessary statistics
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格内扫描，提高效率

🚀 使用方法

基本操作：

打开GUI：按 L 键打开统计界面
选择模组：在模组浏览器中选择要监控的模组
添加监控：点击"添加选中模组"开始监控
查看统计：选择已监控的模组查看详细数据
管理数据：使用重置按钮清理不需要的数据

界面说明：

左侧：模组列表（支持搜索和分页）
右侧：选中模组的详细统计数据
底部：控制按钮（添加、重置、复制、刷新）

命令支持：

/distanceTo addTarget - 添加距离测量目标
/distanceTo check - 检查到目标的距离

⚙️ 技术特点

混合检测系统：

Mixin注入：使用 ASM 技术在底层注入统计代码
事件监听：监听实体伤害和移除事件
NBT存储：使用 Minecraft 原生的 NBT 系统保存数据
跨世界支持：每个世界独立统计数据

数据持久化：

自动保存：数据随世界一起保存
安全存储：使用 Minecraft 的 SavedData 系统
版本兼容：数据结构向后兼容

🛡️ 注意事项

性能建议：

不要同时监控过多模组（建议不超过20个）
定期清理不需要的统计数据
使用"刷新状态"按钮而不是频繁打开/关闭界面

兼容性：

Minecraft版本：1.20.1
Mod加载器：Forge
依赖：无强制依赖
兼容性：与大多数模组兼容，不会修改游戏核心逻辑

故障排除：

统计数据不更新：确保模组已被添加到监控列表
GUI不显示：检查按键绑定（默认L键）
性能问题：减少同时监控的模组数量

📁 安装要求

最低配置：

Minecraft 1.20.1
Forge 47.0.0 或更高版本
4GB 内存或更高

💡 使用场景

对于玩家：

了解不同模组的生物强度
追踪自己的战斗表现
分析模组间的平衡性

对于服务器管理员：

监控服务器中模组的活跃度
分析玩家行为模式
优化服务器性能

对于模组开发者：

测试模组生物的强度平衡
收集玩家反馈数据
优化模组性能

🔄 更新计划

即将添加的功能：

图表可视化统计数据
导出数据到文件
定时自动刷新
更多统计维度

改进计划：

优化内存使用
添加更多过滤选项
支持模组分组