# Universal Web Heatmap Setup Guide<\/p>\n
A lightweight Minecraft plugin to track player activity and visualize it using a web-based heatmap.<\/p>\n
## 1. Plugin Installation
\n1. Download `UniversalWebHeatmap-1.0.0.jar`.
\n2. Place the jar file into your server’s `plugins\/` directory.
\n3. Restart your server to generate the configuration files.<\/p>\n
## 2. Configuration (`config.yml`)
\nNavigate to `plugins\/UniversalWebHeatmap\/config.yml`.<\/p>\n
“`yaml
\n# How often to save data to disk (in minutes)
\nsave-interval: 5<\/p>\n
# Grid size for activity tracking (16 is default chunk size)
\ngrid-size: 16<\/p>\n
# GitHub Integration (Optional)
\n# If enabled, the plugin will automatically upload the JSON data to a GitHub repo.
\ngithub:
\n enabled: false
\n token: “your_github_token”
\n repo: “username\/repository”
\n“`<\/p>\n
## 3. Web Setup (The Viewer)
\nSince the plugin generates a data file, you need a way to view it.<\/p>\n
1. Take the `heatmap_data.json` file generated.
\n2. Upload it to https:\/\/twinfront.ct.ws\/UWH\/ and get your result<\/p>\n
## 4. How to Use
\n1. **Track Activity**: The plugin automatically tracks movement, building, mining, and PvP.
\n2. **Generate Data**: Run `\/heatmap generate` in-game or from console.
\n3. **Locate Data**:
\n – Find the generated file at `plugins\/UniversalWebHeatmap\/output\/heatmap-data.json`.
\n4. **Visualize**:
\n – Open your website where you uploaded `heatmap_viewer.php`.
\n – Either **Upload** the `heatmap-data.json` file using the file picker.
\n – Or **Paste** the text content of the JSON file into the text area.
\n – Click **Visualize Data**.<\/p>\n
## 5. Commands
\n– `\/heatmap generate` – Exports the current activity data to JSON.
\n– `\/heatmap reset` – Clears all tracked activity data.
\n– `\/heatmap config` – Displays current settings.<\/p>\n
## 6. Permissions
\n– `heatmap.admin` – Required to use all plugin commands.<\/p>\n","protected":false},"excerpt":{"rendered":"
A Minecraft-based Heatmap plug-in<\/p>\n","protected":false},"featured_media":162582,"template":"","meta":{"_minecraft_slug":"universal-web-heatmap","_minecraft_project_id":"8ezRFcLT","_minecraft_author":"SkyFoxMC","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":11,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"universal-web-heatmap.zip","_minecraft_size_bytes":265329,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:06:39.727123Z","_minecraft_date_created":"2026-01-13T23:04:30.197501Z","_minecraft_date_modified":"2026-01-06T21:47:13.347269Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/universal-web-heatmap","_minecraft_icon_attachment_id":162582,"_minecraft_imported_at":"2026-06-09T16:09:28+00:00","_minecraft_import_hash":"7d4cc48d6fa2eb5f6ce29f5049a2f89f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,129,92],"mod_loader":[134],"minecraft_version":[845,846,847,848,849,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-162581","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-spigot","mod_category-utility","mod_loader-spigot","minecraft_version-1-2-1","minecraft_version-1-2-2","minecraft_version-1-2-3","minecraft_version-1-2-4","minecraft_version-1-2-5","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n