Sephral’s Content Backup & Restore
Sephral’s Content Backup & Restore creates, manages, deletes, and reconstructs backups for supported world documents in FoundryVTT.
Discord
Questions, feedback, and module support are welcome on Discord.
Demo
If the embedded preview is not available in your GitHub view, please check the media folder.
Features
- Named backups for scenes, actors, items, journal entries, playlists, macros, roll tables, and cards
- Restore existing documents from a selected backup
- Recovery view for deleted documents when matching backups are available
- Central module interface for backup management and recovery
- Context menu entry on supported documents for quick access
- Client-side interface settings for language and design
- World-scoped backup payload files with a slim metadata index in module settings
Usage
- Enable the module in Foundry.
- Open the context menu on any supported document, or launch
Open SCBRfrom the module settings. - Create, restore, delete, or reconstruct backups from the unified interface.
Storage and migration
- Backup payloads are stored in world data under:
worlds/<world-id>/scbr/<DocumentType>.jsonEach type file contains all backups for that document type. - The world setting
sephrals-content-backup-restore.backupStorestores only backup metadata (index), not full document payloads. - Backup writes are serialized with a world lock so two GMs cannot save conflicting changes at the same time.
- Legacy data is migrated on startup.
