Skip to content

Entity Data

Jump to bottom Edit New page
JasperLorelai edited this page Apr 25, 2026 · 30 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 19 version.

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
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

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

Horses have this too, but in their own section.

Option Description Default
saddled Boolean false

item
Option Description
dropped-item or material 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

copper_golem

copper-golem section:

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

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
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
llama-variant (old color) Llama Color
llama-decor (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:

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

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