SquareMarkerZ

Marker plugin for Squaremap, similar to plugin squaremarker.

View project on GitHub: https://github.com/rawwlock/SquareMarkerZ

Commands

Base command: /marker (alias /squaremarker).

Markers

Command	Description
/marker add <id> [iconUrl] [label...] [--set <setId>]	Creates a marker at your location. iconUrl is optional only if the target set has a default icon.
/marker addat <id> <world> <x> <z> [iconUrl] [label...] [--set <setId>]	Same as above, from the console (or a player) at explicit coordinates. Y defaults to the highest block at that x/z.
/marker remove <id>	Deletes a marker.
/marker move <id>	Moves a marker to your current location.
/marker moveset <id> <setId>	Moves a marker into a different set.
/marker label <id> <label...>	Sets the hover tooltip text.
/marker icon <id> <iconUrl>	Changes a marker's icon.
/marker desc <id> <text...>	Sets the click popup text (basic HTML allowed).
/marker list [world] [page] [--set <setId>]	Paginated list with clickable [tp] entries.
/marker info <id>	Shows a marker's full details.
/marker tp <id>	Teleports you to a marker.
/marker reload	Reloads config, sets, markers and re-registers icons.

An argument is treated as an icon URL only if it starts with http:// or https://; --set <setId> can appear anywhere after the required arguments and is stripped out before the rest is treated as the label. Marker ids match [a-z0-9_-]{1,32} (case-insensitive) and are globally unique across every set.

Marker sets

Command	Description
/marker set create <setId> [label...]	Creates a new set/layer.
/marker set delete <setId> [confirm] [--moveto <setId>]	With --moveto, moves the set's markers there and deletes it immediately. Otherwise, run it once to get a 30-second confirmation prompt, then run /marker set delete <setId> confirm to actually delete the set and its markers. The default set can't be deleted.
/marker set label <setId> <label...>
/marker set hide <setId> <true|false>	Whether the layer starts hidden in the web UI.
/marker set controls <setId> <true|false>	Whether the layer shows up in the web UI's layer toggle at all.
/marker set priority <setId> <number>
/marker set zindex <setId> <number>
/marker set icon <setId> <iconUrl|none>	Default icon used by markers added to this set without an explicit icon. none clears it.
/marker set list
/marker set info <setId>

A default set (id and label from config.yml, markers/"Markers" out of the box) always exists and can't be deleted; markers created without --set go into it.

Icons

• Only http:///https:// URLs are accepted.
• Downloads run entirely off the main thread, with a 5s connect timeout, a 5s read timeout, and a 512 KB max size (all configurable). Anything that isn't a valid PNG, JPG or GIF is rejected.
• Accepted images are resized to fit a configurable square (16×16 by default), keeping aspect ratio, and cached to plugins/SquareMarkerZ/icons/<sha1-of-url>.png. Cached icons are reused on restart without re-downloading, and keep working even if the source URL later goes offline.
• Several markers/sets sharing the same URL share one cached file and one squaremap icon registration (reference-counted); the registration is dropped once nothing uses it anymore, but the disk cache stays.
• If a download/validation fails, the command sender gets the reason and the marker/set is left unchanged — nothing is created or modified on failure.

Configuration (config.yml)

Covers the default set's id/label, icon size/download limits/timeouts, default layer properties for newly created sets, and every chat message (with a prefix, either legacy & color codes or MiniMessage — toggle messages.minimessage). See the shipped config.yml for the full, commented list. Changes take effect after /marker reload — no restart needed.

Storage

• plugins/SquareMarkerZ/sets.yml — marker sets.
• plugins/SquareMarkerZ/markers.yml — markers (id, set, world, x, y, z, label, description, icon-url, created-by, created-at).
• Every change is saved asynchronously by writing a temp file and renaming it into place, so a crash mid-write can't corrupt either file.
• Markers saved before marker sets existed (no set field) are migrated into the default set on load.