Alluria - Tablekeeper

Alluria - Tablekeeper is a lightweight storage, sync, and preference helper extension for Fantasy Grounds Unity.

It was built as shared infrastructure for Alluria extensions that need to save user preferences, campaign settings, presets, or small pieces of extension data without writing those values into the campaign database.

What Tablekeeper Does

Fantasy Grounds extensions often need somewhere to save settings. One option is to write those settings into the campaign db.xml, but that can leave behind old extension data, abandoned keys, test values, or settings from extensions that are no longer being used.

Tablekeeper provides an alternative.

It stores extension settings in a sidecar file outside the campaign database, helping keep db.xml cleaner while still allowing settings and presets to persist between sessions.

It supports per-user settings, campaign-level settings, namespaced keys, typed values, grouped storage, and blob/table-style preset data.

It also includes host/player sync support, allowing player-side setting changes to be sent to the host and stored safely.

In order for Tablekeeper to operate correctly, it will require you to create a folder for it manually inside your campaign folder. When appropriate, Tablekeeper will open an instruction box. Follow those instructions and Tablekeeper will work forevermore. This only needs to be done once per campaign and you should never again need to interact with Tablekeeper directly.

Main Features

• Sidecar storage outside db.xml

• Cleaner extension setting storage

• Per-user extension settings

• Campaign/global settings

• Namespaced key/value storage

• Typed values

• Grouped storage format

• Blob/table-style preset storage

• Host-side persistence

• Player-to-host OOB setting writes

• Player sync cache support

• Consumer API for other extensions

• Storage check commands for troubleshooting

Designed for Extension Support

Tablekeeper is mostly intended as an infrastructure extension rather than a player-facing gameplay tool.

Other extensions can use it to store preferences and settings in a consistent way. For example, Resource Ledger can use Tablekeeper for saved configuration and preset support.

Safety

Tablekeeper deliberately avoids writing extension settings into the campaign db.xml.

It does not modify character sheets, NPCs, Combat Tracker entries, effects, maps, tokens, items, modules, or ruleset data.

Compatibility

Tablekeeper is built and tested for the 3.5E / PFRPG ruleset family.

It is designed to be broadly ruleset-agnostic as a storage helper, but official compatibility should only be assumed for the rulesets listed by the release.

Notes

This is an unofficial community extension for Fantasy Grounds Unity. It is not affiliated with SmiteWorks or Fantasy Grounds.

As with any extension, please back up your campaign before installing or updating.