mirror of
https://github.com/PaperMC/Paper.git
synced 2025-08-07 15:42:19 -07:00
104 lines
3.6 KiB
Java
104 lines
3.6 KiB
Java
package org.bukkit;
|
|
|
|
import com.google.common.collect.Multimap;
|
|
import org.bukkit.advancement.Advancement;
|
|
import org.bukkit.attribute.Attribute;
|
|
import org.bukkit.attribute.AttributeModifier;
|
|
import org.bukkit.block.data.BlockData;
|
|
import org.bukkit.entity.EntityType;
|
|
import org.bukkit.inventory.CreativeCategory;
|
|
import org.bukkit.inventory.EquipmentSlot;
|
|
import org.bukkit.inventory.ItemStack;
|
|
import org.bukkit.material.MaterialData;
|
|
import org.bukkit.plugin.InvalidPluginException;
|
|
import org.bukkit.plugin.PluginDescriptionFile;
|
|
import org.bukkit.potion.PotionType;
|
|
import org.jetbrains.annotations.NotNull;
|
|
import org.jetbrains.annotations.Nullable;
|
|
|
|
/**
|
|
* This interface provides value conversions that may be specific to a
|
|
* runtime, or have arbitrary meaning (read: magic values).
|
|
* <p>
|
|
* 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.
|
|
*/
|
|
@Deprecated
|
|
public interface UnsafeValues {
|
|
|
|
Material toLegacy(Material material);
|
|
|
|
Material fromLegacy(Material material);
|
|
|
|
Material fromLegacy(MaterialData material);
|
|
|
|
Material fromLegacy(MaterialData material, boolean itemPriority);
|
|
|
|
BlockData fromLegacy(Material material, byte data);
|
|
|
|
Material getMaterial(String material, int version);
|
|
|
|
int getDataVersion();
|
|
|
|
ItemStack modifyItemStack(ItemStack stack, String arguments);
|
|
|
|
void checkSupported(PluginDescriptionFile pdf) throws InvalidPluginException;
|
|
|
|
byte[] processClass(PluginDescriptionFile pdf, String path, byte[] clazz);
|
|
|
|
/**
|
|
* Load an advancement represented by the specified string into the server.
|
|
* The advancement format is governed by Minecraft and has no specified
|
|
* layout.
|
|
* <br>
|
|
* It is currently a JSON object, as described by the <a href="https://minecraft.wiki/w/Advancements">Minecraft wiki</a>.
|
|
* <br>
|
|
* Loaded advancements will be stored and persisted across server restarts
|
|
* and reloads.
|
|
* <br>
|
|
* Callers should be prepared for {@link Exception} to be thrown.
|
|
*
|
|
* @param key the unique advancement key
|
|
* @param advancement representation of the advancement
|
|
* @return the loaded advancement or null if an error occurred
|
|
*/
|
|
Advancement loadAdvancement(NamespacedKey key, String advancement);
|
|
|
|
/**
|
|
* Delete an advancement which was loaded and saved by
|
|
* {@link #loadAdvancement(org.bukkit.NamespacedKey, java.lang.String)}.
|
|
* <br>
|
|
* This method will only remove advancement from persistent storage. It
|
|
* should be accompanied by a call to {@link Server#reloadData()} in order
|
|
* to fully remove it from the running instance.
|
|
*
|
|
* @param key the unique advancement key
|
|
* @return true if a file matching this key was found and deleted
|
|
*/
|
|
boolean removeAdvancement(NamespacedKey key);
|
|
|
|
Multimap<Attribute, AttributeModifier> getDefaultAttributeModifiers(Material material, EquipmentSlot slot);
|
|
|
|
CreativeCategory getCreativeCategory(Material material);
|
|
|
|
String getBlockTranslationKey(Material material);
|
|
|
|
String getItemTranslationKey(Material material);
|
|
|
|
String getTranslationKey(EntityType entityType);
|
|
|
|
String getTranslationKey(ItemStack itemStack);
|
|
|
|
@Nullable
|
|
FeatureFlag getFeatureFlag(@NotNull NamespacedKey key);
|
|
|
|
/**
|
|
* Do not use, method will get removed, and the plugin won't run
|
|
*
|
|
* @param key of the potion type
|
|
* @return an internal potion data
|
|
*/
|
|
PotionType.InternalPotionData getInternalPotionData(NamespacedKey key);
|
|
}
|