Pet Configuration
Directories Configuration
Nodes
id
A unique identifier for each pet.
default
Defines default initial attributes and settings.
Node | Data Type | Default | Description |
---|---|---|---|
exp | Int | 100 | Experience required to level up |
level | Int | 100 | Maximum level |
attribute | Related attributes |
attribute
Defines default values for attributes.
Node | Data Type | Default | Description |
---|---|---|---|
health | double | 20.0 | Maximum health |
speed | double | 1.0 | Speed |
attack | double | 0.0 | Attack damage |
hook
The attribute system storage is a flexible data management method that stores and retrieves various attributes of pets using a key-value pair format.
This storage method functions similarly to a simple database, where the key
represents the name of the attribute, and the value
is the specific value or state of that attribute.
It can be used as a storage system or as an attribute system (driver required).
Node | Data Type | Default | Description | Options | ||||||
---|---|---|---|---|---|---|---|---|---|---|
type | STORAGE | Storage system |
| |||||||
key | String | Key | ||||||||
value | String | Value |
entityType
The type of entity, with a default value of PIG
.
addon
Addons are additional components that can be attached to pets, providing extra features like holographic displays or making the pet invincible.
Invincibility
Node | Parameter Type | Description | Options | ||||||
---|---|---|---|---|---|---|---|---|---|
type | Sets the pet to be invincible | INVINCIBLE | |||||||
select | Specifies the entities that are immune |
|
Holographic Display
Node | Parameter Type | Description | Options | ||||||
---|---|---|---|---|---|---|---|---|---|
type | Holographic display | NAME | |||||||
select | Target |
| |||||||
height | Double | Height | |||||||
lines | String[] | Display content |
action
Node | Parameter Type | Description | Options |
---|---|---|---|
id | String | Identifier for the action behavior | |
priority | Int | Action priority, lower values are executed first |
Built-in Behaviors
Action ID | Description |
---|---|
attack | A melee attack mechanism similar to a wolf |
walk | Follows the owner |
Custom behaviors can be defined through configuration files or developed using an API, identified by their IDs.
Behavior configuration files are located in:
imiPetCore/action/...
The default behavior configuration includes an example, lookowner
, which makes the pet occasionally look at its owner.
model
Allows you to choose different model providers and define the model behavior for pets.
You can customize the appearance and animations of pets using model providers such as MODEL_ENGINE
or COMMON
.
Node | Parameter Type | Default | Description | Options | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
select | String | COMMON | The name of the model provider, specifying which model engine to use |
| ||||||||||||
id | String | Entity type (for COMMON) or model identifier | ||||||||||||||
state | String | Animation state configuration for controlling model behavior and duration |
state
Defines how the model behaves in different scenarios, such as when the pet attacks or follows its owner.
Each state can be customized with parameters like lerpin
, lerpout
, and speed
.
Node | Parameter Type | Default | Description | Notes |
---|---|---|---|---|
id | String | Action identifier | ||
lerpin | Double | 0.0 | Transition time into the animation | Only required for ModelEngine |
lerpout | Double | 0.0 | Transition time out of the animation | Only required for ModelEngine |
speed | Double | 1.0 | Animation playback speed | Only required for ModelEngine |
force | Boolean | false | Whether to force the animation to play | Only required for ModelEngine |
time | Int | 3 | Duration of the animation | Required for GermEngine and DragonCore |
skill
Defines the default values for pet skills.
Node | Parameter Type | Default | Description |
---|---|---|---|
number | Int | 3 | Maximum default number of skills |
icon
Used to define how the pet is displayed in the interface, including item material, name, description, and custom model data.
This configuration allows for the specific information about the pet to be displayed in menus and interfaces.
Node | Parameter Type | Default | Description |
---|---|---|---|
material | String | ZOMBIE_HEAD | Item material |
name | String | Item name | |
lore | String[] | Item lore (description) | |
modelData | Int | 0 | Custom model data for the item |
Variable Support
The icon configuration supports Kether statements, allowing dynamic variables to be embedded in the form of {{ kether }}
.
For example:
{{pet name}}
represents the pet's name.{{pet level}}
represents the pet's level.
By using these dynamic variables, the icon descriptions can be made more personalized and updated in real-time.