mirror of
https://github.com/MinecraftForge/MinecraftForge.git
synced 2026-11-19 03:49:14 +00:00
* Bump pack.mcmeta formats * 1.19 biome modifiers * Mark ClientPlayerNetworkEvent.LoggedOutEvent's getters as nullable * Add docs and package-info to client extension interfaces package * Move RenderBlockOverlayEvent hooks to ForgeHooksClient * Add package-infos to client events package * Rename SoundLoadEvent to SoundEngineLoadEvent This reduces confusion from consumers which may think the name SoundLoadEvent refers to an individual sound being loaded rather than the sound engine. * Document and change SoundLoadEvent to fire on mod bus Previously, it fired on both the mod bus and the Forge bus, which is confusing for consumers. * Delete SoundSetupEvent Looking at its original implementation shows that there isn't an appropriate place in the new sound code to reinsert the event, and the place of 'sound engine/manager initialization event' is taken already by SoundLoadEvent. * Perform some cleanup on client events - Removed nullable annotations from ClientPlayerNetworkEvent - Renamed #getPartialTicks methods to #getPartialTick, to be consistent with vanilla's naming of the partial tick - Cleanup documentation to remove line breaks, use the spelling 'cancelled' over 'canceled', and improve docs on existing and new methods. * Remove EntityEvent.CanUpdate Closes MinecraftForge/MinecraftForge#6394 * Switch to Jetbrains nullability annotations * New PlayLevelSoundEvent; replaces old PlaySoundAtEntityEvent * Remove ForgeWorldPresetScreens * Remove IForgeRegistryEntry * Remove use of List<Throwable> in FML's CompletableFutures * Add docs to mod loading stages, stages, and phases * Gradle 7.4.2 * Use SLF4J in FMLLoader and other subprojects * Switch dynamic versions in subprojects to pinned ones * Switch ForgeRoot and MDK to FG plugin markers * Configure Forge javadoc task The task now uses a custom stylesheet with MCForge elements, and configured to combine the generation from the four FML subprojects (fmlloader, fmlcore, javafmllanguage, mclanguage) and the Forge project into the javadoc output. * Update docs/md files, for 1.19 update and the move away from IRC to Discord. * Make "Potentially dangerous alternative prefix" a debug warning, not info. Co-authored-by: Curle <[email protected]> Co-authored-by: sciwhiz12 <[email protected]> Signed-off-by: SizableShrimp <[email protected]>
83 lines
2.2 KiB
Java
83 lines
2.2 KiB
Java
/*
|
|
* Copyright (c) Forge Development LLC and contributors
|
|
* SPDX-License-Identifier: LGPL-2.1-only
|
|
*/
|
|
|
|
package net.minecraftforge.event;
|
|
|
|
import net.minecraft.world.entity.Entity;
|
|
import net.minecraft.world.level.Level;
|
|
import net.minecraft.world.level.gameevent.GameEvent;
|
|
import net.minecraft.world.phys.Vec3;
|
|
import net.minecraftforge.common.MinecraftForge;
|
|
import net.minecraftforge.eventbus.api.Cancelable;
|
|
import net.minecraftforge.eventbus.api.Event;
|
|
import org.jetbrains.annotations.Nullable;
|
|
|
|
/**
|
|
* VanillaGameEvent is fired on the server whenever one of Vanilla's {@link GameEvent GameEvents} fire. <br>
|
|
* <br>
|
|
* This allows for listening to Vanilla's events in a more structured and global way that is not tied to needing a block entity listener. <br>
|
|
* <br>
|
|
* This event is fired on the {@link MinecraftForge#EVENT_BUS}. <br>
|
|
* <br>
|
|
* Cancel this event to prevent Vanilla from posting the {@link GameEvent} to all nearby {@link net.minecraft.world.level.gameevent.GameEventListener GameEventListeners}.
|
|
**/
|
|
@Cancelable
|
|
public class VanillaGameEvent extends Event
|
|
{
|
|
private final Level level;
|
|
private final GameEvent vanillaEvent;
|
|
private final Vec3 position;
|
|
private final GameEvent.Context context;
|
|
|
|
public VanillaGameEvent(Level level, GameEvent vanillaEvent, Vec3 position, GameEvent.Context context)
|
|
{
|
|
this.level = level;
|
|
this.vanillaEvent = vanillaEvent;
|
|
this.position = position;
|
|
this.context = context;
|
|
}
|
|
|
|
/**
|
|
* @return The level the Vanilla {@link GameEvent} occurred.
|
|
*/
|
|
public Level getLevel()
|
|
{
|
|
return level;
|
|
}
|
|
|
|
/**
|
|
* @return The entity that was the source or "cause" of the {@link GameEvent}.
|
|
*/
|
|
@Nullable
|
|
public Entity getCause()
|
|
{
|
|
return context.sourceEntity();
|
|
}
|
|
|
|
/**
|
|
* @return The Vanilla event.
|
|
*/
|
|
public GameEvent getVanillaEvent()
|
|
{
|
|
return vanillaEvent;
|
|
}
|
|
|
|
/**
|
|
* @return The position the event took place at.
|
|
*/
|
|
public Vec3 getEventPosition()
|
|
{
|
|
return position;
|
|
}
|
|
|
|
/**
|
|
* @return the context of the vanilla event
|
|
*/
|
|
public GameEvent.Context getContext()
|
|
{
|
|
return context;
|
|
}
|
|
}
|