Type: pet_definition
Defines a species of pet. This includes its default appearance, leveling progression, and combat settings.
Configuration
| Field | Type | Default | Description |
|---|
id | String | "" | Unique identifier. |
description | String | "" | Internal description. |
texture | String | "" | Base64 texture for HEAD mode. |
npc | Ref<EntityDefinition> | Empty | Entity definition for GROUND mode or skin. |
skins | List<Skin> | [] | List of alternative skins. |
defaultMode | Enum | HEAD | HEAD (floating) or GROUND (walking). |
headOffset | Vector | Zero | Offset for floating head position. |
xp | XpSettings | ... | Leveling configuration. |
combat | CombatSettings | ... | Retaliation configuration. |
token | TokenSettings | ... | Appearance of the item representing this pet. |
Xp Settings
| Field | Type | Default | Description |
|---|
formula | String | "" | Expression using {level} for XP per level. |
levels | List<Level> | [] | Explicit per-level requirements. |
maxLevel | Int | 10 | Maximum achievable level. |
killReward | Int | 0 | XP gained when owner kills a mob. |
Combat Settings
| Field | Type | Default | Description |
|---|
enabled | Boolean | false | Whether the pet attacks attackers. |
Token Settings
| Field | Type | Default | Description |
|---|
item | Item | PlayerHead | Icon used in menus/items. |
name | String | "{name}" | Display name. |
lore | List<String> | ... | Item lore. |
glow | Boolean | false | If the item glows. |