How It Works
Get Started with Loremaster
From installation to your first AI-enhanced session, here's everything you need to know.
Step 1: Installation
Install the Foundry Module
Loremaster is installed like any other Foundry VTT module. You can install it directly from the manifest URL or through the Foundry module browser.
Manifest URL:
https://your-manifest-url/module.json Installation Steps
- Open Foundry VTT and go to Add-on Modules
- Click Install Module
- Paste the manifest URL and click Install
- Enable the module in your world's module settings
Step 2: Configure Proxy Server
Connect to the Proxy Server
Loremaster uses a proxy server to communicate with Claude's API. This keeps your API key secure and handles the conversation management.
Proxy Options
Module Settings
- Open Foundry's Module Settings
- Find Loremaster in the settings list
- Enter the Proxy Server URL
- Enter your Claude API Key
- Configure other preferences (response visibility, batching mode, etc.)
Step 3: Basic Usage
Start Chatting
Once configured, using Loremaster is as simple as typing in Foundry's chat.
Chat Commands
@lm The party enters the ancient ruins. What do they see? Send a public message to Loremaster
@lm! What's the guard captain's secret motivation? Private GM chat - only you see the response
[GM RULING: The door is magically sealed] Override AI with your ruling
Message Batching
When multiple players send messages, Loremaster can collect them before responding:
- Timer Mode: Automatically waits for configured duration
- Manual Mode: GM sends keyword (default: "send") to trigger response
Step 4: Advanced Features
Level Up Your Sessions
Once you're comfortable with basic chat, explore Loremaster's advanced capabilities.
Upload Adventure PDFs
- Open Loremaster's Content Manager from the scene controls
- Click Upload PDF
- Select your adventure PDF and choose a category
- Wait for processing (usually under a minute)
- Select the adventure as "Active" to focus the AI
Generate GM Prep Scripts
- Upload an adventure PDF
- Click Generate Prep Script
- Wait 1-2 minutes for generation
- Find the script in your Foundry journals
- Edit and customize as needed
Manage House Rules
When the AI flags a rules discrepancy:
- Review both interpretations (PDF vs Foundry)
- Choose your ruling
- Select whether it's session-only or persistent
- The ruling is saved to a journal entry
Monitor Usage
Open the Usage Monitor to track:
- Total tokens used (all-time and session)
- Breakdown by feature type
- Prompt caching efficiency
- Progress toward your monthly limit
Tips for Success
Be Specific
The more context you give, the better the AI responds. "The rogue searches the desk" works better than just "search".
Use Private Mode
Use @lm! to brainstorm or ask questions without players seeing. Great for improvising.
Embrace Iteration
Don't settle for the first response. Use Iterate to refine until you get exactly what you want.
Set House Rules Early
When you notice a discrepancy, set a persistent house rule immediately. Consistency builds trust.
Upload Core Rules
Upload your system's core rulebook for better mechanical accuracy, not just adventures.
Monitor Usage
Check the usage monitor occasionally. Prompt caching can save significant tokens over time.