advanced-method.md

Entity creation

Converting an existing model

{% hint style="danger" %} Remember to make a backup of your .bbmodel file before using this tool! {% endhint %}

Open your .bbmodel project with Blockbench, then click on File -> Convert Project

Select "ItemsAdder Entity Model" in the Format setting, then press Confirm.

Now save the new converted model file in a new folder where you will put only this file.

You will have something like that:

Saving the project

Now create a new folder inside ItemsAdder/contents/, it's your namespace folder. For example mine is custom, so the path is ItemsAdder/contents/custom/.

Save the project file .iaentitymodel into your ItemsAdder namespace folder, in this example into contents/custom/.

Configuring the model

Now you can configure your model based on your preferences. The ItemsAdder extension automatically decided some settings for you but you might need to change them.
Click on the ItemsAdder tab and press Settings.

Here you have to decide a namespace for your custom entities.
The default one is custom, but you should decide your own, for example my_entities, hell_mobs, npcs...

The other thing you might need to change is the "Model Scaling Mode":

• Max Model size provides 7x7x7 block wide models but limits scaling to shrinking only.
• Max Scaling range provides shrinking and growing up to 3.125x in size, but limits the maximum model size to 3x3x3 blocks

Change "Max Model Size" only if you have animated the size of some bones.

Export the model

Click on the ItemsAdder tab and press Export.

You should get a success message.

Creating the ingame entity configuration

As you can see the extension created a file automatically, called custom_entity_NAME.yml. It will create it only on the first export.

You can customize it with more properties if needed.

{% code title="barman_robot.yml" %}

info:
  namespace: custom
entities:
  barman_robot:
    display_name: "Barman Robot"
    type: ZOMBIE
    model_folder: entity/barman_robot
    silent: true
    can_sun_burn: false
    speed:
      movement: 1
      flying: 0
    max_health: 20
      

{% endcode %}

In this example my custom entity will use a ZOMBIE as base entity for its AI.
You can use any living entity as base entity, depending on your needs.

Summoning the entity

Use the summon command: /iaentity summon <entity>

Notes

{% hint style="info" %} Do not create too many bones, keep the model simple, remember this is a blocky pixelated game, use its style. {% endhint %}