# DungeonRevealer

Dungeon Revealer does one thing extremely well: it puts a battle map on your players' screens with a fog of war you control, and you wipe the fog away as they explore. The DM sees the whole map. The players see only what you've revealed.

That is the entire pitch, and it's why people keep using it alongside heavier virtual tabletops. There is no game system to install, no character sheets, no module ecosystem to maintain. Upload an image, draw the grid, and start playing. It also does tokens, a shared dice roller, notes, and a chat sidebar, but the map is the point.

Hosting it here means the map is at a fixed HTTPS address your table can bookmark, and your uploaded maps live on backed-up storage.

[Get a 7-day trial of ElfHosted DungeonRevealer! 🪄](<https://store.elfhosted.com/product/dungeon-revealer/>)

## How do I access DungeonRevealer?

DungeonRevealer is available:

- From your dashboard: [https://your-username.elfhosted.com](<https://your-username.elfhosted.com>)
- Directly: [https://your-username-dungeonrevealer.elfhosted.com](<https://your-username-dungeonrevealer.elfhosted.com>)

> [!NOTE]
>
> **Signed-in users see their own URLs**
>
> The addresses above show the general pattern. [Sign in](<https://docs-internal.elfhosted.com/app/dungeonrevealer/>) and these become your personal, clickable links.

## How do I use it?

### Set your passwords first

Dungeon Revealer has two roles, each behind its own password:

- **DM**, who sees the whole map, reveals areas, and moves tokens
- **Player**, who sees only revealed areas

These are set with the `DM_PASSWORD` and `PC_PASSWORD` settings, which you can change using [ElfBot](<https://docs-internal.elfhosted.com/app/elfbot/>). **Set both before you share the address with anyone.**

Your instance is deliberately **not** behind ElfHosted's SSO, because your players aren't ElfHosted customers and can't sign in to it. Dungeon Revealer's own passwords are the only thing standing between the internet and your maps, so give them the same care you'd give any other password.

### Running a session

Sign in as DM, upload a map image, and set the grid so token sizes make sense. The map starts fully fogged; use the brush and area tools to reveal as your party moves. Push a map live to the player view when you're ready, and keep the next one staged and hidden until they get there.

Send your players the same address. They pick **Player**, enter the player password, and see the live map.

### Maps

Any image works. Bring your own, or grab maps from the many free and paid mapmakers around. Large, high-resolution images are fine, though very large files take longer to reach players on slow connections.

### What it deliberately doesn't do

No character sheets, no automated rules, no combat tracker. If you want those, [Foundry VTT](</app/foundryvtt/>) is the heavier tool, and plenty of tables run both: Foundry for the campaign, Dungeon Revealer for a quick one-shot where setup time matters more than features.

## DungeonRevealer also works with

- [x] [FoundryVTT](</app/foundryvtt/>)
- [x] [BookStack](</app/bookstack/>)

## How do I get support for DungeonRevealer?

1. For general use of DungeonRevealer, refer to the [official site](<https://github.com/dungeon-revealer/dungeon-revealer>) or to one of the links in the resources section below.
2. For specific support re your ElfHosted configuration / account, see the [ElfHosted support options](</get-help/>)!

## DungeonRevealer resources

- [DungeonRevealer (*official site*)](<https://github.com/dungeon-revealer/dungeon-revealer>)
- [DungeonRevealer Discord](<https://discord.gg/AVBBMD9>)