BlueMap Sign Markers

Overview

Fabric plugin for BlueMap that displays markers based on in-game signs

Installation

Place in your mods folder along with BlueMap.

Server-side only.

Usage

Place a sign or hanging sign with the following text on either the front or back:

[poi]
<short description>

A marker will be displayed on the map at the location of the sign with the text <short description>. The marker will be removed from the map when the sign is broken.

Note that the prefixes can be configured in the configuration file.

Configuration

The mod will create a BMSM-Core.json file in the config/bluemapsignmarkers folder. This file contains the following options:

• markerGroups - a list of marker groups (described in detail below); default is a list with a single marker group configured for the [poi] prefix.

Marker Groups

A marker group is a collection of markers that can be toggled on and off in the BlueMap UI. Each marker group configuration contains the following options:

• prefix - prefix that the sign must contain to be included in the marker group; required;
• matchType - the type of match to use when checking the first non-empty sign text line; optional; default is STARTS_WITH (case-sensitive exact match);
  • STARTS_WITH - line must start with the prefix;
  • REGEX - line must match the regular expression (uses Java regex engine);
• name - the name of the marker group; required;
• type - the type of marker to display; optional; default is POI
  • POI - a single point marker per sign;
  • LINE - signs sharing this group's prefix and the same first-line label become ordered points of one line marker (points ordered by placement time); requires at least 2 signs to appear;
• icon - the icon path or URL to display for the marker; optional; default is null (BlueMap default POI icon); POI only
• offsetX - the x offset of the marker; optional; default is 0 (corresponds with anchor.x in BlueMap base configuration); POI only
• offsetY - the y offset of the marker; optional; default is 0 (corresponds with anchor.y in BlueMap base configuration); POI only
• defaultHidden - If this is true, the marker-set will be hidden by default and can be enabled by the user; optional; default is false
• minDistance - the minimum distance from the camera at which the marker will be displayed; optional; default is 0.0 (floating point, double precision)
• maxDistance - the maximum distance from the camera at which the marker will be displayed; optional; default is 10000000.0 (floating point, double precision)
• lineWidth - the width in pixels of the line; optional; default is 2; LINE only
• lineColor - the hex color (with alpha) of the line, e.g. #FF0000FF; optional; default is #FF0000FF; LINE only

Setting a POI-only field on a LINE group (or vice versa) is not an error; the mod logs a warning and ignores the field.

Example

{
  "markerGroups": [
    {
      "prefix": "[poi]",
      "name": "Points of Interest"
    },
    {
      "prefix": "[store]",
      "name": "Stores",
      "icon": "assets/store.png"
    },
    {
      "prefix": "\\[[vV][iI][lL][lL][aA][gG][eE]\\]",
      "matchType": "REGEX",
      "name": "Villages"
    },
    {
      "prefix": "[trail]",
      "name": "Trails",
      "type": "LINE",
      "lineWidth": 3,
      "lineColor": "#00A2FFFF"
    }
  ]
}

This example configuration creates 4 marker groups: one for [poi] signs, one for [store] signs, one for signs where the prefix is a regex match for villages (e.g. [Village] or [VILLAGE]), and one for [trail] signs.

The [poi] and Villages marker groups use the default POI icon, while the [store] marker group uses a custom icon located at assets/store.png.

Signs with the [poi] prefix will be displayed in the "Points of Interest" marker group. Signs with the [store] prefix will be displayed in the "Stores" marker group. Signs that match the villages regex will be displayed in the 'Villages' marker group. Signs with the [trail] prefix, sharing the same description line, will be connected in placement order into a line in the "Trails" marker group once 2 or more such signs exist.