Package net.minecraft.resource

Class NamespaceResourceManager

java.lang.Object

net.minecraft.resource.NamespaceResourceManager

All Implemented Interfaces:

ResourceFactory, ResourceManager

public class NamespaceResourceManager
extends Object
implements ResourceManager

A resource manager that only loads resources for a specific namespace. This is an implementation detail for LifecycledResourceManagerImpl, based on the heuristic that most namespaces are only defined in few resource packs, making loading in those namespaces faster.

See Also:

• LifecycledResourceManagerImpl

Mappings:

Namespace	Name
official	agc
intermediary	net/minecraft/class_3294
named	net/minecraft/resource/NamespaceResourceManager

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	NamespaceResourceManager.DebugInputStream
private class	NamespaceResourceManager.Entry
private static final record	NamespaceResourceManager.EntryList
private static final record	NamespaceResourceManager.FilterablePack

Nested classes/interfaces inherited from interface net.minecraft.resource.ResourceManager

ResourceManager.Empty

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static final org.slf4j.Logger	LOGGER
private final String	namespace
protected final List<NamespaceResourceManager.FilterablePack>	packList
(package private) final ResourceType	type

Constructor Summary

Constructors

Constructor	Description
NamespaceResourceManager(ResourceType type, String namespace)

Method Summary

Modifier and Type	Method	Description
private void	addPack(String name, @Nullable ResourcePack underlyingPack, @Nullable Predicate<Identifier> filter)
void	addPack(String name, Predicate<Identifier> filter)
void	addPack(ResourcePack pack)
void	addPack(ResourcePack pack, Predicate<Identifier> filter)
private static void	applyFilter(NamespaceResourceManager.FilterablePack pack, Map<Identifier,NamespaceResourceManager.EntryList> idToEntryList)
boolean	containsResource(Identifier id)	Checks whether any of the currently-loaded resource packs contain an entry for the given id.
Map<Identifier,List<ResourceRef>>	findAllResources(String startingPath, Predicate<Identifier> allowedPathPredicate)
private void	findAndAdd(NamespaceResourceManager.FilterablePack pack, String startingPath, Predicate<Identifier> allowedPathPredicate, Map<Identifier,NamespaceResourceManager.EntryList> idToEntryList)
Map<Identifier,ResourceRef>	findResources(String startingPath, Predicate<Identifier> allowedPathPredicate)	Returns a sorted list of identifiers matching a path predicate.
Set<String>	getAllNamespaces()	Gets a set of all namespaces offered by the resource packs loaded by this manager.
List<ResourceRef>	getAllResources(Identifier id)	Gets all of the available resources to the corresponding resource identifier.
(package private) static Identifier	getMetadataPath(Identifier id)
Resource	getResource(Identifier id)	Finds and returns the corresponding resource for a resource's identifier.
private boolean	isPathAbsolute(Identifier id)
protected InputStream	open(Identifier id, ResourcePack pack)
Stream<ResourcePack>	streamResourcePacks()	Gets a stream of loaded resource packs in increasing order of priority.
private void	validate(Identifier id)

Methods inherited from class java.lang.Object

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

Field Details

LOGGER

static final org.slf4j.Logger LOGGER

Mappings:

Namespace	Name	Mixin selector
official	b	Lagc;b:Lorg/slf4j/Logger;
intermediary	field_14285	Lnet/minecraft/class_3294;field_14285:Lorg/slf4j/Logger;
named	LOGGER	Lnet/minecraft/resource/NamespaceResourceManager;LOGGER:Lorg/slf4j/Logger;

packList

protected final List<NamespaceResourceManager.FilterablePack> packList

Mappings:

Namespace	Name	Mixin selector
official	a	Lagc;a:Ljava/util/List;
intermediary	field_14283	Lnet/minecraft/class_3294;field_14283:Ljava/util/List;
named	packList	Lnet/minecraft/resource/NamespaceResourceManager;packList:Ljava/util/List;

type

final ResourceType type

Mappings:

Namespace	Name	Mixin selector
official	c	Lagc;c:Lafk;
intermediary	field_14284	Lnet/minecraft/class_3294;field_14284:Lnet/minecraft/class_3264;
named	type	Lnet/minecraft/resource/NamespaceResourceManager;type:Lnet/minecraft/resource/ResourceType;

namespace

private final String namespace

Mappings:

Namespace	Name	Mixin selector
official	d	Lagc;d:Ljava/lang/String;
intermediary	field_21561	Lnet/minecraft/class_3294;field_21561:Ljava/lang/String;
named	namespace	Lnet/minecraft/resource/NamespaceResourceManager;namespace:Ljava/lang/String;

Constructor Details

NamespaceResourceManager

public NamespaceResourceManager(ResourceType type,
 String namespace)

Mappings:

Namespace	Name	Mixin selector
official	<init>	Lagc;<init>(Lafk;Ljava/lang/String;)V
intermediary	<init>	Lnet/minecraft/class_3294;<init>(Lnet/minecraft/class_3264;Ljava/lang/String;)V
named	<init>	Lnet/minecraft/resource/NamespaceResourceManager;<init>(Lnet/minecraft/resource/ResourceType;Ljava/lang/String;)V

Method Details

addPack

public void addPack(ResourcePack pack)

Mappings:

Namespace	Name	Mixin selector
official	a	Lagc;a(Lafj;)V
intermediary	method_24233	Lnet/minecraft/class_3294;method_24233(Lnet/minecraft/class_3262;)V
named	addPack	Lnet/minecraft/resource/NamespaceResourceManager;addPack(Lnet/minecraft/resource/ResourcePack;)V

addPack

public void addPack(ResourcePack pack,
 Predicate<Identifier> filter)

Mappings:

Namespace	Name	Mixin selector
official	a	Lagc;a(Lafj;Ljava/util/function/Predicate;)V
intermediary	method_41256	Lnet/minecraft/class_3294;method_41256(Lnet/minecraft/class_3262;Ljava/util/function/Predicate;)V
named	addPack	Lnet/minecraft/resource/NamespaceResourceManager;addPack(Lnet/minecraft/resource/ResourcePack;Ljava/util/function/Predicate;)V

addPack

public void addPack(String name,
 Predicate<Identifier> filter)

Mappings:

Namespace	Name	Mixin selector
official	a	Lagc;a(Ljava/lang/String;Ljava/util/function/Predicate;)V
intermediary	method_41261	Lnet/minecraft/class_3294;method_41261(Ljava/lang/String;Ljava/util/function/Predicate;)V
named	addPack	Lnet/minecraft/resource/NamespaceResourceManager;addPack(Ljava/lang/String;Ljava/util/function/Predicate;)V

addPack

private void addPack(String name,
 @Nullable
 @Nullable ResourcePack underlyingPack,
 @Nullable
 @Nullable Predicate<Identifier> filter)

Mappings:

Namespace	Name	Mixin selector
official	a	Lagc;a(Ljava/lang/String;Lafj;Ljava/util/function/Predicate;)V
intermediary	method_41260	Lnet/minecraft/class_3294;method_41260(Ljava/lang/String;Lnet/minecraft/class_3262;Ljava/util/function/Predicate;)V
named	addPack	Lnet/minecraft/resource/NamespaceResourceManager;addPack(Ljava/lang/String;Lnet/minecraft/resource/ResourcePack;Ljava/util/function/Predicate;)V

getAllNamespaces

public Set<String> getAllNamespaces()

Gets a set of all namespaces offered by the resource packs loaded by this manager.

Specified by:

getAllNamespaces in interface ResourceManager

Mappings:

Namespace	Name	Mixin selector
official	a	Lagk;a()Ljava/util/Set;
intermediary	method_14487	Lnet/minecraft/class_3300;method_14487()Ljava/util/Set;
named	getAllNamespaces	Lnet/minecraft/resource/ResourceManager;getAllNamespaces()Ljava/util/Set;

getResource

public Resource getResource(Identifier id)
                     throws IOException

Finds and returns the corresponding resource for a resource's identifier.

Starts by scanning each resource pack from highest priority to lowest. If no resource packs were found to contain the requested entry, will throw a FileNotFoundException.

The returned resource must be closed to avoid resource leaks.

Specified by:

getResource in interface ResourceFactory

Parameters:

id - the resource identifier to search for

Throws:

FileNotFoundException - if the identified resource could not be found, or could not be loaded.

IOException - if the identified resource was found but a stream to it could not be opened.

Mappings:

Namespace	Name	Mixin selector
official	getResource	Lagm;getResource(Lza;)Lagi;
intermediary	method_14486	Lnet/minecraft/class_5912;method_14486(Lnet/minecraft/class_2960;)Lnet/minecraft/class_3298;
named	getResource	Lnet/minecraft/resource/ResourceFactory;getResource(Lnet/minecraft/util/Identifier;)Lnet/minecraft/resource/Resource;

containsResource

public boolean containsResource(Identifier id)

Checks whether any of the currently-loaded resource packs contain an entry for the given id.

Starts by querying the resource pack with the highest priority to lowest until it finds one that responds to the requested identifier.

Specified by:

containsResource in interface ResourceManager

Parameters:

id - the resource identifier to search for

Mappings:

Namespace	Name	Mixin selector
official	a	Lagk;a(Lza;)Z
intermediary	method_18234	Lnet/minecraft/class_3300;method_18234(Lnet/minecraft/class_2960;)Z
named	containsResource	Lnet/minecraft/resource/ResourceManager;containsResource(Lnet/minecraft/util/Identifier;)Z

open

protected InputStream open(Identifier id,
 ResourcePack pack)
                    throws IOException

Throws:

IOException

Mappings:

Namespace	Name	Mixin selector
official	a	Lagc;a(Lza;Lafj;)Ljava/io/InputStream;
intermediary	method_14476	Lnet/minecraft/class_3294;method_14476(Lnet/minecraft/class_2960;Lnet/minecraft/class_3262;)Ljava/io/InputStream;
named	open	Lnet/minecraft/resource/NamespaceResourceManager;open(Lnet/minecraft/util/Identifier;Lnet/minecraft/resource/ResourcePack;)Ljava/io/InputStream;

validate

private void validate(Identifier id)
               throws IOException

Throws:

IOException

Mappings:

Namespace	Name	Mixin selector
official	d	Lagc;d(Lza;)V
intermediary	method_14472	Lnet/minecraft/class_3294;method_14472(Lnet/minecraft/class_2960;)V
named	validate	Lnet/minecraft/resource/NamespaceResourceManager;validate(Lnet/minecraft/util/Identifier;)V

isPathAbsolute

private boolean isPathAbsolute(Identifier id)

Mappings:

Namespace	Name	Mixin selector
official	e	Lagc;e(Lza;)Z
intermediary	method_18221	Lnet/minecraft/class_3294;method_18221(Lnet/minecraft/class_2960;)Z
named	isPathAbsolute	Lnet/minecraft/resource/NamespaceResourceManager;isPathAbsolute(Lnet/minecraft/util/Identifier;)Z

getAllResources

public List<ResourceRef> getAllResources(Identifier id)
                                  throws IOException

Gets all of the available resources to the corresponding resource identifier.

Resources are returned in load order, or ascending order of priority, so the last element in the returned list is what would be returned normally by ResourceFactory.getResource(net.minecraft.util.Identifier)

Each resource in this returned list must be closed to avoid resource leaks.

Specified by:

getAllResources in interface ResourceManager

Parameters:

id - the resource identifier to search for

Throws:

FileNotFoundException - if no matching resources could be found (i.e. if the list would be empty)

IOException - if resources were found, but any one of them could not be opened to be read.

Mappings:

Namespace	Name	Mixin selector
official	b	Lagk;b(Lza;)Ljava/util/List;
intermediary	method_14489	Lnet/minecraft/class_3300;method_14489(Lnet/minecraft/class_2960;)Ljava/util/List;
named	getAllResources	Lnet/minecraft/resource/ResourceManager;getAllResources(Lnet/minecraft/util/Identifier;)Ljava/util/List;

findResources

public Map<Identifier,ResourceRef> findResources(String startingPath,
 Predicate<Identifier> allowedPathPredicate)

Returns a sorted list of identifiers matching a path predicate.

Scanning begins in startingPath and each candidate file present under that directory will be offered up to the predicate to decide whether it should be included or not.

Elements in the returned list may not, necessarily be unique. Additional effort is advised to ensure that duplicates in the returned list are discarded before loading.

Specified by:

findResources in interface ResourceManager

Parameters:

startingPath - the starting path to begin scanning from

allowedPathPredicate - a predicate to determine whether a path should be included or not

Returns:

the list matching identifiers

Mappings:

Namespace	Name	Mixin selector
official	b	Lagk;b(Ljava/lang/String;Ljava/util/function/Predicate;)Ljava/util/Map;
intermediary	method_14488	Lnet/minecraft/class_3300;method_14488(Ljava/lang/String;Ljava/util/function/Predicate;)Ljava/util/Map;
named	findResources	Lnet/minecraft/resource/ResourceManager;findResources(Ljava/lang/String;Ljava/util/function/Predicate;)Ljava/util/Map;

applyFilter

private static void applyFilter(NamespaceResourceManager.FilterablePack pack,
 Map<Identifier,NamespaceResourceManager.EntryList> idToEntryList)

Mappings:

Namespace	Name	Mixin selector
official	a	Lagc;a(Lagc$c;Ljava/util/Map;)V
intermediary	method_41259	Lnet/minecraft/class_3294;method_41259(Lnet/minecraft/class_3294$class_7082;Ljava/util/Map;)V
named	applyFilter	Lnet/minecraft/resource/NamespaceResourceManager;applyFilter(Lnet/minecraft/resource/NamespaceResourceManager$FilterablePack;Ljava/util/Map;)V

findAndAdd

private void findAndAdd(NamespaceResourceManager.FilterablePack pack,
 String startingPath,
 Predicate<Identifier> allowedPathPredicate,
 Map<Identifier,NamespaceResourceManager.EntryList> idToEntryList)

Mappings:

Namespace	Name	Mixin selector
official	a	Lagc;a(Lagc$c;Ljava/lang/String;Ljava/util/function/Predicate;Ljava/util/Map;)V
intermediary	method_41258	Lnet/minecraft/class_3294;method_41258(Lnet/minecraft/class_3294$class_7082;Ljava/lang/String;Ljava/util/function/Predicate;Ljava/util/Map;)V
named	findAndAdd	Lnet/minecraft/resource/NamespaceResourceManager;findAndAdd(Lnet/minecraft/resource/NamespaceResourceManager$FilterablePack;Ljava/lang/String;Ljava/util/function/Predicate;Ljava/util/Map;)V

findAllResources

public Map<Identifier,List<ResourceRef>> findAllResources(String startingPath,
 Predicate<Identifier> allowedPathPredicate)

Specified by:

findAllResources in interface ResourceManager

Mappings:

Namespace	Name	Mixin selector
official	c	Lagk;c(Ljava/lang/String;Ljava/util/function/Predicate;)Ljava/util/Map;
intermediary	method_41265	Lnet/minecraft/class_3300;method_41265(Ljava/lang/String;Ljava/util/function/Predicate;)Ljava/util/Map;
named	findAllResources	Lnet/minecraft/resource/ResourceManager;findAllResources(Ljava/lang/String;Ljava/util/function/Predicate;)Ljava/util/Map;

streamResourcePacks

public Stream<ResourcePack> streamResourcePacks()

Gets a stream of loaded resource packs in increasing order of priority.

Specified by:

streamResourcePacks in interface ResourceManager

Mappings:

Namespace	Name	Mixin selector
official	b	Lagk;b()Ljava/util/stream/Stream;
intermediary	method_29213	Lnet/minecraft/class_3300;method_29213()Ljava/util/stream/Stream;
named	streamResourcePacks	Lnet/minecraft/resource/ResourceManager;streamResourcePacks()Ljava/util/stream/Stream;

getMetadataPath

static Identifier getMetadataPath(Identifier id)

Mappings:

Namespace	Name	Mixin selector
official	c	Lagc;c(Lza;)Lza;
intermediary	method_14473	Lnet/minecraft/class_3294;method_14473(Lnet/minecraft/class_2960;)Lnet/minecraft/class_2960;
named	getMetadataPath	Lnet/minecraft/resource/NamespaceResourceManager;getMetadataPath(Lnet/minecraft/util/Identifier;)Lnet/minecraft/util/Identifier;