net.risingworld.api.events.world

Class ItemElementCollisionEvent

java.lang.Object

net.risingworld.api.events.Event

net.risingworld.api.events.world.ItemElementCollisionEvent

public class ItemElementCollisionEvent
extends Event

Called when an item "touches" a World3DModel, or more precisely, when the item collides with the collision shape of the element. This means the event only works for elements which have a collision shape.
If the item does no longer collide with the world element, the event is triggered again (isColliding() returns false in this case).

This event only works if World3DModel.setListenForCollisions(boolean) is set to true.

See Also:

PlayerElementCollisionEvent

Example: If an item touches the element, throw it away and create an explosion after a few seconds

1	@EventMethod
2	public void onItemElementCollision(ItemElementCollisionEvent e){
3	//Get the item which triggered this event
4	WorldItem item = e.getItem();
5
6	//Get the world element which was involved in this event
7	WorldElement element = e.getWorldElement();
8
9	//Create a new vector for the "physical impulse" (to throw the item away)
10	Vector3f impulse = new Vector3f();
11
12	//Math: Get impulse vector which leads away from the world element
13	impulse.set(item.getPosition()).subtractLocal(element.getPosition());
14
15	//We "normalize" the vector, i.e. turn it into a unit vector...
16	impulse.normalizeLocal();
17
18	//...this gives better control over the impulse, since we can multiply it with a scalar
19	impulse.multLocal(15f);
20
21	//Now apply the physical impulse to the item!
22	item.applyPhysicalImpulse(impulse);
23
24	//Finally create a timer which triggers once after 2 seconds to create an explosion
25	Timer timer = new Timer(0f, 2f, 0, () -> {
26	getWorld().triggerExplosion(item.getPosition(), true, true);
27	});
28
29	//Remember to start the timer, otherwise it's useless...
30	timer.start();
31	}

Constructor Summary

Constructors

Constructor and Description
ItemElementCollisionEvent(WorldItem item, WorldElement worldElement, boolean colliding, float appliedImpulse)

Method Summary

Modifier and Type	Method and Description
WorldItem	getItem()
WorldElement	getWorldElement() Gets the world element.
boolean	isColliding() Gets whether or not the item is currently "touching" (colliding with) the element.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ItemElementCollisionEvent

public ItemElementCollisionEvent(WorldItem item,
                                 WorldElement worldElement,
                                 boolean colliding,
                                 float appliedImpulse)

Method Detail

getItem

public WorldItem getItem()

getWorldElement

public WorldElement getWorldElement()

Gets the world element.

Returns:

the world element.

isColliding

public boolean isColliding()

Gets whether or not the item is currently "touching" (colliding with) the element.

Returns:

true if the item collides with the element (start collision), false if the item is no longer colliding with the element (stop collision). False is only returned if the item collided with the element previously.