Package net.minecraftforge.event.entity.living

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:

• SpawnPlacementRegisterEvent

API Note:

If your modifications are for a single entity, and do not vary at runtime, use SpawnPlacementRegisterEvent.

Nested Class Summary

Nested classes/interfaces inherited from class net.minecraftforge.eventbus.api.Event

net.minecraftforge.eventbus.api.Event.HasResult, net.minecraftforge.eventbus.api.Event.Result

Field Summary

Fields

Modifier and Type	Field	Description
private final boolean	defaultResult
private final EntityType<?>	entityType
private final ServerLevelAccessor	level
private final BlockPos	pos
private final RandomSource	random
private final MobSpawnType	spawnType

Constructor Summary

Constructors

Constructor	Description
SpawnPlacementCheck(EntityType<?> entityType, ServerLevelAccessor level, MobSpawnType spawnType, BlockPos pos, RandomSource random, boolean defaultResult)	Internal.

Method Summary

Modifier and Type	Method	Description
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.
EntityType<?>	getEntityType()
ServerLevelAccessor	getLevel()
BlockPos	getPos()
RandomSource	getRandom()	In all vanilla cases, this is equal to LevelAccessor.getRandom().
MobSpawnType	getSpawnType()	Retrieves the type of mob spawn that is happening.

Methods inherited from class net.minecraftforge.eventbus.api.Event

getListenerList, getPhase, getResult, hasResult, isCancelable, isCanceled, setCanceled, setPhase, setResult

Methods inherited from class java.lang.Object

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

Field Details

entityType

private final EntityType<?> entityType

level

private final ServerLevelAccessor level

spawnType

private final MobSpawnType spawnType

pos

private final BlockPos pos

random

private final RandomSource random

defaultResult

private final boolean defaultResult

Constructor Details

SpawnPlacementCheck

@Internal
public SpawnPlacementCheck(EntityType<?> entityType,
 ServerLevelAccessor level,
 MobSpawnType spawnType,
 BlockPos pos,
 RandomSource random,
 boolean defaultResult)

Internal.

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:

• MobSpawnType

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.