Mel-Minimap provides a compact, aspect-ratio-preserving overview of the active Foundry VTT scene, including the current viewport, visible Tokens, and optional Map Notes.
It supports Token and Map Note hover information, permission-aware Actor and Journal interactions, and keyboard shortcuts for opening sheets or artwork.
The minimap adapts automatically to different scene sizes, respects visibility and Fog of War rules, and includes configurable settings with multilingual support.

• Displays the complete background of the active Scene or viewed Level.
• Preserves the original image aspect ratio. The map is never stretched.
• Uses a normal scale of 10% of the source image dimensions.
• Keeps the shorter map edge at least 300 pixels where possible.
• Scales very large maps down proportionally so the outer window does not exceed 350 × 350 pixels.
• Gives the map the maximum possible size when an extreme aspect ratio prevents both size limits from being met.
• Fits the map automatically. Manual resizing is not required or enabled.
• Displays the configured grid and a translucent white frame around the current main-canvas viewport.
• Can be moved or minimized like any other Foundry ApplicationV2 window.
• Clicking the minimap centers the main canvas on the selected position without changing the minimap's size or aspect ratio.

Visible Tokens are displayed as compact markers using Foundry disposition colors:

• Party for friendly Tokens
• Neutral for neutral Tokens
• Opposition for hostile Tokens
• Self for the controlled Token or the Token belonging to the current user's character

The user's own Token is highlighted with a white marker and blue outline. Hovering over a Token displays its name and localized disposition in the top-left information area, subject to Foundry's Token name-display mode and the user's permissions.

Map Notes use their configured Foundry icon and iconSize, scaled proportionally to the complete Scene. The feature is controlled by the client setting Show Map Notes, which is disabled by default.

When the pointer hovers over a Map Note, its custom Note text or linked Journal title is shown in the top-left information area. Pressing Ctrl+S opens the linked Journal Entry and, when configured, its linked Journal Entry Page.

• Ctrl+S opens the Actor Sheet for a hovered Token when the current user has at least Observer permission for that Actor.
• Ctrl+1 opens the hovered Actor's artwork locally when the current user may view that Actor.
• Ctrl+2 allows a GM to open and share the hovered Actor's artwork with all connected players.

The settings are client-specific and can be found in Foundry's module settings:

• Open minimap when the world starts: Opens the minimap automatically after the World is ready. Enabled by default.
• Show map background: Displays the active Scene background in the minimap. Enabled by default.
• Show Map Notes: Displays visible Map Note markers and enables Map Note hover actions. Disabled by default.

Changing Show Map Notes updates open minimaps immediately.

The shortcut only applies while the pointer is over the minimap. If the current user does not have the required permission, the shortcut is ignored.

Mel-Minimap follows Foundry's current Scene visibility state for non-GM users:

• Unexplored or currently invisible areas are masked.
• Tokens inside masked areas are not displayed.
• Hidden or otherwise invisible Tokens are not displayed to players.
• Non-global Map Notes in unexplored or currently invisible areas are not displayed to players.
• Global Map Notes follow Foundry's global visibility behavior.
• GMs can see content that is hidden from players; hidden Token markers use reduced opacity.
• If the Scene's Token Vision setting is disabled, players see the complete map regardless of Exploration Mode.

The Fog of War mask is sampled across the map for performance. Lighting, weather, animated effects, and video animation are not reproduced as a separate full Scene render.

Mel-Minimap includes translations for de, en, fr, es and nl. 

Documentation

Full documentation under: https://github.com/melnari/mel-minimap/blob/main/README.md

Parts of this module were created with AI assistance. The maintainer reviews, tests, maintains, develops, and supports the code and is responsible for its quality, compatibility, licensing, and continued development.