Migration guide

From CMI to NexoraSMP

CMI + addons One JAR

CMI is a great plugin. It's also paid, has 200+ commands you'll never touch, and bundles a UI system most SMPs don't need. NexoraSMP is the lighter swap focused on what SMP servers actually use, with a real web dashboard instead of in-game GUIs.

Back up first. Copy plugins/CMI/, your worlds, and your database. CMI's data is yours either way, but the import only goes one direction.

When CMI → NexoraSMP makes sense

When CMI → NexoraSMP doesn't make sense

Command mapping

CMI namespaces most things under /cmi <sub> with shorter aliases. NexoraSMP uses the short forms directly.

CMINexoraSMPNote
/cmi sethome/sethomeIdentical
/cmi home, /home/homeLimit set in config
/cmi tpa/tpaIdentical
/cmi spawn/spawnIdentical
/cmi warp, /warp/warpIdentical
/cmi back, /back/backIdentical
/cmi afk, /afk/afkIdentical
/cmi kit, /kit/kitDefined in modules/kits.yml
/cmi vanish, /vanish, /v/vanishStaff only
/cmi invsee/invseeIdentical
/cmi enderchest, /echest/echestIdentical
/cmi freeze/freezeIdentical
/cmi mute, /mute/muteHistory stored in DB
/cmi ban, /ban/ban, /tempbanReplaces CMI bans
/cmi kick/kickIdentical
/cmi warn/warnAuto-escalation in config
/cmi msg, /msg, /tell/msg, /tellIdentical
/cmi seen, /seen/seenIdentical
/cmi gamemode, /gm/gm0..3, /gmc, /gmsIdentical
/cmi fly, /fly/flyIdentical
/cmi god/godIdentical
/cmi heal, /cmi feed/heal, /feedIdentical
/cmi clearchat, /cc/clearchatIdentical
/cmi balance, /bal— (use Vault)No built-in economy
/cmi shop— (use a shop plugin)Pair with QuickShop, ShopGUI+
/cmi portal— (use vanilla)No portal system

What CMI has that NexoraSMP doesn't

Be honest about gaps. If any of these are load-bearing, stick with CMI or use both side-by-side:

Step-by-step

1

Stop the server & back up

Copy plugins/, your worlds, and dump the database if you use MySQL.

2

Drop in NexoraSMP, keep CMI for now

Run both at once during the migration. NexoraSMP detects CMI and yields its commands so they don't fight.

3

Run the importer

From console:

/nexora import cmi

Pulls homes, warps, kits, ban/mute history, AFK status, and player notes. Idempotent.

If you used CMI's MySQL backend, point NexoraSMP at the same database in config.yml first so the importer can read it.

4

Decide on overlap

Set commands.override-cmi: true in config.yml so NexoraSMP wins on every shared command. Or, leave specific CMI commands enabled (like /cmi shop) and let the rest go to NexoraSMP.

5

Test on a copy

Spin up a private copy of the server and run through every common command as a player and as staff. Confirm homes, /back, ban history, and chat behavior all work.

6

Decide: full swap, or hybrid?

Two valid endings:

  • Full swap: remove CMI. Keep NexoraSMP + Vault + (optional) economy plugin.
  • Hybrid: keep CMI for shops/economy/portals, let NexoraSMP own everything else. They cohabit cleanly.
License note: CMI is paid. Removing it from your stack is also a cost saving — usually $10-20/server/month depending on plan. Worth factoring in.

FAQ

Will I lose my CMI player data?

No. The importer reads CMI's data files / DB and copies what it understands. CMI's own data files stay untouched — you can roll back any time.

Can I use both CMI and NexoraSMP long-term?

Yes — many servers do. Common pattern: NexoraSMP for moderation, dashboard, kits, custom items, anti-exploit; CMI for economy + shops + portals. Set commands.override-cmi: true for the commands NexoraSMP should win.

Do CMI placeholders still work?

If you keep CMI installed, yes. NexoraSMP exposes its own placeholders via PlaceholderAPI — see the docs for the full list.

What about CMI's GUIs?

No replacement. We deliberately moved configuration into the web dashboard instead. If your players rely on CMI menus (shop GUIs etc.), keep those CMI features active.

Migration help: Drop into our Discord with your CMI config and we'll help map the unusual stuff.
← Migrating from EssentialsX? Read the full docs