# Projectvollidioten

A Minecraft Fabric mod that logs player data on join and leave events to an external API.

## Features

- Logs player join and leave events
- Captures detailed player statistics including:
  - Health and max health
  - Hunger level
  - Experience level
  - Game mode
  - Position (X, Y, Z, Dimension)
- Tracks completed advancements with display names
- Asynchronous API communication to prevent server lag
- Pretty-printed JSON logging for debugging

## Requirements

- Minecraft 1.21.11
- Fabric Loader 0.18.3
- Fabric API 0.140.2+1.21.11

## Installation

1. Download the mod JAR file from the releases page
2. Place the JAR file in your server's `mods` folder
3. Ensure the Fabric API is also installed
4. Start your Minecraft server

## Configuration

The mod sends data to a hardcoded API endpoint: `http://localhost:3000/api/data`

To change the API endpoint, modify the `API_URL` constant in `PlayerDataLogger.java`.

## API Format

The mod sends POST requests with JSON payloads in the following format:

```json
{
  "eventType": "JOIN" | "LEAVE",
  "player": "PlayerName",
  "uuid": "player-uuid-string",
  "timestamp": 1234567890123,
  "stats": {
    "health": 20.0,
    "maxHealth": 20.0,
    "foodLevel": 20,
    "xpLevel": 10,
    "gameMode": "survival",
    "position": {
      "x": 100.5,
      "y": 64.0,
      "z": -200.3,
      "dimension": "minecraft:overworld"
    }
  },
  "advancements": [
    {
      "id": "minecraft:story/root",
      "title": "Minecraft"
    }
  ]
}
```

## Building from Source

1. Clone the repository
2. Run `./gradlew build`
3. The built JAR will be in `build/libs/`

## Development

This mod uses:
- Fabric Loom for building
- Gson for JSON serialization
- Java 21

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request