minecraft-src/net/minecraft/world/level/LevelAccessor.java

package net.minecraft.world.level;

import net.minecraft.core.BlockPos;
import net.minecraft.core.Direction;
import net.minecraft.core.Holder;
import net.minecraft.core.particles.ParticleOptions;
import net.minecraft.core.registries.Registries;
import net.minecraft.resources.ResourceKey;
import net.minecraft.server.MinecraftServer;
import net.minecraft.sounds.SoundEvent;
import net.minecraft.sounds.SoundSource;
import net.minecraft.util.RandomSource;
import net.minecraft.world.Difficulty;
import net.minecraft.world.DifficultyInstance;
import net.minecraft.world.entity.Entity;
import net.minecraft.world.entity.player.Player;
import net.minecraft.world.level.block.Block;
import net.minecraft.world.level.block.state.BlockState;
import net.minecraft.world.level.chunk.ChunkSource;
import net.minecraft.world.level.gameevent.GameEvent;
import net.minecraft.world.level.material.Fluid;
import net.minecraft.world.level.redstone.NeighborUpdater;
import net.minecraft.world.level.storage.LevelData;
import net.minecraft.world.phys.Vec3;
import net.minecraft.world.ticks.LevelTickAccess;
import net.minecraft.world.ticks.ScheduledTick;
import net.minecraft.world.ticks.TickPriority;
import org.jetbrains.annotations.Nullable;

public interface LevelAccessor extends CommonLevelAccessor, LevelTimeAccess {
	@Override
	default long dayTime() {
		return this.getLevelData().getDayTime();
	}

	long nextSubTickCount();

	LevelTickAccess<Block> getBlockTicks();

	private <T> ScheduledTick<T> createTick(BlockPos pos, T type, int delay, TickPriority priority) {
		return new ScheduledTick<>(type, pos, this.getLevelData().getGameTime() + delay, priority, this.nextSubTickCount());
	}

	private <T> ScheduledTick<T> createTick(BlockPos pos, T type, int delay) {
		return new ScheduledTick<>(type, pos, this.getLevelData().getGameTime() + delay, this.nextSubTickCount());
	}

	default void scheduleTick(BlockPos pos, Block block, int delay, TickPriority priority) {
		this.getBlockTicks().schedule(this.createTick(pos, block, delay, priority));
	}

	default void scheduleTick(BlockPos pos, Block block, int delay) {
		this.getBlockTicks().schedule(this.createTick(pos, block, delay));
	}

	LevelTickAccess<Fluid> getFluidTicks();

	default void scheduleTick(BlockPos pos, Fluid fluid, int delay, TickPriority priority) {
		this.getFluidTicks().schedule(this.createTick(pos, fluid, delay, priority));
	}

	default void scheduleTick(BlockPos pos, Fluid fluid, int delay) {
		this.getFluidTicks().schedule(this.createTick(pos, fluid, delay));
	}

	/**
	 * Returns the world's WorldInfo object
	 */
	LevelData getLevelData();

	DifficultyInstance getCurrentDifficultyAt(BlockPos pos);

	@Nullable
	MinecraftServer getServer();

	default Difficulty getDifficulty() {
		return this.getLevelData().getDifficulty();
	}

	/**
	 * Gets the world's chunk provider
	 */
	ChunkSource getChunkSource();

	@Override
	default boolean hasChunk(int chunkX, int chunkZ) {
		return this.getChunkSource().hasChunk(chunkX, chunkZ);
	}

	RandomSource getRandom();

	default void blockUpdated(BlockPos pos, Block block) {
	}

	/**
	 * @param queried The block state of the current block
	 * @param pos The position of the neighbor block
	 * @param offsetPos The position of the current block
	 */
	default void neighborShapeChanged(Direction direction, BlockState queried, BlockPos pos, BlockPos offsetPos, int flags, int recursionLevel) {
		NeighborUpdater.executeShapeUpdate(this, direction, queried, pos, offsetPos, flags, recursionLevel - 1);
	}

	default void playSound(@Nullable Player player, BlockPos pos, SoundEvent sound, SoundSource source) {
		this.playSound(player, pos, sound, source, 1.0F, 1.0F);
	}

	/**
	 * Plays a sound. On the server, the sound is broadcast to all nearby <em>except</em> the given player. On the client, the sound only plays if the given player is the client player. Thus, this method is intended to be called from code running on both sides. The client plays it locally and the server plays it for everyone else.
	 */
	void playSound(@Nullable Player player, BlockPos pos, SoundEvent sound, SoundSource source, float volume, float pitch);

	void addParticle(ParticleOptions particleData, double x, double y, double z, double xSpeed, double ySpeed, double zSpeed);

	void levelEvent(@Nullable Player player, int type, BlockPos pos, int data);

	default void levelEvent(int type, BlockPos pos, int data) {
		this.levelEvent(null, type, pos, data);
	}

	void gameEvent(Holder<GameEvent> gameEvent, Vec3 pos, GameEvent.Context context);

	default void gameEvent(@Nullable Entity entity, Holder<GameEvent> gameEvent, Vec3 pos) {
		this.gameEvent(gameEvent, pos, new GameEvent.Context(entity, null));
	}

	default void gameEvent(@Nullable Entity entity, Holder<GameEvent> gameEvent, BlockPos pos) {
		this.gameEvent(gameEvent, pos, new GameEvent.Context(entity, null));
	}

	default void gameEvent(Holder<GameEvent> gameEvent, BlockPos pos, GameEvent.Context context) {
		this.gameEvent(gameEvent, Vec3.atCenterOf(pos), context);
	}

	default void gameEvent(ResourceKey<GameEvent> gameEvent, BlockPos pos, GameEvent.Context context) {
		this.gameEvent(this.registryAccess().registryOrThrow(Registries.GAME_EVENT).getHolderOrThrow(gameEvent), pos, context);
	}
}