How do I avoid performance issues with large data in Foundry VTT?

For datasets larger than 100KB, store the data in an external JSON file using the FilePicker API and save a reference to the file path in a flag or setting rather than the data itself.

What is the correct way to update multiple flags at once?

Instead of calling setFlag() multiple times, use the document.update() method with nested flag keys (e.g., 'flags.my-module.key') to perform a single database write.

Why is namespacing important for Foundry VTT flags?

Namespacing prevents data collisions between different modules. Always use your unique module ID as the scope when setting or getting flags to ensure data integrity.

When should I use Flags instead of Settings in Foundry VTT?

Use Flags for data attached to a specific document (like an Actor, Item, or Scene) that needs to travel with that document. Use Settings for global module configuration or per-client UI preferences.

Foundry VTT Data Storage

Name: Foundry VTT Data Storage
Author: ImproperSubset

byImproperSubset

Desarrollo de Videojuegos

Optimizes data management strategy in Foundry VTT using standardized patterns for flags, settings, and file storage.

Acerca de

The fvtt-data-storage skill provides specialized guidance for developers building modules and systems on the Foundry Virtual Tabletop platform. It streamlines the decision-making process between using Document Flags for actor-specific data, Module Settings for global configurations, and external Files for large datasets. By enforcing best practices like proper namespacing, batch updates via document.update(), and efficient lazy-loading patterns, this skill helps developers avoid common performance bottlenecks and database corruption issues while ensuring cross-version compatibility.

Características Principales

High-performance batch update techniques for document flags
Data migration workflows for module schema updates
Decision matrix for selecting Flags, Settings, or File storage
0 GitHub stars
Namespacing patterns to prevent module data collisions
Complex settings registration with FormApplication menus

Casos de Uso

Creating persistent GM configuration menus for module behavior
Implementing custom character sheet attributes via Actor flags
Offloading large datasets to external JSON files to maintain VTT performance

Acerca de

Características Principales

High-performance batch update techniques for document flags
Data migration workflows for module schema updates
Decision matrix for selecting Flags, Settings, or File storage
0 GitHub stars
Namespacing patterns to prevent module data collisions
Complex settings registration with FormApplication menus

Casos de Uso

Creating persistent GM configuration menus for module behavior
Implementing custom character sheet attributes via Actor flags
Offloading large datasets to external JSON files to maintain VTT performance