mirror of https://github.com/FabricMC/fabric.git synced 2024-11-24 00:28:10 -05:00

History

Technici4n 23a79c8a40 Block Entity Lifecycle fixes (#2783 ) - Fire client chunk unload event when the load distance is decreased. Fixes #1821. - Fire client chunk unload event before entities are cleared from the chunk to fix block entity unload event not firing. Clarify that block entity data is unreliable in the block entity load events. Fixes #2423.		2022-12-23 16:34:09 +00:00
..
src	Block Entity Lifecycle fixes (#2783 )	2022-12-23 16:34:09 +00:00
build.gradle	Port to 22w06a (#1989 )	2022-02-11 17:02:44 +00:00
README.md	Add readme for fabric-lifecycle-events-v1 (#1119 )	2020-12-05 19:05:40 +00:00

README.md

Fabric Lifecycle Events (V1)

Contains events which indicate when the lifecycle of a Minecraft client, Minecraft server and the lifecycle objects which exist on the client and server has changed.

Organization

Events in this module belong to a single class which relates to the category of events. The event callbacks to be implemented are nested classes within.

For example, if you are listening to ServerLifecycleEvents.SERVER_STARTING in ServerLifecycleEvents the callback interface that would be implemented is ServerLifecycleEvents.ServerStarting.

Server Events

Events related to objects on a logical server. These classes are located in net.fabricmc.fabric.api.event.lifecycle.v1.

`ServerLifecycleEvents`

Contains lifecycle events related to a Minecraft server. This includes events which indicate when a server is starting up, is in a data pack reload or shutting down.

`ServerTickEvents`

Contains events related to the ticking of a Minecraft server. There are events that indicate the beginning and end of the tick for the server and each ServerWorld.

`ServerWorldEvents`

Events related to the lifecycle a ServerWorld. Currently, this contains events related to loading and unloading ServerWorlds.

`ServerChunkEvents`

Events related to the lifecycle of chunks in a ServerWorld. Currently, this contains events related to loading and unloading chunks in a ServerWorld.

`ServerEntityEvents`

Events related to the lifecycle of entities in a ServerWorld. Currently, this only contains an event for an entity being loaded into a ServerWorld. The unload event has not been implemented yet.

`ServerBlockEntityEvents`

Events related to the lifecycle of block entities in a ServerWorld. Currently, this contains events related to loading and unloading block entities in a ServerWorld.

Client Events

Events related to objects on a logical client. These classes are located in net.fabricmc.fabric.api.client.event.lifecycle.v1.

Note: These events are only available on a client. Trying to access these events on a dedicated server will cause the game to crash.

`ClientLifecycleEvents`

Events related to the lifecycle of a Minecraft client. Currently, this contains events related to when the Minecraft Client is starting or stopping.

`ClientTickEvents`

Events related to ticking of a Minecraft client. There are events that indicate the beginning and end of the tick for the client and the ClientWorld if in game.

`ClientChunkEvents`

Events related to the lifecycle of chunks on a Minecraft client. Currently, this contains events related to loading and unloading chunks in a ClientWorld.

`ClientEntityEvents`

Events related to the lifecycle of entities in a ClientWorld. Currently, this contains event for an entity being loaded into a ClientWorld.

`ClientBlockEntityEvents`

Events related to the lifecycle of block entities in a ClientWorld. Currently, this contains events related to loading and unloading block entities in a ClientWorld.