Overview
IrisEngineHotloadEvent extends IrisEngineEvent and is fired when an Iris engine performs a hotload operation, reloading dimension data without requiring a server restart.
Event Properties
| Property | Type | Description |
|---|---|---|
engine | Engine | The Iris engine instance that was hotloaded |
IrisEngineEvent
When It Fires
This event fires when:- A developer uses
/iris hotloadcommand - Dimension configuration files are reloaded at runtime
- Changes to biomes, objects, or other dimension data are applied without restart
Important Notes
- This event is asynchronous (inherited from
IrisEngineEvent) - Cannot be cancelled
- Useful for clearing caches or reloading custom integrations when dimension data changes
Event Handler Examples
Basic Hotload Detection
Clear Custom Caches
Notify Online Players
Reload Custom Generators
Comparison with IrisEngineEvent
| Feature | IrisEngineEvent | IrisEngineHotloadEvent |
|---|---|---|
| When fired | General engine operations | Specifically on hotload |
| Use case | Monitor all engine events | React to configuration reloads |
| Specificity | Broad | Narrow |
Registering the Event
Register your listener in your plugin’sonEnable() method:
Source Code Reference
Location:core/src/main/java/com/volmit/iris/core/events/IrisEngineHotloadEvent.java