Entity data is a configuration section with data needed to summon an entity.
Important
This page shows the current configuration for the 4.0 Beta 19 version.
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
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.
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
Vanilla item format or Magic Item String (supports string expressions )
Entity-Specific Configuration:
Note that Display Entities are documented separately.
Items defined in the ItemStack format:
main-hand
off-hand
helmet
chestplate
leggings
boots
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.
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
Option
Description
Default
saddled
Boolean
false
Option
Description
should-burn-in-day
Boolean
Option
Description
baby
Boolean
age
Integer
Option
Description
health
Double
Option
Description
friction-state
true, false, or not_set
Option
Description
tamed
Boolean
tamed-owner
Boolean option which sets the entity as tamed and sets the Recipient as the tamer.
Option
Description
Default
chested
Boolean
false
Option
Description
Default
saddled
Boolean
false
Option
Description
dropped-item
ItemStack
will-age
Boolean
pickup-delay
Integer
can-mob-pickup
Boolean
can-player-pickup
Boolean
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
Option
Description
block
Block Data
cancel-drop
Boolean
hurt-entities
Boolean
damage-per-block
Float
max-damage
Integer
Old option names/paths for backward support.
Option
Description
falling-block or material
Block Data
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 )
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
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
Option
Description
Default
powered
Boolean
false
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
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
Option
Description
Default
size
Integer
0
Old option names/paths for backward support.
Option
Description
Default
size
Integer
0
Option
Description
carried-block (old material)
Block Data
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)
Old option names/paths for backward support.
Option
Description
shulker-color (old color)
DyeColor
Option
Description
sitting
Boolean
Option
Description
Default
sheared
Boolean
false
color
DyeColor
Old option names/paths for backward support.
Option
Description
Default
sheared
Boolean
false
sheep-color (old color)
DyeColor
See Collar Colorable .
Option
Description
Default
anrgy
Boolean
false
variant
Wolf Variant
Old option names/paths for backward support.
Option
Description
max-speed
Double
slow-when-empty
Boolean
display-block-offset
Integer
display-block
Block Data
command
String, for command_block_minecart.
Option
Description
mooshroom-type (old type)
Variant
Old option names/paths for backward support.
Old option names/paths for backward support.
Option
Description
patrol-leader
Boolean
can-join-raid
Boolean
celebrating
Boolean
Old option names/paths for backward support.
Option
Description
llama-variant or color
Llama Color
llama-decor or material
Case insensitive Material as decor.
Option
Description
parrot-variant (old type)
Variant
Old option names/paths for backward support.
Option
Description
johnny
Boolean
Option
Description
Default
size
Integer
0
should-burn-in-day
Boolean
false
Old option names/paths for backward support.
Option
Description
Default
size
Integer
0
should-burn-in-day
Boolean
false
Option
Description
can-hunt
Boolean
dancing
Integer ticks
Option
Description
immune-to-zombification
Boolean
Option
Description
Default
puff-state
Integer
0
Old option names/paths for backward support.
Option
Description
Default
size
Integer
0
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.
entity : tropical_fish
tropical-fish :
body-color :
pattern :
# . . .
Old option names/paths for backward support.
Old option names/paths for backward support.
Option
Description
fox-type (old type)
Fox Type
Old option names/paths for backward support.
Option
Description
axolotl-variant or type
Variant
Old option names/paths for backward support.
Option
Description
has-left-horn
Boolean
has-right-horn
Boolean
screaming
Boolean
Option
Description
immune-to-zombification
Boolean
able-to-be-hunted
Boolean
Option
Description
height
Float
width
Float
responsive
Sets if this interaction entity should trigger a response when interacted with.
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.
Option
Description
Default
should-burn-in-day
Boolean
false
Old option names/paths for backward support.
Option
Description
Default
should-burn-in-day
Boolean
false
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.
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.
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:
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