Update
Atlas VTT 0.2.0
Token resources, bulk statblock import and asset manager upgrades
New
-
Set maximum HP and secondary resource values in Edit Token, with per-token overrides of linked statblock defaults.
-
Choose a token's size from its right-click menu on the map: Medium (1×1), Large (2×2), Huge (3×3) or Gargantuan (4×4).
-
Give token assets a default size in the token creator, when editing a token, or from the asset manager's right-click menu. Tokens spawn at that size, and it travels with collection exports. Fantasy Statblocks imports pick it up from the creature's size.
-
The ruler follows the grid's Snap to grid setting: switch snapping off to measure from any point.
-
Click a selected token's HP or secondary-resource bar to edit it: the bar highlights on hover, and a popover opens below it with current and maximum fields. Type a number or a
+5/-3adjustment, use the arrow keys to step (Shift for tens), Tab between fields, Enter or click away to apply, Escape to cancel. -
Choose whether to share the DM’s initiative tracker in the local player view. The read-only player panel appears only while the DM tracker is open and player sharing is enabled, independently of other widgets. Turn order and rounds update live; hidden tokens stay private.
-
Select several assets or folders in the asset manager like in a file manager: Ctrl/Cmd-click adds or removes single items, Shift-click selects everything between the last clicked item and the one you click.
-
Tab and Shift+Tab cycle through the asset manager tabs, like in the command palette.
-
Ctrl/Cmd+F in the asset manager jumps to the search box.
-
Ctrl/Cmd+A in the asset manager selects all items of one kind: every folder when a folder is selected, otherwise every asset in the current view.
-
Import tokens from Fantasy Statblocks in bulk. Preview creatures with local artwork, choose a collection, and create linked tokens while skipping existing imports and preserving original notes and images.
-
Hold Shift and click tokens to add them to or remove them from the selection, then drag any of them to move the whole group.
-
New scenes align their grid to the map image on their own the first time they open. Maps without a grid simply open without one; the grid alignment tool remains available for corrections.
-
Read what's new after an Atlas update and browse previous releases in an offline changelog. Open it anytime with the View changelog command or from Atlas settings.
-
Turn automatic update announcements on or off in Atlas settings or in the changelog.
-
Report a bug or suggest a feature from inside Obsidian with the Report an issue command or from Atlas settings under Help and feedback. Atlas fills in your Atlas and Obsidian versions and submits your report directly, preserving the chosen issue type and affected area. No GitHub account or second form is needed.
Improved
-
Browse release notes in a fixed-size changelog with a scrolling history, release sections and a feature-update-only announcement option. Beta builds include their pending notes.
-
The issue-report form uses Atlas dropdowns and grouped categories, with only its text fields scrolling.
-
Exporting a collection now packs everything it needs: scenes with their map files, backgrounds and previews, token art and thumbnails, encounters, and the Fantasy Statblocks notes tokens link to together with their artwork, plus the collection's tags and settings. Importing restores all of it into the new vault with working scene previews and statblock links, and a progress dialog shows what is being packed or written.
-
Hover highlights in the asset manager, dropdown menus and context menus now appear and disappear instantly, and every item also shows a pressed highlight while you click it.
-
Deleting a token asset now tells you which encounters and maps still use it, removes it from them on confirm, and deletes encounters that would be left empty.
-
Fantasy Statblocks artwork now opens in the same token import cards as uploaded images, with crop controls, tags for selected tokens, and individual or global ring choices.
-
Dice roll toasts now look like a game HUD: a large glowing result, a ringed portrait, an accent-tinted ability label and knotwork corners. Natural 20s glow gold and natural 1s glow crimson, and the number lands with the reveal chime.
-
The asset manager stays quick with large libraries: it keeps its index in memory, shows small thumbnails instead of full-size token art (existing tokens get theirs in the background), and only renders the cards on screen.
-
Fantasy Statblocks imports now open inside the existing token creator. Filter by system/layout and choose the Atlas ring for all tokens or individually. Tokens imported without a ring retain their full artwork on the map.
-
Grid auto-detect now lines up across the whole map instead of drifting towards the edges, finds faint grids on busy art, and no longer reports a grid on maps that have none or picks the wrong grid type. The result tells you how much of the map the grid was found on.
-
Grids draw in black or white, whichever stands out against the map image, instead of cyan. Maps still on the old cyan default switch over automatically; pick Auto in the grid colour swatches to return to this after choosing a colour.
Fixed
-
Spawning several selected tokens from the asset manager keeps each token's ring setting and default size, matching single spawns.
-
The current and maximum numbers on token gauges sit close together around the slash. Changing a maximum in the bar popover preserves it as a token override.
-
Deleting an open scene no longer makes Atlas and Obsidian both close its view. Closing the active scene loads the next scene and restores its viewport and undo history.
-
Closing a map waits for its pending saves to finish, and overlapping saves keep their original order.
-
Token HP and secondary-resource fills keep their rounded leading edge at low values. Clicking a selected token's bar keeps the value editor open, and changing only the secondary-resource maximum refreshes its bar and label.
-
Token artwork and glass overlays update throughout resize and rotation gestures, including after release.
-
Edit Token no longer draws an extra frame around its fields, and its actions use the shared button states.
-
Scene tabs and widgets share the top row, with widgets aligned right and the initiative tracker kept clear. The view-actions menu sits at the bottom right.
-
Resize and rotation handles on selected tokens respond to clicks and drags again instead of deselecting the token.
-
Deleting or renaming a collection in Manage Tags & Collections now sticks: the collection and its assets are removed from the vault, and the dropdown no longer shows it after reopening the asset manager. Deleting asks for confirmation first, and the default collection cannot be deleted.
-
Right-clicking assets, folders and tags in the asset manager opened from the dashboard shows the context menu again, including when no map is open or another map tab was closed.
-
Fantasy Statblocks import actions stay in a padded footer while the list scrolls, and the system/layout filter uses the Atlas dropdown.
-
The local player window no longer shows hidden tokens, the selection outline, marquee, token controls or resize and rotation handles from the DM view.
-
Imported collections open their scenes again and keep each token's ring setting and statblock link.
-
Token ring toggles keep their full button height in the importer sidebar and use the consistent label “Toggle token ring”.
-
Clicking controls in Manage Tags or closing the dialog no longer closes the asset manager behind it.
-
Token import ring controls now share the editable preview state, and fast-loading images no longer get stuck optimizing.
-
Shift+2 centers the selected token at a readable on-screen size across map resolutions and window sizes, with room around it in small panes.
-
Local player windows refresh at the display frame rate without the display-only label or FPS counter, and reconnect to the presented scene after Obsidian reloads.
-
Creating a token from a statblock image no longer mistakes the source artwork for an existing token.
-
Opening a settings dropdown closes the previous one, including when switching with the keyboard or between map views.
-
Grid settings dropdowns keep opening after other map tabs close, and size to their button unless longer options need more room.
-
The unit type picker in collection default settings uses the Atlas dropdown menu instead of the native system menu.
-
Ctrl/Cmd+hover statblock previews open when you press the key while already over a token, and tall statblocks scroll inside the card with a soft edge shadow instead of running off the screen.
Important changes
- Removed the music and ambience player.
- Removed the vault-wide and current-folder image optimization commands. Images are still optimized during import.
- Removed the New map from image command. Create scenes through the scene browser.

