Source Toggles and Monster Filtering

Dice Monster uses source-aware queries so players only see content from allowed owners.

How Sources Work

A source is an owner identity for content (for example, a specific user or system content).

Source identity stays stable as the source owner id, and UI metadata is layered on top:

• displayName: label shown in source pickers and toggles
• abbreviation: short label for chips/badges
• toggleKey: stable key used to persist on/off source toggle state

Book metadata is stored in the database (content_source_metadata) so labels can be managed without app code changes.

Naming rules:

• book/system sources use their configured book metadata (for example WotC SRD, TOB3)
• user sources use the pattern UserName's Homebrew and abbreviation H

Allowed sources are combined from:

• your own account
• explicitly granted access entries
• system content sources

These source filters are applied server-side when searching monsters, spells, powers, and other compendium content.

Source Controls in Practice

The monster search Filters dialog includes a Content Sources multiselect. It shows the names of sources available to your account while saving their stable source IDs.

• applying a non-empty selection narrows results and saves it as your account default
• clearing the selection shows all content allowed for your account and clears the saved default
• a source selection in a shared or bookmarked URL takes precedence over the saved default
• sources you can no longer access are ignored when a saved default is applied

Admin and management screens keep using their owner/user source filters. Admin all-source and owner filters are not changed by account defaults.

Monster Filtering

Monster browsing supports both source filtering and attribute filters.

Available monster filters include:

• name search
• CR range
• HP range
• AC range
• creature type
• creature size
• alignment
• role
• special flags (for example legendary/lair/villain/mythic markers)

Access Management

Admin access management can grant or revoke source visibility between users.

This directly affects what appears in filtered queries for monsters and compendium content.

Utility powers from The Talent and Psionics appear on monster statblocks only while the account has explicit access to the TAP source. The server removes this field from search and detail responses when that access is absent, including for copied monsters.

Admins can still fetch and edit individual compendium entries by direct link even when the source would not normally be visible through a non-admin source filter.

Persistence Notes

Monster source defaults are saved per account. An empty saved selection retains the standard behavior of searching every source currently available to the account.

Source filtering remains enforced by server-side access checks. Saving a source does not preserve access to it, so revoked or removed sources are safely omitted the next time the default is applied.

Per-campaign source defaults are not currently supported.