Universal Web Heatmap

Universal Web Heatmap Setup Guide

A lightweight Minecraft plugin to track player activity and visualize it using a web-based heatmap.

1. Plugin Installation

1. Download `UniversalWebHeatmap-1.0.0.jar`. 2. Place the jar file into your server's `plugins/` directory. 3. Restart your server to generate the configuration files.

2. Configuration (`config.yml`)

Navigate to `plugins/UniversalWebHeatmap/config.yml`.

```yaml

How often to save data to disk (in minutes)

save-interval: 5

Grid size for activity tracking (16 is default chunk size)

grid-size: 16

GitHub Integration (Optional)

If enabled, the plugin will automatically upload the JSON data to a GitHub repo.

github: enabled: false token: "your_github_token" repo: "username/repository" ```

3. Web Setup (The Viewer)

Since the plugin generates a data file, you need a way to view it.

1. Take the `heatmap_data.json` file generated. 2. Upload it to https://twinfront.ct.ws/UWH/ and get your result

4. How to Use

1. Visualize Data: The plugin automatically tracks movement, building, mining, and PvP. 2. Visualize Data: Run `/heatmap generate` in-game or from console. 3. Visualize Data: - Find the generated file at `plugins/UniversalWebHeatmap/output/heatmap-data.json`. 4. Visualize Data: - Open your website where you uploaded `heatmap_viewer.php`. - Either Visualize Data the `heatmap-data.json` file using the file picker. - Or Visualize Data the text content of the JSON file into the text area. - Click Visualize Data.

5. Commands

- `/heatmap generate` - Exports the current activity data to JSON. - `/heatmap reset` - Clears all tracked activity data. - `/heatmap config` - Displays current settings.

6. Permissions

- `heatmap.admin` - Required to use all plugin commands.