Skip to content

Properties

D3v1s0m edited this page Nov 4, 2023 · 2 revisions

This page provides a list of all properties available for customizing your NPCs in ZNPCsPlus.

Not all properties are available for all versions and all NPC Types. For example, is_elder property is only available in versions 1.8.8-1.10 and only for guardian.

helmet

Used to equip helmet to the NPC.
Usage: /npc property set <id> helmet - Hold the item in your hand
Default: none
Versions: all
Types: player,armor_stand,giant,skeleton,zombie,zombified_piglin,husk,stray,
wither_skeleton,zombie_villager,drowned,piglin,piglin_brute

chestplate

Used to equip chestplate to the NPC.
Usage: /npc property set <id> chestplate - Hold the item in your hand
Default: none
Versions: all
Types: player,armor_stand,giant,skeleton,zombie,zombified_piglin,husk,stray,
wither_skeleton,zombie_villager,drowned,piglin,piglin_brute

leggings

Used to equip leggings to the NPC.
Usage: /npc property set <id> leggings - Hold the item in your hand
Default: none
Versions: all
Types: player,armor_stand,giant,skeleton,zombie,zombified_piglin,husk,stray,
wither_skeleton,zombie_villager,drowned,piglin,piglin_brute

boots

Used to equip boots to the NPC.
Usage: /npc property set <id> boots - Hold the item in your hand.
Default: none
Versions: all
Types: player,armor_stand,giant,skeleton,zombie,zombified_piglin,husk,stray,
wither_skeleton,zombie_villager,drowned,piglin,piglin_brute

hand

Used to equip an item in hand of the NPC.
Usage: /npc property set <id> hand - Hold the item in your hand
Default: none
Versions: all
Types: player,armor_stand,giant,skeleton,zombie,zombified_piglin,husk,stray,
wither_skeleton,zombie_villager,drowned,piglin,piglin_brute,vex,pillager,allay

offhand

Used to equip an item in off hand of the NPC.
Usage: /npc property set <id> offhand - Hold the item in your hand
Default: none
Versions: 1.9+
Types: player,armor_stand,giant,skeleton,zombie,zombified_piglin,husk,stray,
wither_skeleton,zombie_villager,drowned,piglin,piglin_brute,vex,pillager,allay

dinnerbone

The NPC is inverted like using Dinnerbone nametag.
Usage: /npc property set <id> dinnerbone <true/false>
Default: false
Versions: all
Types: all (EXCEPT ender_dragon)

look

Change how the NPC looks, i.e. the head rotation.
Usage: /npc property set <id> look <FIXED/CLOSEST_PLAYER/PER_PLAYER>
Default: FIXED
Example: /npc property set 1 look CLOSEST_PLAYER
FIXED - NPC will not move its head
CLOSEST_PLAYER - NPC will look at the closest player
PER_PLAYER - NPC will look at the player who is looking at it
Versions: all
Types: all

look_distance

Used to set the distance at which the NPC will look at the player.
Usage: /npc property set <id> look_distance <distance>
Default: 10
Example: /npc property set 1 look_distance 20.5
Versions: all
Types: all

view_distance

Used to set the distance till which the NPC will be visible to the player.
Usage: /npc property set <id> view_distance <distance>
Default: 32
Example: /npc property set 1 view_distance 50
Versions: all
Types: all

permission_required

If true, only players with the permission znpcsplus.npc.<id> will be able to view the NPC.
Usage: /npc property set <id> permission_required <true/false>
Default: false
Versions: all
Types: all

glow

To make the NPC glow.
Usage: /npc property set <id> glow [<GlowColor>]
Default: false
Example: /npc property set 1 glow RED
Versions: 1.9+
Types: all

fire

To set the NPC on fire.
Usage: /npc property set <id> fire <true/false>
Default: false
Versions: all
Types: all

invisible

To set the NPC invisible. This works like the invisibility potion effect.
Usage: /npc property set <id> invisible <true/false>
Default: false
Versions: all
Types: all (EXCEPT ender_dragon)

silent

To make the NPC silent. Like the silent tag in commands.
Usage: /npc property set <id> silent <true/false>
Default: false
Versions: all
Types: all

sitting

To make the NPC sit.
Usage: /npc property set <id> sitting <true/false>
Default: false
Versions: all
Types: cat, parrot, wolf

tamed

To tame the NPC. Needed for collar color to work.
Usage: /npc property set <id> tamed <true/false>
Default: false
Versions: all
Types: cat, parrot, wolf

potion_color

To set the potion color of the NPC.
Usage: /npc property set <id> potion_color [<Color>]
Default: none
Example: /npc property set 1 potion_color #FFFF00 - Sets the potion color to yellow
Versions: all
Types: all (EXCEPT ender_dragon)

potion_ambient

To set the potion effect to be ambient.
Usage: /npc property set <id> potion_ambient <true/false>
Default: false
Versions: all
Types: all (EXCEPT ender_dragon)

baby

To make the NPC a baby.
Usage: /npc property set <id> baby <true/false>
Default: false
Versions: all
Types: all ageable mobs, zombies, piglins, zoglins

small

If true, the Armor Stand NPC will be small.
Usage: /npc property set <id> small <true/false>
Default: false
Versions: all
Types: armor_stand

arms

If true, the Armor Stand NPC will have arms.
Usage: /npc property set <id> arms <true/false>
Default: false
Versions: all
Types: armor_stand

base_plate

If false, the Armor Stand NPC will not have a base plate.
Usage: /npc property set <id> base_plate <true/false>
Default: true
Versions: all
Types: armor_stand

head_rotation

Used to set rotation of the head of the Armor Stand NPC.
Usage: /npc property set <id> head_rotation <x> <y> <z>
Default: 0 0 0
Example: /npc property set 1 head_rotation 0 90 0
Versions: all
Types: armor_stand

body_rotation

Used to set rotation of the body of the Armor Stand NPC.
Usage: /npc property set <id> body_rotation <x> <y> <z>
Default: 0 0 0
Example: /npc property set 1 body_rotation 0 90 0
Versions: all
Types: armor_stand

left_arm_rotation

Used to set rotation of the left arm of the Armor Stand NPC.
Usage: /npc property set <id> left_arm_rotation <x> <y> <z>
Default: -10 0 -10
Example: /npc property set 1 left_arm_rotation 0 0 -5
Versions: all
Types: armor_stand

right_arm_rotation

Used to set rotation of the right arm of the Armor Stand NPC.
Usage: /npc property set <id> right_arm_rotation <x> <y> <z>
Default: -15 0 10
Example: /npc property set 1 right_arm_rotation -105 0 100
Versions: all
Types: armor_stand

left_leg_rotation

Used to set rotation of the left leg of the Armor Stand NPC.
Usage: /npc property set <id> left_leg_rotation <x> <y> <z>
Default: -1 0 -1
Example: /npc property set 1 left_leg_rotation 40 0 0
Versions: all
Types: armor_stand

right_leg_rotation

Used to set rotation of the right leg of the Armor Stand NPC.
Usage: /npc property set <id> right_leg_rotation <x> <y> <z>
Default: 1 0 1
Example: /npc property set 1 right_leg_rotation -40 0 0
Versions: all
Types: armor_stand

attacking

To make the Ghast NPC look like it is attacking.
Usage: /npc property set <id> attacking <true/false>
Default: false
Versions: all
Types: ghast

hanging

To make the Bat NPC hang upside down.
Usage: /npc property set <id> hanging <true/false>
Default: false
Versions: all
Types: bat

blaze_on_fire

To make the Blaze NPC on fire.
Usage: /npc property set <id> blaze_on_fire <true/false>
Default: false
Versions: all
Types: blaze

creeper_state

To set the state of the Creeper NPC.
Usage: /npc property set <id> creeper_state <IDLE/FUSE>
Default: IDLE
Versions: all
Types: creeper

creeper_charged

To make the Creeper NPC charged.
Usage: /npc property set <id> creeper_charged <true/false>
Default: false
Versions: all
Types: creeper

is_saddled

To make the Horse NPC saddled.
Usage: /npc property set <id> is_saddled <true/false>
Default: false
Versions: all
Types: horse, donkey, mule, skeleton_horse, zombie_horse

is_eating

To make the Horse NPC eating.
Usage: /npc property set <id> is_eating <true/false>
Default: false
Versions: all
Types: horse, donkey, mule, skeleton_horse, zombie_horse

is_rearing

To make the Horse NPC rearing.
Usage: /npc property set <id> is_rearing <true/false>
Default: false
Versions: all
Types: horse, donkey, mule, skeleton_horse, zombie_horse

has_mouth_open

To make the Horse NPC's mouth open.
Usage: /npc property set <id> has_mouth_open <true/false>
Default: false
Versions: all
Types: horse, donkey, mule, skeleton_horse, zombie_horse

beam_target

To set the target of the End Crystal NPC's beam.
Usage: /npc property set <id> beam_target <x> <y> <z>
Default: none
Example: /npc property set 1 beam_target 0 100 0
Versions: 1.9+
Types: ender_crystal

show_base

If false, the End Crystal NPC will not have a base like a placed End Crystal.
Usage: /npc property set <id> show_base <true/false>
Default: true
Versions: 1.9+
Types: ender_crystal

is_elder

To make the Guardian NPC an Elder Guardian.
Usage: /npc property set <id> is_elder <true/false>
Default: false
Versions: 1.8.8-1.10
Types: guardian

is_retracting_spikes

To make the Guardian NPC retract its spikes.
Usage: /npc property set <id> is_retracting_spikes <true/false>
Default: false
Versions: all
Types: guardian, elder_guardian

horse_type

To set the type of the Horse NPC.
Usage: /npc property set <id> horse_type <HORSE/DONKEY/MULE/SKELETON/ZOMBIE>
Default: HORSE
Versions: 1.8.8-1.10
Types: horse

horse_style

To set the style of the Horse NPC.
Usage: /npc property set <id> horse_style <NONE/WHITE/WHITEFIELD/WHITE_DOTS/BLACK_DOTS>
Default: HORSE
Versions: all
Types: horse

horse_color

To set the color of the Horse NPC.
Usage: /npc property set <id> horse_color <WHITE/CREAMY/CHESTNUT/BROWN/BLACK/GRAY/DARK_BROWN>
Default: HORSE
Versions: all
Types: horse

horse_armor

To set the armor of the Horse NPC.
Usage: /npc property set <id> horse_armor <NONE/IRON/GOLD/DIAMOND>
Default: NONE
Versions: 1.8.8-1.13
Types: horse

has_chest

If true, the NPC will have a chest.
Usage: /npc property set <id> has_chest <true/false>
Default: false
Versions: all
Types: horse(only 1.8.8-1.13), donkey, mule, llama

ZNPCsPlus Wiki

Welcome to the documentation for ZNPCsPlus!

  • Home: Introduction and Overview
  • Setup: Installation and Configuration
  • Converting: Migrating from Older Versions or Other Plugins
  • Commands: List of Available Commands
  • Permissions: Permissions and Access Control
  • NPC Types: Information about Different NPC Types
  • Properties: Customization Options
  • API Docs: Documentation of API
  • Other: Additional Resources and Information

Feel free to click on any of the links above to access the corresponding page for detailed information on that topic. If you have any questions or need further assistance, please don't hesitate to reach out on our Discord server

Clone this wiki locally