Skip to content

Entity Data

Jump to bottom Edit New page
JasperLorelai edited this page Oct 29, 2025 · 23 revisions

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 18 version.

Mutual Configuration:

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
velocity Vector
yaw Angle, ~0 by default.
pitch Angle, ~0 by default.
scoreboard-tags List of string expressions
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:
        0:
            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
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
equipment Config section containing either of the drop-chance options for the respective equipment slots or body Magic Item String option.

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

Ageable
Option Description
baby Boolean
age Integer

Attributable
Option Description
attribute-modifiers Attributes

Damageable
Option Description
health Double

Nameable
Option Description
custom-name Rich Text

Tameable
Option Description Default
tamed Boolean false

Chested "Horse"
Option Description Default
chested Boolean false

Collar Colorable
Option Description
collar-color Dye Color

Steerable

Horses have this too, but in their own section.

Option Description Default
saddled Boolean false

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

falling_block
Option Description
falling-block (old material) Block Data

armor_stand
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

creeper
Option Description Default
powered Boolean false

slime
Option Description Default
size Integer 0

enderman
Option Description
carried-block (old material) Block Data

shulker
Option Description Default
shulker-color (old color) DyeColor

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

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

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

mushroom_cow
Option Description
mooshroom-type (old type) Variant

horse
Option Description Default
saddled Boolean false
horse-color (old color) Horse Color
horse-style (old style) Horse Style

rabbit
Option Description
rabbit-type (old type) Rabbit Type

llama
Option Description
(old color) Llama Color
(old material) Case insensitive Material as decor.

parrot
Option Description
parrot-variant (old type) Variant

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

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

pufferfish
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:
  # . . .

cat
Option Description
cat-variant (old type) Cat Variant

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

fox
Option Description
fox-type (old type) Fox Type

axolotl
Option Description
axolotl-variant (old type) Variant

frog
Option Description
frog-variant (old type) Frog Variant

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

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

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:

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

Note

Anyone can edit the wiki so if you feel like you need to edit or add something, or if you find some mistakes, please do help us out. We would appreciate it! ❤️

General Links:

Spell Configuration:

Useful Links:

Clone this wiki locally