Installation & Setup
How to install VaultBB Advanced Dice Rolls on your MyBB 1.8.x forum.
Installation & Setup
VaultBB Advanced Dice Rolls is a premium dice engine for MyBB that stores roll results permanently, supports hidden rolls, conditional rendering, profiles, drop/keep notation, and roll labels.
Requirements
| Requirement | Minimum Version |
|---|---|
| MyBB | 1.8.0 |
| PHP | 8.0.0 |
| VaultBB Core | 1.0.1 |
VaultBB Core must be installed and activated before you attempt to install or activate Advanced Dice. The plugin performs a hard dependency check and will abort with a clear error page if Core is missing or too old.
Installing Advanced Dice
Upload the files
Extract the release .zip and upload the contents of UPLOAD/ to your MyBB root, preserving the directory structure:
UPLOAD/
├── admin/
│ └── modules/
│ └── vaultbb/
│ ├── advdice.php
│ ├── advdice_profiles.php
│ ├── advdice_rules.php
│ └── advdice_settings.php
└── inc/
├── languages/
│ └── english/
│ ├── admin/
│ │ └── vaultbb_advdice.lang.php
│ └── vaultbb_advdice.lang.php
└── plugins/
├── vaultbb_advdice.php
└── vaultbb_advdice/
├── bootstrap.php
├── vaultbb_advdice.css
└── class/
├── DB.php
├── Engine.php
├── Hooks.php
├── Parser.php
├── Renderer.php
├── RuleEngine.php
└── SafeHtml.phpInstall the plugin
In the Admin CP, go to Configuration → Plugins, find VaultBB Advanced Dice Rolls, and click Install & Activate.
During installation, the plugin will:
- Create three database tables:
vaultbb_advdice_rolls,vaultbb_advdice_profiles,vaultbb_advdice_rules - Register a settings group (
VaultBB Advanced Dice Rolls) under Configuration → Settings - Install the
vaultbb_dice_roll_outputMyBB template into the master set - Install the
vaultbb_advdice.cssstylesheet into all active themes - Create a VaultBB Advanced Dice section in the forum Help Documents with four articles
- Register itself with VaultBB Core's plugin registry
Verify the admin tab entry
After activation, the VaultBB admin tab gains a new Advanced Dice submenu entry with three sub-pages: Overview, Profiles, and Settings. A healthy install shows recent roll stats on the Overview page immediately — although, you can only expect values equal to 0 for now.
Uninstalling
Click Uninstall in the plugins list. This drops all three tables, removes settings, deletes the MyBB template, removes the stylesheet from all themes, and removes the Help Documents section. The VaultBB Core registry entry for Advanced Dice is also removed.
Uninstalling permanently deletes all stored rolls, profiles, and rules. There is no built-in export — back up the three tables before uninstalling if you need to preserve the data.