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. **Track Activity**: The plugin automatically tracks movement, building, mining, and PvP. 2. **Generate Data**: Run `/heatmap generate` in-game or from console. 3. **Locate Data**: - Find the generated file at `plugins/UniversalWebHeatmap/output/heatmap-data.json`. 4. **Visualize**: - Open your website where you uploaded `heatmap_viewer.php`. - Either **Upload** the `heatmap-data.json` file using the file picker. - Or **Paste** 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.