Custom Events
AstralTown fires the following Bukkit events. All events extend org.bukkit.event.Event and can be listened to with @EventHandler as usual.
Town lifecycle
TownCreateEvent
Fired immediately after a town has been persisted but before its creator is notified.
Cancellable: Yes — cancelling rolls back the creation.
Method | Return | Description |
|---|---|---|
|
| Creator. |
|
| The freshly-created town. |
TownDisbandEvent
Fired before a disband is committed.
Cancellable: Yes.
Method | Return | Description |
|---|---|---|
|
| The actor. |
|
| The town about to be deleted. |
TownDisbandedEvent
Fired after disband, once all cascading deletes complete.
Cancellable: No. May fire async.
Method | Return | Description |
|---|---|---|
|
| The deleted town (state is final). |
Use this event to clean up data tied to a town from your own plugin's storage.
Selection
TownSelectEvent/TownUnselectEvent
Fired when a player sets or clears their selected town through /town select or the select-town action.
Cancellable: No.
Method | Return | Description |
|---|---|---|
|
| The player. |
|
| The town being (un)selected. |
Movement
TownEnterEvent/TownExitEvent
Fired by ClaimListener when a player crosses the boundary between two ownership states (wilderness ↔ town, town A ↔ town B).
Cancellable: No.
Method | Return | Description |
|---|---|---|
|
| The player. |
|
| The town the player just entered / left. |
These events drive the welcome / goodbye message system (VISITORS_NOTIFICATIONS setting).
Claims
TownClaimEvent/TownUnclaimEvent
Fired after a chunk is claimed or unclaimed.
Cancellable: No (the operation already committed; reject earlier via permission).
Method | Return | Description |
|---|---|---|
|
| Actor. |
|
| Town. |
|
| The chunk record. |
Members
TownMemberJoinEvent
Fired right after a member is added to a town's roster (invitation accepted, or admin add).
Cancellable: No.
Method | Return |
|---|---|
|
|
|
|
|
|
TownMemberLeaveEvent
Fired right after a member is removed (leave, kick, ban).
Cancellable: No.
Same accessor surface as TownMemberJoinEvent.
Settings
TownSettingChangedEvent
Fired whenever a TownSettings flag flips.
Cancellable: No.
Method | Return | Description |
|---|---|---|
|
| Owner town. |
|
| The flag that changed. |
|
| New state. |
Summary
Event | Async | Cancellable | When |
|---|---|---|---|
| No | Yes | After persistence, before notification. |
| No | Yes | Before cascade. |
| Possibly | No | After cascade. |
| No | No | Player selects a town. |
| No | No | Player clears selection. |
| No | No | Player enters a claim. |
| No | No | Player exits a claim. |
| No | No | Chunk claimed. |
| No | No | Chunk unclaimed. |
| No | No | Member joined. |
| No | No | Member left. |
| No | No | Setting flipped. |