Why is this skill necessary for Foundry VTT developers?

Foundry V13 introduced significant API changes by moving globals into namespaces, and V15 will remove those globals entirely. This skill provides the boilerplate code to handle these transitions smoothly.

What is the 'modern-first' fallback pattern?

It is a coding pattern that attempts to access the newest namespaced API first (using nullish coalescing) and only falls back to legacy globals if the modern path is undefined.

Will this code work in Foundry V15?

Yes, the implementation logic is designed specifically to prevent breakage when legacy globals are removed in Foundry V15 by prioritizing namespaced access.

Does this skill help with sheet registration?

Yes, it includes specific patterns for registering Actor and Item sheets that work with both the legacy collection-based registration and the newer DocumentSheetConfig API.

Foundry VTT Version Compatibility

Name: Foundry VTT Version Compatibility
Author: ImproperSubset

byImproperSubset

Desarrollo de Videojuegos

Standardizes API migration patterns to ensure Foundry VTT modules remain functional across V12, V13, and V15+ releases.

Acerca de

The fvtt-version-compat skill provides specialized guidance for Foundry Virtual Tabletop (VTT) developers navigating the platform's transition from global variables to namespaced APIs. It implements a 'modern-first' fallback pattern that allows modules to support legacy V11/V12 environments while remaining compatible with V13's namespacing and V15's total removal of globals. This skill is essential for maintaining cross-version support for sheet registration, template loading, and document enrichment without triggering deprecation warnings or breaking on newer releases.

Características Principales

Namespaced HTML enrichment for journal and document content
Compatible Handlebars template loading and rendering
0 GitHub stars
Modern-first fallback patterns for Foundry namespaces
Future-proof utility resolution for randomID and core globals
Cross-version Actor and Item sheet registration wrappers

Casos de Uso

Upgrading legacy Foundry VTT modules to support V13 and V15 versions
Maintaining a single codebase that functions across multiple Foundry VTT environments
Refactoring global API calls to eliminate deprecation warnings in the console

Acerca de

Características Principales

Namespaced HTML enrichment for journal and document content
Compatible Handlebars template loading and rendering
0 GitHub stars
Modern-first fallback patterns for Foundry namespaces
Future-proof utility resolution for randomID and core globals
Cross-version Actor and Item sheet registration wrappers

Casos de Uso

Upgrading legacy Foundry VTT modules to support V13 and V15 versions
Maintaining a single codebase that functions across multiple Foundry VTT environments
Refactoring global API calls to eliminate deprecation warnings in the console