Skip to content

Commit 2c263df

Browse files
committed
docs: add README
1 parent dec9b3c commit 2c263df

1 file changed

Lines changed: 59 additions & 0 deletions

File tree

README.md

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
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

Comments
 (0)