VaultBBDocs
MyBBAdvanced Dice

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

RequirementMinimum Version
MyBB1.8.0
PHP8.0.0
VaultBB Core1.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.php

Install 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_output MyBB template into the master set
  • Install the vaultbb_advdice.css stylesheet 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.

On this page