Using Events

Events are the triggers that make your map interactive. They are the "when" in your game's logic—for example, when a player enters a region, when a block is broken, or when a player dies.

Events are configured within Regions. You first define an area, and then you define what happens when certain events occur inside that area.

How to Configure Events

1. Go to /editmap -> Regions.
2. Select the region you want to add logic to, or create a new one.
3. Click on the "Events" item (Redstone).
4. You will see a list of all available event types. Click on one to create a new Event Handler for it.
5. Once created, you can configure its Actions and its specific Configuration.

Event Data (Action Values)

Each event provides specific pieces of information, called Action Values, that your actions can use. For example, a Player Break Block event provides:

• The Player who broke the block.
• The Block that was broken.

When you configure an action within this event, you can tell it to target the Player from the event or use the Block's location.

Common Event Configuration

Most events have their own unique configuration menu, but many share these common options:

• Filtering by Block/Entity Type: For events like Player Break Block or Entity Death, you can specify that the event should only trigger for a certain type of block (e.g., only Diamond Ore) or entity (e.g., only Zombies).
• Execution Mode: You can control how often an event can be triggered.
  • Always: The event runs every single time it happens.
  • Once Per Player: The event will only run the first time each player triggers it.
  • Once: The event runs only the very first time it's triggered by anyone, and then never again.
• Cancel Event: Many events have a "Cancel" option. If enabled, the original Minecraft action will be stopped. For example, if you set "Cancel" to true on a Player Break Block event, the block will not actually break.

---

Player Events

These events are triggered by actions performed by players.

Entity Events

These events are triggered by non-player entities, such as mobs or projectiles.

World Events

These events are related to changes in the game world, like explosions.

Property Events

These events are triggered by changes in your game's logic.