Get Loremaster

How It Works

Get Started with Loremaster

From installation to your first AI-enhanced session, here's everything you need to know.

Get Loremaster

Step 1: Quick Start (Hosted)

1

The Easy Path

The hosted version is the simplest way to get started. No server setup, no API keys to manage — just subscribe and play.

Recommended for Most Users

A. Get Foundry VTT Hosting

If you don't already have Foundry VTT, we recommend The Forge — a fully managed hosting service that handles everything for you. Alternatively, you can run your own Foundry VTT server.

B. Join Our Patreon

Subscribe to Loremaster on Patreon to get access to the hosted proxy server. Choose a tier based on your usage:

  • Basic ($5/mo): 500K tokens — casual play, 1-2 sessions/month
  • Pro ($15/mo): 2M tokens — regular weekly sessions
  • Premium ($30/mo): 5M tokens — professional GMs

Once subscribed, you'll receive the hosted server URL in the Patreon welcome message.

C. Install the Module

  1. In Foundry VTT, go to Add-on Modules → Install Module
  2. Paste this manifest URL:
https://github.com/digitsu/loremaster-foundry/releases/latest/download/module.json
  1. Click Install, then enable the module in your world

D. Configure the Module

  1. Open Module Settings → Loremaster
  2. Enter the Proxy Server URL from your Patreon welcome message:

Example (WebSocket URL):

wss://proxy.loremastervtt.com
  1. Enter your Patreon email for authentication
  2. That's it! You're ready to play.

Alternative: Self-Hosted Setup

⚙

Run Your Own Proxy Server

For users who want full control or unlimited usage, you can self-host the proxy server with a one-time license purchase.

Requirements

Module Installation Options

Git Clone (For Developers)

Navigate to your Foundry modules directory and clone:

git clone https://github.com/digitsu/loremaster-foundry.git loremaster

Module paths by platform:

  • Windows: %LOCALAPPDATA%\FoundryVTT\Data\modules
  • macOS: ~/Library/Application Support/FoundryVTT/Data/modules
  • Linux: ~/.local/share/FoundryVTT/Data/modules
Manual Download
  1. Download from GitHub Releases
  2. Extract to your Foundry Data/modules/loremaster directory
  3. Restart Foundry VTT and enable the module

Module Settings

  1. Enter your self-hosted proxy URL (e.g., wss://localhost:3000)
  2. Enter your Claude API Key
  3. Enter your License Key from Gumroad

See the GitHub repository for detailed self-hosting documentation.

Step 2: Basic Usage

2

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 3: Advanced Features

3

Level Up Your Sessions

Once you're comfortable with basic chat, explore Loremaster's advanced capabilities.

Upload Adventure PDFs

  1. Open Loremaster's Content Manager from the scene controls
  2. Click Upload PDF
  3. Select your adventure PDF and choose a category
  4. Wait for processing (usually under a minute)
  5. Select the adventure as "Active" to focus the AI

Generate GM Prep Scripts

  1. Upload an adventure PDF
  2. Click Generate Prep Script
  3. Wait 1-2 minutes for generation
  4. Find the script in your Foundry journals
  5. Edit and customize as needed

Manage House Rules

When the AI flags a rules discrepancy:

  1. Review both interpretations (PDF vs Foundry)
  2. Choose your ruling
  3. Select whether it's session-only or persistent
  4. 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.

Ready to Get Started?

Get Loremaster and transform your tabletop sessions.

Get Loremaster