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.

# 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.