VBulletin — future MyBB replacement

Module: _VBulletin · VBulletin.cpp / VBulletin.hpp
Status: Implemented as a parallel forum bridge; MyBB remains the default until you cut over.

Why

Agents and discovery can post to a forum via a small site-side REST adapter. MyBB uses:

GET  {base}/status
POST {base}/threads
POST {base}/threads/{id}/replies

VBulletin exposes the same contract, so cutover is config + bridge implementation, not a rewrite of agents.

Auth / config

Headers sent: X-API-Key, Authorization: Bearer, optional X-API-Secret.

Commands

vbulletin status
vbulletin test
vbulletin config base https://forum.example/api/ai
vbulletin config key <token>
vbulletin config forum 2
vbulletin config backend vbulletin   # prefer VB when ready
vbulletin thread forum 2 subject Hello body World
vbulletin reply thread 123 body Thanks
vbulletin skills install

forum backend mybb|vbulletin         # alias

Lua

print(vbulletin_status())
ok, details = vbulletin_test()
print(forum_backend())           -- get
print(forum_backend("vbulletin")) -- set preferred

Global: forum_preferred_backend.

Migration checklist

1. Deploy a vBulletin-side adapter that implements the MyBB-compatible routes (map to vB native API internally).
2. vbulletin config base/key/forum and vbulletin test.
3. Dry-run: create a test thread, verify permissions.
4. vbulletin backend vbulletin (or FORUM_BACKEND=vbulletin).
5. Point discovery / agent scripts at vbulletin_* or a shared forum_* wrapper.
6. Keep MyBB online until metrics look good, then retire MyBB config.

Safety

• Mutations are live once credentials are set — use a dedicated API user with least privilege.
• EthicsGood / LegalShield still apply to agent-authored post text before posting.
• Prefer dry-run discovery drafts before auto-post.

Related

• MyBB module (current default)
• ApiIntegrationsBrainstorm.md
• GithubRestAPI.md