Package net.minecraftforge.registries

Class RegistryObject<T>

java.lang.Object
net.minecraftforge.registries.RegistryObject<T>
All Implemented Interfaces:
Supplier<T>
public final class RegistryObject<T> extends Object implements Supplier<T>

  • Field Details

    • name

      @Nullable private final @Nullable ResourceLocation name

    • key

      @Nullable private @Nullable ResourceKey<T> key

    • optionalRegistry

      private final boolean optionalRegistry

    • value

      @Nullable private T value

    • holder

      @Nullable private @Nullable Supplier<Holder<T>> holder

    • EMPTY

      private static final RegistryObject<?> EMPTY

  • Constructor Details

  • Method Details

    • create

      public static <T, U extends T> RegistryObject<U> create(ResourceLocation name, IForgeRegistry<T> registry)
      Factory for a RegistryObject that stores the value of an object from the provided forge registry once it is ready.
      Parameters:
      name - the name of the object to look up in the forge registry
      registry - the forge registry
      Returns:
      a RegistryObject that stores the value of an object from the provided forge registry once it is ready

    • create

      public static <T, U extends T> RegistryObject<U> create(ResourceLocation name, ResourceKey<? extends Registry<T>> registryKey, String modid)
      Factory for a RegistryObject that stores the value of an object from a registry once it is ready based on a lookup of the provided registry key.

      If a registry with the given key cannot be found, an exception will be thrown when trying to fill this RegistryObject. Use createOptional(ResourceLocation, ResourceKey, String) for RegistryObjects of optional registries.

      Parameters:
      name - the name of the object to look up in a registry
      registryKey - the key of the registry. Supports lookups on BuiltInRegistries and RegistryManager.ACTIVE.
      modid - the mod id calling context
      Returns:
      a RegistryObject that stores the value of an object from a registry once it is ready
      See Also:

    • createOptional

      public static <T, U extends T> RegistryObject<U> createOptional(ResourceLocation name, ResourceKey<? extends Registry<T>> registryKey, String modid)
      Factory for a RegistryObject that optionally stores the value of an object from a registry once it is ready if the registry exists based on a lookup of the provided registry key.

      If a registry with the given key cannot be found, it will be silently ignored and this RegistryObject will not be filled. Use create(ResourceLocation, ResourceKey, String) for RegistryObjects that should throw exceptions on missing registry.

      Parameters:
      name - the name of the object to look up in a registry
      registryKey - the key of the registry. Supports lookups on BuiltInRegistries and RegistryManager.ACTIVE.
      modid - the mod id calling context
      Returns:
      a RegistryObject that stores the value of an object from a registry once it is ready
      See Also:

    • create

      public static <T, U extends T> RegistryObject<U> create(ResourceLocation name, ResourceLocation registryName, String modid)
      Factory for a RegistryObject that stores the value of an object from a registry once it is ready based on a lookup of the provided registry name.

      If a registry with the given name cannot be found, an exception will be thrown when trying to fill this RegistryObject. Use createOptional(ResourceLocation, ResourceLocation, String) for RegistryObjects of optional registries.

      Parameters:
      name - the name of the object to look up in a registry
      registryName - the name of the registry. Supports lookups on BuiltInRegistries and RegistryManager.ACTIVE.
      modid - the mod id calling context
      Returns:
      a RegistryObject that stores the value of an object from a registry once it is ready
      See Also:

    • createOptional

      public static <T, U extends T> RegistryObject<U> createOptional(ResourceLocation name, ResourceLocation registryName, String modid)
      Factory for a RegistryObject that optionally stores the value of an object from a registry once it is ready if the registry exists based on a lookup of the provided registry name.

      If a registry with the given name cannot be found, it will be silently ignored and this RegistryObject will not be filled. Use create(ResourceLocation, ResourceLocation, String) for RegistryObjects that should throw exceptions on missing registry.

      Parameters:
      name - the name of the object to look up in a registry
      registryName - the name of the registry. Supports lookups on BuiltInRegistries and RegistryManager.ACTIVE.
      modid - the mod id calling context
      Returns:
      a RegistryObject that stores the value of an object from a registry once it is ready
      See Also:

    • empty

      private static <T> RegistryObject<T> empty()

    • get

      @NotNull public T get()
      Retrieves the wrapped object in the registry. This value will automatically be updated when the backing registry is updated.
      Specified by:
      get in interface Supplier<T>
      Throws:
      NullPointerException - If the value is null. Use isPresent() to check if the value exists first.
      See Also:

    • updateReference

      void updateReference(IForgeRegistry<? extends T> registry)

    • updateReference

      void updateReference(Registry<? extends T> registry)

    • updateReference

      void updateReference(ResourceLocation registryName)

    • updateReference

      void updateReference(RegisterEvent event)

    • registryExists

      private static boolean registryExists(ResourceLocation registryName)

    • getId

      public ResourceLocation getId()

    • getKey

      @Nullable public @Nullable ResourceKey<T> getKey()
      Returns the resource key that points to the registry and name of this registry object. Nullable only if this RegistryObject is empty and has no name.
      Returns:
      the resource key that points to the registry and name of this registry object

    • stream

      public Stream<T> stream()

    • isPresent

      public boolean isPresent()
      Return true if there is a mod object present, otherwise false.
      Returns:
      true if there is a mod object present, otherwise false

    • ifPresent

      public void ifPresent(Consumer<? super T> consumer)
      If a mod object is present, invoke the specified consumer with the object, otherwise do nothing.
      Parameters:
      consumer - block to be executed if a mod object is present
      Throws:
      NullPointerException - if mod object is present and consumer is null

    • filter

      public RegistryObject<T> filter(Predicate<? super T> predicate)
      If a mod object is present, and the mod object matches the given predicate, return an RegistryObject describing the value, otherwise return an empty RegistryObject.
      Parameters:
      predicate - a predicate to apply to the mod object, if present
      Returns:
      an RegistryObject describing the value of this RegistryObject if a mod object is present and the mod object matches the given predicate, otherwise an empty RegistryObject
      Throws:
      NullPointerException - if the predicate is null

    • map

      public <U> Optional<U> map(Function<? super T,? extends U> mapper)
      If a mod object is present, apply the provided mapping function to it, and if the result is non-null, return an Optional describing the result. Otherwise return an empty Optional.
      Type Parameters:
      U - The type of the result of the mapping function
      Parameters:
      mapper - a mapping function to apply to the mod object, if present
      Returns:
      an Optional describing the result of applying a mapping function to the mod object of this RegistryObject, if a mod object is present, otherwise an empty Optional
      Throws:
      NullPointerException - if the mapping function is null
      API Note:
      This method supports post-processing on optional values, without the need to explicitly check for a return status.

    • flatMap

      public <U> Optional<U> flatMap(Function<? super T,Optional<U>> mapper)
      If a value is present, apply the provided Optional-bearing mapping function to it, return that result, otherwise return an empty Optional. This method is similar to map(Function), but the provided mapper is one whose result is already an Optional, and if invoked, flatMap does not wrap it with an additional Optional.
      Type Parameters:
      U - The type parameter to the Optional returned by
      Parameters:
      mapper - a mapping function to apply to the mod object, if present the mapping function
      Returns:
      the result of applying an Optional-bearing mapping function to the value of this Optional, if a value is present, otherwise an empty Optional
      Throws:
      NullPointerException - if the mapping function is null or returns a null result

    • lazyMap

      public <U> Supplier<U> lazyMap(Function<? super T,? extends U> mapper)
      If a mod object is present, lazily apply the provided mapping function to it, returning a supplier for the transformed result. If this object is empty, or the mapping function returns null, the supplier will return null.
      Type Parameters:
      U - The type of the result of the mapping function
      Parameters:
      mapper - A mapping function to apply to the mod object, if present
      Returns:
      A Supplier lazily providing the result of applying a mapping function to the mod object of this RegistryObject, if a mod object is present, otherwise a supplier returning null
      Throws:
      NullPointerException - if the mapping function is null
      API Note:
      This method supports post-processing on optional values, without the need to explicitly check for a return status.

    • orElse

      public T orElse(T other)
      Return the mod object if present, otherwise return other.
      Parameters:
      other - the mod object to be returned if there is no mod object present, may be null
      Returns:
      the mod object, if present, otherwise other

    • orElseGet

      public T orElseGet(Supplier<? extends T> other)
      Return the mod object if present, otherwise invoke other and return the result of that invocation.
      Parameters:
      other - a Supplier whose result is returned if no mod object is present
      Returns:
      the mod object if present otherwise the result of other.get()
      Throws:
      NullPointerException - if mod object is not present and other is null

    • orElseThrow

      public <X extends Throwable> T orElseThrow(Supplier<? extends X> exceptionSupplier) throws X
      Return the contained mod object, if present, otherwise throw an exception to be created by the provided supplier.
      Type Parameters:
      X - Type of the exception to be thrown
      Parameters:
      exceptionSupplier - The supplier which will return the exception to be thrown
      Returns:
      the present mod object
      Throws:
      X - if there is no mod object present
      NullPointerException - if no mod object is present and exceptionSupplier is null
      API Note:
      A method reference to the exception constructor with an empty argument list can be used as the supplier. For example, IllegalStateException::new

    • getHolder

      @NotNull public @NotNull Optional<Holder<T>> getHolder()
      Returns an optional Holder instance pointing to this RegistryObject's name and value.

      This should only be used in cases where vanilla code requires passing in a Holder. Mod-written code should rely on RegistryObjects or Suppliers instead.

      The returned optional will be empty if the registry does not exist or if returns false.

      Returns:
      an optional Holder instance pointing to this RegistryObject's name and value

    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object