Events

ScalaPlot publishes a set of custom Bukkit events (package com.scala.plotAPI.events) that you can listen to with a regular @EventHandler, exactly like any other Bukkit event.

All events extend the abstract class PlotEvent, which exposes:

public abstract class PlotEvent extends Event {
    public IPlot getPlot();
}

Many events also extend PlotCancellableEvent (implementing Cancellable), letting you cancel them to prevent the action that triggered them.

Event list

Event	Cancellable	Description	Extra methods
`PlotClaimEvent`	✅	A player claims a plot	`getPlayer()`
`PlotDeleteEvent`	✅	A plot is deleted	`getPlayer()`
`PlotEnterEvent`	✅	A player enters a plot	`getPlayer()`
`PlotLeaveEvent`	✅	A player leaves a plot	`getPlayer()`
`PlotOwnerChangeEvent`	✅	A plot’s owner changes	`getOldOwner()`, `getNewOwner()`
`PlotTrustEvent`	✅	A player is added to the trusted list	`getPlayerId()`
`PlotUntrustEvent`	✅	A player is removed from the trusted list	`getPlayerId()`
`PlotBanEvent`	✅	A player is banned from the plot	`getPlayerId()`
`PlotUnbanEvent`	✅	A player is unbanned from the plot	`getPlayerId()`
`PlotReportEvent`	✅	A plot is reported (Premium)	`getPlayer()`, `getReason()`
`PlotBackupEvent`	✅	A backup of the plot is created	`getBackupFilePath()`, `getBackupFile()`

Example: blocking entry to a plot

import com.scala.plotAPI.events.PlotEnterEvent;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;

public class MyListener implements Listener {

    @EventHandler
    public void onPlotEnter(PlotEnterEvent event) {
        if (someCondition(event.getPlayer())) {
            event.setCancelled(true);
            event.getPlayer().sendMessage("You can't enter this plot right now!");
        }
    }
}

Example: reacting to a claim

@EventHandler
public void onClaim(PlotClaimEvent event) {
    getLogger().info(event.getPlayer().getName() + " claimed plot " + event.getPlot());
}