⚔️ Tantu Help

The Story Weaver — D&D 5e GM Tool

🚀 Getting started
⚔️ Campaign & prep▸
🎮 GM Dashboard 📜 Campaigns & story 🕸️ Story Web 🤝 Session Zero 📈 Tension Curve 🔮 Foreshadowing 📄 Handouts 📊 Session Log & Analytics
🎭 Characters & NPCs▸
👤 NPCs 🎲 Player characters ✨ Character creation 🎟️ Player onboarding invites
⚡ Live session▸
📡 Running a live session 🖼️ Scene Push 🎵 Sound & ambient 🎬 Cut-In system 🎲 Whisper & dice 📊 Player Polls 🔮 Mystery Items
🤖 AI features▸
🧵 Threads & AI overview 📖 Story Coach 💬 NPC Dialog AI ⚒️ AI Generators 🎙️ Voice Interview 🗣️ Voice Input
📚 Content & reference▸
📕 SRD Rulebook 🎰 Random Tables 🎨 Media Library 🖨️ Print Pack
⚙️ Settings & admin▸
🔧 Instance Settings 💾 Storage & files 📋 Login Log 🔒 GDPR & Data Export 🔑 SSO & Feature Gating
💰 Plans & support▸
💳 Pricing ❓ FAQ & Troubleshooting

🚀 Getting started

Welcome to Tantu — The Story Weaver

Tantu is an AI-powered Game Master tool for tabletop RPGs like Dungeons & Dragons 5e. It helps you prepare campaigns, run live sessions, and push scenes, sound, and secrets directly to your players' phones — no app download needed.

Whether you're a first-time GM or a veteran storyteller, Tantu handles the heavy lifting so you can focus on what matters: telling a great story.


Your first steps

  1. Sign up at tantu.site — free forever. You get your own Realm (yourname.tantu.site).

  2. Create a campaign — Guided Setup walks you through everything, or Quick Create for pros.

  3. Add NPCs — Start with 2-3 key characters your players will meet.

  4. Plan your first session — Every session starts with a Strong Opening Scene.

  5. Go Live — Hit Start Session, players scan the QR code, done in 10 seconds.

Key concepts

Concept

What it means

Realm

Your personal Tantu instance (yourname.tantu.site)

Campaign

A single adventure with NPCs, sessions, and world

Session

One game night with strong opening, scenes, encounters

Scene

Content you push to players: image, description, sound

Threads

Tantu's AI currency for AI-powered features

What's in these docs

Browse the categories in the sidebar to learn about every feature Tantu offers — from campaign prep and AI tools to live session management and admin settings.

Need help? Use the bug report button (bottom-right in the GM tool, or Ctrl+Shift+B).

⚔️ Campaign & prep

Overview of all tools for preparing your campaigns, stories, and sessions.

🎮 GM Dashboard

The GM Dashboard

Your command center. When you log in to your Realm, the GM Dashboard gives you access to everything.

Campaign selector

The left sidebar lists all your campaigns. Click to load one, or + New Campaign to start fresh. Campaigns are fully independent — each has its own NPCs, sessions, and world.

Navigation

The sidebar organizes your tools into logical groups:

Prep mode — Overview, Story & World, NPCs, Players, Sessions, Plotlines, Scenes & Sound, Encounters, Items/Monsters, Random Tables, Rulebook, Print Pack, Story Web, Session Zero, Media, Storage

Live mode — Scenes, Players & Initiative, Pacing, NPCs, Items

AI tools — Story Coach, Tension Arc, Foreshadowing

Guided vs. quick create

When creating a campaign:

  • Guided Setup walks you through world building, NPCs, and your first session step by step

  • Quick Create drops you into an empty campaign immediately

📜 Campaigns & story

Campaigns & story

Every adventure starts with a campaign that holds your world, NPCs, sessions, encounters, and plotlines.

Story & World tab

Three sections form the heart of your campaign:

The Story — Your main narrative arc, history, and current events. 2-3 paragraphs is plenty to start.

The World — Kingdoms, factions, geography, lore. Your campaign bible for when players ask "what do I know about the Northern Wastes?"

GM Secrets — Plot twists, hidden motivations, the BBEG's true plan. Players never see this, even during live sessions.

All three auto-save when you click Save All.

Plotlines

Track your story threads with title, description, priority, and status:

  • Main Plot — The central quest or conflict

  • Side Quests — Optional adventures that enrich the world

  • Character Arcs — Personal stories tied to individual players

Keep 2-3 plotlines active at any time. Too many overwhelms, too few feels empty.

Sessions

Plan each game night with:

  • Strong Opening Scene — The most important part. Drop players right into the action.

  • Recap — What happened last time

  • Notes — Your prep notes for the session

🕸️ Story Web

Story Web

The Story Web is a visual relationship graph that maps the connections in your campaign. It shows NPCs, locations, factions, items, and events as nodes, with edges representing their relationships.

Node types

Type

Color

Use for

NPC

Blue

Characters in your world

Location

Teal

Places, cities, dungeons

Faction

Amber

Organizations, guilds, armies

Item

Red

Important objects, artifacts

Event

Purple

Key moments, battles, rituals

Custom

Gray

Anything else

Edge types

Connections between nodes can be typed:

  • Connection — Generic relationship

  • Ally — Friendly bond

  • Enemy — Hostile relationship

  • Family — Blood or marriage ties

  • Location-Link — "is located at"

  • Quest-Link — Related to a quest

Custom types

You can create your own node and edge types per campaign with custom colors and icons. This lets you adapt the Story Web to your specific world.

NPC import

Click Import NPCs to automatically create nodes for all NPCs in your campaign. Their personality and relationships are preserved.

AI generation

The AI can analyze your campaign's story, NPCs, and plotlines to automatically generate a Story Web with suggested connections. This is a great starting point that you can then refine manually.

Standalone view

The Story Web has a dedicated full-screen view at /gm/story-web.html for complex campaigns with many nodes.

🤝 Session Zero

Session Zero

Session Zero is a structured player onboarding tool. Before the first real session, each player fills out a questionnaire so you understand their expectations.

What players share

  • Playstyle — Do they prefer combat, roleplay, exploration, or a mix?

  • Boundaries — Topics or themes they want to avoid

  • Expectations — What they hope to get from the campaign

  • Preferred session length — Default "2-3 hours"

  • Combat preference — Scale 1-10 (how much combat they want)

  • RP preference — Scale 1-10 (how much roleplay they want)

  • Notes — Anything else they want to share

Why it matters

Understanding your players before session 1 prevents conflicts and helps you tailor the experience. A player who wants 90% roleplay won't enjoy a dungeon crawl, and vice versa.

Managing responses

All Session Zero responses are stored per campaign. You can view, compare, and delete entries from the GM Dashboard. Use the data to find the sweet spot for your group.

📈 Tension Curve

Tension Curve

The Tension Curve is an AI-powered narrative analysis tool that visualizes the dramatic arc of your campaign across sessions.

How it works

The AI reads your session recaps, plotline statuses, encounter difficulties, and story events to map the emotional intensity over time. The result is a curve showing peaks (climactic moments) and valleys (downtime, social scenes).

What you learn

  • Are your sessions pacing well, or is every session at maximum intensity?

  • Did you give players enough downtime between major conflicts?

  • Where are the natural climax points in your story arc?

  • Is the tension building toward your planned finale?

Using it effectively

Check the Tension Curve before planning your next session. If the last three sessions were all high-intensity combat, maybe it's time for a social session. If things have been quiet, it might be time for a dramatic twist.

This feature requires the ai_story_coach feature flag and uses Threads.

🔮 Foreshadowing

Foreshadowing

Foreshadowing is an AI tool that suggests subtle hints you can plant in your sessions about future events.

How it works

The AI analyzes your active plotlines, GM secrets, and planned twists, then generates a list of foreshadowing opportunities — small moments you can weave into your next session that will pay off later.

Examples

If your GM Secret says "the king is actually a dragon," the AI might suggest:

  • An NPC mentions the king never seems to feel the cold

  • The party finds a suspiciously large claw mark on the throne room wall

  • A scholar mentions old legends about shapeshifting wyrms

Using it

Go to the Foreshadowing section in your GM Dashboard. The AI generates suggestions based on your current campaign state. You can accept, modify, or dismiss each suggestion.

Good foreshadowing makes players feel like the story was planned from the beginning — even when you're improvising. It rewards attentive players and creates satisfying "I knew it!" moments.

This feature requires the foreshadowing feature flag and uses Threads.

📄 Handouts

Handout system

Handouts are documents, letters, maps, or notes that you create during prep and distribute to players during live sessions.

Creating handouts

In the Handouts section of your campaign:

  • Title — What the handout is ("Letter from the Duke")

  • Content — The text content

  • Image — Attach an image (map, illustration, letter)

  • Type — note, letter, map, or custom

  • Secret — Mark as secret (only given to specific players)

Distributing during play

During a live session, use Give Handout to send a handout to one or all players. The handout appears on their phone with the image and text. Players can review received handouts at any time.

Read tracking

You can see which players have read their handouts (read status tracking). This is useful for secret handouts — you'll know when the rogue has read the letter meant only for them.

Physical play

Handouts are also included in the Print Pack for analog sessions. Print them separately and hand them out physically for maximum immersion.

📊 Session Log & Analytics

Session Log & Analytics

Every event during a live session is automatically logged: scene pushes, dice rolls, whispers, NPC dialog, items given, polls, and more.

Timeline

View a chronological timeline of everything that happened during a session. Filter by event type, search for specific moments, and paginate through long sessions (up to 200 events per page).

Stats

See aggregated statistics for any session:

  • Total events by type (how many scenes pushed, dice rolled, etc.)

  • Session duration (first event to last event)

  • Player activity breakdown

  • Most-used features

Summary

A quick overview of event counts grouped by type. Useful for comparing sessions — "last week we had 12 dice rolls and 3 NPC dialogs, this week we had 25 rolls and 8 dialogs."

Campaign overview

The Campaign Log Overview shows high-level statistics across all sessions in a campaign, helping you spot trends in your GMing style.

🎭 Characters & NPCs

Everything about creating and managing NPCs, player characters, and portraits.

👤 NPCs

NPC management

NPCs are the lifeblood of your campaign. Create them in the NPCs tab.

Creating an NPC

  • Name and Short Description ("grizzled dwarven blacksmith with a missing eye")

  • Personality — How they act ("gruff but secretly kind, protective of children")

  • Motivation — What drives them ("find the hammer stolen from his ancestor's forge")

  • Secret — What players don't know ("spy for the thieves' guild")

  • Voice/Speech — How they talk ("deep voice, short sentences, calls everyone 'lad'")

  • Importance — Major (recurring, plot-critical) or Minor (one-scene, flavor)

AI Dialog

During live sessions, generate in-character NPC responses. The AI reads personality, motivation, secrets, and story context. It maintains context within a session.

NPC portraits

Generate AI portraits based on the NPC's description. Portraits can be evolved (refined) and pushed to player phones during sessions.

Start with 2-3 key NPCs. Add minor ones on the fly during play.

🎲 Player characters

Player characters

Players are added automatically when they join a live session via QR code and create a character. They can also be added manually.

Character sheet

Full D&D 5e character sheet: all six ability scores, saving throws, skills, hit points, armor class, speed, attacks, equipment, features, personality traits, ideals, bonds, and flaws.

Inventory

Track items the GM gives during play. Items can be:

  • Normal — Immediately visible with full description

  • Mystery — Unidentified until the GM reveals them (see Mystery Items)

GM Notes

Private notes per player character that only you see. Track backstory hooks, planned reveals, or reminders.

Level progression

Level up characters directly from the Players tab.

✨ Character creation

Character creation

Tantu includes a guided character creation flow backed by the complete SRD.

SRD integration

Choose from all SRD races and classes with full subclass support. Each option shows traits, stat bonuses, and features.

AI character suggestions

The AI can suggest personality traits, background, and backstory based on the chosen race and class. It considers the campaign setting for contextually appropriate suggestions.

Portrait generation

After creating a character, generate an AI portrait:

  1. The AI creates a visual prompt from the character's description

  2. Choose a style (dark fantasy, painterly, etc.)

  3. Generate and attach the portrait

  4. Evolve (refine) with additional prompts if needed

Portraits are visible to the GM and can be pushed to all players during sessions.

🎟️ Player onboarding invites

Player onboarding invites

Send invite links to new players so they can create their characters before game night.

Creating an invite

From your campaign, generate an onboarding invite with:

  • Label — Who the invite is for ("Sarah's character")

  • Max uses — How many times the link can be used (default: 1)

  • Expiry — When the link expires (in hours)

What players see

Players receive a URL and/or QR code. When they open it, they see:

  • The campaign name and GM's welcome message

  • A guided character creation flow

  • Race and class selection from the SRD

  • AI-assisted personality and backstory generation

  • Portrait creation

Before game night

Characters created via onboarding invites are ready in your Players tab before the first session. No setup time wasted at the table.

Exporting characters

Players can export their character data as JSON or formatted text via a personal token link.

⚡ Live session

All tools available during a live game session with connected players.

📡 Running a live session

Running a live session

The Live tab turns your laptop into a session cockpit.

Starting up

  1. Open your campaign, go to Live

  2. Click Start Session — a unique QR code appears

  3. Players scan with their phone camera — no app needed

  4. Connected within 10 seconds

Each session gets a unique 6-character code. Players can also enter it manually at your Realm URL.

Player experience

On their phones, players see the current scene, their character info, chat/whisper area, dice roller, inventory, and any handouts. Everything runs in the mobile browser.

Session persistence

If a player disconnects (bad wifi, phone locks), they rejoin by scanning the QR code again. Data and position persist.

🖼️ Scene Push

Scene Push

Push images, descriptions, and read-aloud text to all player phones simultaneously.

How to push

  1. Select a prepared scene or create one on the fly

  2. Click Push Scene

  3. The image fades in on all connected phones

  4. Assigned sound starts playing

  5. Read-aloud text appears (if shared)

Preparing scenes

In prep mode, set up scenes with:

  • Title and Read-aloud text

  • Image to display on player phones

  • Sound — ambient or SFX

  • Overlay — visual effects (fog, fire, rain, snow)

  • GM Secrets — notes only you see

Recap Push

At session start, push a recap of what happened last time to all players. They see the title and recap text on their phones — great for getting everyone up to speed.

🎵 Sound & ambient

Sound & ambient

Set the mood with Tantu's built-in sound system.

Ambient sounds

Continuous background atmosphere with built-in presets: tavern, forest, dungeon, ocean, city, rain, combat drums, and more.

Sound effects (SFX)

One-shot triggers: sword clashes, explosions, door creaks, thunder. Fire them manually during dramatic moments.

Custom upload

Upload your own MP3/WAV files to build a personal sound library. All uploads are stored in your Media Library by campaign.

Volume control

Players can adjust their own volume. You control the master volume for all connected devices.

Important note

Mobile browsers require a user interaction before playing audio. Players may need to tap the screen once after connecting. This is a browser security feature, not a Tantu bug.

🎬 Cut-In system

Cut-In system

Cut-Ins are dramatic full-screen reveals on all player phones. Use them for:

  • Boss reveals

  • Plot twists

  • Dramatic moments

  • Celebrating critical rolls

Manual cut-ins

From the Live panel, trigger a Cut-In with:

  • An image or visual

  • A title

  • A style: dramatic, success, danger, or mystery

Automatic cut-ins

Tantu can automatically trigger cut-ins on:

  • Natural 20 — A celebratory full-screen reveal

  • Natural 1 — A dramatic failure moment

The auto cut-in listens for dice rolls from connected players and fires instantly.

This feature requires the cut_ins feature flag.

🎲 Whisper & dice

Whisper & dice

Whisper

Send secret messages to individual players during live sessions. Only the target player sees the whisper. Perfect for:

  • "You notice something the others don't..."

  • Secret knowledge checks

  • Private NPC conversations

  • Betrayal setups

Dice rolling

Built-in dice roller supporting all standard D&D dice: d4, d6, d8, d10, d12, d20, d100. Roll any combination.

Results can be:

  • Open — Visible to all connected players

  • Hidden — Only the GM sees the result (for secret checks)

Initiative tracking

When combat starts:

  1. Each player rolls initiative

  2. Add monsters to the tracker

  3. Tantu displays the turn order

  4. Click to advance turns

Pacing timer

Set countdowns for dramatic moments ("you have 30 seconds to decide!") or to remind yourself to keep scenes moving.

📊 Player Polls

Player Polls

Create real-time polls during live sessions. Players vote on their phones.

Creating a poll

From the Live panel:

  1. Enter a question ("Where do you go next?")

  2. Add options ("The haunted forest", "The merchant's guild", "The abandoned mine")

  3. Push the poll — it appears on all player phones instantly

How players vote

Players see the question and options on their phone and tap to vote. Votes are collected in real-time.

Results

The GM sees live results as votes come in. Use polls for:

  • Letting players decide direction

  • Gauging interest in story branches

  • Fun mid-session decisions

  • "Who do you trust?" moments

Polls are logged in the Session Log for later review.

🔮 Mystery Items

Mystery Items

Give players unidentified items that must be discovered through gameplay.

How it works

  1. Give an item to a player during a live session with the mystery flag

  2. The player sees only "Unidentified Item" in their inventory

  3. When the narrative moment is right, click Identify on the item

  4. The full name, description, and properties are revealed to the player

  5. A notification appears on their phone

Use cases

  • Loot from a dungeon that needs an Identify spell

  • A mysterious artifact whose purpose becomes clear later

  • A cursed item that reveals its nature at the worst moment

  • A letter in a language the player can't yet read

Live feedback

When an item is identified, the player's phone shows a reveal animation. The moment is logged in the Session Log.

🤖 AI features

Tantu's AI-powered tools: Story Coach, Dialog, Portraits, Voice, and more.

🧵 Threads & AI overview

Threads — AI currency

All AI features use Threads, Tantu's internal currency. Different actions cost different amounts:

Feature

Approx. cost

NPC Dialog

~1-2 Threads

Portrait Generation

~5-10 Threads

Story Analysis

~3-5 Threads

Monster/Item Generation

~3-5 Threads

Character Suggestion

~2-3 Threads

Voice Transcription

~1 Thread

Your monthly allocation depends on your plan. Free (Adventurer) gets limited Threads, paid plans get more. Purchase additional bundles anytime — unused Threads don't expire.

Feature flags

AI features are gated by feature flags that depend on your subscription plan. If a feature shows "locked," you may need to upgrade or contact your admin.

Active AI feature flags: ai_story_coach, ai_npc_dialog, ai_portraits, ai_creator, ai_chargen, story_web, foreshadowing, cut_ins, voice_input

📖 Story Coach

AI Story Coach

The Story Coach analyzes your entire campaign and helps with narrative development.

Capabilities

  • Story Analysis — Find plot holes, inconsistencies, and missed opportunities in your narrative

  • Next Session Planning — Get suggestions for your next session based on active plotlines

  • Consistency Check — Verify NPC motivations, timelines, and facts align across the campaign

  • Description Generation — Generate vivid descriptions for any scene, location, or item

  • Session Recap — Auto-generate a recap of what happened in the last session

  • Foreshadowing — Get suggestions for subtle hints about future events

  • Tension Curve — Visualize the dramatic intensity across your sessions

Context-aware

The Story Coach reads your campaign data — story, world, NPCs, sessions, plotlines, and GM secrets — to give contextually relevant suggestions. It understands your world.

Usage

Access Story Coach tools from the sidebar navigation in the GM Dashboard. Each analysis uses Threads.

💬 NPC Dialog AI

AI NPC Dialog

Generate in-character NPC responses during live play or in prep mode.

How it works

The AI considers:

  • The NPC's personality, motivation, and secrets

  • The current story context and world

  • Previous dialog in this session (context is maintained)

  • The player's question or statement

During live play

Click on an NPC name in the Live panel to open the dialog interface. Type or describe what the player says, and the AI generates an in-character response.

In prep mode

Test NPC dialog from the NPC detail view before the session. Useful for rehearsing important conversations.

Quality tips

The more detail you put in the NPC's personality and voice fields, the better the dialog. "Deep voice, speaks in short sentences, always calls people 'lad'" produces much more distinctive responses than just "friendly dwarf."

Requires the ai_npc_dialog feature flag.

⚒️ AI Generators

AI Monster & Item generators

Create custom game content with AI assistance.

Monster Generator

  1. Describe what you want ("a fire-breathing turtle the size of a house")

  2. Set the target challenge rating

  3. The AI generates a complete, balanced stat block

  4. Optionally generate AI artwork for the monster

The v2 generator produces more detailed and balanced stat blocks with proper action economy.

Item Generator

Create custom magic items:

  1. Describe the concept ("a sword that whispers battle tactics")

  2. The AI generates name, description, mechanics, rarity, and lore

  3. Add to your campaign inventory

Character Suggestions

Help new players build characters:

  • Suggest personality traits and backstory based on race/class

  • Recommend combinations that fit the campaign setting

  • Generate character concepts for inspiration

Requires the ai_creator and ai_chargen feature flags.

🎙️ Voice Interview

Voice Interview

The Voice Interview is a Socratic AI-guided conversation for creating campaign content through speech.

How it works

  1. Start a Voice Interview from the Story Coach

  2. The AI asks you questions about your campaign, NPCs, or planned encounters

  3. You speak your answers (via browser microphone)

  4. Your speech is transcribed automatically (Whisper via Groq)

  5. The AI follows up with deeper questions based on your answers

  6. At the end, the AI compiles everything into structured campaign content

Use cases

  • Campaign brainstorming — Talk through your ideas and let the AI organize them

  • NPC creation — Describe a character verbally, the AI fills in the template

  • Encounter design — Explain what you want, the AI builds it

  • World building — Ramble about your world, the AI structures it

Why voice?

Many GMs think better out loud than in writing. The Voice Interview captures the creative flow of verbal brainstorming and turns it into usable game content.

Requires the voice_input feature flag. Transcription uses Groq's Whisper Large v3 Turbo.

🗣️ Voice Input

Voice Input

Tantu supports speech-to-text input throughout the GM tool.

How it works

Click the microphone icon on any text field to dictate instead of type. Your speech is transcribed in real-time using Groq's Whisper Large v3 Turbo model.

Where you can use it

  • Session notes

  • NPC descriptions

  • Story and world text

  • Scene descriptions

  • Any text input in the GM Dashboard

Language support

Whisper supports multiple languages. Tantu is configured for the language of your instance.

Privacy

Audio is processed through Groq's API for transcription and is not stored. Only the resulting text is saved.

Requires the voice_input feature flag.

📚 Content & reference

SRD rulebook, random tables, media library, and print tools.

📕 SRD Rulebook

SRD Rulebook browser

Tantu includes the complete D&D 5e Systems Reference Document — over 5,000 entries.

What's included

  • Monsters — Complete stat blocks for all SRD creatures

  • Spells — Every spell with level, school, casting time, range, description

  • Items — Magic items, equipment, weapons, armor

  • Races — All playable races with traits and stat bonuses

  • Classes — Every class with subclasses, features, progression tables

  • Feats — Optional character abilities

  • Conditions — Blinded, charmed, frightened, etc. with full rules

Universal Search

Find anything by name, type, or challenge rating. Search works across all categories.

During play

The Rulebook stays accessible during live sessions. Quick lookups without leaving Tantu.

🎰 Random Tables

Random Tables

10 sets of random tables for quick improvisation during play.

Available tables

  • NPC names and traits

  • Tavern events and rumors

  • Wilderness encounters

  • Treasure hoards

  • Plot hooks

  • Weather

  • Dungeon rooms

  • Shop inventories

  • And more

How to use

Click on any table to roll. Results are generated instantly. Use them when players go off-script and you need inspiration on the spot.

During live sessions

Random Tables are accessible in both prep and live mode.

🎨 Media Library

Media Library

All uploaded images and sounds are stored in your Media Library, organized by campaign.

File management

  • Upload images (scenes, portraits, maps, handouts)

  • Upload sounds (ambient, SFX, custom music)

  • View storage usage and quota

  • Delete files to free space

Storage quotas

Storage limits depend on your plan. Check your current usage in the Storage section of the GM Dashboard. The quota covers all uploaded files across all campaigns in your Realm.

Reuse

Assets can be reused across sessions within the same campaign. For cross-campaign sharing, re-upload the file.

Supported formats

  • Images: JPG, PNG, WebP, GIF

  • Audio: MP3, WAV, OGG

🖨️ Print Pack

Print Pack

Generate complete session packets for analog or hybrid play.

What you can print

  • Story & Secrets — Campaign narrative and GM notes

  • Sessions — Planned sessions with strong openings

  • Scenes — Read-aloud text

  • NPC Reference Cards — Cut-out cards for behind the GM screen

  • Plotlines — Active story threads

  • Encounter Stat Blocks — Monster stats for combat

  • Player Character Sheets — Current character data

  • Initiative Tracker — Blank table

  • Blank Character Sheets — 3 copies for new players

Tips for analog play

  1. Cut out NPC cards for quick reference behind the screen

  2. Practice read-aloud text — atmosphere matters

  3. Print handouts separately for physical distribution

  4. Keep Tantu open on your laptop for AI help and the rulebook

Hybrid mode

Combine laptop (lookups + AI) with printed materials (immersion). You don't have to choose.

⚙️ Settings & admin

Instance settings, storage, privacy, data export, and admin tools.

🔧 Instance Settings

Instance Settings

Configure your Tantu Realm in the Settings section.

Privacy settings

  • Analytics opt-out — Disable anonymous usage analytics

  • AI training opt-out — Prevent your content from being used for AI training

Both settings are stored per instance and can be changed at any time.

Custom favicon

Upload a custom favicon for your Realm. It appears in the browser tab when players access your instance. Supported formats: ICO, PNG, SVG.

Notification preferences

Configure how and when Tantu notifies you about session events, player activity, and system updates.

💾 Storage & files

Storage Management

Monitor and manage your Realm's file storage.

Storage stats

View total used space, available quota, and file count. Storage includes all uploaded images, sounds, and generated portraits across all campaigns.

File browser

List all uploaded files with size, type, and upload date. Delete files you no longer need to free space.

Quota limits

Storage limits depend on your subscription plan:

  • Adventurer (Free) — Limited storage

  • Starter — More storage

  • Guild — Maximum storage

If you hit your limit, you'll need to delete files or upgrade your plan before uploading more.

📋 Login Log

Login Log

The Login Log shows a history of all authentication events for your Realm.

What's tracked

  • Successful logins (timestamp, IP, method)

  • SSO authentications via tantu-platform

  • Session token creation

Security

Use the Login Log to:

  • Verify no unauthorized access

  • Check when you last logged in

  • Monitor SSO integration activity

Access the Login Log from the admin section in the GM Dashboard sidebar.

🔒 GDPR & Data Export

GDPR & Data Export

Tantu is fully GDPR-compliant with built-in tools for data rights.

Data Export (Art. 15 & 20)

Export all your data as a JSON file containing:

  • All campaigns with story, world, and secrets

  • All NPCs with full details

  • All sessions with notes

  • All scenes

  • All characters

  • Instance settings

Account Deletion (Art. 17)

Delete your entire account and all associated data. This action is permanent and cannot be undone. All campaigns, NPCs, sessions, and uploaded files are removed.

How to access

Both features are accessible from the GM Dashboard's admin section. Data export generates a downloadable JSON file. Account deletion requires confirmation.

Privacy controls

Additionally, you can opt out of analytics and AI training via Instance Settings — see the Instance Settings article.

🔑 SSO & Feature Gating

SSO & Feature Gating

Single Sign-On (SSO)

Tantu instances authenticate through tantu-platform, the central management system. When you sign up at tantu.site, your account is created in tantu-platform, which provisions your Realm and handles authentication.

SSO means you use one account across:

  • tantu-platform (account management, billing)

  • Your Realm (GM tool)

Feature Gating

Features are controlled by feature flags set through tantu-platform based on your subscription plan. When a feature is locked:

  • The UI shows a lock icon or "upgrade" prompt

  • API calls return a feature_locked error with an upgrade URL

  • The feature flag name tells you which plan unlocks it

Current feature flags

Flag

Feature

Required plan

ai_story_coach

Story analysis, recap, consistency

Starter+

ai_npc_dialog

NPC dialog generation

Starter+

ai_portraits

Portrait generation & evolution

Starter+

ai_creator

Monster & item generators

Starter+

ai_chargen

Character suggestions

Starter+

story_web

Visual relationship graph

Guild

foreshadowing

AI foreshadowing tips

Guild

cut_ins

Dramatic cut-in system

Starter+

voice_input

Speech-to-text

Guild

💰 Plans & support

Pricing, FAQ, and troubleshooting.

💳 Pricing

Pricing & Plans

Adventurer (Free — forever)

  • 1 campaign, 5 NPCs

  • Complete SRD rulebook browser

  • Encounter builder + dice

  • 10 random table sets

  • Scene push to phones

  • Limited AI Threads

Starter (€4.99/month)

  • 3 campaigns, unlimited NPCs

  • All AI features (Story Coach, NPC Dialog, Portraits)

  • Custom sounds upload

  • Session planning tools

  • Print session packets

  • More AI Threads

Guild (€19.99/month)

  • Unlimited campaigns and NPCs

  • All Starter features + Story Web, Foreshadowing, Voice Input

  • Priority AI processing

  • Custom monster and item generators

  • Advanced analytics

  • Maximum AI Threads

  • Priority support

Custom subdomain

Every account gets a personal Realm at yourname.tantu.site.

Note: Tantu is in Closed Beta. Pricing may change before public launch.

❓ FAQ & Troubleshooting

Frequently Asked Questions

Do players need an app? No. QR code scan, runs in mobile browser.

What RPG systems? Optimized for D&D 5e SRD. Session tools work for any system.

In-person or online? Designed for in-person. Also works hybrid.

How do players join? Scan QR code or enter session code at your Realm URL.

Can players see GM Secrets? Never. GM Secrets, NPC secrets, and hidden notes are only visible to you.

Can I use Tantu without AI? Yes. Sessions, scenes, sound, dice, encounters, rulebook all work without Threads.


Troubleshooting

Sound not playing: Mobile browsers need a user tap before audio plays.

Players can't connect: Check QR code is current, internet works, try manual code entry. Corporate networks may block WebSocket connections.

Login issues: Use Forgot Password, check Realm URL, clear browser cache.

Slow AI: Server load dependent. Keep images under 2MB for faster scene pushes.

Bug Reports

Use the bug report button (bottom-right, or Ctrl+Shift+B). Include what you did, expected, and actual result. Reports may earn bonus Threads!