Skip to content

Moving rosters between servers

Rosters can be exported as a file and imported into another server running BooM BoT — useful for families with separate planning and main servers, or for migrating servers wholesale.

Exporting

On the roster dashboard, Tools → Export produces a JSON file of a finalized month's rosters. The file embeds each account's Discord owner and display name, so ownership survives the trip even if the destination server has never seen the account.

Importing

On the destination server, run /roster import (admin) with the file and the month. The import lands as resumable saved progress, not a published roster: open /roster dashboard, hit Build, and resume to review everything before submitting. Nothing goes public without the usual pipeline.

Accounts are re-resolved against the destination server's own registry; where the registry doesn't know an account, the ownership embedded in the file is used as a fallback.

Order of operations

Do these on the destination server before importing, or accounts arrive unlinked:

  1. Link the clans (/link dashboard → Clans).
  2. Populate the registry — let the poller discover members, or run a bulk import.
  3. Then /roster import.

Note

Export/import moves rosters. It does not move signups, configuration, or flag history.