|
| 1 | +# PerformTracker |
| 2 | + |
| 3 | +>[!NOTE] |
| 4 | +>This mod will be locked to Minecraft 1.21.11 during the early development phase; we plan to support additional game versions in the future. |
| 5 | +
|
| 6 | +A Minecraft Fabric mod for tracking game performance metrics. |
| 7 | + |
| 8 | +## Features |
| 9 | + |
| 10 | +- **In-game Performance Display**: Shows real-time FPS, TPS, MSPT, heap memory, and CPU usage. |
| 11 | +- **Metrics Export**: Exports performance data to CSV, JSON, or YAML formats. |
| 12 | +- **HTTP API**: Exposes metrics via a local HTTP server for integration with monitoring tools. |
| 13 | +- **Configurable Collection**: Toggle which metrics to collect and export. |
| 14 | + |
| 15 | +## Commands |
| 16 | + |
| 17 | +- `/ptracker start` - Start tracking |
| 18 | +- `/ptracker stop` - Stop tracking |
| 19 | +- `/ptracker deviceinfo` - Display device information |
| 20 | +- `/ptracker config` - Configure individual settings |
| 21 | + |
| 22 | +## Building |
| 23 | + |
| 24 | +```bash |
| 25 | +./gradlew build |
| 26 | +``` |
| 27 | + |
| 28 | +The built JAR will be in `build/libs/`. |
| 29 | + |
| 30 | +## Contributing |
| 31 | + |
| 32 | +Contributions are welcome. Please feel free to submit issues or pull requests on the GitHub repository. |
| 33 | + |
| 34 | +## Privacy Risks |
| 35 | + |
| 36 | +**IMPORTANT**: Even though this project does not include telemetry, this mod involves data collection and transmission that you should be aware of: |
| 37 | + |
| 38 | +1. **Local Data Export**: When enabled, performance metrics are written to files in a configurable directory. |
| 39 | + |
| 40 | +2. **HTTP Reporting**: When the network feature is enabled, this mod sends performance metrics to a remote HTTP endpoint. The transmitted data includes: |
| 41 | + - Session identifier |
| 42 | + - Timestamp |
| 43 | + - All enabled metrics (FPS, TPS, heap, CPU, etc.) |
| 44 | + - Complete system information as listed above |
| 45 | + |
| 46 | +3. **No Authentication**: The HTTP endpoint has no built-in authentication or encryption. Any party with network access to the endpoint can receive and store your data. |
| 47 | + |
| 48 | +4. **Data Retention**: Any remote server you send data to will retain that data according to their own policies. This mod has no control over how your data is stored or used by third parties. |
| 49 | + |
| 50 | +**Recommendations:** |
| 51 | +- Only enable the HTTP reporting feature if you trust the endpoint |
| 52 | +- Use localhost (`127.0.0.1`) or a trusted local server as the endpoint when testing |
| 53 | +- Be aware of what data is being collected and transmitted |
| 54 | +- Review the data before sharing any exported files |
| 55 | +- Consider the implications of exposing system information to network endpoints |
| 56 | + |
| 57 | +## License |
| 58 | + |
| 59 | +This project is licensed under the **Apache License, Version 2.0**. |
0 commit comments