EasterEggPlaceEvent

The EasterEggPlaceEvent is triggered whenever a server administrator or a player with the correct permissions successfully places an Easter Egg block into the world. This event is useful for tracking setups, logging administrative actions, or triggering custom world notifications.

Technical Overview

Parent Class: EasterEggsEvent
Cancellable: No

Methods

Since this event extends EasterEggsEvent, you have access to getUser() in addition to the following specific method:

Method	Return Type	Description
`getEggId()`	`String`	Returns the specific ID of the Easter Egg that was just placed.

Common Use Cases

Audit Logging: Log exactly who placed which eggs to keep track of your server’s setup process and prevent unauthorized placements.
Staff Alerts: Send a silent notification to other staff members or a Discord webhook when a new egg is hidden in the world.
Dynamic World Events: Broadcast a global chat message or play a server-wide sound hinting to players that a new egg has just been hidden.

Example Usage

The following example demonstrates how to listen for this event and send a formatted alert to all online administrators when a new egg is hidden.

import org.bukkit.Bukkit;
import org.bukkit.entity.Player;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;

public class EggPlacementListener implements Listener {

    @EventHandler
    public void onEggPlace(EasterEggPlaceEvent event) {
        // Accessing the Bukkit Player who placed the egg
        Player admin = event.getUser().getPlayer();
        String eggId = event.getEggId();

        // Send a notification to players with administrative permissions
        for (Player online : Bukkit.getOnlinePlayers()) {
            if (online.hasPermission("eastereggs.admin")) {
                online.sendMessage("§8[§6Admin Alert§8] §e" + admin.getName() + " §7has just hidden a new §6" + eggId + " §7egg!");
            }
        }
    }
}