fvtt-performance-safe-updates

What problem does it solve?

Foundry VTT module development often suffers from update storms and unnecessary re-renders when multiple clients sync changes across sessions. This skill provides a structured pattern to guard updates, batch changes, and let Foundry handle renders to keep all clients in sync.

Core Features & Use Cases

• Ownership guards to ensure only authorized users perform updates on shared documents.
• No-op detection and batched updates to minimize database writes and UI churn.
• Queueing updates with a dedicated wrapper to prevent race conditions in multi-client environments.
• Atomic embedded document updates to avoid delete+create flicker when replacing items or abilities.
• Guard rerenders to refresh only owned or visible sheets without causing spurious redraws.

Quick Start

Use this skill when updating documents in a Foundry VTT module, e.g., update an actor's item or swap an embedded document, and rely on queueUpdate for safe persistence.