Package org.bukkit

Interface Registry<T extends Keyed>

Type Parameters:

T - type of item in the registry

All Superinterfaces:

Iterable<T>

All Known Implementing Classes:

Registry.SimpleRegistry

public interface Registry<T extends Keyed>
extends Iterable<T>

Represents a registry of Bukkit objects that may be retrieved by NamespacedKey.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	Registry.SimpleRegistry<T extends Enum<T> & Keyed>

Field Summary

Fields

Modifier and Type	Field	Description
static final Registry<Advancement>	ADVANCEMENT	Deprecated. Advancement has no real server-side registry.
static final Registry<Art>	ART	Server art.
static final Registry<Attribute>	ATTRIBUTE	Attribute.
static final Registry<PatternType>	BANNER_PATTERN	Server banner patterns.
static final Registry<Biome>	BIOME	Server biomes.
static final Registry<BlockType>	BLOCK	Server block types.
static final Registry<KeyedBossBar>	BOSS_BARS	Deprecated. BossBar has no real server-side registry.
static final Registry<Cat.Type>	CAT_VARIANT	Server cat types.
static final Registry<DamageType>	DAMAGE_TYPE	Damage types.
static final Registry<PotionEffectType>	EFFECT	Server mob effects.
static final Registry<Enchantment>	ENCHANTMENT	Server enchantments.
static final Registry<EntityType>	ENTITY_TYPE	Server entity types.
static final Registry<Fluid>	FLUID	Server fluids.
static final Registry<Frog.Variant>	FROG_VARIANT	Frog variants.
static final Registry<GameEvent>	GAME_EVENT	Game events.
static final Registry<MusicInstrument>	INSTRUMENT	Server instruments.
static final Registry<ItemType>	ITEM	Server item types.
static final Registry<JukeboxSong>	JUKEBOX_SONG	Jukebox songs.
static final Registry<LootTables>	LOOT_TABLES	Deprecated. LootTables, not to be confused with the LootTable class, has no real server-side registry.
static final Registry<MapCursor.Type>	MAP_DECORATION_TYPE	Map cursor types.
static final Registry<Material>	MATERIAL	Server materials.
static final Registry<MemoryKey>	MEMORY_MODULE_TYPE	Memory Keys.
static final Registry<MenuType>	MENU	Server menus.
static final Registry<Particle>	PARTICLE_TYPE	Server particles.
static final Registry<PotionType>	POTION	Server potions.
static final Registry<Sound>	SOUNDS	Sound keys.
static final Registry<Statistic>	STATISTIC	Server statistics.
static final Registry<Structure>	STRUCTURE	Server structures.
static final Registry<StructureType>	STRUCTURE_TYPE	Server structure types.
static final Registry<TrimMaterial>	TRIM_MATERIAL	Trim materials.
static final Registry<TrimPattern>	TRIM_PATTERN	Trim patterns.
static final Registry<Villager.Profession>	VILLAGER_PROFESSION	Villager profession.
static final Registry<Villager.Type>	VILLAGER_TYPE	Villager type.
static final Registry<Wolf.Variant>	WOLF_VARIANT	Wolf variants.

Method Summary

Modifier and Type	Method	Description
T	get(NamespacedKey key)	Get the object by its key.
T	getOrThrow(NamespacedKey key)	Get the object by its key.
default T	match(String input)	Attempts to match the registered object with the given key.
Stream<T>	stream()	Returns a new stream, which contains all registry items, which are registered to the registry.

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Field Details

ADVANCEMENT

@Deprecated(since="1.21.4")
static final Registry<Advancement> ADVANCEMENT

Deprecated.

Advancement has no real server-side registry.

Server advancements.

See Also:

• Bukkit.getAdvancement(org.bukkit.NamespacedKey)
• Bukkit.advancementIterator()

ART

static final Registry<Art> ART

Server art.

See Also:

• Art

ATTRIBUTE

static final Registry<Attribute> ATTRIBUTE

Attribute.

See Also:

• Attribute

BANNER_PATTERN

static final Registry<PatternType> BANNER_PATTERN

Server banner patterns.

See Also:

• PatternType

BIOME

static final Registry<Biome> BIOME

Server biomes.

See Also:

• Biome

BLOCK

@Internal
static final Registry<BlockType> BLOCK

Server block types.

See Also:

• BlockType

API Note:

BlockType is not ready for public usage yet

BOSS_BARS

@Deprecated(since="1.21.4")
static final Registry<KeyedBossBar> BOSS_BARS

Deprecated.

BossBar has no real server-side registry.

Custom boss bars.

See Also:

• Bukkit.getBossBar(org.bukkit.NamespacedKey)
• Bukkit.getBossBars()

CAT_VARIANT

static final Registry<Cat.Type> CAT_VARIANT

Server cat types.

See Also:

• Cat.Type

ENCHANTMENT

static final Registry<Enchantment> ENCHANTMENT

Server enchantments.

See Also:

• Enchantment

ENTITY_TYPE

static final Registry<EntityType> ENTITY_TYPE

Server entity types.

See Also:

• EntityType

INSTRUMENT

static final Registry<MusicInstrument> INSTRUMENT

Server instruments.

See Also:

• MusicInstrument

ITEM

@Internal
static final Registry<ItemType> ITEM

Server item types.

See Also:

• ItemType

API Note:

ItemType is not ready for public usage yet

LOOT_TABLES

@Deprecated(since="1.21.4")
static final Registry<LootTables> LOOT_TABLES

Deprecated.

LootTables, not to be confused with the LootTable class, has no real server-side registry.

Default server loot tables.

See Also:

• LootTables

MATERIAL

static final Registry<Material> MATERIAL

Server materials.

See Also:

• Material

MENU

@Experimental
static final Registry<MenuType> MENU

Server menus.

See Also:

• MenuType

EFFECT

static final Registry<PotionEffectType> EFFECT

Server mob effects.

See Also:

• PotionEffectType

PARTICLE_TYPE

static final Registry<Particle> PARTICLE_TYPE

Server particles.

See Also:

• Particle

POTION

static final Registry<PotionType> POTION

Server potions.

See Also:

• PotionType

STATISTIC

static final Registry<Statistic> STATISTIC

Server statistics.

See Also:

• Statistic

STRUCTURE

static final Registry<Structure> STRUCTURE

Server structures.

See Also:

• Structure

STRUCTURE_TYPE

static final Registry<StructureType> STRUCTURE_TYPE

Server structure types.

See Also:

• StructureType

SOUNDS

static final Registry<Sound> SOUNDS

Sound keys.

See Also:

• Sound

TRIM_MATERIAL

@Experimental
static final Registry<TrimMaterial> TRIM_MATERIAL

Trim materials.

See Also:

• TrimMaterial

TRIM_PATTERN

@Experimental
static final Registry<TrimPattern> TRIM_PATTERN

Trim patterns.

See Also:

• TrimPattern

DAMAGE_TYPE

@Experimental
static final Registry<DamageType> DAMAGE_TYPE

Damage types.

See Also:

• DamageType

JUKEBOX_SONG

@Experimental
static final Registry<JukeboxSong> JUKEBOX_SONG

Jukebox songs.

See Also:

• JukeboxSong

VILLAGER_PROFESSION

static final Registry<Villager.Profession> VILLAGER_PROFESSION

Villager profession.

See Also:

• Villager.Profession

VILLAGER_TYPE

static final Registry<Villager.Type> VILLAGER_TYPE

Villager type.

See Also:

• Villager.Type

MEMORY_MODULE_TYPE

static final Registry<MemoryKey> MEMORY_MODULE_TYPE

Memory Keys.

See Also:

• MemoryKey

FLUID

static final Registry<Fluid> FLUID

Server fluids.

See Also:

• Fluid

FROG_VARIANT

static final Registry<Frog.Variant> FROG_VARIANT

Frog variants.

See Also:

• Frog.Variant

WOLF_VARIANT

static final Registry<Wolf.Variant> WOLF_VARIANT

Wolf variants.

See Also:

• Wolf.Variant

MAP_DECORATION_TYPE

static final Registry<MapCursor.Type> MAP_DECORATION_TYPE

Map cursor types.

See Also:

• MapCursor.Type

GAME_EVENT

static final Registry<GameEvent> GAME_EVENT

Game events.

See Also:

• GameEvent

Method Details

get

@Nullable
T get(@NotNull
 NamespacedKey key)

Get the object by its key.

Parameters:

key - non-null key

Returns:

item or null if does not exist

getOrThrow

@NotNull
T getOrThrow(@NotNull
 NamespacedKey key)

Get the object by its key. If there is no object with the given key, an exception will be thrown.

Parameters:

key - to get the object from

Returns:

object with the given key

Throws:

IllegalArgumentException - if there is no object with the given key

stream

@NotNull
Stream<T> stream()

Returns a new stream, which contains all registry items, which are registered to the registry.

Returns:

a stream of all registry items

match

@Nullable
default T match(@NotNull
 String input)

Attempts to match the registered object with the given key.

This will attempt to find a reasonable match based on the provided input and may do so through unspecified means.

Parameters:

input - non-null input

Returns:

registered object or null if does not exist