Entity Data

Description:

Entity data is a configuration section with data needed to summon an entity.

Other Versions:

Important

This page shows the current configuration for the 4.0 Beta 19 version.

• Entity Data for 4.0 Beta 18
• Entity Data for 4.0 Beta 17
• Entity Data for 4.0 Beta 16
• Entity Data for 4.0 Beta 15
• Entity Data for 4.0 Beta 14
• Entity Data for 4.0 Beta 13
• Entity Data for 4.0 Beta 11 & 12

Base Entity:

All options aren't forced to be constants but may be expressions instead - functions for numeric string for other types that should be evaluated into the appropriate type.

Option	Description
entity	String with a case insensitive Entity Type.
relative-offset	Vector
glowing	Boolean
visible-by-default	Boolean
custom-name-visible	Boolean
gravity	Boolean
silent	Boolean
no-physics	Boolean
persistent	Boolean
invulnerable	Boolean
visual-fire	true, false, or not_set
fire-ticks	Integer
freeze-ticks	Integer
velocity	Vector
pose	Pose
pose-fixed	Boolean,false by default
yaw	Angle, ~0 by default.
pitch	Angle, ~0 by default.
scoreboard-tags	Can be a list of string expressions of tags to add. Alternatively, it can be a configuration section with a clear boolean flag, and add/remove lists of string expression tags to modify the entity with.
passengers	List of Entity Data
delayed-entity-data	Delayed Modification List

Delayed Modification:

A list of delayed modifications to the initial entity data. Each entry in the list has the following options:

Option	Description	Type	Default
entity-data	Entity Data to be applied.	Config
interval	If greater than 0, specifies the interval in ticks between applications of entity-data.	Long (Int)	0
iterations	If greater than 0, specifies how many times the effect will appear	Long (Int)	0
delay	Specifies a delay in ticks before entity-data is first applied.	Long (Int)	1

Note: if iterations <= 0 and interval <= 0, the entry will only be applied once.

Example:

Item-Display-Example-TMulti:
    spell-class: ".TargetedMultiSpell"
    spells:
      - Item-Display-Example
        
Item-Display-Example: 
    spell-class: ".targeted.DummySpell"
    effects:
      - position: target
        effect: entity
        entity:
          entity: item_display
          item: golden_sword
          glowing: false
          silent: true
          gravity: true
          visible-by-default: true
          scoreboard-tags: ""
          iterations: 1
          duration: 20
          velocity: 0,0,0
          relative-offset: 0,2,0
          billboard: none
          transformation:
            left-rotation: "0,0,0,1"
            right-rotation: "0,0,0,1"
            translation: "0,0,0"
            scale: "1,1,1"                  
          delayed-entity-data:
            - delay: 5
              interval: 1
              iterations: 1
              entity-data:
                item: iron_sword
            - delay: 10
              interval: 1
              iterations: 1
              entity-data:
                item: diamond_sword

ItemStack Option:

Vanilla item format or Magic Item String (supports string expressions)

Entity-Specific Configuration:

Note that Display Entities are documented separately.

Living Entity

Option	Description
ai	Boolean
can-pickup-items	Boolean
max-health	Double
potion-effects	Potion Effect List
equipment	Equipment Config

Equipment Config:

Items defined in the ItemStack format:

• main-hand
• off-hand
• helmet
• chestplate
• leggings
• boots

Mob

Option	Description
aware	Boolean
equipment	Config section containing either of the drop-chance options for the respective equipment slots or body Magic Item String option.
mob-goals	Config section containing Mob Goals configuration. Note that through Entity Data, the following options support expressions too: remove-types, remove-vanilla, remove.

Drop-Chance Options:

• Sets the float drop chance of the specified slot's item.
  • Chance of 0 will never drop.
  • Chance of 1 will always drop if killed by a player.
  • Chance greater than 1 will always drop if killed by anything.
• Options:
  • main-hand-drop-chance
  • off-hand-drop-chance
  • helmet-drop-chance
  • chestplate-drop-chance
  • leggings-drop-chance
  • boots-drop-chance
  • body-drop-chance

Abstract Horse

Option	Description	Default
saddled	Boolean	false

Abstract Skeleton

skeleton section:

Option	Description
should-burn-in-day	Boolean

Ageable

Option	Description
baby	Boolean
age	Integer

Attributable

Option	Description
attribute-modifiers	Attributes

Damageable

Option	Description
health	Double

Frictional

Option	Description
friction-state	true, false, or not_set

Nameable

Option	Description
custom-name	Rich Text

Tameable

Option	Description
tamed	Boolean
tamed-owner	Boolean option which sets the entity as tamed and sets the Recipient as the tamer.

Chested "Horse"

Option	Description	Default
chested	Boolean	false

Collar Colorable

Option	Description
collar-color	Dye Color

Steerable

Option	Description	Default
saddled	Boolean	false

item

item section:

Option	Description
dropped-item	ItemStack
will-age	Boolean
pickup-delay	Integer
can-mob-pickup	Boolean
can-player-pickup	Boolean

Base section:

Old option names/paths for backward support.

Option	Description
dropped-item or material	ItemStack
will-age	Boolean
pickup-delay	Integer
can-mob-pickup	Boolean
can-player-pickup	Boolean

falling_block

falling-block section:

Option	Description
block	Block Data
cancel-drop	Boolean
hurt-entities	Boolean
damage-per-block	Float
max-damage	Integer

Base section:

Old option names/paths for backward support.

Option	Description
falling-block or material	Block Data

armor_stand

armor-stand section:

Option	Description
	Options below are supported here.
disable-slots	Bool or a list of EquipmentSlot
equipment-locks	List of configuration sections with options slot (EquipmentSlot) and lock (LockType)

Base section:

Use these options in the armor-stand section. They are supported in the base section for backwards support.

Option	Description	Default
small	Boolean	false
has-arms	Boolean	true
marker	Boolean	false
visible	Boolean	true
has-base-plate	Boolean	true
head-angle	Vector
body-angle	Vector
left-arm-angle	Vector
right-arm-angle	Vector
left-leg-angle	Vector
right-leg-angle	Vector

copper_golem

copper-golem section:

Option	Description
weathering-state	WeatheringCopperState
golem-state	Copper Golem State
oxidizing	Can be:- unset - oxidation happens naturally- waxed - oxidation is disabled- Long number of ticks until the next weathering state

cow

cow section:

Option	Description
variant	Cow Variant
sound-variant	Cow Sound Variant

creeper

Option	Description	Default
powered	Boolean	false

mannequin

mannequin section:

Option	Description	Type
immovable		Boolean
description	Defaults to null instead of the vanilla "NPC" text (</lang:entity.minecraft.mannequin.label> component) to avoid nameplate shifting when custom-name is used and visible.	Rich Text
main-hand		MainHand
skin-parts	Config section with boolean toggles for cape, jacket, left-sleeve, right-sleeve, left-pants, right-pants, and hats.	Config section
profile		Profile config section

mannequin profile:

If the texture fields are used, they will override the profile fields. Otherwise, name or uuid will be used to resolve the Player profile from Mojang servers. If no profile is resolved, a random default skin will be used.

Option	Description	Type
name		String
uuid		UUID formatted String
body, cape, or elytra	Path to a textures folder in a resourcepack.	Namespaced Key
model		SkinModel

slime

slime section:

Option	Description	Default
size	Integer	0

Base section:

Old option names/paths for backward support.

Option	Description	Default
size	Integer	0

enderman

Option	Description
carried-block (old material)	Block Data

shulker

shulker section:

Option	Description
color	DyeColor
attach-face	Block Face - Only cartesian block faces are allowed (N, E, S, W, up, and down)
peek	Float (0.0 - 1.0)

Base section:

Old option names/paths for backward support.

Option	Description
shulker-color (old color)	DyeColor

Sittable

Option	Description
sitting	Boolean

sheep

sheep section:

Option	Description	Default
sheared	Boolean	false
color	DyeColor

Base section:

Old option names/paths for backward support.

Option	Description	Default
sheared	Boolean	false
sheep-color (old color)	DyeColor

wolf

See Collar Colorable.

wolf section:

Option	Description	Default
anrgy	Boolean	false
variant	Wolf Variant

Base section:

Old option names/paths for backward support.

Option	Description	Default
anrgy	Boolean	false
color	Old name for Collar Colorable entities' collar-color option
wolf-variant	Wolf Variant

Minecart

minecart section:

Option	Description
max-speed	Double
slow-when-empty	Boolean
display-block-offset	Integer
display-block	Block Data
command	String, for command_block_minecart.

mushroom_cow

Option	Description
mooshroom-type (old type)	Variant

horse

horse section:

Option	Description
color	Horse Color
style	Horse Style

Base section:

Old option names/paths for backward support.

Option	Description	Default
horse-color or color	Horse Color
horse-style or style	Horse Style

rabbit

rabbit section:

Option	Description
type	Rabbit Type

Base section:

Old option names/paths for backward support.

Option	Description
rabbit-type or type	Rabbit Type

Raider

raider section:

Option	Description
patrol-leader	Boolean
can-join-raid	Boolean
celebrating	Boolean

llama

llama section:

Option	Description
variant	Llama Color
decor	Material

Base section:

Old option names/paths for backward support.

Option	Description
llama-variant or color	Llama Color
llama-decor or material	Case insensitive Material as decor.

parrot

Option	Description
parrot-variant (old type)	Variant

villager

villager section:

Option	Description
type	Villager Type
profession (old type)	Villager Profession

Base section:

Old option names/paths for backward support.

Option	Description
villager-type	Villager Type
villager-profession (old type)	Villager Profession

vindicator

vindicator section:

Option	Description
johnny	Boolean

phantom

phantom section:

Option	Description	Default
size	Integer	0
should-burn-in-day	Boolean	false

Base section:

Old option names/paths for backward support.

Option	Description	Default
size	Integer	0
should-burn-in-day	Boolean	false

pig

pig section:

Option	Description
variant	Pig Variant
sound-variant	Pig Sound Variant

piglin

piglin section:

Option	Description
can-hunt	Boolean
dancing	Integer ticks

Piglin Abstract

piglin section:

Option	Description
immune-to-zombification	Boolean

pufferfish

pufferfish section:

Option	Description	Default
puff-state	Integer	0

Base section:

Old option names/paths for backward support.

Option	Description	Default
size	Integer	0

tropical_fish

While its old color, pattern-color and type base options still work, they have been moved and renamed to be in a tropical-fish section.

Option	Description
body-color	Color
pattern-color	Pattern Color
pattern	Pattern

entity: tropical_fish
tropical-fish:
  body-color:
  pattern:
  # . . .

salmon

salmon section:

Option	Description
variant	Salmon Variant

cat

cat section:

Option	Description
variant	Cat Variant
sound-variant	Cat Sound Variant

Base section:

Old option names/paths for backward support.

Option	Description
cat-variant or type	Cat Variant

chicken

chicken section:

Option	Description
variant	Chicken Variant
sound-variant	Chicken Sound Variant

panda

panda section:

Option	Description
main-gene	Panda Gene
hidden-gene	Panda Gene

Base section:

Old option names/paths for backward support.

Option	Description
main-gene	Panda Gene
hidden-gene	Panda Gene

fox

Option	Description
fox-type (old type)	Fox Type

axolotl

axolotl section:

Option	Description
variant	Variant

Base section:

Old option names/paths for backward support.

Option	Description
axolotl-variant or type	Variant

frog

frog section:

Option	Description
variant	Frog Variant

Base section:

Old option names/paths for backward support.

Option	Description
frog-variant or type	Frog Variant

goat

goat section:

Option	Description
has-left-horn	Boolean
has-right-horn	Boolean
screaming	Boolean

hoglin

hoglin section:

Option	Description
immune-to-zombification	Boolean
able-to-be-hunted	Boolean

interaction

interaction section:

Option	Description
height	Float
width	Float
responsive	Sets if this interaction entity should trigger a response when interacted with.

Base section:

Old option names/paths for backward support.

Option	Description
interaction-height	Float
interaction-width	Float
responsive	Sets if this interaction entity should trigger a response when interacted with.

zombie

zombie section:

Option	Description	Default
should-burn-in-day	Boolean	false

Base section:

Old option names/paths for backward support.

Option	Description	Default
should-burn-in-day	Boolean	false

zombie_nautilus

zombie-nautilus section:

Option	Description
variant	Zombie Nautilus Variant

zombie_villager

zombie-villager section:

Option	Description
type	Villager Type
profession	Villager Profession

Display Entities

Option	Description
transformation	Config section with options from the Transformation config below.
teleport-duration	Integer
interpolation-duration	Integer
interpolation-delay	Integer
view-range	Float
shadow-radius & shadow-strength	Float
height & width	Float
billboard	Can be one of these.
glow-color-override	ARGB Color
brightness	Config section with Integer options block & sky.

Transformation config:

All options are required.

Option	Description
left-rotation	Rotation config
right-rotation	Rotation config
translation	A string "x,y,z" or a config section with those keys.
scale	A string "x,y,z" or a config section with those keys.

Rotation config:

Either in:

• Angle-axis form: A config section with the following options.

  Option	Description
  angle	Float Radian
  axis	3D unit vector; either a string "x,y,z" or a config section with those keys.

• Quaternion form: Accepts a string "x,y,z,w", a config section with those keys, or a list with 4 items.

Display Specific Options:

block_display

Option	Description
block	Block Data

item_display

Option	Description
item	ItemStack
item-display-transform	Item Display Transform

text_display

Option	Description
text	Rich Text
line-width	Integer
background	ARGB Color
text-opacity	Integer
shadow	Boolean
see-through	Boolean
default-background	Boolean
alignment	Text Alignment