Ground Markers is a Bolt launcher plugin for RuneScape 3 that brings the comfort of RuneLite / HDOS style tile markers to RS3, including fully user-controlled layouts for both instanced content and regular overworld chunks.
Copy the following URL and add it as a custom plugin in Bolt:
https://j3sven.github.io/bolt-groundmarkers/dist/meta.json
View the CHANGELOG to see what's new in the latest version.
| Action | Shortcut |
|---|---|
| Mark / unmark the tile under your cursor | Alt + Middle Click |
| Cycle a tile through the color palette | Ctrl + Middle Click |
| Cycle the global palette selection | Ctrl + Scroll |
| Open / close the layouts UI | Click the tile launcher button (Shift + Drag to move it) |
| Adjust chunk-tile height in the grid | Shift + Scroll over a marked cell |
| Action | Shortcut |
|---|---|
| Zoom the chunk grid | Scroll (no modifier) |
| Add a Tile | Click the desired tile |
| Add or edit a label on a tile | Ctrl + Click on a tile in the chunk map |
- Status Bar – shows whether you are in an instance, how many unsaved tiles are waiting to be saved, and which layout(s) are active.
- Save Current Tiles – mark tiles and click Save Layout to store them. Saved layouts use chunk-local coordinates and can be reused anywhere.
- Instance Layouts – when in an instance, all marked tiles are temporary and can be saved as a reusable instance layout.
- Chunk Layouts – when in the overworld, only unsaved tiles in the current chunk can be saved as a chunk-specific layout.
- Saved Layouts – list of every stored layout (both instance and chunk layouts). Each item includes:
- A badge indicating the layout type (Instance or Chunk)
- A toggle switch to activate/deactivate the layout (hidden for linked layouts - see below)
- Link Button (Instance layouts only) – link the layout to your current entrance location. When linked:
- The button turns green to indicate the layout is linked
- The layout will automatically enable when you enter the instance from within a 9-tile radius of the linked location
- All instance layouts automatically disable when you exit any instance
- Multiple layouts can be linked to the same entrance
- You must be on the surface world (not in an instance) to link a layout
- Edit Button – opens the layout in the Chunk Map editor where you can add, remove, or modify individual tiles. Changes are automatically saved.
- Export Button – copies the layout JSON to your clipboard (or opens a modal fallback) so you can share layouts with others.
- Delete Button – removes the layout permanently after confirmation.
- The Import Layout button opens a modal where you can paste JSON from an exported layout.
- Provides an interactive top-down grid map of the current chunk (64×64 tiles). The player tile is highlighted in orange; blue tiles are marked; white indicates the hover preview.
- Zooming – scroll to zoom in/out. The viewport always tries to keep you centered while respecting chunk boundaries.
- Editing – click to mark or unmark tiles, matching the selected color in the dropdown. Hovering a tile previews it in-game.
- Height Control – hold
Shiftand scroll over a marked tile to raise or lower its elevation. - The legend, status line, and dropdown all update live as layouts and palettes change.
- Line Thickness – adjust the thickness of the tile outlines drawn in-game.
- Tile Fill – toggle filled tiles on or off, and adjust the fill opacity.
- Fill Opacity – adjust the opacity of filled tiles when tile fills are enabled.
- Connecting Lines – toggle the visibility of lines connecting adjacent marked tiles.
- Tile Labels – toggle the visibility of text labels on tiles.
- Palette Editor – customize the global color palette used for marking tiles. Each slot can be renamed and recolored. Changes apply immediately everywhere.
- Prep – enter your instance.
- Mark Tiles – use
Alt+Middle Clickor the chunk map to paint tiles as usual. These are stored as temporary tiles until you save them. - Save a Layout – Open the UI and give the tiles a descriptive name (e.g., "Croesus North"). They are saved chunk-relative, so the markers automatically shift to match whatever instance chunk you stand in next.
- Activate Layouts – toggle the layout you need. The plugin remembers your choice and reapplies it whenever you re-enter an instance until you toggle it off.
- Edit with the Chunk Map (Optional) – use the Chunk Map tab to fine-tune tiles, preview placements from afar, and set heights via
Shift+Scroll. - Reuse Later – when you load into a different run of the same encounter, simply enter the instance and the active layout will appear. You can still place temporary tiles on top if needed.
- Create Your Layout – enter the instance, mark tiles, and save the layout as described above.
- Link to Entrance – exit the instance and return to the entrance location on the surface world (within ~9 tiles of where you usually enter).
- Click the Link Button – in the layouts list, click the link icon next to your instance layout and confirm your link. The button will turn green.
- Automatic Switching – from now on, whenever you enter the instance from this entrance area, the linked layout will automatically enable and all other instance layouts will disable.
- Exit Behavior – when you leave any instance, linked instance layouts automatically disable.
The reason layouts are chunk-relative is that bolt currently has no reliable way to identify specific instances or encounters. We can however detect whether you are in an instanced area. Layouts can be reused across multiple runs of the same content, and with entrance linking, they automatically activate when you enter from the correct location.
- Export – click the copy icon next to a layout. The layout JSON is copied to your clipboard (or shown in a modal) and includes name, pretty display name, and every tile.
- Import – click Import Layout, paste JSON that matches the export format, and confirm. You can rename or recolor tiles after importing.
Ground Markers ships with a sensible default palette, but every slot can be renamed and recolored in the Palette tab. Palette changes are global:
- Existing ground markers, instance layouts, and the chunk editor update immediately.
- The chunk map color picker always reflects the latest palette state.
- Clicking the tile button toggles the layouts window.
- Holding Shift while dragging the button lets you move it anywhere on the screen. Its position is remembered between sessions.