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 Citizens | Becomes |
|---|---|
| Name and location | Same name (sanitized if needed for the entity name limit) and exact position |
| Display name | Copied exactly, including any color codes — see Skins for how formatting is handled |
| Entity type | Same mob type |
| Skin | Copied directly if Citizens already had one cached; otherwise fetched fresh by username |
| Gravity setting | Copied — Citizens NPCs have gravity on unless it was explicitly turned off, and that's preserved |
| Click-to-run commands | Converted 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.