Package net.neoforged.neoforge.client.event

Class RegisterGuiOverlaysEvent

java.lang.Object

net.neoforged.bus.api.Event

net.neoforged.neoforge.client.event.RegisterGuiOverlaysEvent

All Implemented Interfaces:

net.neoforged.fml.event.IModBusEvent

public class RegisterGuiOverlaysEvent
extends net.neoforged.bus.api.Event
implements net.neoforged.fml.event.IModBusEvent

Allows users to register custom GUI overlays.

This event is not cancellable, and does not have a result.

This event is fired on the mod-specific event bus, only on the logical client.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static enum	RegisterGuiOverlaysEvent.Ordering

Nested classes/interfaces inherited from class net.neoforged.bus.api.Event

net.neoforged.bus.api.Event.HasResult, net.neoforged.bus.api.Event.Result

Field Summary

Fields

Modifier and Type	Field	Description
private final List<ResourceLocation>	orderedOverlays
private final Map<ResourceLocation,IGuiOverlay>	overlays

Constructor Summary

Constructors

Constructor	Description
RegisterGuiOverlaysEvent(Map<ResourceLocation,IGuiOverlay> overlays, List<ResourceLocation> orderedOverlays)

Method Summary

Modifier and Type	Method	Description
private void	register(@NotNull RegisterGuiOverlaysEvent.Ordering ordering, @Nullable ResourceLocation other, @NotNull ResourceLocation key, @NotNull IGuiOverlay overlay)
void	registerAbove(@NotNull ResourceLocation other, @NotNull String id, @NotNull IGuiOverlay overlay)	Deprecated, for removal: This API element is subject to removal in a future version. Use the RL-explicit variant instead; mod ID inference will be removed in a later update, alongside the move of registration events to the NeoForge main bus
void	registerAbove(@NotNull ResourceLocation other, @NotNull ResourceLocation id, @NotNull IGuiOverlay overlay)	Registers an overlay that renders above another.
void	registerAboveAll(@NotNull String id, @NotNull IGuiOverlay overlay)	Deprecated, for removal: This API element is subject to removal in a future version. Use the RL-explicit variant instead; mod ID inference will be removed in a later update, alongside the move of registration events to the NeoForge main bus
void	registerAboveAll(@NotNull ResourceLocation id, @NotNull IGuiOverlay overlay)	Registers an overlay that renders above all others.
void	registerBelow(@NotNull ResourceLocation other, @NotNull String id, @NotNull IGuiOverlay overlay)	Deprecated, for removal: This API element is subject to removal in a future version. Use the RL-explicit variant instead; mod ID inference will be removed in a later update, alongside the move of registration events to the NeoForge main bus
void	registerBelow(@NotNull ResourceLocation other, @NotNull ResourceLocation id, @NotNull IGuiOverlay overlay)	Registers an overlay that renders below another.
void	registerBelowAll(@NotNull String id, @NotNull IGuiOverlay overlay)	Deprecated, for removal: This API element is subject to removal in a future version. Use the RL-explicit variant instead; mod ID inference will be removed in a later update, alongside the move of registration events to the NeoForge main bus
void	registerBelowAll(@NotNull ResourceLocation id, @NotNull IGuiOverlay overlay)	Registers an overlay that renders below all others.

Methods inherited from class net.neoforged.bus.api.Event

getResult, hasResult, setResult

Methods inherited from class java.lang.Object

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

Field Details

overlays

private final Map<ResourceLocation,IGuiOverlay> overlays

orderedOverlays

private final List<ResourceLocation> orderedOverlays

Constructor Details

RegisterGuiOverlaysEvent

@Internal
public RegisterGuiOverlaysEvent(Map<ResourceLocation,IGuiOverlay> overlays,
 List<ResourceLocation> orderedOverlays)

Method Details

registerBelowAll

@Deprecated(forRemoval=true,
            since="1.20.2")
public void registerBelowAll(@NotNull
 @NotNull String id,
 @NotNull
 @NotNull IGuiOverlay overlay)

Deprecated, for removal: This API element is subject to removal in a future version.

Use the RL-explicit variant instead; mod ID inference will be removed in a later update, alongside the move of registration events to the NeoForge main bus

Registers an overlay that renders below all others.

Parameters:

id - A unique resource id for this overlay

overlay - The overlay

registerBelowAll

public void registerBelowAll(@NotNull
 @NotNull ResourceLocation id,
 @NotNull
 @NotNull IGuiOverlay overlay)

Registers an overlay that renders below all others.

Parameters:

id - A unique resource id for this overlay

overlay - The overlay

registerBelow

@Deprecated(forRemoval=true,
            since="1.20.2")
public void registerBelow(@NotNull
 @NotNull ResourceLocation other,
 @NotNull
 @NotNull String id,
 @NotNull
 @NotNull IGuiOverlay overlay)

Deprecated, for removal: This API element is subject to removal in a future version.

Use the RL-explicit variant instead; mod ID inference will be removed in a later update, alongside the move of registration events to the NeoForge main bus

Registers an overlay that renders below another.

Parameters:

other - The id of the overlay to render below. This must be an overlay you have already registered or a vanilla overlay. Do not use other mods' overlays.

id - A unique resource id for this overlay

overlay - The overlay

registerBelow

public void registerBelow(@NotNull
 @NotNull ResourceLocation other,
 @NotNull
 @NotNull ResourceLocation id,
 @NotNull
 @NotNull IGuiOverlay overlay)

Registers an overlay that renders below another.

Parameters:

other - The id of the overlay to render below. This must be an overlay you have already registered or a vanilla overlay. Do not use other mods' overlays.

id - A unique resource id for this overlay

overlay - The overlay

registerAbove

@Deprecated(forRemoval=true,
            since="1.20.2")
public void registerAbove(@NotNull
 @NotNull ResourceLocation other,
 @NotNull
 @NotNull String id,
 @NotNull
 @NotNull IGuiOverlay overlay)

Deprecated, for removal: This API element is subject to removal in a future version.

Use the RL-explicit variant instead; mod ID inference will be removed in a later update, alongside the move of registration events to the NeoForge main bus

Registers an overlay that renders above another.

Parameters:

other - The id of the overlay to render above. This must be an overlay you have already registered or a vanilla overlay. Do not use other mods' overlays.

id - A unique resource id for this overlay

overlay - The overlay

registerAbove

public void registerAbove(@NotNull
 @NotNull ResourceLocation other,
 @NotNull
 @NotNull ResourceLocation id,
 @NotNull
 @NotNull IGuiOverlay overlay)

Registers an overlay that renders above another.

Parameters:

other - The id of the overlay to render above. This must be an overlay you have already registered or a vanilla overlay. Do not use other mods' overlays.

id - A unique resource id for this overlay

overlay - The overlay

registerAboveAll

@Deprecated(forRemoval=true,
            since="1.20.2")
public void registerAboveAll(@NotNull
 @NotNull String id,
 @NotNull
 @NotNull IGuiOverlay overlay)

Deprecated, for removal: This API element is subject to removal in a future version.

Use the RL-explicit variant instead; mod ID inference will be removed in a later update, alongside the move of registration events to the NeoForge main bus

Registers an overlay that renders above all others.

Parameters:

id - A unique resource id for this overlay

overlay - The overlay

registerAboveAll

public void registerAboveAll(@NotNull
 @NotNull ResourceLocation id,
 @NotNull
 @NotNull IGuiOverlay overlay)

Registers an overlay that renders above all others.

Parameters:

id - A unique resource id for this overlay

overlay - The overlay

register

private void register(@NotNull
 @NotNull RegisterGuiOverlaysEvent.Ordering ordering,
 @Nullable
 @Nullable ResourceLocation other,
 @NotNull
 @NotNull ResourceLocation key,
 @NotNull
 @NotNull IGuiOverlay overlay)