Package net.neoforged.neoforge.event.level

Class ChunkTicketLevelUpdatedEvent

java.lang.Object
net.neoforged.bus.api.Event
net.neoforged.neoforge.event.level.ChunkTicketLevelUpdatedEvent
public class ChunkTicketLevelUpdatedEvent extends net.neoforged.bus.api.Event
This event is fired whenever a chunk has its ticket level changed via the server's ChunkMap.

This event does not fire if the new ticket level is the same as the old level, or if both the new AND old ticket levels represent values past the max chunk distance.

Due to how vanilla processes ticket level changes this event may be fired "twice" in one tick for the same chunk. The scenario where this happens is when increasing the level from say 31 (ticking) to 32, the way vanilla does it is by first changing it from 31 to 46, and then queuing the update from 46 to 32. However, when going from 32 to 31, vanilla is able to go directly.

This event is not

invalid reference 
cancellable
and does not
invalid reference 
have a result
.

This event is fired on the main Forge event bus only on the logical server.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    private final @Nullable net.minecraft.server.level.ChunkHolder
    chunkHolder
     
    private final long
    chunkPos
     
    private final net.minecraft.server.level.ServerLevel
    level
     
    private final int
    newTicketLevel
     
    private final int
    oldTicketLevel
     

  • Constructor Summary

    Constructors
    Constructor
    Description
    ChunkTicketLevelUpdatedEvent(net.minecraft.server.level.ServerLevel level, long chunkPos, int oldTicketLevel, int newTicketLevel, @Nullable net.minecraft.server.level.ChunkHolder chunkHolder)
     

  • Method Summary

    Modifier and Type
    Method
    Description
    @Nullable net.minecraft.server.level.ChunkHolder
    getChunkHolder()
    Returns chunk that had its ticket level updated.
    long
    getChunkPos()
    Returns the long representation of the chunk position the ticket level changed for.
    net.minecraft.server.level.ServerLevel
    getLevel()
    Returns the server level containing the chunk.
    int
    getNewTicketLevel()
    Returns the new ticket level for the chunk.
    int
    getOldTicketLevel()
    Returns the previous ticket level the chunk had.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

    • level

      private final net.minecraft.server.level.ServerLevel level

    • chunkPos

      private final long chunkPos

    • oldTicketLevel

      private final int oldTicketLevel

    • newTicketLevel

      private final int newTicketLevel

    • chunkHolder

      @Nullable private final @Nullable net.minecraft.server.level.ChunkHolder chunkHolder

  • Constructor Details

    • ChunkTicketLevelUpdatedEvent

      public ChunkTicketLevelUpdatedEvent(net.minecraft.server.level.ServerLevel level, long chunkPos, int oldTicketLevel, int newTicketLevel, @Nullable @Nullable net.minecraft.server.level.ChunkHolder chunkHolder)

  • Method Details

    • getLevel

      public net.minecraft.server.level.ServerLevel getLevel()
      Returns the server level containing the chunk.
      Returns:
      the server level containing the chunk

    • getChunkPos

      public long getChunkPos()
      Returns the long representation of the chunk position the ticket level changed for.
      Returns:
      the long representation of the chunk position the ticket level changed for

    • getOldTicketLevel

      public int getOldTicketLevel()
      Returns the previous ticket level the chunk had.
      Returns:
      the previous ticket level the chunk had

    • getNewTicketLevel

      public int getNewTicketLevel()
      Returns the new ticket level for the chunk.
      Returns:
      the new ticket level for the chunk

    • getChunkHolder

      @Nullable public @Nullable net.minecraft.server.level.ChunkHolder getChunkHolder()
      Returns chunk that had its ticket level updated.
      Returns:
      chunk that had its ticket level updated