NPC Citizens
Server setup
NPCs with skins and click actions using /npcLearn more
Configure a Citizens NPC's name, model, skin, gaze, held items, overhead text, and click action. Copy the generated /npc commands into chat in order.
My Game select version
Save your preferences in this browser and apply them to supported tools. Settings in a shared link take priority. Wiki version labels are not affected.
How to use the result
- Install Citizens
Plugin file — place in folder plugins on a Paper or Spigot server, then restart. How to install plugins — in Citizens NPC guide.
- Stand in the NPC's position
The NPC appears at your position, facing the same direction. Requires citizens.* or operator.
- Enter commands in order
The first one creates NPCs and selects one; the rest follow it. Fix later: /npc select stand next to them and run the required command again.
What to know
- Skin — only for players. The server downloads it directly by username. For zombies or villagers, the command /npc skin will not work.
- /npc lookclose — toggle. New NPC has gaze disabled; the command enables it; on a second run, it disables it.
- A word with a minus sign takes Citizens' own. "-p" or "--x" inside a name or command will treat it as a flag and remove the opening quote — such words are not allowed on the page.
- Hologram lines Citizens processes from bottom to top, so commands appear from the last line — on screen, it will look exactly as entered.
Without a plugin, one /summon command spawns an NPC with a skin mannequin generator (from 1.21.9). All plugin commands are in the Citizens documentation. Player click permissions are in LuckPerms generator.
Frequently asked questions
How to create an NPC on a server?
Install Citizens, stand where you want the NPC, and run /npc create with its name. Use the following /npc commands to configure its skin, gaze, and click actions.
How to make a NPC run a command on click?
With the command /npc command add: without the -p flag it runs in console, with -p it runs for the player. In Citizens commands, %player% is replaced with the player's nickname when clicked.
Why doesn't an NPC's skin change?
Skins work only on player-type NPCs, not zombies or villagers. Use an existing Minecraft account username so Citizens can retrieve the skin.
Minecraft skin mannequin
Minecraft text hologram generator