Description
KubeJS Extended Events Addon - Complete Introduction
This powerful addon for KubeJS introduces a vast array of new event listeners, empowering developers to intercept and control Minecraft's game logic with unprecedented granularity. It significantly expands the capabilities of KubeJS on the server side, allowing you to monitor low-level events such as entity movement, collisions, block entity operations, item durability damage, and even death messages, with the ability to modify or cancel these vanilla behaviors.
Event Groups & Details
1. Projectile Events Group
This group focuses on the behavior of various projectiles.
projectile.tick: Fires every game tick for a projectile (e.g., arrows, fireballs) as it updates and moves through the world.
projectile.shoot: Triggers the moment a projectile is launched. This event can be cancelled, allowing you to prevent or alter the shooting action.
2. Block Entity Events Group
This group allows you to monitor activities related to block entities like furnaces and chests.
block_entity.death: Triggers when a block entity is destroyed or removed from the world.
block_entity.tick: Fires every game tick for a block entity. Ideal for adding dynamic logic to custom blocks.
3. Item Entity Events Group
This group focuses on item entities that are dropped on the ground.
item_entity.hurt: Triggers when a dropped item entity (e.g., when it's about to be burned by fire or attacked by a player) takes damage.
item_entity.tick: Fires every game tick, monitoring the state of a dropped item in the world.
4. MEJS Expansion Events Group
This is a comprehensive event group that provides deep control over general entities, player interactions, and game systems.
durabilityDamage: Triggers when an item's durability is about to decrease. This event can be cancelled, enabling features like unbreakable items or custom durability loss logic.
entityStartRiding: Triggers when a player starts riding an entity (e.g., a horse, a boat). This event can be cancelled to allow or deny the riding action.
entityStopRiding: Triggers when a player stops riding an entity. This event can be cancelled to control whether a player can dismount.
entityTick: Fires every game tick for every entity. This is an extremely powerful and versatile event.
entityCollision: Triggers when an entity collides with a block or another entity. This event can be cancelled to modify the outcome of the collision (e.g., bouncing, canceling damage).
entityMove: Triggers when an entity changes its position. This event can be cancelled, allowing you to prevent movement or alter its path.
deathMessage: Triggers when a player's death message is about to be displayed in the chat. This event can be cancelled, allowing you to fully customize the content of the death message.
Key Features
Granular Control: Provides low-level access to core game mechanics like entity movement, collision, and riding, giving your scripts superior control.
Interceptable Game Flow: Multiple critical events are marked with hasResult(), meaning your scripts can actively cancel or modify the default behavior of the vanilla game.
Broad Application Scope: Events cover a wide spectrum, from projectiles and block entities to general entities and player interactions, offering limitless possibilities for developing functional mods, map mechanics, or quality-of-life improvements.
In conclusion, this addon is an essential tool for any developer looking to push the boundaries of what's possible with KubeJS, elevating your modding ideas to a new level.