API Events

HuskTowns provides several API events your plugin can listen to when players do certain town-related things. These events deal in HuskTowns class types, so you may want to familiarize yourself with the API basics first. Note that on cross-server setups, events only fire on the server the event occurred on and will not fire as a result of API calls/updates.

Consult the Javadocs for more information—and don't forget to register your listener when listening for these event calls.

List of API Events

Bukkit Event class	Since	Cancellable	Description
`TownCreateEvent`	1.8	✅	Called when a town is created
`PostTownCreateEvent`	2.6	❌	Called after a town is created
`TownUpdateEvent`	3.1.3	❌	Called when a town is updated
`TownDisbandEvent`	1.8	✅	Called when a town is deleted
`ClaimEvent`	1.8	✅	Called when a player claims a chunk for a town
`UnClaimEvent`	1.8	✅	Called when a player deletes a claim
`UnClaimAllEvent`	2.1	✅	Called when a player deletes all of a town's claims
`PlayerEnterTownEvent`	2.0	✅	Called when a player walks into a town claim from wilderness or another town
`PlayerLeaveTownEvent`	2.0	✅	Called when a player walks out of a town claim into wilderness or another town
`MemberJoinEvent`	2.0	✅	Called when a player joins a town
`MemberLeaveEvent`	2.0	✅	Called when a player leaves or is evicted from a town
`MemberRoleChangeEvent`	2.0	✅	Called when a player is promoted or demoted within a town
`TownWarCreateEvent`	3.0.6	❌	Called when a town war starts
`TownWarEndEvent`	3.0.6	❌	Called when a town war ends