Features / Citizens migration

Citizens migration

If Citizens is installed and enabled, this plugin can recreate your existing Citizens NPCs as its own NPCs. Nothing is removed from Citizens — this only creates new NPCs here, side by side.

Preview first

/npc migrate citizens

Running it without confirm shows you how many Citizens NPCs were found and what migrating will do, without actually doing it.

Migrate everything

/npc migrate citizens confirm

Migrate one specific NPC

/npc migrate citizens confirm <citizensnpcname>

The NPC name tab-completes, pulling live from Citizens' own NPC list, so you don't need to type it exactly from memory.

What gets carried over

From CitizensBecomes
Name and locationSame name (sanitized if needed for the entity name limit) and exact position
Display nameCopied exactly, including any color codes — see Skins for how formatting is handled
Entity typeSame mob type
SkinCopied directly if Citizens already had one cached; otherwise fetched fresh by username
Gravity settingCopied — Citizens NPCs have gravity on unless it was explicitly turned off, and that's preserved
Click-to-run commandsConverted into this plugin's own command / console_command actions, on the matching left-click or right-click trigger
Name conflicts
If an NPC with the same name already exists here, the migrated copy gets a number appended (like Bob_1) so nothing is overwritten.
If a skin needs fetching live
Some skin lookups happen over the network and can't finish instantly. The command tells you how many are still in progress — those NPCs will update their skin on their own the moment the lookup finishes, with no further action needed from you.