/npc

The /npc command is the main command for managing NPCs. It allows you to create, modify, and remove NPCs. You can also customize NPCs by changing their type, skin, equipment, and more.

Manage npcs

Help about commands

Shows help about all commands.

• Permissions: fancynpcs.command.npc.help
• Syntax: /npc help [page]

Create a NPC

Creates a new NPC. Can be customized with flags (note: The name check is strict and only allows A-Z a-z 0-9 _ - / characters).

• Permissions: fancynpcs.command.npc.create
• Syntax: /npc create (name) [--position (x y z)] [--world (world)] [--type (type)]

Copy a NPC

Copies (duplicates) the specified NPC (note: The name check is strict and only allows A-Z a-z 0-9 _ - / characters).

• Permissions: fancynpcs.command.npc.copy
• Syntax: /npc copy (npc) (new_name)

Remove a NPC

Removes the specified NPC.

• Permissions: fancynpcs.command.npc.remove
• Syntax: /npc remove (npc)

List all NPCs

Lists all NPCs in all worlds. Can be filtered and sorted.

• Permissions: fancynpcs.command.npc.list
• Syntax: /npc list [--type (type)] [--sort (sort)]

Get NPC information

Shows information about the specified NPC.

• Permissions: fancynpcs.command.npc.info
• Syntax: /npc info (npc)

Customize NPCs

Set type

Changes the type of the NPC.

• Permissions: fancynpcs.command.npc.type
• Syntax: /npc type (npc) (type)

Set display name

Changes the displayname of the NPC. Supports MiniMessage, PlaceholderAPI and MiniPlaceholders (note: Empty message placeholder is @none).

• Permissions: fancynpcs.command.npc.displayname
• Syntax: /npc displayname (npc) (@none | name)

Set skin

Changes skin of the NPC.

• Permissions: fancynpcs.command.npc.skin
• Syntax: /npc skin (npc) (@none | @mirror | name | url | file name) [--slim]

Set equipment

Sets equipment slot of the NPC to item currently held in main hand, none or a specific item type.

• Permissions: fancynpcs.command.npc.equipment.(sub)
• Syntax: /npc equipment (npc) (set | clear | list)

Toggle glowing

Changes glowing state and color of the NPC.

• Permissions: fancynpcs.command.npc.glowing
• Syntax: /npc glowing (npc) [disabled | color]

Show NPC in the tab-list

Changes whether the NPC is shown in the player-list. This works only on NPCs of PLAYER type (note: Re-connecting to the server might be required for changes to take effect).

• Permissions: fancynpcs.command.npc.show_in_tab
• Syntax: /npc show_in_tab (npc) [state]

Toggle collidable

Changes whether the NPC can collide with other entities.

• Permissions: fancynpcs.command.npc.collidable
• Syntax: /npc collidable (npc) [state]

Edit size

Changes the scale of the size of the NPC.

• Permissions: fancynpcs.command.npc.scale
• Syntax: /npc scale (npc) (factor)

Set attributes

Sets an attribute of the NPC.

• Permissions: fancynpcs.command.npc.attribute.(sub)
• Syntax: /npc attribute (npc) (set | list)

NPC location and rotation

Turn NPC to player

Changes whether the NPC should turn to the player when in a certain range.

• Permissions: fancynpcs.command.npc.turn_to_player
• Syntax: /npc turn_to_player (npc) [state]

Distance when NPC starts turning

Changes the distance at which the NPC should turn to the player.

• Permissions: fancynpcs.command.npc.turn_to_player_distance
• Syntax: /npc turn_to_player_distance (npc) [distance]

Move NPC to your location

Teleports the specified NPC to your location.

• Permissions: fancynpcs.command.npc.move_to
• Syntax: /npc move_here (npc)

Move NPC to a location

Teleports NPC to the specified location.

• Permissions: fancynpcs.command.npc.move_to
• Syntax: /npc move_to (npc) (x) (y) (z) [world] [--look-in-my-direction]

Rotate NPC

Sets the yaw and pitch of the specified NPC.

• Permissions: fancynpcs.command.npc.rotate
• Syntax: /npc rotate (npc) (yaw) (pitch)

Center NPC

Centers the NPC at the location, which it's standing at.

• Permissions: fancynpcs.command.npc.center
• Syntax: /npc center (npc)

Show nearby NPCs

Lists all NPCs in your world. Can be filtered and sorted.

• Permissions: fancynpcs.command.npc.nearby
• Syntax: /npc nearby [--radius (radius)] [--type (type)] [--sort (sort)]

Teleport to NPC

Teleports you to the specified NPC.

• Permissions: fancynpcs.command.npc.teleport
• Syntax: /npc teleport (npc)

Manage interactions

Add action

Adds an action to the specified NPC's trigger.

• Permissions: fancynpcs.command.npc.action.add and fancynpcs.command.npc.action.add.(actionType | *) for the specific action type
• Syntax: /npc action (npc) (trigger) add (actiontype) [value]

Add action before

Adds an action before the specified index in the NPC's action list for the given trigger.

• Permissions: fancynpcs.command.npc.action.addBefore and fancynpcs.command.npc.action.add.(actionType | *) for the specific action type
• Syntax: /npc action (npc) (trigger) add_before (index) (actiontype) [value]

Add action after

Adds an action after the specified index in the NPC's action list for the given trigger.

• Permissions: fancynpcs.command.npc.action.addAfter and fancynpcs.command.npc.action.add.(actionType | *) for the specific action type
• Syntax: /npc action (npc) (trigger) add_after (index) (actiontype) [value]

Set action

Sets an action at the specified number in the NPC's action list for the given trigger.

• Permissions: fancynpcs.command.npc.action.set and fancynpcs.command.npc.action.add.(actionType | *) for the specific action type
• Syntax: /npc action (npc) (trigger) set (number) (actiontype) [value]

Remove action

Removes an action from the NPC's action list based on the specified number for the given trigger.

• Permissions: fancynpcs.command.npc.action.remove
• Syntax: /npc action (npc) (trigger) remove (number)

Move action up

Moves the action at the specified number up in the NPC's action list for the given trigger.

• Permissions: fancynpcs.command.npc.action.moveUp
• Syntax: /npc action (npc) (trigger) move_up (number)

Move action down

Moves the action at the specified number down in the NPC's action list for the given trigger.

• Permissions: fancynpcs.command.npc.action.moveDown
• Syntax: /npc action (npc) (trigger) move_down (number)

Clear actions

Clears all actions from the NPC for the given trigger.

• Permissions: fancynpcs.command.npc.action.clear
• Syntax: /npc action (npc) (trigger) clear

List actions

Lists all actions for the specified NPC and trigger.

• Permissions: fancynpcs.command.npc.action.list
• Syntax: /npc action (npc) (trigger) list

Interaction cooldown

Changes duration between interactions (cooldown) of the NPC (note: Formerly known as /npc interactionCooldown).

• Permissions: fancynpcs.command.npc.interaction_cooldown
• Syntax: /npc interaction_cooldown (npc) (disabled | cooldown)