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
setfield) are migrated into the default set on load.
No gallery available for this project.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
SquareMarkerZ 1.0.0 1.0.0 |
26.3
|
bukkit, paper, purpur, spigot
|
Download |