Commands and permissions

The main command is /migrate; /mg is its alias. Without arguments, players see the management menu and the console sees command help.

Commands #

CommandPermissionPurpose
/migrate helpmigrate.helpShows the command list.
/migrate scanmigrate.scanDetects supported plugins and data and suggests routes.
/migrate adaptersmigrate.scanLists adapters, domains and rollback support.
/migrate compatibilitymigrate.compatibilityShows platform, Java and plugin compatibility.
/migrate diagnosticsmigrate.adminWrites a redacted support report.
/migrate prepare <source> <target> <domain>migrate.prepareBuilds a migration plan without writing.
/migrate dryrun <id>migrate.prepareValidates a plan without writing.
/migrate conflicts <id>migrate.historyLists conflicts and active policies.
/migrate resolve <id> <conflict> <policy> [record]migrate.prepareSelects a conflict policy.
/migrate start <id>migrate.executeRequests a real run and shows the confirmation scope.
/migrate confirm <id>migrate.executeConfirms and starts the requested run.
/migrate status <id>migrate.historyShows progress and the next action.
/migrate inspect <id>migrate.historyShows counters and the migration event log.
/migrate cancel <id>migrate.executeCancels a pending run or pauses a running one.
/migrate resume <id>migrate.executeContinues an interrupted, paused or failed run.
/migrate rollback <id> [confirm]migrate.rollbackReviews and then undoes records written by a migration.
/migrate historymigrate.historyLists recent migrations.
/migrate backups [id]migrate.backupsLists backups or verifies one and its checksums.
/migrate language [locale]migrate.languageShows or changes the active language.
/migrate reloadmigrate.adminValidates and reloads configuration and language files.

A migration that has written records cannot be cancelled; use rollback instead. Reload is refused while a migration runs, and invalid new configuration is not applied.

Permissions #

All permissions default to server operators. migrate.admin contains every permission below, including reload access.

  • migrate.help
  • migrate.gui
  • migrate.scan
  • migrate.prepare
  • migrate.execute
  • migrate.rollback
  • migrate.history
  • migrate.backups
  • migrate.compatibility
  • migrate.language

migrate.execute and migrate.rollback change target data and should be granted only to trusted administrators.