Installation & Setup

VaultBB Core is the foundational framework required by all VaultBB premium plugins. It must be installed and activated before any other VaultBB plugin.

Requirements

Requirement	Minimum Version
MyBB	1.8.0
PHP	8.0.0
MySQL / MariaDB	Any version supported by MyBB 1.8
PHP extension	`curl` (required for the Update Checker)

VaultBB Core requires PHP 8.0 or newer. Attempting to install on an older PHP version will produce an environment assertion error and abort gracefully.

Installing VaultBB Core

Upload the files

Extract the release .zip and upload the contents of the UPLOAD/ folder to your MyBB root directory, preserving the directory structure.

UPLOAD/
├── admin/
│   └── modules/
│       └── vaultbb/          ← VaultBB admin tab
└── inc/
    ├── languages/
    │   └── english/
    │       └── admin/
    │           └── vaultbb_core.lang.php
    └── plugins/
        ├── vaultbb_core.php  ← Main plugin file
        └── vaultbb_core/     ← Framework classes

No files should overwrite existing MyBB core files. If your FTP client asks to confirm any overwrites, stop and double-check the paths.

Install the plugin

In your MyBB Admin Control Panel, navigate to:

Admin CP → Configuration → Plugins

Find VaultBB Core in the list and click Install & Activate.

During installation, Core will:

Create the vaultbb_logs database table
Create the vaultbb_plugins database table
Register its own settings group (VaultBB Core) under Configuration → Settings
Add a scheduled task (VaultBB Core: Log Cleanup) that runs daily at 03:00
Register itself in the plugin registry

Verify the VaultBB tab appears

After activation, a new VaultBB tab will appear in the Admin CP top navigation bar. Click it to open the Dashboard — you should see the system overview card with your PHP and MyBB versions, and a health check confirming both database tables are present.

Database Tables Created

VaultBB Core creates two tables on install:

`vaultbb_logs`

Stores all activity and error logs generated by Core and every VaultBB plugin.

Column	Type	Description
`id`	`BIGINT UNSIGNED`	Auto-increment primary key
`dateline`	`INT UNSIGNED`	Unix timestamp of the log entry
`uid`	`INT UNSIGNED`	MyBB user ID (0 = system/anonymous)
`plugin`	`VARCHAR(64)`	Plugin identifier (e.g. `advdice`)
`action`	`VARCHAR(64)`	Action identifier (e.g. `plugin_activated`)
`severity`	`ENUM`	`info`, `warning`, or `error`
`ipaddress`	`VARBINARY(16)`	IP address of the actor
`data`	`MEDIUMTEXT`	JSON-encoded contextual payload

`vaultbb_plugins`

The central plugin registry — tracks all installed VaultBB plugins.

Column	Type	Description
`id`	`INT UNSIGNED`	Auto-increment primary key
`codename`	`VARCHAR(120)`	Unique plugin identifier
`title`	`VARCHAR(120)`	Human-readable plugin name
`version`	`VARCHAR(32)`	Currently installed version
`core_min`	`VARCHAR(32)`	Minimum Core version required
`active`	`TINYINT(1)`	Whether the plugin is currently active
`installed_dateline`	`INT UNSIGNED`	When the plugin was first registered
`updated_dateline`	`INT UNSIGNED`	When the registry entry was last updated
`last_seen`	`INT UNSIGNED`	Last time the plugin was active at runtime
`data`	`MEDIUMTEXT`	JSON-encoded optional plugin metadata

Scheduled Task

Core installs a daily cleanup task named VaultBB Core: Log Cleanup. It runs at 03:00 every day and deletes log entries older than the configured retention period (default: 90 days).

You can view or adjust the task schedule under Admin CP → Tools & Maintenance → Task Manager.

Updating VaultBB Core

To update to a newer version:

Upload the new UPLOAD/ contents, overwriting existing VaultBB Core files.
In the Admin CP plugins list, deactivate then reactivate VaultBB Core.
Core will automatically run any pending schema upgrades (e.g. adding new columns) via Core::runUpgradesIfNeeded(), which fires on every global_start hook.

You do not need to uninstall to update. Your logs, settings, and plugin registry entries are preserved across deactivate/activate cycles. Only an explicit Uninstall removes the database tables.

Uninstalling VaultBB Core

Uninstalling VaultBB Core will drop the vaultbb_logs and vaultbb_plugins tables, removing all log history and plugin registry data permanently. Deactivate all dependent VaultBB plugins first.

In the Admin CP plugins list, click Uninstall next to VaultBB Core. This will:

Drop vaultbb_logs and vaultbb_plugins
Remove all VaultBB Core settings and settings group
Remove the cleanup scheduled task
Remove Update Checker internal settings

Installation & Setup

On this page