All Documentation

Player Portal Guide

Set up the Grimoire Player Portal so your players can explore the campaign world, with block-level visibility keeping your secrets hidden.

The Player Portal lets your players access campaign content you've shared with them. This guide covers what players can see and do.

For Gamemasters

Inviting Players

  1. Go to your campaign's Settings
  2. Click Invite Codes
  3. Click Create Invite Code
  4. Choose:

- Single use: One player only - Multi-use: Multiple players - Expiration: When the code stops working

  1. Share the invite link with your player

What Players Can Browse

Every campaign starts on Wiki only. Your players see the wiki pages you share and nothing else, exactly as before. When you are ready to let players explore the world, open the Player Portal tab in your campaign Settings and pick a preset.

Wiki only (default) Players see the wiki pages you share, nothing else. No entity browsing.

Revealed world Players can browse what the party has met, plus anything you mark as Player Knowledge. The world fills in as your players play: an NPC, location, or quest shows up in the portal once it appears in a session you have logged.

Open world Players can browse everything except your secrets. Anything that is Common Knowledge or Player Knowledge is visible.

Under every preset, DM Secret content and session prep never appear, and the wiki keeps working exactly as it does today.

The Revealed World Sub-Toggle

Under Revealed world you get one extra switch:

"Also show common knowledge the party has not discovered yet."

  • Off (default): the world reveals itself as your players explore it. A common-knowledge tavern in a far-off city stays hidden until the party gets there.
  • On: common-knowledge entries show up right away, even for places the party has not reached. Player-knowledge and met-in-session entries always show either way.

What Sessions Reveal

Under Revealed world, logging a session recap reveals the things that session touched: NPCs, locations, quests, items (loot), creatures, player characters, lore, and deities.

Some entity types are never pulled in by sessions. Factions, world rules, mechanics, and vehicles appear under Revealed world only when you mark them Player Knowledge (or when you turn on the sub-toggle above and they are Common Knowledge). If a faction should be visible, set its Player Knowledge to Player Knowledge.

Hiding a Single Entity

Any entity has a "Hidden from the portal" toggle in its edit form, next to Player Knowledge. Turn it on and that entity never shows in the portal, whatever its visibility tier and whether or not the party has met it. Use it for the one NPC you want held back even in an Open world.

Managing Access

To revoke access:

  1. Go to Settings > Players
  2. Click on the player
  3. Click "Remove from Campaign"

To change what a player sees:

  • Pick a portal preset in Settings > Player Portal
  • Set an entity's Player Knowledge to Common Knowledge, Player Knowledge, or DM Secret
  • Turn on "Hidden from the portal" to keep a single entity out
  • Use "View as Player" to test

For Players

Joining a Campaign

  1. Get an invite link from your GM
  2. Click the link
  3. Create your account (username + password)
  4. You're in!

The Player Portal

When you log in, you'll see:

Campaign Overview

  • Campaign name and description
  • Your character (if linked)

Wiki Access

  • Browse shared world information
  • Search for NPCs, locations, lore

Understanding Visibility

You'll only see what your GM has shared:

  • Common Knowledge: Things everyone in the world knows
  • Player Knowledge: Things you've discovered in play

If something seems missing, your character might not know it yet!

Collaborative Wiki Editing

If your GM enables it, you can edit wiki pages:

  1. Click a wiki page
  2. Make your changes
  3. Changes save automatically

Collaboration indicators:

  • Colored avatars show who's viewing
  • Amber dot = Your GM is online
  • Typing dots = Someone is editing

Best Practices

  1. Explore: Click around! See what your GM has built
  2. Take notes: Record important information
  3. Don't metagame: Only act on what your character knows
  4. Ask questions: If you're unsure what you can access, ask your GM

The Player Experience

Mobile Access

The Player Portal works on phones and tablets:

  • Responsive design adapts to screen size
  • Touch-friendly interface

Real-Time Updates

When your GM makes changes:

  • New content appears automatically
  • No need to refresh
  • You'll see when the GM is online

Frequently Asked Questions

Q: Why can't I see certain content? A: Your GM controls visibility. If you can't see something, your character hasn't discovered it yet.

Q: Can I edit wiki pages? A: Only if your GM has enabled collaborative editing for that campaign.

Q: What happens if I forget my password? A: Contact your GM - they can reset your access or create a new invite code.

Q: Can I access multiple campaigns? A: Yes! Each invite code is for a specific campaign. Join as many as your GMs invite you to.

AI Integration