Local Map Markers

Local Map Markers lets players manually place their own local markers on Muck's map. MuckSaveGame is optional: the mod works without it, while installing it enables per-save marker persistence.

Marker types

Exactly six custom marker types are supported:

• House
• Cave
• Village
• Revive
• Boss
• Generic

Note: The Statue marker type is no longer available and has been replaced by the Revive marker.

Controls

• 1 – 6 — Select marker type
• LMB click — Place the selected marker
• LMB drag — Move/pan the map
• RMB click — Remove the nearest local map marker
• Mouse Wheel — Zoom the map

The currently selected marker and controls guide are shown in the top-left corner of the HUD while the map is open.

Persistence Behavior

Local Map Markers supports advanced, save-aware persistence, which adapts based on whether the optional MuckSaveGame mod is installed.

With MuckSaveGame Installed

• Map markers persist with the corresponding saved game.
• Loading a saved game automatically restores its associated markers.
• Starting a new game with a seed that has an existing saved game starts with a clean, empty marker map.
• Once the new game session is saved, its current markers are saved to disk and become the persistent set for that save.
• Deleted saves have their orphaned v2 marker data cleaned up safely on a later startup when MuckSaveGame is available.
• Matching legacy v1 marker data is migrated conservatively to v2 when an existing saved game is loaded; the original v1 data is preserved.

Without MuckSaveGame Installed

• The mod still functions normally, but operates in session-only mode.
• Placed markers are kept in memory only and will not be persisted to disk.
• Markers are cleared when returning to the main menu or starting/loading a different world.

Note: MuckSaveGame integration is entirely optional. LocalMapMarkers runs gracefully without it.

Safety / Scope

• Does not modify Muck .mucksave files.
• Does not modify world generation.
• Does not synchronize markers via networking/RPC. Markers are strictly local to each player.
• Safe self-healing visual hydration makes sure markers render correctly even if the map UI layout is cleared during initialization by other mods.

Installation

Thunderstore / r2modman (Recommended)

1. Search for LocalMapMarkers in your mod manager.
2. Click Install. BepInEx and other dependencies will be resolved automatically.

Manual Installation

1. Install BepInExPack_Muck (version 5.4.1101 or later).
2. Download the release archive.
3. Extract the contents and place LocalMapMarkers.dll under BepInEx/plugins/LocalMapMarkers/.
4. Launch Muck.

Changelog

1.0.2

• Minor documentation improvements.

1.0.1

• Documentation improvements.

1.0.0

First public release.

• Six custom map marker types: House, Cave, Village, Revive, Boss, and Generic.
• Marker selection with keys 1–6.
• Place markers with LMB and remove them with RMB.
• Keeps normal map dragging and mouse-wheel zoom behavior.
• In-map selected-marker and controls display.
• Optional per-save marker persistence through MuckSaveGame.
• Session-only operation when MuckSaveGame is not installed.
• New games remain isolated from existing marker data even when using the same seed.
• Local-only markers with no networking or RPC synchronization.