Custom Entities

The Entity Module allows you to create and configure custom entities. You can design unique mobs with specific stats, equipment, and appearances to serve as enemies, allies, or interactive characters in your game.

Manage your custom entities in /editmap -> Entities (Zombie Head).

Creating a Custom Entity

1. Go to the Entities menu.
2. Click "Add Entity" and select the base entity type (e.g., ZOMBIE, VILLAGER, ARMOR_STAND).
3. Give your new entity a unique name.
4. This opens the Entity Edit Menu where you can configure its properties.

Configuring a Custom Entity

In the Entity Edit Menu, you can define every aspect of your entity.

General Settings

• Name: The custom name that appears above the entity's head. Supports color codes.
• AI: Toggle whether the entity has its default AI (e.g., if disabled, a zombie won't attack players).
• Invulnerable: Makes the entity immune to all damage.
• Silent: Prevents the entity from making sounds.
• Invisible: Makes the entity invisible.
• Collidable: Toggles whether players and other entities can pass through it.

Appearance & Equipment

• Equipment: Click to open the Equipment Menu. Here you can set the entity's armor, held items (main hand and off-hand), and the drop chance for each item.
• Entity-Specific Options: Many entities have unique options. For example:
  • Zombies/Skeletons: Can be set as babies.
  • Sheep: Can have their wool color set.
  • Villagers: Can have their profession and biome type set.
  • Creepers: Can be set as "Powered" (charged).

Health & Effects

• Maximum Health: Set the entity's max health.
• Potion Effects: Apply permanent potion effects to the entity, such as Speed, Strength, or Invisibility.

Spawning a Custom Entity

Creating a custom entity only defines its template. To bring it into your game world, you must use an action.

• Spawn Custom Entity Action: This action spawns an instance of your configured entity at a specific location.
• Kill Action: Use this on an entity to remove it from the world.
• Change Property (Entity): You can store a spawned entity in an Entity Property to reference it later, for example, to teleport it or make it ride another entity.

Example: Creating a "Miniboss Zombie"

1. Create Entity: Create a new custom entity named Miniboss Zombie with the ZOMBIE type.
2. Configure Stats:
   • In the Entity Edit Menu, set Maximum Health to 50 (25 hearts).
   • Set its Name to &cMiniboss Zombie.
3. Configure Equipment:
   • Open the Equipment menu.
   • Give it a full set of diamond armor and a diamond sword.
   • Set the drop chance for each piece to 0% so it doesn't drop its gear on death.
4. Create a Spawn Trigger:
   • Create a region named Boss Arena.
   • Add a Player Enter Region event to it.
   • Set the event's Execution Mode to Once so it only triggers one time.
5. Add Spawn Action:
   • Inside the event, add a Spawn Custom Entity action.
   • Select your Miniboss Zombie as the entity to spawn.
   • Set the Location to the center of your boss arena.

Now, the first time a player enters the Boss Arena region, your custom miniboss will spawn.