ExpTracker

A Minecraft Paper plugin that logs player experience gains to an InfluxDB (v2) database.

Build & Install

You must have Java installed.

1. Set up Paper

1. Download Paper from papermc.io.
2. Place the downloaded .jar in a new directory.
3. Start the server once:

   java -Xms4G -Xmx4G -jar <paper.jar> --nogui

This generates the /plugins folder.

2. Set up InfluxDB

1. In this repository's /compose, copy .env-example → .env.
2. Edit values as needed (DB name, org, etc.).
3. From /compose, run InfluxDB:

   docker-compose up

4. Open http://localhost:8086, log in, and generate an API token. Add it to your .env.

3. Configure the plugin

Edit ExpTracker.java with your InfluxDB connection details:

collector = new ExpMetricsCollector(
    "YOUR_URL_HERE",
    "YOUR_TOKEN_HERE",
    "YOUR_ORG_HERE",
    "YOUR_BUCKET_HERE"
);

4. Build the plugin

1. Open the project in IntelliJ IDEA.
2. In the Gradle tool window, run the build task.
3. The plugin .jar will appear in ./build/libs.

5. Install & run

1. Copy the generated plugin .jar into /plugins.
2. Ensure InfluxDB is running.
3. Start the server again:

   java -Xms4G -Xmx4G -jar <paper.jar> --nogui