Spawning an entity

After you have injected your entity, you will likely want to spawn it in the world. You can use the /summon command (e.g. /summon my_plugin:capybara), but you may also want to do this programmatically using the Bestium API.

To spawn an entity with the API, use:

Kotlin

Bestium.getEntityManager().spawn(Location, Class, EntitySpawnReason, CreatureSpawnEvent.SpawnReason, [Consumer])

Java

Bestium.getEntityManager().spawn(Location, Class, EntitySpawnReason, CreatureSpawnEvent.SpawnReason, [Consumer]);

This method requires four parameters:

1. Location

The position where the entity should be spawned.

Kotlin

Location(world, 0.0, 64.0, 0.0)

Java

new Location(world, 0.0, 64.0, 0.0)

2. Class

The class of the injected entity you want to spawn.

Kotlin

Capybara::class.java

Java

Capybara.class

3. EntitySpawnReason

The (NMS) reason for spawning the entity, stored in the entity data.

For example, when spawning via a command:

Kotlin

EntitySpawnReason.COMMAND

Java

EntitySpawnReason.COMMAND

4. CreatureSpawnEvent.SpawnReason

The (Bukkit) spawn reason, used for Bukkit events.

For example, when spawning via a command:

Kotlin

CreatureSpawnEvent.SpawnReason.COMMAND

Java

CreatureSpawnEvent.SpawnReason.COMMAND

5. Consumer (optional)

A function that allows you to modify the entity just before it is spawned.
This is useful if you want to customize the entity, right after creation.

Entities with custom names

At the time of writing this, BetterModel does not support entities with custom names.

Attributes must be applied later

Attributes are applied to entities right before they are spawned, that means that any attributes applied in this consumer will probably get overwritten by the default entity attributes.