Bluemap-Marker-Plugin-Web

BlueMap Web Markers brings interactive, in-browser 3D marker creation directly to your BlueMap live map.
Say goodbye to tedious in-game commands and manual coordinate typing. With this plugin, server administrators can click blocks directly in the 3D map viewer to place Shapes, 3D Extrudes, Points of Interest (POIs), and Lines with real-time visual feedback and instant server-side saving.
## Features
- **Click-to-Place in 3D**: Click any block in the BlueMap 3D map viewer to inspect coordinates and start placing marker points immediately.
- **Full Marker Type Support**: Create 3D Extrude prisms with custom heights, flat 2D Shape polygons, POI pins with custom icons, and connected Line paths.
- **Live 3D Preview**: Automatically draws dynamic lines connecting your clicked blocks in real-time with color and opacity controls.
- **Admin Subpath**: Regular visitors see only the clean map. The editor is restricted to the `/admin` route.
- **Console Token Security**: Server console generates a secure access token on startup. Saving or deleting markers requires this token.
- **Keyboard Isolation**: Prevents `W`, `A`, `S`, `D`, and `Space` from moving the camera while you are typing labels or coordinates into input fields.
- **Non-Destructive Storage**: Safely merges with `markers.json` without overwriting existing marker sets or manual markers.
## Getting Started
Follow these steps to install the plugin and start creating markers directly on your map.
### Installation
1. Ensure your server is running Paper, Purpur, or Folia 1.21+ with BlueMap 5.x installed.
2. Download `BlueMapWebMarkers-1.0.0.jar` and place it into your server's `plugins/` directory.
3. Restart your server.
### Admin Token
On startup, the plugin logs your admin token to the server console:
```text
[BlueMapWebMarkers] Admin Edit Token: bm-jtbPsbPYJS
```
You can view or manage this token anytime from the server console:
- `/bmmweb token` — Display current token and admin URL
- `/bmmweb token <new-token>` — Set a custom token
- `/bmmweb token regen` — Generate a new random token
### Web Usage
1. Open your browser and navigate to: ` https://your-map-domain.com/admin`
2. Enter your token in the top Admin Console Token bar and click Verify.
3. Left-click any block on the 3D map.
4. Click "+ Add Marker" in the coordinate popup.
5. Select your marker type, click additional blocks to shape your area, customize labels and colors, and click Save.
## Commands
The plugin provides console and in-game commands for management:
| Command | Description | Permission |
| :--- | :--- | :--- |
| `/bmmweb token` | Display current admin token and `/admin` URL | `bmwebmarkers.admin` |
| `/bmmweb token <new-token>` | Update the admin editing token | `bmwebmarkers.admin` |
| `/bmmweb token regen` | Generate a fresh random admin token | `bmwebmarkers.admin` |
| `/bmmweb reload` | Reload configuration and re-sync endpoints | `bmwebmarkers.admin` |
| `/bmmweb status` | Display registered maps and active markers | `bmwebmarkers.admin` |
Command aliases include `/bmwebmarkers`, `/bmwm`, and `/bmwebeditor`.
## Requirements
This plugin requires a Paper, Purpur, or Folia server running Minecraft 1.21 or newer with BlueMap v5.x installed as a required dependency.