Developer API

RogueHomesAPI exposes immutable async access through ServicesManager.

Resolve the service after plugins have enabled. Always handle a missing provider so your plugin fails clearly instead of crashing.

// Add RogueHomesAPI from the installed plugin API to your imports.
RogueHomesAPI api = Bukkit.getServicesManager().load(RogueHomesAPI.class);

if (api == null) {
    getLogger().warning("RogueHomesAPI is unavailable; disabling this integration.");
    getServer().getPluginManager().disablePlugin(this);
    return;
}

// Keep the reference and call only methods exposed by your installed version.

Register Bukkit listeners normally and use only event methods exposed by the installed API. Pre-events marked cancellable can stop an operation; completed events report an outcome after it has happened.

• Pre-create/create
• Pre-delete/delete
• Rename
• Relocate
• Pre-teleport/teleport/teleport-cancel