Release notes for the dungeon office.

Continuous early access builds

These unofficial early access desktop builds are mirrored as the continuous public release for Windows, macOS, and Linux.

The artifacts include the Electron desktop runtime and app dependencies. Local AI is optional and built in: the app can download a small model and run it on its bundled llama.cpp runtime, or connect to an Ollama, LM Studio, or llama.cpp server you already run. The generator itself never needs a model.

Compare the available version shown below with your installed version in the app's About dialog or Help menu update check.

New here? Start with the first dungeon quickstart, then return for downloads and known issues.

Looking for the overworld sibling? Hexes on Automatic has its own site and downloads, mirrored the same way as the hexes-continuous release; the first-run steps below apply to it too. The whole family is listed on the On Automatic page.

View SHA-256 checksum files, updater metadata, and all mirrored release assets.

These builds are unsigned, so every OS challenges the first launch. First-run steps for each platform and the current known issues are below.

Foundry VTT monster module

The whole monster library installs into Foundry VTT as a compendium for the GURPS Game Aid — every monster an Actor with its portrait, hex token, stat block, and armour. It installs from a manifest URL rather than Foundry's module browser.

How to install the Foundry VTT module — the URL, the steps, and what you need first.

What will bite you first

Continuous builds are working software with rough edges. This is the honest list. Anything you hit that is not here belongs on the issue tracker — seed and app version included, please.

The builds are unsigned — every OS challenges the first launch

Windows: SmartScreen shows “Windows protected your PC.” Click More info, then Run anyway. This appears once per download.

macOS: the first open is blocked because the app is not notarized. Open System Settings → Privacy & Security, scroll to the message about the blocked app, and click Open Anyway. If macOS instead claims the app is “damaged,” clear the quarantine flag in Terminal: xattr -dr com.apple.quarantine "/Applications/Dungeons on Automatic.app". In-app updates also do not install on macOS while builds are unsigned — when the app offers an update, re-download from this page instead.

Linux: mark the AppImage executable (chmod +x or the file manager's Properties → Permissions), then run it. Some distributions need the FUSE 2 library (libfuse2) for AppImages.

Current known issues

• The built-in local-AI setup (bundled llama.cpp runtime with a one-click model download) is new, and its first-run flow on a completely fresh machine is still being verified. If it misbehaves, the Ollama / LM Studio connection path is the fallback — and a bug report is a favor.
• Universal VTT (.dd2vtt) import hardening is in progress. Importers differ in strictness; if a file is rejected, say which VTT and attach the file.
• A dungeon is reproducible from its seed within an app version. Across versions the generator changes, so keep the Dungeon JSON export for anything you want to keep exactly.

Public documentation shell

This release creates the public site and mirrors the current continuous desktop builds.

• Added product home page for Dungeons on Automatic.
• Added user manual with quick start, exact controls, exports, current limitations, and troubleshooting.
• Added release notes and download links backed by the public site repository.
• Mirrored the current desktop release assets from the application repository.

Current limitations

• Generation currently covers one level. Stairs are placed and exported; multi-floor graphing is future work.
• Universal VTT .dd2vtt output includes an embedded map image, walls, portals, lights, and GM/player modes. Importer hardening is ongoing.
• Custom treasure per room and custom container tables are still partial.
• Hallways currently use fixed widths.

Application changelog

Every pull request merged into the application, newest first. Entries arrive automatically with each build.