RPGX Quest Log

by Ashton Rogers / RPGX / X8 Studios rpgxstudios.com · Discord · Patreon · Facebook

RPGX Quest Log is a comprehensive quest tracking system for Foundry VTT, designed for Game Masters who want more than a notepad. It gives you a living, player-facing quest board with full GM control. From posting jobs, tracking active missions, and managing rewards, all the way to generating entirely new quests using local AI that understands your actual campaign world.

It is built to work in all three Foundry deployment scenarios: remote hosted servers, local network setups, and single-machine GM stations.

Compatibility

Free Tier Features

Everything below is available to all users with no subscription required.

Quest Tracking

• Quest Log window: A resizable, minimizable panel accessible from the floating toolbar button or chat commands /quest
• Five quest statuses: Job Board, Active, Completed, Failed, and Abandoned, each with its own tab
• Up to 10 quests per world: Create and manage up to ten quests without any subscription
• One-click status changes: Click the status stripe on any quest row to instantly change its status without opening the full sheet
• Right-click context menu: Alternate power-user access to status changes directly from the quest list

Quest Sheet

• Quest title, player-facing description, and GM-only notes: All stored separately so players only ever see what you want them to see
• Auto-save: Description, GM notes, and hidden milestone text save automatically as you type, debounced so nothing is lost
• Quest status selector: Change status directly from within the sheet

Job Board

• Player-visible job board: All users can see Job Board quests, even without being assigned
• Player quest claiming: Players can drag and drop their own characters onto a Job Board quest to claim it; the GM's client processes the claim and posts a chat card announcing who accepted
• Automatic status transition: Claimed quests move from Job Board to Active automatically

Drag-and-Drop

• Quest givers: Drag any actor onto the quest giver zone; supports multiple quest givers per quest
• Quest recipients: Drag actors onto the recipient zone to assign them
• Reward items: Drag any item from the world or compendium directly onto the rewards panel

Reward Distribution

• XP auto-split: Distributes total XP evenly across all assigned characters and updates their sheets directly
• Currency auto-split: Splits GP, SP, and CP evenly, with the remainder going to the first character; PP supported
• Custom currency field: Free-text field for non-standard currencies or special rewards
• Loot assignment and transfer: Assign individual reward items to specific characters, then transfer them all to inventory in one click
• Reveal rewards toggle: GM controls when reward details become visible to players

Milestones

• Add, complete, fail, and remove milestones: Track quest objectives individually
• Hidden milestones: GM-only text field for secret objectives players haven't discovered yet
• Reveal milestones toggle: Make milestones visible to players when the time is right

Multi-Player Sync

• Real-time socket updates: All connected clients (GM and players) see quest changes immediately without refreshing
• Role-based access: Players only see quests they are assigned to; Job Board quests are visible to everyone
• Click-through portraits: Players can click quest giver and recipient portraits to open their character sheets

Pro Features

Pro features require the RPGX Proton desktop application to be running on the GM's computer with an active Patreon subscription. Proton is the sole validator — no license keys, no cloud accounts. Subscription status is verified silently on load and re-checked every 30 minutes.

Unlimited Quests

The free tier allows up to 10 quests per world. Pro removes that cap entirely — no limit on how many quests your world can hold.

AI Quest Generation

The flagship Pro feature. Open any quest sheet, navigate to the AI Generate tab, optionally enter a theme or premise, and click Generate. The AI writes a complete quest tailored to your campaign: title, player-facing description, and full GM notes including the real plot, villain motivation, a twist, encounter suggestions, and campaign hooks.

How generation works:

1. World lore search: Before calling the AI, the system queries your RPGX RAG knowledge base for lore relevant to the characters involved. Journal entries, actor biographies, session notes, and any ingested documents are searched using hybrid semantic and keyword retrieval. Relevant chunks are injected into the prompt as authoritative campaign facts.

2. Character context: The quest giver's and recipients' full character sheet data is read live at generation time: alignment, race, class, background, ideals, bonds, flaws, traits, and biography (including NPC public and detail biography blocks). This data is used to personalise the quest and find narrative threads connecting the characters involved.

3. Alignment-driven storytelling: The AI applies different rules based on the quest giver's alignment:

   • Evil givers deceive the players in the description. The quest is made to sound benign, heroic, or profitable. The GM notes expose the true, sinister goal, the exact lie being told, and what actually happens if the party succeeds.
   • Neutral givers are self-interested, honest about what benefits them, quiet about what doesn't.
   • Good givers are transparent and earnest. GM notes may still include hardship or moral complexity, but there is no manipulation.
   • If alignment is not set on the sheet, the AI infers it from biography, ideals, bonds, and flaws.

4. Genre matching: Quests are written to fit the game system set in the RPGX AI Assistant settings. D&D gets fantasy and political intrigue. Cyberpunk gets corporate espionage and street-level danger. Star Wars gets galactic stakes. The tone is always native to the system.

5. Robust output parsing: The AI response is processed through a multi-strategy parser that handles chain-of-thought bleed, model reasoning text, extra fields, and malformed JSON gracefully. If the model produces multiple attempts, the cleanest one is used automatically.

AI Model Tiers — select based on your hardware:

Custom model names are also supported for advanced users.

Additional AI settings: generation timeout (30–600 seconds), and creativity/temperature (0.5 Structured → 1.5 Wild).

Integration with RPGX AI Assistant

If the RPGX AI Assistant module is also installed, Quest Log integrates with it automatically:

• Shared auth token: Quest Log reads the AI Assistant's Proton token automatically. No duplicate configuration needed.
• Shared game system: The system set in AI Assistant settings (D&D 5e, Pathfinder, Cyberpunk, etc.) is used by Quest Log's AI generation for genre-accurate quests.
• Shared RAG knowledge base: The same world documents, actor biographies, and journal entries are ingested by AI Assistant power Quest Log's world lore context injection.

If Quest Log is installed standalone without AI Assistant, both the token and game system are configured independently in Quest Log's own module settings.

Integration with RPGX Proton

RPGX Proton is the GM's local AI companion desktop application. It manages Ollama (the local AI engine), the RAG knowledge base server, and subscription validation. All running privately on your own machine. No data leaves your computer.

Quest Log connects to Proton in three ways:

HTTP (AI generation and subscription): The module makes authenticated fetch requests to Proton's local server for AI generation (/ollama/generate), world lore search (/search), and subscription validation (/api/subscription). All requests carry a Bearer token validated server-side.

Foundry WebSocket (Proton Bridge): Proton connects to Foundry's existing WebSocket as a client and exchanges quest data in real time. Proton can read all quests, receive live updates when quests change, and push status changes back to the world — without any polling or separate connection infrastructure.

Proton Quest Panel: The Proton desktop app includes a dedicated quest view that mirrors the Foundry Quest Log, letting the GM manage quests from the companion app without switching to the browser.

Security

• Bearer token authentication: Every HTTP request from the Foundry module to the Proton RAG server carries a Authorization: Bearer header. Requests without a valid token are rejected with a 401 before any processing occurs.
• CORS origin allowlisting: The RAG server only accepts browser requests from the GM's configured Foundry URL. No other webpage can reach the server.
• Private Network Access headers: The server sends PNA headers to prevent rogue HTTPS pages from exploiting the local server.
• Timing-safe token comparison: The server uses timingSafeEqual from Node's crypto module to compare tokens, preventing timing-based token guessing attacks.
• Cross-module token sharing: When both RPGX AI Assistant and Quest Log are installed, they share one token automatically. Changing the token in one place updates both.
• GM-only data writes: Only the GM client processes socket messages that modify quest data. Player clients are structurally excluded from write operations regardless of what socket messages they send.
• Subscription validation isolation: Proton detection and subscription status are checked in two independent steps, so a subscription endpoint issue can never make Proton appear offline.

Settings Reference

Links