This package contains art, text, or software code produced using generative AI.
Smart Chat AI integrates OpenAI's language models into Foundry VTT to assist with real-time content generation, rules lookups, and game support, enhancing human creativity rather than replacing it.
Smart Chat AI
Bring AI to your Foundry VTT table with powerful OpenAI integration. Whether you prefer simple Chat Completions or sophisticated Assistants with custom knowledge bases, this module adapts to your needs.
Usage Examples
Public Questions (Visible to Everyone)
/? what's the cost of standing up from prone?
Response: Standing up from prone costs half of your movement speed.
Private Whispers (DM & Sender Only)
/w [gpt, gm] time to don and doff armor
Response: According to the rules in the Player's Handbook, donning and doffing armor takes:
| Armor Type | Donning Time | Doffing Time |
| Light Armor | 1 minute | 1 minute |
| Medium Armor | 5 minutes | 1 minute |
| Heavy Armor | 10 minutes | 5 minutes |
| Shield | 1 action | 1 action |
Quick Start
1. Get your API key from [OpenAI](https://platform.openai.com/account/api-keys)
2. Install the module using: https://github.com/marccosta12/foundryvtt_SmartChatAI/releases/latest/download/module.json
3. Configure settings with your API key and preferred AI engine
4. Start asking! Use `/?` or `/w gpt` in chat
How It Works
The module intercepts `/?` and `/w gpt` commands in Foundry VTT chat and sends them to your chosen OpenAI API. Responses are formatted with proper Markdown support and integrated into your game's chat log.
Your custom prompts determine how the AI behaves—whether it acts as a knowledgeable GM assistant, rules adjudicator, or creative inspiration engine. The AI understands rulesets for popular game systems but always benefits from additional context in custom prompts.