Configuration & Settings
All configurable settings for VaultBB Advanced Dice Rolls.
Configuration & Settings
Settings are available at Admin CP → Configuration → Settings → VaultBB Advanced Dice Rolls, or via the Settings tab inside VaultBB → Advanced Dice → Settings.
Settings Reference
Enable Dice Rolls
| Property | Value |
|---|---|
| Setting name | vaultbb_advdice_enabled |
| Type | Yes / No |
| Default | Yes |
Master switch for the entire dice system. When disabled, no dice tags are processed on post insert and no roll blocks are rendered on the postbit — even if rolls exist in the database.
Max Rolls Per Post
| Property | Value |
|---|---|
| Setting name | vaultbb_advdice_max_per_post |
| Type | Numeric |
| Default | 10 |
Maximum number of [dice] tags that will be processed in a single post or thread opener. Tags beyond the limit are silently ignored. The minimum enforced value is 1 — setting this to 0 is treated as 1 internally.
Strip Dice Tags From Posts
| Property | Value |
|---|---|
| Setting name | vaultbb_advdice_strip_tags |
| Type | Yes / No |
| Default | Yes |
When enabled, [dice]...[/dice] tags are removed from the stored post body before saving. Roll output is rendered dynamically at display time from the vaultbb_advdice_rolls table. This is the recommended setting — it keeps the stored post clean and ensures results are always read from the permanent roll record.
Tags are always stripped from the saved message during insert regardless of this setting, because roll results are stored separately and rendered at display time. This setting is reserved for edge-case compatibility.
Edits With Dice Tags
| Property | Value |
|---|---|
| Setting name | vaultbb_advdice_edit_mode |
| Type | Select |
| Options | block, strip, allow |
| Default | block |
Controls what happens when a user edits a post and includes [dice] tags in the edited message:
| Option | Behaviour |
|---|---|
| Block Edit | Returns a validation error — the edit is rejected and the user is told dice tags cannot be used when editing |
| Strip Tags | Dice tags are silently removed from the edited message; no new rolls are created |
| Allow (Re-roll) | Dice tags are processed normally, creating new rolls — not recommended as it allows result manipulation |
The Block Edit default is intentional. Dice rolls are meant to be immutable records. Allowing re-rolls on edit would undermine the integrity of the roll history.
GM Usergroup IDs
| Property | Value |
|---|---|
| Setting name | vaultbb_advdice_gm_groups |
| Type | Text |
| Default | (empty) |
A comma-separated list of MyBB usergroup IDs that can view hidden rolls in addition to admins and super moderators. For example: 5,12,18.
Users who can view hidden rolls:
- The user who made the roll (always)
- Administrators (
cancppermission) - Super moderators (
canmodcppermission) - Any user whose primary or additional group matches a GM group ID listed here
Leave blank to restrict hidden roll visibility to the roller and staff only.