Importing Data

Import existing bans from other plugins

Plugin Compatibility

Plugin Bans IP Bans Mutes UUID Support SQLite/H2 MySQL
LiteBans Full Support H2
AdvancedBan Full Support*
BanManager v5-7 Full Support* H2
MaxBans Name→UUID SQLite

* Staff UUID not stored, visual inconsistencies may occur if staff names changed before import

Configuration Guide

Config Example

import:
  from: vanilla
  sqlite: true
  sqlite_file: plugins/MaxBans/bans.db
  import_ipbans: true
  import_mysql_address: localhost:3306
  import_mysql_database: maxbans
  import_mysql_username: ''
  import_mysql_password: ''
  import_table_prefix: default

Quick Steps

  1. Configure import section in config.yml
  2. Set correct plugin name in 'from:'
  3. Configure database settings
  4. Run /litebans import start

Important Notes

  • Imports run asynchronously in background
  • UUIDs fetched automatically in online-mode
  • All bans import with default server scope
  • Original plugin should be unloaded during import

Plugin-Specific Steps

Vanilla: Just run import start

AdvancedBan: Set MySQL details first

BanManager: Verify correct version

MaxBans: Check SQLite file path

Common Issues

Database in Use Error

Remove original plugin before import

Wrong Credentials

Verify database settings in config.yml