RyanDo at 09:43, 12 October 2025

2025-10-12T09:43:46Z

← Older revision		Revision as of 09:43, 12 October 2025
Line 1:		Line 1:
	~~[[BKCommonLib\|« Go back]]~~

	==Introduction==		==Introduction==
	The EntityController class contains various methods a plugin can override to alter entity behaviour.		The EntityController class contains various methods a plugin can override to alter entity behaviour.

RyanDo: Created page with "« Go back ==Introduction== The EntityController class contains various methods a plugin can override to alter entity behaviour. ==Functionalities== * Alteri..."

2021-06-09T18:15:44Z

Created page with "« Go back ==Introduction== The EntityController class contains various methods a plugin can override to alter entity behaviour. ==Functionalities== * Alteri..."

New page

[[BKCommonLib|« Go back]]

==Introduction==
The EntityController class contains various methods a plugin can override to alter entity behaviour.

==Functionalities==
* Altering, cancelling or completely rewriting entity movement physics
* Handling block collisions, cancelling them
* Handling entity collisions, cancelling them
* Handling onTick to disable or completely alter Entity logic
* Handling damage dealt to the Entity
* Handling entity interaction (by players)
* Altering the name of an Entity
* Handling when an Entity dies

==How to use==
Entity Controllers are used in combination with Common Entities. Assigning one is fairly simple: use setController. There is no need to manually bind the entity to the controller, setController takes care of that for you.

For example, here we assign an onBlockCollision handler for items to create an explosion.

<pre>Item item = ...;
CommonItem entity = CommonEntity.get(item);
entity.setController(new EntityController<CommonItem>() {
@Override
public boolean onBlockCollision(Block block, BlockFace hitFace) {
block.getWorld().createExplosion(block.getLocation(), 5.0f);
return false;
}
});</pre>
What you put in the (overridden) methods is completely up to you. You can (literally) make pigs fly.

==Replacing all entities==
If you wish to replace all entities globally, so set controllers whenever a new Entity is added to the server, you can use the EntityAdd event provided by BKCommonLib:

<pre>@EventHandler(priority = EventPriority.LOWEST)
public void onEntityAdd(EntityAddEvent event) {
if (!(event.getEntity() instanceof Item)) {
return;
}
CommonEntity.get((Item) event.getEntity()).setController(new CustomItemController());
}</pre>

BKCommonLib/Controller - Revision history

RyanDo at 09:43, 12 October 2025

RyanDo: Created page with "« Go back ==Introduction== The EntityController class contains various methods a plugin can override to alter entity behaviour. ==Functionalities== * Alteri..."