A Foundry VTT module that shows a different mouse cursor on the canvas depending on the active scene-control layer and tool — token select, target, ruler, measurement templates, drawings, walls, and more. Cursors are configured per-user, so every player can pick the look they like.
- Per-mode cursor images, matched against
${control}.${tool}first, then the layer (${control}) alone — so you can set a layer-wide cursor and override it for specific tools. - Configurable cursor hotspot (the click point within the image).
- Per-user settings — each player configures their own cursors.
- Ships with starter cursors for target, ruler, measurement templates, drawings, and walls.
- Recognises the standard layers (tokens, tiles, drawings, walls, lighting,
sounds, regions, notes) and any custom
control.toolkey you add by hand.
- In Foundry, go to Add-on Modules → Install Module.
- Search for Cursor Modes and click Install.
- In Foundry, go to Add-on Modules → Install Module.
- Paste the manifest URL into the Manifest URL field:
https://github.com/AdamGorbert/cursor-modes/releases/latest/download/module.json - Click Install.
- Enable Cursor Modes for your world (Game Settings → Manage Modules).
- Open Game Settings → Configure Settings → Cursor Modes → Configure Cursors.
- Pick a cursor image for each mode you care about. A mode with no image keeps Foundry's default cursor.
- Set the hotspot (in pixels from the top-left). For a 32×32 reticle,
16, 16centres it.
Drop images into cursors/ (or anywhere in your Foundry Data/ directory) and
point a mode at them in the settings menu.
- Use a non-animated image (
.png,.avif,.webp,.svg, or.cur). - Keep it small: max 128×128, 32×32 recommended.
- Minimum: Foundry VTT v13
- Verified: Foundry VTT v14
Released under the MIT License.