RankForge Custom Events – PointsChange, TierUp & TierDown

RankForge provides custom Bukkit events under xyz.noxlydev.rankforge.api.event. Listen to them using standard Bukkit @EventHandler annotations.

Event Triggers

Important Event Notice

These events are dispatched when points change via the setPoints / addPoints / removePoints API methods. Direct in-game PvP kill/death events or administrative commands (/rankforge setpoints) execute internally. To intercept normal PvP kills, listen to PlayerDeathEvent and query the API.

Event	Cancellable	Fired When	Player Online Check
PlayerPointsChangeEvent	Yes	Prior to committing points through the API	Always
PlayerTierUpEvent	No	After points increase crossing into a higher tier	Player is online
PlayerTierDownEvent	No	After points drop into a lower tier or unranked	Player is online

PlayerPointsChangeEvent

Allows listening to, cancelling, or dynamically adjusting points:

@EventHandler
public void onPointsChange(PlayerPointsChangeEvent event) {
    if (event.getDifference() > 0) {
        Player online = event.getPlayer().getPlayer();
        if (online != null && online.hasPermission("myplugin.vip")) {
            int bonus = (int) Math.ceil(event.getDifference() * 0.10);
            event.setNewPoints(event.getNewPoints() + bonus);
        }
    }
}

PlayerTierUpEvent & PlayerTierDownEvent

@EventHandler
public void onTierUp(PlayerTierUpEvent event) {
    Player player = event.getPlayer();
    Tier oldTier = event.getOldTier();
    Tier newTier = event.getNewTier();

    player.sendMessage("Congratulations on reaching " + newTier.display + "!");
}