API events

Package: com.example.marketplace.api.event. Standard Bukkit Event + HandlerList. None are Cancellable.

ListingCreatedEvent

Fired: after a successful list in MarketManager.sellItem.

public MarketListing getListing();

ListingRemovedEvent

Fired: removeListing and forceExpire.

public MarketListing getListing();
public String getReason();

Reasons in code:

The expiry timer (30 min) does not fire this event.

TransactionCompletedEvent

Fired: only after buy commit (COMPLETED).

public MarketTransaction getTransaction();

No events for FAILED, ROLLED_BACK, or refund (error = REFUND:<timestamp>).

Registration

public final class MarketListener implements Listener {
    @EventHandler
    public void onCreate(ListingCreatedEvent event) {
        int id = event.getListing().getId();
    }

    @EventHandler
    public void onRemove(ListingRemovedEvent event) {
        String reason = event.getReason();
    }

    @EventHandler
    public void onDone(TransactionCompletedEvent event) {
        String txId = event.getTransaction().getId();
    }
}

An exception in a listener does not undo the listing or purchase — the plugin logs a warning and continues.