foundry-vtt

What problem does it solve?

Foundry VTT development and deployment is highly fragmented, with scattered documentation for module building, system extension, testing, and self-hosted infrastructure setup, forcing developers and tabletop operators to waste time searching for consistent, up-to-date guidance.

Core Features & Use Cases

• Module & System Development: Complete guidance for building Foundry modules and game systems using ApplicationV2, TypeDataModel schemas, Handlebars/Svelte templates, and the hooks event system, plus integration with dev tools like Vite, TypeScript, and libWrapper.
• Infrastructure Deployment: Step-by-step instructions for deploying Foundry VTT via Docker, Helm charts, or raw Kubernetes/K3s manifests, including Traefik ingress configuration for WebSocket support and persistent storage setup with Rook-Ceph.
• Testing & CI/CD: Patterns for in-Foundry Quench testing and external Jest/Vitest unit tests, plus GitHub Actions pipeline examples for automated module building, linting, and distribution.
• System Extension: Dedicated reference for extending the WFRP4e game system with custom species, effects triggers, and config overrides. Use Case: A TTRPG developer building a custom WFRP4e module can use this skill to access the exact API references for effect triggers, generate a valid module.json manifest, and deploy the final add-on to a K3s cluster with a single Helm command.

Quick Start

Use the foundry-vtt skill to build a custom Foundry VTT module with ApplicationV2 actor sheets and deploy it to your K3s cluster via Helm with Traefik WebSocket ingress.