xyz.upperlevel.spigot.book.internals

Class NmsUtil

java.lang.Object

xyz.upperlevel.spigot.book.internals.NmsUtil

public final class NmsUtil
extends Object

Tiny NMS utility, it should be loaded only if the NMS helper is used or if the developer uses ItemStack hovering (since it requires saving the NMS NBT as a JSON, and that is currently impossible)

Field Summary

Fields

Modifier and Type	Field and Description
static int	major
static int	minor
static String	version

Method Summary

Modifier and Type	Method and Description
static Class<?>	getCraftClass(String path)
static Class<?>	getNmsClass(String className, boolean required) Use getNmsClass(String, String, boolean) to make sure of compatibility with mc 1.17+.
static Class<?>	getNmsClass(String className, String post17middlePackage, boolean required)
static String	itemToJson(org.bukkit.inventory.ItemStack item)
static Object	nmsCopy(org.bukkit.inventory.ItemStack item) Creates a NMS copy of the parameter
static Object	toNms(org.bukkit.entity.Player player) Gets the EntityPlayer handled by the argument

Methods inherited from class java.lang.Object

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

Field Detail

version

public static final String version

major

public static final int major

minor

public static final int minor

Method Detail

itemToJson

public static String itemToJson(org.bukkit.inventory.ItemStack item)

toNms

public static Object toNms(org.bukkit.entity.Player player)
                    throws InvocationTargetException,
                           IllegalAccessException

Gets the EntityPlayer handled by the argument

Parameters:

player - the Player handler

Returns:

the handled class

Throws:

InvocationTargetException - when some problems are found with the reflection

IllegalAccessException - when some problems are found with the reflection

nmsCopy

public static Object nmsCopy(org.bukkit.inventory.ItemStack item)
                      throws InvocationTargetException,
                             IllegalAccessException

Creates a NMS copy of the parameter

Parameters:

item - the ItemStack to be nms-copied

Returns:

a NMS-ItemStack that is the equivalent of the one passed as argument

Throws:

InvocationTargetException - when some problems are found with the reflection

IllegalAccessException - when some problems are found with the reflection

getNmsClass

public static Class<?> getNmsClass(String className,
                                   boolean required)

Use getNmsClass(String, String, boolean) to make sure of compatibility with mc 1.17+.

Parameters:

className - The simple name of the class

required - If true a RuntimeException will be thrown when the class cannot be found

Returns:

Net Minecraft Server class with the provided name or null (if not required)

getNmsClass

public static Class<?> getNmsClass(String className,
                                   String post17middlePackage,
                                   boolean required)

Parameters:

className - The simple name of the class

post17middlePackage - The package the class have been relocated to after mc 1.17

required - If true a RuntimeException will be thrown when the class cannot be found

Returns:

Net Minecraft Server class. Either net.minecraft.server.$className if pre 1.17 or net.minecraft.$post17middlePackage.$className if v1.17+

getCraftClass

public static Class<?> getCraftClass(String path)