Class MobSpawnEvent.SpawnPlacementCheck

java.lang.Object
net.minecraftforge.eventbus.api.Event
net.minecraftforge.event.entity.living.MobSpawnEvent.SpawnPlacementCheck
Enclosing class:
MobSpawnEvent

public static class MobSpawnEvent.SpawnPlacementCheck extends net.minecraftforge.eventbus.api.Event
This event is fired when Spawn Placements (aka Spawn Rules) are checked, before a mob attempts to spawn.
Spawn Placement checks include light levels, slime chunks, grass blocks for animals, and others in the same vein.
The purpose of this event is to permit runtime changes to any or all spawn placement logic without having to wrap the placement for each entity.

This event has a result.
To change the result of this event, use Event.setResult(net.minecraftforge.eventbus.api.Event.Result). Results are interpreted in the following manner:

  • Allow - The check will succeed, and the spawn process will continue.
  • Default - The value of the vanilla check will be used to determine success.
  • Deny - The check will fail, and the spawn process will abort.
This event is fired on the main Forge event bus, only on the logical server.

This event is not fired for mob spawners which utilize CustomSpawnRules, as they do not check spawn placements.

See Also:
  • Field Details

  • Constructor Details

  • Method Details

    • getEntityType

      public EntityType<?> getEntityType()
      Returns:
      The type of entity that checks are being performed for.
    • getLevel

      public ServerLevelAccessor getLevel()
      Returns:
      The level relating to the mob spawn action
    • getSpawnType

      public MobSpawnType getSpawnType()
      Retrieves the type of mob spawn that is happening.
      Returns:
      The mob spawn type.
      See Also:
    • getPos

      public BlockPos getPos()
      Returns:
      The position where checks are being evaluated.
    • getRandom

      public RandomSource getRandom()
      In all vanilla cases, this is equal to LevelAccessor.getRandom().
      Returns:
      The random source being used.
    • getDefaultResult

      public boolean getDefaultResult()
      The default vanilla result is useful if an additional check wants to force Event.Result.ALLOW only if the vanilla check would succeed.
      Returns:
      The result of the vanilla spawn placement check.