Package org.bukkit
Interface UnsafeValues
Deprecated.
This interface provides value conversions that may be specific to a
runtime, or have arbitrary meaning (read: magic values).
Their existence and behavior is not guaranteed across future versions. They may be poorly named, throw exceptions, have misleading parameters, or any other bad programming practice.
-
Method Summary
Modifier and TypeMethodDescriptionvoid
Deprecated.Deprecated, for removal: This API element is subject to removal in a future version.Deprecated.default Entity
deserializeEntity
(byte[] data, World world) Deprecated.deserializeEntity
(byte[] data, World world, boolean preserveUUID) Deprecated.deserializeItem
(byte[] data) Deprecated.fromLegacy
(Material material) Deprecated.fromLegacy
(MaterialData material) Deprecated.fromLegacy
(MaterialData material, boolean itemPriority) Deprecated.fromLegacy
(Material material, byte data) Deprecated.getBiomeKey
(RegionAccessor accessor, int x, int y, int z) Deprecated.Gets theNamespacedKey
for the biome at the given location.getCreativeCategory
(Material material) Deprecated.int
Deprecated.getDefaultAttributeModifiers
(Material material, EquipmentSlot slot) Deprecated.getDefaultEntityAttributes
(@NotNull NamespacedKey entityKey) Deprecated.Gets the default attributes for the entity represented by the namespaced key.getItemAttributes
(@NotNull Material material, @NotNull EquipmentSlot equipmentSlot) Deprecated.Returns an immutable multimap of attributes for the material and slot.getItemRarity
(Material material) Deprecated.Gets the item rarity of a material.getItemStackRarity
(ItemStack itemStack) Deprecated.Gets the item rarity of the itemstack.Deprecated.Just don't use it.getMaterial
(String material, int version) Deprecated.int
Deprecated.Returns the server's protocol version.Deprecated.Server name to report to timings v2getTranslationKey
(Block block) Deprecated.Return the translation key for the Block, so the client can translate it into the active locale when using aTranslatableComponent
.getTranslationKey
(EntityType type) Deprecated.Return the translation key for the EntityType, so the client can translate it into the active locale when using aTranslatableComponent
.
This isnull
, when the EntityType isn't known to NMS (custom entities)getTranslationKey
(ItemStack itemStack) Deprecated.Return the translation key for the ItemStack, so the client can translate it into the active locale when using aTranslatableComponent
.Deprecated.Return the translation key for the Material, so the client can translate it into the active locale when using aTranslatableComponent
.default VersionFetcher
Deprecated.Called once by the version command on first use, then cached.Deprecated, for removal: This API element is subject to removal in a future version.boolean
hasDefaultEntityAttributes
(@NotNull NamespacedKey entityKey) Deprecated.Checks if the entity represented by the namespaced key has default attributes.boolean
isCollidable
(@NotNull Material material) Deprecated.Checks if this material is collidable.static boolean
isLegacyPlugin
(Plugin plugin) Deprecated.boolean
isSupportedApiVersion
(String apiVersion) Deprecated.boolean
isValidRepairItemStack
(@NotNull ItemStack itemToBeRepaired, @NotNull ItemStack repairMaterial) Deprecated.Checks if an itemstack can be repaired with another itemstack.Deprecated, for removal: This API element is subject to removal in a future version.loadAdvancement
(NamespacedKey key, String advancement) Deprecated.Load an advancement represented by the specified string into the server.modifyItemStack
(ItemStack stack, String arguments) Deprecated.int
Deprecated.Creates and returns the next EntityId available.Deprecated, for removal: This API element is subject to removal in a future version.Deprecated, for removal: This API element is subject to removal in a future version.byte[]
processClass
(PluginDescriptionFile pdf, String path, byte[] clazz) Deprecated.registryFor
(Class<T> classOfT) Deprecated.Gets the server-backed registry for a type.boolean
Deprecated.Delete an advancement which was loaded and saved byloadAdvancement(org.bukkit.NamespacedKey, java.lang.String)
.void
Deprecated.resolveWithContext
(Component component, CommandSender context, Entity scoreboardSubject, boolean bypassPermissions) Deprecated.byte[]
serializeEntity
(Entity entity) Deprecated.byte[]
serializeItem
(ItemStack item) Deprecated.void
setBiomeKey
(RegionAccessor accessor, int x, int y, int z, NamespacedKey biomeKey) Deprecated.Sets the biome at the given location to a biome registered to the givenNamespacedKey
.Deprecated.
-
Method Details
-
componentFlattener
ComponentFlattener componentFlattener()Deprecated. -
plainComponentSerializer
Deprecated, for removal: This API element is subject to removal in a future version. -
plainTextSerializer
Deprecated, for removal: This API element is subject to removal in a future version. -
gsonComponentSerializer
Deprecated, for removal: This API element is subject to removal in a future version. -
colorDownsamplingGsonComponentSerializer
Deprecated, for removal: This API element is subject to removal in a future version. -
legacyComponentSerializer
Deprecated, for removal: This API element is subject to removal in a future version. -
resolveWithContext
Component resolveWithContext(Component component, CommandSender context, Entity scoreboardSubject, boolean bypassPermissions) throws IOException Deprecated.- Throws:
IOException
-
reportTimings
void reportTimings()Deprecated. -
toLegacy
Deprecated. -
fromLegacy
Deprecated. -
fromLegacy
Deprecated. -
fromLegacy
Deprecated. -
fromLegacy
Deprecated. -
getMaterial
Deprecated. -
getDataVersion
int getDataVersion()Deprecated. -
modifyItemStack
Deprecated. -
checkSupported
Deprecated.- Throws:
InvalidPluginException
-
processClass
Deprecated. -
loadAdvancement
Deprecated.Load an advancement represented by the specified string into the server. The advancement format is governed by Minecraft and has no specified layout.
It is currently a JSON object, as described by the Minecraft Wiki: http://minecraft.gamepedia.com/Advancements
Loaded advancements will be stored and persisted across server restarts and reloads.
Callers should be prepared forException
to be thrown.- Parameters:
key
- the unique advancement keyadvancement
- representation of the advancement- Returns:
- the loaded advancement or null if an error occurred
-
removeAdvancement
Deprecated.Delete an advancement which was loaded and saved byloadAdvancement(org.bukkit.NamespacedKey, java.lang.String)
.
This method will only remove advancement from persistent storage. It should be accompanied by a call toServer.reloadData()
in order to fully remove it from the running instance.- Parameters:
key
- the unique advancement key- Returns:
- true if a file matching this key was found and deleted
-
getDefaultAttributeModifiers
Multimap<Attribute,AttributeModifier> getDefaultAttributeModifiers(Material material, EquipmentSlot slot) Deprecated. -
getCreativeCategory
Deprecated. -
getTimingsServerName
String getTimingsServerName()Deprecated.Server name to report to timings v2- Returns:
- name
-
getVersionFetcher
Deprecated.Called once by the version command on first use, then cached. -
isSupportedApiVersion
Deprecated. -
isLegacyPlugin
Deprecated. -
serializeItem
Deprecated. -
deserializeItem
Deprecated. -
serializeEntity
Deprecated. -
deserializeEntity
Deprecated. -
deserializeEntity
Deprecated. -
getTranslationKey
Deprecated.Return the translation key for the Material, so the client can translate it into the active locale when using aTranslatableComponent
.- Returns:
- the translation key
-
getTranslationKey
Deprecated.Return the translation key for the Block, so the client can translate it into the active locale when using aTranslatableComponent
.- Returns:
- the translation key
-
getTranslationKey
Deprecated.Return the translation key for the EntityType, so the client can translate it into the active locale when using aTranslatableComponent
.
This isnull
, when the EntityType isn't known to NMS (custom entities)- Returns:
- the translation key
-
getTranslationKey
Deprecated.Return the translation key for the ItemStack, so the client can translate it into the active locale when using aTranslatableComponent
.- Returns:
- the translation key
-
nextEntityId
int nextEntityId()Deprecated.Creates and returns the next EntityId available.Use this when sending custom packets, so that there are no collisions on the client or server.
-
registryFor
Deprecated.Gets the server-backed registry for a type.- Type Parameters:
T
- type- Parameters:
classOfT
- type- Returns:
- the server-backed registry
- Throws:
IllegalArgumentException
- if there isn't a registry for that type
-
getMainLevelName
Deprecated.Just don't use it. -
getItemRarity
Deprecated.Gets the item rarity of a material. The material MUST be an item. UseMaterial.isItem()
before this.- Parameters:
material
- the material to get the rarity of- Returns:
- the item rarity
-
getItemStackRarity
Deprecated.Gets the item rarity of the itemstack. The rarity can change based on enchantements.- Parameters:
itemStack
- the itemstack to get the rarity of- Returns:
- the itemstack rarity
-
isValidRepairItemStack
boolean isValidRepairItemStack(@NotNull @NotNull ItemStack itemToBeRepaired, @NotNull @NotNull ItemStack repairMaterial) Deprecated.Checks if an itemstack can be repaired with another itemstack. Returns false if either argument's type is not an item (Material.isItem()
).- Parameters:
itemToBeRepaired
- the itemstack to be repairedrepairMaterial
- the repair material- Returns:
- true if valid repair, false if not
-
getItemAttributes
@NotNull @NotNull Multimap<Attribute,AttributeModifier> getItemAttributes(@NotNull @NotNull Material material, @NotNull @NotNull EquipmentSlot equipmentSlot) Deprecated.Returns an immutable multimap of attributes for the material and slot.Material.isItem()
must be true for this material.- Parameters:
material
- the materialequipmentSlot
- the slot to get the attributes for- Returns:
- an immutable multimap of attributes
- Throws:
IllegalArgumentException
- ifMaterial.isItem()
is false
-
getProtocolVersion
int getProtocolVersion()Deprecated.Returns the server's protocol version.- Returns:
- the server's protocol version
-
hasDefaultEntityAttributes
Deprecated.Checks if the entity represented by the namespaced key has default attributes.- Parameters:
entityKey
- the entity's key- Returns:
- true if it has default attributes
-
getDefaultEntityAttributes
Deprecated.Gets the default attributes for the entity represented by the namespaced key.- Parameters:
entityKey
- the entity's key- Returns:
- an unmodifiable instance of Attributable for reading default attributes.
- Throws:
IllegalArgumentException
- if the entity does not exist of have default attributes (usehasDefaultEntityAttributes(NamespacedKey)
first)
-
isCollidable
Deprecated.Checks if this material is collidable.- Parameters:
material
- the material to check- Returns:
- true if collidable
- Throws:
IllegalArgumentException
- ifMaterial.isBlock()
is false
-
getBiomeKey
Deprecated.Gets theNamespacedKey
for the biome at the given location.- Parameters:
accessor
- TheRegionAccessor
of the provided coordinatesx
- X-coordinate of the blocky
- Y-coordinate of the blockz
- Z-coordinate of the block- Returns:
- the biome's
NamespacedKey
-
setBiomeKey
Deprecated.Sets the biome at the given location to a biome registered to the givenNamespacedKey
. If no biome by the givenNamespacedKey
exists, anIllegalStateException
will be thrown.- Parameters:
accessor
- TheRegionAccessor
of the provided coordinatesx
- X-coordinate of the blocky
- Y-coordinate of the blockz
- Z-coordinate of the blockbiomeKey
- Biome key- Throws:
IllegalStateException
- if no biome by the given key is registered.
-