PlotMarkers icon

PlotMarkers -----

Add PlotSquared markers to your BlueMap maps



Description

PlotMarkers will add BlueMap map markers for your PlotSquared v7 worlds. It handles multiple worlds, any sized plots, and custom markers. If you click on a marker, it shows the owner's name, plot ID, and the owner's first played and last played dates. Markers are added and removed from the maps in real time as players claim and delete plots.

plotmarkers_sample.png

plotmarkers_sample2.png

Note that the POI markers and the shape markers can be shown or hidden individually in BlueMap's menu in the web browser.

Please use the discussion forum for any questions regarding PlotMarkers.

Installation

You should set up PlotSquared and BlueMap to your liking first. Then add PlotMarkers to your plugins folder and restart your server. PlotMarkers will generate a config file with entries for all your PlotSquared worlds, and will automatically add a marker for each plot to your BlueMap maps. If you're happy with the default format, that's all you need to do. Otherwise, see the Configuration section.

Configuration

The first configuration item is date-format, the format of the dates in the icon pop-ups.

Following that is a list of the worlds for which PlotMarkers will generate markers. If you add a world, simply add a new section with the new world name. For each world, you can configure the following:

override-y and y - This controls the height at which the markers will be placed. For a normal, flat plot world, you should leave override-y at true and set y to be one above the ground level of your plots. If you set override-y to false, PlotMarkers will use the average of the plot's y boundaries, which would normally be 128.

custom-icon, custom-icon-anchor-x, custom-icon-anchor-y - This allows you to specify a custom marker icon to use in place of the default BlueMap icon. Simply place your icon file in the PlotMarker configuration folder (where config.yml is located) and add the filename to the config file, as shown in the example below. The anchor settings allow positioning the icon relative to the marker's calculated location. Often you want this to be the middle of the icon, but if you have a needle as your icon, you'd want this to be the location of the tip of the needle.

fill-color, fill-opacity, line-color, line-opacity, line-width - This controls the color and appearance of the shapes outlining each plot or group of plots. The colors are specified as '#rrggbb'. The opacities are specified as 0.0 to 1.0, where 0.0 is transparent (invisible) and 1.0 is opaque.

If you make any configuration changes, simply use /bluemap reload to also reload PlotMarker's configuration file.

Here is sample configuration showing two worlds:
Code (YAML):
# The date format in the icon pop-ups. See Java's SimpleDateFormat.
# Examples include MM/dd/yy, dd/MM/yy, and yy/MM/dd.
date-format
: MM/dd/yy
# Markers will be created for each world listed below.
worlds
:
  plotworld
:
    # override-y causes the marker to be placed at the specified y coordinate.
    # Normally leave this true and set y to one above the ground level of your plots.
    # If set to false, the average height (y value) of each plot will be used.
    override-y
: true
    y
: 63
    # Specify a custom icon in the plugin folder if you don't want the default icon.
    # The anchor is which pixel on the marker-image will be placed at the marker's position.
    custom-icon
: ''
    custom-icon-anchor-x
: 0
    custom-icon-anchor-y
: 0
    # Set the color and opacity for the fill and line areas, and the line width.
    # Color is '#rrggbb'. Opacity is 0.0 - 1.0
    fill-color
: ' #3388ff'
    fill-opacity
: 0.1
    line-color
: ' #3388ff'
    line-opacity
: 1.0
    line-width
: 5

  plotworld2
:
    override-y
: true
    y
: 63
    custom-icon
: my_custom_icon.png
    custom-icon-anchor-x
: 15
    custom-icon-anchor-y
: 33
    fill-color
: ' #3388ff'
    fill-opacity
: 0.1
    line-color
: ' #3388ff'
    line-opacity
: 1.0
    line-width
: 5
Commands/Permissions

None.

Miscellaneous

This plugin uses the bStats metrics system to provide anonymous usage data. You may opt-out globally by changing plugins/bStats/config.yml. The metrics are available at https://bstats.org/plugin/bukkit/PlotMarkers
Resource Information
Author:
----------
Total Downloads: 168
First Release: Jan 21, 2024
Last Update: Jan 9, 2025
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings