Administration
This page is for the person who runs a Realm Initiative site. Admins get an Admin item in the account menu, which opens Running the place, with eight tabs: Dashboard, Users, Themes, Dice, Maps, Monsters, Settings and Audit. Anyone else who finds the address sees an ordinary “nothing here” page.
Being an admin isn’t a key to anybody’s campaign. The admin pages show how many campaigns, characters and encounters there are, never what’s in them, and there’s no admin view of a campaign. You never choose, type or see anybody’s password either.
Setting up a new site
Section titled “Setting up a new site”A new site has no accounts, and until it has one, every address goes to Set up Realm Initiative. Enter Your name, Email, a Password of at least 12 characters and your Time zone (guessed from where you are), and select Create the admin account. That first account is the admin, and you’re signed in straight away.
Setting up also records the address you used as the site’s Site URL, which every email link uses, so it has to start https:// (plain http:// only works on your own computer). You can change it under Site address.
Once setup has run, the setup page is gone for good, even if every admin account is later lost.
A new site starts with registration Closed and email off. Go through Settings before inviting anyone.
Dashboard
Section titled “Dashboard”The first row of tiles counts People (and how many are active), Waiting for approval (highlighted, with Needs you, when anyone is) and Suspended.
The second row counts what’s on the site, across every campaign:
- Campaigns, and how many are in a fight right now.
- Characters: player characters and NPCs, with how many are player characters and how many monsters there are in bestiaries.
- Encounters run in the last 30 days.
Under Waiting for approval is everyone who has signed up, confirmed their address if the site sends email, and is waiting for you, each with Review, which opens their page. Someone who hasn’t confirmed their address yet isn’t counted here.
Three health cards say whether the parts that run without you are working. Each shows its state as a word as well as a colour:
- Email: Off, Working or Failing, with how many account emails went in the last 7 days, how many failed, and why the last one failed.
- Scheduler: when the background job last ran. It runs every quarter of an hour; if it hasn’t for more than 35 minutes, the card says something has stopped it. If the last run had a step that failed, the card says Failing and names the step and what went wrong.
- Housekeeping: what the scheduler tidies away (see Housekeeping). Run housekeeping now runs it straight away, if you’ve just changed something and don’t want to wait.
Below the cards:
- Storage: how much space the site’s files take, and how many there are: the site’s own images, profile and character pictures, battle maps and dice textures.
- Lately: the newest entries in the audit log, with The whole audit log.
- The version that’s deployed, when, and the newest database migration.
The Users tab lists every account, with its badges (Admin, and Active, Waiting or Suspended, plus Address not confirmed while email is on) and when it was last seen. People waiting for you come first, then everyone by name, 50 to a page. A number on the tab says how many are waiting.
- Search by name or email.
- Filter by status: Any, Active, Waiting or Suspended.
- Select Manage to open one person’s page.
The list only lists. Everything that acts on a person is on their own page, so that thirty rows of buttons aren’t thirty chances to click the wrong one.
Adding a person
Section titled “Adding a person”Open Add a person, enter their Name (up to 15 characters) and Email, tick Make them an admin if you want, and select Add them. The account is ready at once, with its address counted as confirmed. You don’t choose a password: they’re emailed a link to choose their own, which works once, for 24 hours. If email is off, or the email doesn’t go, their page shows you the link instead, once, to pass on yourself. It isn’t shown again; if it’s lost, make them a reset link.
Managing one person
Section titled “Managing one person”A person’s page shows their address, when they joined and were last seen, whether their address is confirmed, and how many devices they’re signed in on. It doesn’t show their campaigns or characters. For an active account:
- Role: Make them an admin… or Make them a user…. An admin can use this area and act on every account, but never inside anybody’s campaigns.
- Password: Make a reset link… emails them a link to choose a new password, which works once, for an hour. If email is off, their address isn’t confirmed, or the email doesn’t go, the link is shown to you once instead, to pass on some way other than email.
Below that are the ways out, which depend on the account:
- Waiting for their address (someone who signed up but hasn’t followed their confirmation link): they can’t be approved until they have. A sign-up nobody confirms is removed after seven days. You can still Decline… it.
- Approve (someone waiting): they can sign in, and if email is on, they’re emailed to say so.
- Decline… (someone waiting): removes the sign-up, and if email is on, tells them it wasn’t approved. They can try again later.
- Suspend… (an active account): type a Reason of at least five characters and select Suspend. They’re signed out at once and can’t sign back in, and emails to them stop. Nothing is deleted, and they stay in their campaigns. The reason is shown to them when they try to sign in, so write it for them. Lift the suspension lets them back in with everything as it was. The page says when the suspension began.
- Delete…: type delete and select Delete everything. Their account, picture and preferences go straight away, and there’s no undo. Their places in campaigns go with it, and so does every character in their library, with its companions and summons. A character they play in a campaign is taken out of it first, and what it carried stays in that campaign’s stash. An NPC they made, or a character nobody plays, that’s in a campaign stays there, handed to the campaign’s DM. The bestiaries’ monsters aren’t anyone’s, so they stay.
Everything except Approve and Lift the suspension asks first, with Cancel to back out. If email is on, the person is emailed about each of these: being approved or declined, suspended (with your reason) or let back in, made an admin or a user, and deleted. The message after each one says whether that email went, for example Sam is approved, but the email telling them didn’t go. Let them know yourself; the dashboard’s Email card has the reason.
Two things can stop a change:
- The site always keeps at least one active admin. Making the last one a user, suspending them or deleting them is refused with That’s the only admin. Make someone else an admin first, so the site isn’t left with nobody to look after it.
- Every campaign needs a DM, so an account that’s the DM of any campaign can’t be deleted: They’re the DM of a campaign. Each one has to be handed to a co-DM, or deleted, before the account can go. Only the DM can do that, so suspending is the way to keep someone out in the meantime.
Your own page acts on nothing. Change your own password and account in Settings.
Approving sign-ups
Section titled “Approving sign-ups”When the site is set to Ask me first (or Open while email is off), new people wait for you. Every active admin is told when someone is waiting: in the bell, and by email unless they’ve turned that off under Sign-ups waiting for you in their own notification settings. Push works too, if they tick it. If email is on, you’re told only once the person has confirmed their address.
To deal with them, open Review on the dashboard (or the Waiting filter under Users), then Approve or Decline… on their page.
Themes
Section titled “Themes”Every text colour in a theme has to reach a contrast of 7:1 against every background it sits on, in light and dark mode, and every ring and fill 3:1. The Themes tab is where you edit the built-in themes and make your own.
Each theme has a card with its colours, its key, how many people use it, and whether it’s the default or not offered. Each card has Edit and Duplicate.
- The three built-ins (Ember, Verdant and Arcane) ship with the app. You can change their colours, but you can’t delete them or stop offering them. Revert to shipped puts one back exactly as it came.
- Duplicate makes a separate copy with a key guessed from the original, and opens it for editing straight away. A copy never changes underneath you when its source does; Revert to source copies the source’s current colours back in.
The editor
Section titled “The editor”The editor opens beneath the cards, with:
- Name and Description. A copy also has a Key, the name in its stylesheet’s address. Changing it keeps everyone who’s using the theme on it.
- Every colour, grouped (including the five HP band colours the tracker uses), each with a hint and a Light and a Dark value.
- The contrast checks, which update as you type, with any failing pairs at the top.
- A Live preview of both modes side by side.
Select Save theme to save. A theme with a failing pair still saves, so you can come back to a palette in progress, but it can’t be offered to people until every pair passes.
Under Availability:
- Offer this theme to people puts it in everyone’s Appearance settings. It’s blocked until every pair passes.
- Make it the site default makes it what everyone who hasn’t picked a theme sees, including the signed-out pages. Only an offered theme can be the default.
Delete theme… removes a copy, after asking first. Anyone who was using it gets the site default. The default itself can’t be deleted until another theme is the default.
The Dice tab holds the dice themes people choose from in their own Dice settings. Seven ship with the site, with Ember as the default. The collection lists every theme with a die drawn in its colours, what it’s made of, and a switch to turn it on or off.
- A theme that’s on can be picked by anyone. Switching one off moves everyone who had picked it to the default, and tells them in their notifications.
- The default is what anyone who hasn’t picked rolls with. It’s always on. To change it, open another theme and select Make it the default.
Select Edit to change a theme, or use Add a theme beside the collection to make a new one. The theme template and the blank texture sheet are there to download as starting points. A theme has:
- Name, up to 40 characters.
- Numerals: the colour of the numbers.
- Die colours: up to five. The dice in a set take them in turn. + Another adds one, and × removes one.
- Outline: a ring round every numeral, or tick No outline.
- Material: None, Plastic, Glass, Metal or Wood, for how the light catches the 3D dice.
- Texture (optional): a square, tileable PNG, JPEG or WebP, from 64 to 2048 pixels a side and up to 1 MB. Remove the texture takes one away.
- Bump map: None, The texture, or Its own file, a greyscale picture the texture’s size.
- Blend: how the texture combines with the die colour, and Texture strength, from 0 to 100%.
The numerals have to be easy to read, at 7:1: against their outline, or else against every die colour and texture. The check under the form updates as you type, with a die drawn as it will look, and a theme that fails it isn’t saved. Select Add the theme or Save the theme.
Dice themes can be switched off, but not deleted.
The Maps tab holds the ready-made battle maps: pictures with a grid, for DMs without one of their own. Four come with the site: Grass, Rocks, Sand and Water, each 25 × 14 squares. DMs see the ones that are on under their campaign’s Maps, and add a copy to their campaign to start from.
Each card shows the map with its grid, its size in squares, its grid lines, and how many campaigns have a copy. Switch off hides it from DMs; Switch on offers it again.
To add one, under Add a ready-made map, enter a Name, choose a Picture (PNG, JPEG or WebP, up to 4 MB), set Squares across and Squares down (each from 4 to 100), choose the grid lines, and select Add the map. It’s on straight away. The preview shows the grid on the picture as you change it. Edit changes one, with an optional new picture. Remove it… asks Remove name? first, saying how many campaigns have a copy; select Remove it, or Keep it to back out. There’s no undo.
A campaign’s copy is its own. Changing, switching off or removing a ready-made map leaves copies already made exactly as they are.
Monsters
Section titled “Monsters”The Monsters tab holds the starter monsters: the ones every DM can add to their campaign’s bestiary, and every player can copy onto a character as a companion or summon. The site comes with 17 from the D&D 5e System Reference Document. See Characters and the bestiary for how DMs and players use them.
Starter monsters lists them by name, with how many there are and how many are offered. Each shows its challenge rating, armour class and HP, what it is, its initiative, speed and source. Find a monster narrows the list by name.
- Offered (the switch beside each one) puts it in every campaign’s bestiary and every player’s picker for companions and summons. Switch it off to hide it from both, marked Not offered.
- Edit opens it to change. Select Save, or Cancel.
A copy a DM or player has already made is theirs. Changing, hiding or deleting a starter here leaves every copy exactly as it is.
Adding a starter monster
Section titled “Adding a starter monster”Under Add a starter monster, fill in:
- Name, up to 60 characters. No two starters can share a name.
- Creature (like Small humanoid), and Challenge (like 1/4 or 2).
- Max HP (1 to 9999), Armour class (0 to 99), Initiative (a modifier from −20 to +20, like +2) and Speed (like 30 ft).
- Notes (optional): attacks, senses, what it can do, up to 4,000 characters.
- Source: where it comes from (see below).
- Offered straight away, in every bestiary and picker, ticked unless you’d like to check it first.
Select Add the monster.
To delete one, open it and select Delete…. You’re asked Delete name? first; select Delete it, or Keep it. There’s no undo, so to hide one for now, switch off Offered instead.
Sources
Section titled “Sources”Sources says where the starters come from, with each one’s attribution: the wording its licence asks for. Wherever offered starters show, under a bestiary and under the companions picker, each of their sources’ attributions shows once. Two come with the site: SRD 5.1, with the attribution the System Reference Document asks for, and The site’s own, with none.
To add one, under Add a source, enter a Name (up to 40 characters) and, if its licence asks for one, an Attribution (up to 2,000 characters), word for word. It’s shown as written, and web addresses in it become links. Select Add the source, then choose it for the monsters that come from it.
Edit beside a source changes it. A source can be deleted with Delete… only while no starter comes from it; move its monsters to another source first.
Settings
Section titled “Settings”The Settings tab holds the site’s own settings, a section at a time. A section that can’t be saved comes back with each problem beside its field.
Who can join
Section titled “Who can join”- Closed (the default): nobody can sign up.
- Ask me first: people can sign up, and wait under Users until you approve them. If email is on, they confirm their address first, and only then are the admins told and the person counted as waiting.
- Open: people can sign up and start once they’ve confirmed their email address. While email is off, Open works like Ask me first, because there’s no way to confirm an address.
The sign-up page tells people beforehand which of these will happen to them.
Realm Initiative sends email through Cloudflare. Enter a From address, turn on Send outgoing email, and select Save email. Send a test to me then sends one to your own address, as long as it’s confirmed.
The From address has to be one Cloudflare’s Email Routing is set up to send from, and the Site URL has to be set before email can be turned on. The name on outgoing email is always Realm Initiative. Nothing is ever sent to an address nobody has confirmed, or to a suspended account.
While email is off, everything copes: sign-up falls back to approval, password reset says plainly that it can’t send, and notifications go in the app and by push only.
Turning email off frees everyone waiting on a link that could no longer come, and the section says beforehand how many people that affects. Open sign-ups waiting to confirm wait for your approval instead, sign-ups that were going to need approval go straight to Waiting, and changes of address that are waiting are cancelled.
This site’s own images
Section titled “This site’s own images”Five images, each with a built-in until you upload your own:
- Favicon: the icon in a browser tab. An SVG stays sharp at every size; a PNG should be at least 32 pixels.
- Site icon: the mark beside the name in the top bar and on the sign-in pages.
- App icon: what an installed shortcut shows on a home screen. Square, and at least 512 pixels. Android crops it to a circle or a rounded square, so keep anything that matters inside the middle 80%. Show the crop Android may apply previews it.
- Share image: the picture on the card when someone pastes a link to the site into a chat. 1200 × 630 pixels is the shape every service crops to.
- Notification badge: the small mark Android shows in the status bar and on a push notification. Android uses only its shape, so it has to be a PNG, white on a transparent background, 96 pixels square.
Select Choose…, then Upload. SVG, PNG, JPEG, GIF, WebP and AVIF work (the badge takes PNG only), up to 2 MB, and up to 30 uploads an hour. An SVG that carries a script or points at another server is refused. A HEIC picture from an iPhone is refused too, with a note on how to send it as a JPEG. Use the built-in puts the original back. After changing the app icon, an installed app may need removing and adding again before a home screen shows the new one.
Site description
Section titled “Site description”A sentence or two, up to 200 characters, shown on the card a chat app draws for a pasted link, in the pages’ description, and by an installed app. The preview below the box shows how a pasted link will look. It isn’t for search engines, because every page tells them to stay away.
Site address
Section titled “Site address”Site URL: the address every link in an email uses, and the start of every display link. It has to start https://, with nothing after the name. Select Save address.
Sign in to Forge
Section titled “Sign in to Forge”Forge, the Dragon’s Lair ticket tracker, can let people sign in with their Realm Initiative account. This section is where you allow it. Turn on Sign in to Forge, enter Forge’s address (just the address, like https://forge.example.com, with nothing after it), and select Save Sign in to Forge.
When it’s on, Forge can send people here to ask whether it may sign them in. Forge sees their name and email address, once they’ve said yes, and nothing else. Each person can disconnect it in their own Settings. Turned off, Forge’s requests get a “nothing here” page, and any sign-in already on its way stops working.
Fixed on purpose
Section titled “Fixed on purpose”Some things aren’t settings at all:
- Search engines: every page asks not to be indexed. Nothing here is public.
- Sign-in lockout: five failed attempts from one place locks it out for 15 minutes.
Housekeeping
Section titled “Housekeeping”Every quarter of an hour, the scheduler tidies up by itself:
- Signed-in sessions that have run out.
- Sign-ups whose address nobody has confirmed, seven days after their latest link.
- Changes of address whose link has run out.
- Used and expired links, and expired sign-in codes for Forge.
- Old rate-limit records.
- Notifications: read ones after 60 days, unread ones after 180.
- Push devices that have failed for a week.
- The email log, after 90 days.
Each step runs on its own, so one that fails doesn’t stop the others; the dashboard’s Scheduler card names any that failed last time. Run housekeeping now, on the dashboard, does the same steps at once, and says whether every step worked. A step that fails shows on the Scheduler card, but the card’s last run stays the scheduler’s own, so running it by hand never hides a scheduler that has stopped. If a run is already going, you’re told to give it a minute.
Audit log
Section titled “Audit log”The Audit tab is a record of every admin action on an account, every password and address change, every account created or deleted, every site setting changed (with its old and new values), every change to a theme, a dice theme, a ready-made map, a starter monster or a source, every time housekeeping is run by hand, and every time someone lets Forge sign them in or disconnects it. Each line says who did what, to whom, and when, with names as they were at the time. Nothing in it is ever deleted, and it never holds a password, a link, or anyone’s email address. It’s 50 entries to a page.
Choose an action under What and select Show to narrow it down, or select a name to see everything about that person. Each person’s page also shows their own entries under In the audit log.
