UnKenny: A FoundryVTT Module That Infuses AI Soul into Tabletop Role-Playing Games

UnKenny is an open-source Foundry Virtual Tabletop (FoundryVTT) module. By integrating large language models (LLMs), it endows non-player characters (NPCs) in games with real-time intelligent dialogue capabilities, solving the energy consumption problem of Game Masters (GMs) playing multiple NPCs simultaneously and creating a more immersive tabletop role-playing game (TTRPG) interactive experience.

UnKenny originated from the needs of developer Simon when hosting Starfinder games—traditional preset dialogues could not meet dynamic interaction scenarios. FoundryVTT's modular architecture provided the foundation for its expansion. The project name "UnKenny" implies the "unbelievable" experience brought by AI: NPCs' intelligent responses that break through preset scripts.

Multi-Model Support and Flexible Configuration

Supports models such as OpenAI GPT series and Google Gemini; users can choose according to their needs (GPT has strong capabilities but is paid, while Gemini has free options). Global and role-level configurations are flexible—parameters like temperature and repetition penalty can be adjusted to fit the character's personality.

Character Personalization and Context Management

Define identity, personality, etc. through "character preface" to ensure AI responses align with the settings; use @alias to trigger NPC interactions; automatically manage dialogue history and support cleaning to handle model context window limitations.

API Key Risks

Requires configuration of OpenAI/Gemini API keys, which carries the risk of being stolen by malicious modules. It is recommended to regularly check key usage and install modules cautiously.

Local Deployment Options

Supports connecting to local/self-hosted models compatible with OpenAI API format (e.g., Llama, Mistral), with data retained in the user-controlled environment; remote access requires exposing endpoints and configuring key protection.

Developed based on JavaScript (FoundryVTT's standard language), but the maintainer's preferred stack is not JavaScript. The project is currently "more or less unmaintained" and is looking for someone to take over. Emphasizes the importance of test coverage—the codebase includes a Foundry simulation implementation for isolation testing, and contributors need to ensure features have test coverage.

Reduce GM Burden

Allows GMs to focus on plot progression while AI handles NPC dialogues, improving efficiency and response diversity.

Create Unexpected Surprises

Unpredictable responses generated by AI become memorable moments in the game, supporting open and free role-playing.

AI Learning and Practice Platform

Intuitively understand LLM concepts by adjusting model parameters; open-source code provides references for API integration.

Technical Enhancement Directions

Multimodality (image understanding, speech synthesis), character relationship network management, etc.

Community-Driven Evolution

Expect new maintainers to take over and adapt to FoundryVTT updates; supports multi-language expansion (currently English and German—just add localization files).

UnKenny is an innovative attempt to integrate AI with TTRPG, infusing new vitality into the classic game form. Although it faces maintenance challenges, its open-source nature allows the community to continue its development. For FoundryVTT users, it makes NPCs "come alive", reduces GM burden, and enhances immersion. In the future, we can expect to see more AI applications in the creative entertainment field.