Getting Started
- Open the app. No account or install.
- Create a campaign from the Data Manager sidebar. Everything is scoped to a campaign: maps, tokens, playlists, story slides, sheets.
- Switch between modes using the top nav bar. DMs see five modes; players see only the VTT.
- All data persists locally in your browser. To share with players, start a multiplayer session (see Multiplayer).
The Modes
- VTT
- The live battle map where tokens move, initiative runs, and dice roll. This is what players see.
- Map Editor
- Authoring environment for battle maps. Not shared live with players.
- Data Manager
- Campaign, map, token, asset, playlist, generator, item and status library. Also where you import and export.
- Sheets
- Character and creature sheet editor and viewer. Markdown+ format.
- Story
- Narrative slide reel for image reveals, NPC portraits, and location descriptions.
- Companion
- A phone-sized view for players: sheet, inventory, HP, abilities, and rolls. See Companion Mode.
The music player is not a mode -- it lives as an always-visible widget in the bottom-left corner (see Music).
Campaigns
A campaign is a self-contained bundle of maps, tokens, playlists, story slides, and sheets. Create and switch campaigns from the Data Manager sidebar. Only one campaign is active at a time.
Token templates are campaign-scoped but can be copied across campaigns via import/export.
Large assets (over ~200 KB) need a bit more browser support. In Chromium-based browsers (Chrome, Edge, Brave), FeyGate will ask once for a folder to store them in; everything after that is automatic. In other browsers, stick to smaller assets or use tokens with tiny portraits.
Asset Store
The Store on this website is stocked with content packs and plugins you can add with one click. Open an item and press Add to Fey-Gate.
- Packs ask Add to which campaigns? -- tick as many as you like. A pack is saved once and shared, so adding it to five campaigns doesn't take five times the space. Accidentally deleted something from a pack? Add the same pack again and everything you deleted comes back, while the items you edited stay exactly as you left them. A progress bar shows how far the install has got; keep the tab open until it finishes. Changed your mind later? In the Data Manager's campaign panel, tick or untick it under Store packs in your campaign. No campaign yet? The Store sends you to Fey-Gate to make one first.
- Plugins are saved into your campaign folder, so pick a folder in Settings first (Chrome or Edge). After adding one, approve it in Fey-Gate under Settings → Plugins -- nothing runs until you say so.
Every item is labelled for how much AI went into it: AI Free, AI Supported or AI Generated. Set the AI content filter at the top of the Store to hide whatever you'd rather not see.
Map Editor
Switch to Map Editor mode and open or create a map from the Data Manager.
Tools
- Select (V) -- click or drag-select. Multi-select with shift. Rotate with the orange handle (shift snaps to 15°).
- Rectangle (R), Ellipse (E), Polygon (P), Line (L) -- shape primitives. Shift constrains to square/circle.
- Brush (B) -- freehand fill.
- Pan (H, Space) -- move the viewport.
- Asset (A) -- drop in pre-built assets (vegetation, structures, furniture, light sources).
Boolean draw modifiers
- Ctrl + draw -- union with selected shape.
- Alt + draw -- subtract from selected shape.
Layers, undo, filters
- Layers: visibility, lock, drag-to-reorder.
- Undo/redo with no practical depth limit.
- Hand-drawn filter toggles per map, turning crisp shapes into sketched, organic lines.
- Dynamic lighting: place point lights, choose a time-of-day preset (dawn, day, dusk, night, underground, none), or disable lighting with
none.
For every tool option and every shortcut, see Map Editor Tools.
Running a Session
- Load a map in VTT mode from the map picker.
- Drag token templates from the Data Manager onto the canvas to place instances.
- Pan with right-click drag or Space+drag; zoom with the scroll wheel.
- Open the dice tray (
R), initiative tracker (I), and token picker (T) as needed. - Toggle the grid with
G.
Initiative
Open the tracker with I. Add combatants from the canvas selection or type manually. Cycle turns to advance the round counter. Selecting a tracker entry highlights the token and vice versa.
Line of Sight
Toggle line of sight from the VTT toolbar (DM only). With it on, each player only sees what their tokens can currently see -- everything else fades into fog, and areas a player has already explored settle into a dimmer "remembered" fog instead of snapping back to black.
The DM never gets blacked out. With line of sight on, you see the whole map, dimmed everywhere the players' tokens can't see -- so you know exactly what the party is looking at, and what's still lurking in the dark.
Players: lost your character on a big map? Click the crosshair button on the VTT toolbar (Focus next token you control) to jump the camera to your token. Control more than one? Each click hops to the next.
Tokens
HP & stat bars
- HP input accepts
+5,-3, or an absolute number. - Custom stat bars: name, max, one of seven colours, visibility (
all,dm,hidden).
Statuses
Click a token and tap an icon in its Statuses row to switch it on or off. Each active status shows as a small colored badge around the top of the token, on every screen at the table. If a token piles up more than fit, the last badge turns into +N. The DM can set statuses on any token; players can set them on tokens they own.
Every campaign starts with ten: Stunned, Poisoned, Burning, Frozen, Prone, Invisible, Frightened, Blinded, Paralyzed and Concentrating. Need something odd for one fight? Type it into Other condition… and it shows as a grey badge with its first letter.
To make the list your own, open the Data Manager → Statuses:
- Click a status to rename or recolor it, or swap its icon. Reset puts an edited one back the way it came.
- + New status adds your own. Pick one of 36 built-in icons, or Upload image… -- any picture works, it's cropped square and shrunk for you.
- Export set saves your statuses as a
.feyfile; bring them into another campaign with Import. - A sheet-system plugin can bring its own starting list in place of the ten above. Statuses it marks read-only are set elsewhere: they show on the token while active, but you can't switch them in the inspector.
Hexed, Marked for Death, Smells Faintly of Cheese -- if your table tracks it, it can have a badge.
Built-in icons by Lorc, Delapouite and contributors from game-icons.net, CC BY 3.0.
Size categories
Tiny (0.5x), Small (0.75x), Medium (1x), Large (2x), Huge (3x), Gargantuan (4x). Sets the grid footprint.
Templates & instances
Create a token template in the Data Manager. Each placement on the canvas is an instance with its own HP, statuses, and position. Editing a template's max HP propagates to instances; editing an instance's current HP does not.
Visibility
Per-token: visible, dm (DM sees it, players do not), or hidden (nobody sees it, for staging).
Copy / paste
Ctrl+C / Ctrl+V duplicates selected tokens with every property intact.
Dice
Open the dice tray with R in VTT mode. Rolls are 3D, physics-simulated, and sync to every connected player.
Notation
| Expression | Rolls |
|---|---|
d20 | One d20. |
2d6+4 | Two d6, plus 4. |
1d6+1d4+3 | Compound expression. |
3d8-2 | Subtract a modifier. |
dF, 4dF | Fate/Fudge dice. |
dg, dg+4 | Daggerheart duality dice. |
Supported polyhedrals: d4, d6, d8, d10, d12, d20, d100. Every roll lands in the dice log, and natural 20s and 1s on a d20 get called out there.
Write dice like 2d6+3 in a character sheet or a Story document and they turn into a button in the preview. Click it to roll. This works for the polyhedrals above, not dF or dg.
Dice themes
Pick your dice from the dropdown in the dice tray: Midnight, Ivory, Arcane Amethyst, Emerald, Dragonfire, Frost, Galaxy, Onyx & Gold, Forged Steel, Dwarven Gold or Granite -- or Custom colors to choose your own. Your choice is saved in your browser and only changes what you see, so everyone at the table can roll in their favourite set. Daggerheart Hope and Fear dice keep their own colors.
Story Mode
Story Mode is for narrative beats -- image reveals, NPC dialogue, and scene descriptions. Slides are grouped into named sessions.
Slide types
- Image
- Fullscreen picture. Use for dramatic reveals.
- NPC
- Portrait, display name, and DM-only notes: tone of voice, personality, key phrases. DM notes never cross the network.
- Location
- Optional image and sensory notes (what players see, hear, smell), plus private DM notes.
Generators
Build your own random tables and roll them whenever the party goes off script. A generator is a little web of lists wired together: names, jobs, rumours, whatever your table needs. Make one under Generators in the Data Manager, or grab a ready-made pack from the Store.
Your first table
- In the Data Manager, open Generators and click New. You get a Weighted List already wired to a Result.
- Type a row and press Enter for the next one. Pasting several lines into a row turns each line into its own row, so a whole table goes in at once.
- Raise a row's weight to make it come up more often. The percentage beside it shows the odds.
- Click Roll. The result shows up in the Result node, and the rows it picked light up.
Your changes save as you go.
The nodes
Add nodes from the floating box on the right. To connect two, drag from the dot on one node's right edge to a dot on another's left edge.
- Weighted List
- Picks one row, using the weights.
- Template
- Text with gaps, written in curly braces:
{faction} is fighting {rival}. Each gap becomes a dot you can wire a list into. List rows can have gaps too. - Conditional
- Picks a row based on another result. Wire a value into value, then give each row a When. Only rows matching the value can be picked, and capitals don't matter. Several rows with the same When are chosen by weight. Leave When empty to catch everything else. Write
{value}in a row to print the value. - Import Generator
- Rolls another of your generators, so one list of names can feed ten tables. Everything under Your generators in the box is ready to drop in.
- Result
- What the generator produces. It has its own text box, so you can write around the roll:
### {text}turns it into a heading. Results understand markdown.
A gap with nothing wired into it stays in the result as {gap}, so a missing wire is easy to spot.
Same roll or new roll?
Every wire is a fresh roll. Wire one list into two gaps and you get two different answers, which is what you want for {a} vs {b}. A gap used twice in the same text prints the same roll twice.
Tick One roll on a node when all its wires should agree. Say a gender list feeds a Conditional that picks the name, and also gets printed on the sheet. Without the tick, the two wires can roll differently and your Bob ends up listed as Female.
Rolling during play
Tick Story or VTT under Quick access at the top of a generator and pick an icon.
- Story: a button appears above the text in Edit + Preview view. Clicking it writes the roll in where your cursor is.
- VTT: a button appears at the bottom left, for the DM only. Clicking it shows the roll in a pop-up with a Copy button. It stays for 30 seconds, long enough to read it out in a convincing accent.
Handy to know
- Select a node and press Ctrl+C, then Ctrl+V to copy it, in the same generator or another one. Wires between copied nodes come along. Hold Shift and drag to select several.
- To remove nodes and wires, select them and press Delete or click Delete selection. The trash icon deletes the whole generator.
- If you delete a generator that others import, the confirmation lists the ones that will stop rolling.
- Exporting a generator brings along everything it imports.
Character Sheets
Sheets are Markdown+ documents: standard Markdown plus custom interactive components. Autosaves on every edit.
Components
- HP tracker -- same math input as tokens.
- Stat box -- numeric value with label; good for ability scores and modifiers.
- Skill check button -- clickable roll button.
- Pip tracker -- consumable resource (spell slots, abilities with limited uses).
- Tabs -- split a long sheet into sections.
Because the format is text-first, there is no required structure. Write whatever the system calls for.
Items & Gifts
Hand out loot mid-session: send items and coin straight onto a player's character sheet, and keep a magic item's secrets until the party earns them.
Your items
In the Data Manager, open Items and click New. An item has:
- Unidentified name -- what players see until you identify it, like "Plain silver ring". Leave it empty if the name is no secret.
- Description -- what it looks like. Everyone holding it sees this.
- Effects -- what it does. Tick Undiscovered until you reveal it to keep an effect to yourself.
Undiscovered effects and an unidentified item's real name stay on your device until you reveal them. Items go into .fey files like everything else, and the Store has an SRD Items pack: the SRD magic items, unidentified and with their effects undiscovered, plus all the mundane gear.
Sending a gift
Gifts work with character sheets from a sheet system that supports them, such as the Nimble plugin.
- Open Companion sheets on the VTT toolbar and click Send item… under the player.
- Enter some coin, search for an item, or both. Your Data Manager items and the system's own rules items show up as you type.
- No match? Pick Create “…”. "Dragonscales" ×5 becomes a new item in your Data Manager, ready for rules after the session.
- Set the quantity and click Send.
The player gets a popup and picks Accept or Decline. Until they answer, the gift waits under Gifts waiting for an answer, where you can Withdraw it. A player who's offline gets it when they're back.
Revealing secrets
Click a player in Companion sheets. Under Not yet discovered by … you'll find every item their character holds that still hides something:
- Identify tells them its real name and every effect.
- Reveal next to an effect tells them just that one.
Each character's copy is tracked on its own, and edits you make to an item in the Data Manager reach every copy: right away for players at the table, the next time they connect for the rest. On the player's screen a reveal darkens everything while the truth seeps in, so nobody misses that the ring was cursed all along.
Music Player
The music player is an always-on widget in the bottom-left corner. It appears as soon as the active campaign has at least one playlist. There is no separate Music mode.
Creating playlists and tracks
- Open the Data Manager and switch to the Playlists content type.
- Create a playlist (campaign-scoped).
- Add tracks by pasting any YouTube URL.
Playing music during a session
- Pick a playlist from the dropdown in the player widget.
- Use prev / play-pause / next. DM controls are mirrored to every connected player in real time.
- The progress bar along the top of the widget shows track position.
Roles
- DM (or solo)
- Full control: switch playlists, transport, volume.
- Connected player
- View-only transport (disabled buttons show what's playing). The volume slider is always enabled, so each player balances music against voice chat on their own.
Collapsed state
A chevron in the top-right corner collapses the widget to a compact pill (play-pause + track title). The widget auto-collapses when you switch to Map Editor so it does not cover your drawing surface; toggle it back open at any time.
Multiplayer
Hosting
- Click Invite in the nav bar. That one click starts the room and copies the player invite link.
- Paste the link to your players, or let them scan the QR code in the popover that opens.
- Need the link again? Click the room code in the nav bar and it's copied once more.
Joining
Players open FeyGate with a URL parameter:
https://www.fey-gate.com/app/?join=ABC123 URL parameters
?room=CODE- DM: rejoin an existing room as host.
?join=CODE- Player: join a room.
?join=CODE&companion=1- Player: join and open straight into Companion Mode. This is what the invite QR code links to.
Who's at the table
As DM, click the session indicator to see who's connected. If a player drops out -- a phone goes to sleep, a laptop lid shuts -- they stay on the list as offline, along with how long they've been gone, and their character sheet stays with them. When they come back under the same name, they pick up where they left off. Click the × next to an offline player to remove them and their sheet from the session.
How it works
A lightweight relay passes messages between everyone at the table and stores nothing itself. The DM's game is always the source of truth; late joiners catch up automatically, and a dropped connection reconnects with tokens exactly where they were left. Shared images aren't re-sent if someone at the table already has them, so reconnecting and catching up stays fast.
If the DM drops for long enough that the room closes, Fey-Gate opens it again under the same code when the DM reconnects, as long as nobody else has grabbed it in the meantime. Your invite links keep working, and players just refresh to rejoin.
Companion Mode
Companion Mode gives each player a phone-sized view instead of the full VTT: their character sheet, inventory, HP, abilities, and a roll log, synced live with the DM.
Joining
Open the session popover in the nav bar while connected and scan the QR code, or share the invite link -- both drop a player straight into Companion Mode on their phone, no separate app or login.
What syncs
The DM sees a player's sheet as soon as they join. HP and sheet edits made in Companion Mode sync to the DM's screen immediately, and abilities a player has shared are visible to the DM in a drawer on the VTT toolbar. Gifts and item reveals from the DM land here too (see Items & Gifts).
A player can also reach Companion Mode from a desktop browser via the same invite link -- it's a view, not a device restriction.
Import / Export
Pack your maps, tokens, textures, assets, playlists, collections, generators and items into a single .fey file to back them up, move them to another device or hand them to a co-DM. The images they use come along inside the file.
Export
- In the Data Manager, click Select.
- Tick what you want to take with you. You can switch sections and keep ticking. Select All ticks everything in view.
- Click Export. A
.feyfile lands in your downloads.
Statuses have their own Export set button in the Data Manager's Statuses section. Story slides and character sheets don't go into .fey files.
Import
- Open the campaign you want the content in.
- Data Manager → Import, then pick a
.feyfile. - If something in the file is already in this campaign, choose Overwrite or Skip for each one (or Overwrite All / Skip All), then click Import.
Keyboard Shortcuts
Map Editor
V | Select |
R | Rectangle |
E | Ellipse |
P | Polygon |
L | Line |
B | Brush |
H / Space | Pan |
A | Asset picker |
T | Token picker |
Shift + L | Cycle time of day |
Shift + draw | Constrain rect to square / ellipse to circle |
Ctrl + draw | Boolean union |
Alt + draw | Boolean subtract |
Shift + rotate | Snap rotation to 15° |
VTT
R | Dice tray |
I | Initiative tracker |
T | Token picker (DM only) |
G | Toggle grid |
Ctrl+C / Ctrl+V | Copy / paste selection |