Comment on page

Event API

Introduction
PlotSquared uses the Guava EventBus to register listeners and dispatch events.
Event List
Check the Javadoc of PlotSquared events.
Getting an instance
import org.bukkit.Bukkit;
import org.bukkit.plugin.java.JavaPlugin;
​
public class MyPlotPlugin extends JavaPlugin {
    public static MyPlotPlugin THIS;
​
    @Override
    public void onEnable() {
        MyPlotPlugin.THIS = this;
        if (Bukkit.getPluginManager().getPlugin("PlotSquared") != null) {
        // Do something
       }
    }
}
Registering a Listener
Registering a listener is super easy. Add the @Subscribe (from the com.google.common.eventbus package) annotation to any methods that are listening to events, register the class with the EventBus through PlotAPI#registerListener(Class) and you're done! One example:
public class P2Listener {
​
  // if you like the dependency-injection-like approach:
  public P2Listener(PlotAPI api) {
    api.registerListener(this);
  }
​
  // less OOP, but if you want to make things easy:
  public P2Listener() {
    PlotAPI api = new PlotAPI();
    api.registerListener(this);
  }
​
  // A method handling a PlayerEnterPlotEvent
  @Subscribe
  public void onPlayerEnterPlot(PlayerEnterPlotEvent e) {
    //do stuff
  }
}

API - Previous

API documentation

Next - API

Flag API

Last modified 4mo ago