BlueMap-KingdomMarker

A lightweight Paper plugin that reads shape and extrude markers directly from your BlueMap configuration files and displays them in-game as colored particle lines on the ground.

The plugin also sends title notifications to players when they enter or leave a territory.

It is designed for servers that use BlueMap to define team claims, kingdoms, or custom zones and want players to see those borders directly while walking around in-game.

What it does

• Reads BlueMap Markers: Parses your .conf / .json files on startup and reload.
• In-Game Particle Borders: Renders particle lines on the terrain surface using the exact RGB colors defined in BlueMap.
• Screen Titles: Shows customizable enter/leave titles when players cross territory borders (e.g. Kingdom of Team: CYBORG).
• Performance Friendly: Only calculates and renders particles around active players within a configurable radius.
• Configurable Messages: All messages, sounds, render distances, and file paths can be configured in config.yml.

Quick Setup

1. Put the .jar file into your plugins/ folder.
2. Open plugins/BlueMap-KingdomMarker/config.yml and check whether bluemap-file points to your BlueMap map configuration file, for example: plugins/BlueMap/maps/world.conf
3. Run /bmkm reload or restart your server.

Configuration

# Path to your BlueMap map configuration file
bluemap-file: "plugins/BlueMap/maps/world_one_normal.conf"

particles:
  render-distance: 40.0

messages:
  prefix: "&8[&6KingdomMarker&8] "
  no-permission: "&cYou do not have permission to execute this command."
  reload-success: "&aConfiguration and BlueMap markers reloaded successfully!"
  command-usage: "&eUsage: /bmkm reload"

  title-header: "&6Kingdom"
  subtitle-enter: "&7Kingdom of Team: &e%kingdom%"

  leave-title-enabled: true
  leave-title-header: ""
  leave-subtitle-leave: "&cYou have left the kingdom of %kingdom%"