Package ch.njol.skript

Class Skript

java.lang.Object

org.bukkit.plugin.PluginBase

org.bukkit.plugin.java.JavaPlugin

ch.njol.skript.Skript

All Implemented Interfaces:

io.papermc.paper.plugin.lifecycle.event.LifecycleEventOwner, net.kyori.adventure.key.Namespaced, org.bukkit.command.CommandExecutor, org.bukkit.command.TabCompleter, org.bukkit.command.TabExecutor, org.bukkit.event.Listener, org.bukkit.plugin.Plugin

public final class Skript
extends org.bukkit.plugin.java.JavaPlugin
implements org.bukkit.event.Listener

Skript - A Bukkit plugin to modify how Minecraft behaves without having to write a single line of code (You'll likely be writing some code though if you're reading this =P)

Use this class to extend this plugin's functionality by adding more conditions, effects, expressions, etc.

If your plugin.yml contains 'depend: [Skript]' then your plugin will not start at all if Skript is not present. Add 'softdepend: [Skript]' to your plugin.yml if you want your plugin to work even if Skript isn't present, but want to make sure that Skript gets loaded before your plugin.

If you use 'softdepend' you can test whether Skript is loaded with 'Bukkit.getPluginManager().getPlugin("Skript") != null'

Once you made sure that Skript is loaded you can use Skript.getInstance() whenever you need a reference to the plugin, but you likely won't need it since all API methods are static.

See Also:

• registerAddon(JavaPlugin)
• registerCondition(Class, String...)
• registerEffect(Class, String...)
• registerExpression(Class, Class, ExpressionType, String...)
• registerEvent(String, Class, Class, String...)
• EventValues.registerEventValue(Class, Class, Converter, int)
• Classes.registerClass(ClassInfo)
• Comparators.registerComparator(Class, Class, Comparator)
• Converters.registerConverter(Class, Class, Converter)

Field Summary

Fields

Modifier and Type	Field	Description
static final double	EPSILON	A small value, useful for comparing doubles or floats.
static final double	EPSILON_MULT	A value a bit larger than 1
static final Message	m_finished_loading
static final Message	m_invalid_reload
static final Message	m_no_errors
static final Message	m_no_scripts
static final int	MAXBLOCKID	The maximum ID a block can have in Minecraft.
static final int	MAXDATAVALUE	The maximum data value of Minecraft, i.e.
static final String	SCRIPTSFOLDER
static final Thread.UncaughtExceptionHandler	UEH

Constructor Summary

Constructors

Constructor	Description
Skript()

Method Summary

Modifier and Type	Method	Description
static void	adminBroadcast(String message)
static void	broadcast(String message, String permission)
static void	checkAcceptRegistrations()
static boolean	classExists(String className)	Tests whether a given class exists in the classpath.
static void	closeOnDisable(Closeable closeable)	Registers a Closeable that should be closed when this plugin is disabled.
static boolean	debug()
static void	debug(String info)
static void	debug(String message, Object... objects)	Sends a debug message with formatted objects if debug() returns true.
static void	disableHookRegistration(Class<? extends ch.njol.skript.hooks.Hook<?>>... hooks)	Disables the registration for the given hook classes.
static boolean	dispatchCommand(org.bukkit.command.CommandSender sender, String command)	Dispatches a command with calling command events
static void	error(@Nullable String error)
static void	error(String error, ErrorQuality quality)	Use this in SyntaxElement.init(Expression[], int, Kleenean, ch.njol.skript.lang.SkriptParser.ParseResult) (and other methods that are called during the parsing) to log errors with a specific ErrorQuality.
static void	error(String message, Object... objects)	Sends an error message with formatted objects.
static void	error(org.bukkit.command.CommandSender sender, String error)
static EmptyStacktraceException	exception(@Nullable Throwable cause, @Nullable TriggerItem item, String... info)
static EmptyStacktraceException	exception(@Nullable Throwable cause, @Nullable Thread thread, @Nullable TriggerItem item, String... info)	Used if something happens that shouldn't happen
static EmptyStacktraceException	exception(@Nullable Throwable cause, @Nullable Thread thread, String... info)
static EmptyStacktraceException	exception(@Nullable Throwable cause, String... info)
static EmptyStacktraceException	exception(String... info)	Used if something happens that shouldn't happen
static ExperimentRegistry	experiments()
static boolean	fieldExists(Class<?> c, String fieldName)	Tests whether a field exists in the given class.
static @Nullable SkriptAddon	getAddon(String name)	Deprecated, for removal: This API element is subject to removal in a future version. Use Skript.addon(String).
static @Nullable SkriptAddon	getAddon(org.bukkit.plugin.java.JavaPlugin plugin)	Deprecated, for removal: This API element is subject to removal in a future version. There is no exact replacement for this method.
static SkriptAddon	getAddonInstance()	Deprecated, for removal: This API element is subject to removal in a future version. Use instance() instead.
static @Unmodifiable Collection<SkriptAddon>	getAddons()	Deprecated, for removal: This API element is subject to removal in a future version. Use Skript.addons().
static @Unmodifiable Collection<SyntaxElementInfo<? extends Condition>>	getConditions()	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.syntaxes(Key) with SyntaxRegistry.CONDITION.
static @Unmodifiable Collection<SyntaxElementInfo<? extends Effect>>	getEffects()	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.syntaxes(Key) with SyntaxRegistry.EFFECT.
static @Unmodifiable Collection<SkriptEventInfo<?>>	getEvents()	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.syntaxes(Key) with BukkitSyntaxInfos.Event.KEY.
static Iterator<ExpressionInfo<?,?>>	getExpressions()	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.syntaxes(Key) with SyntaxRegistry.EXPRESSION.
static Iterator<ExpressionInfo<?,?>>	getExpressions(Class<?>... returnTypes)	Deprecated, for removal: This API element is subject to removal in a future version. There is no exact replacement for this method.
static Skript	getInstance()
static @Nullable org.bstats.bukkit.Metrics	getMetrics()
static Version	getMinecraftVersion()
static String	getRestartMessage()
static RuntimeErrorManager	getRuntimeErrorManager()
File	getScriptsFolder()
static @Unmodifiable Collection<SyntaxElementInfo<? extends Section>>	getSections()	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.syntaxes(Key) with SyntaxRegistry.SECTION.
static ServerPlatform	getServerPlatform()
static String	getSkriptPrefix()
static @Unmodifiable Collection<SyntaxElementInfo<? extends Statement>>	getStatements()	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.syntaxes(Key) with SyntaxRegistry.STATEMENT.
static @Unmodifiable List<StructureInfo<? extends Structure>>	getStructures()	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.syntaxes(Key) with SyntaxRegistry.STRUCTURE.
static Origin	getSyntaxOrigin(Class<?> source)	Deprecated, for removal: This API element is subject to removal in a future version. This method exists solely for compatibility reasons.
@Nullable SkriptUpdater	getUpdater()	Gets the updater instance currently used by Skript.
static Version	getVersion()
static String	getWarningMessage()
static void	info(String info)
static void	info(org.bukkit.command.CommandSender sender, String info)
static Skript	instance()
static boolean	isAcceptRegistrations()
static boolean	isFinishedLoadingHooks()
static boolean	isHookEnabled(Class<? extends ch.njol.skript.hooks.Hook<?>> hook)	Checks whether a hook has been enabled.
static boolean	isRunningCraftBukkit()
static boolean	isRunningMinecraft(int major, int minor)
static boolean	isRunningMinecraft(int major, int minor, int revision)
static boolean	isRunningMinecraft(Version v)
static boolean	log(Verbosity minVerb)
static boolean	logHigh()
static boolean	logNormal()
static boolean	logVeryHigh()
static void	markErrored()	Mark that an exception has occurred at some point during runtime.
static void	message(org.bukkit.command.CommandSender sender, String info)	Similar to info(CommandSender, String) but no [Skript] prefix is added.
static boolean	methodExists(Class<?> c, String methodName, Class<?>... parameterTypes)	Tests whether a method exists in the given class.
static boolean	methodExists(Class<?> c, String methodName, Class<?>[] parameterTypes, Class<?> returnType)	Tests whether a method exists in the given class, and whether the return type matches the expected one.
static Thread	newThread(Runnable r, String name)	Creates a new Thread and sets its UncaughtExceptionHandler.
void	onDisable()
void	onEnable()
void	onPluginDisable(org.bukkit.event.server.PluginDisableEvent event)
static void	outdatedError()
static void	outdatedError(Exception e)
static SkriptAddon	registerAddon(org.bukkit.plugin.java.JavaPlugin plugin)	Deprecated, for removal: This API element is subject to removal in a future version. Use Skript.registerAddon(Class, String).
static <E extends Condition> void	registerCondition(Class<E> conditionClass, Condition.ConditionType type, String... patterns)	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.CONDITION.
static <E extends Condition> void	registerCondition(Class<E> conditionClass, String... patterns)	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.CONDITION.
static <E extends Effect> void	registerEffect(Class<E> effectClass, String... patterns)	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.EFFECT.
static <E extends SkriptEvent> SkriptEventInfo<E>	registerEvent(String name, Class<E> eventClass, Class<? extends org.bukkit.event.Event>[] events, String... patterns)	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.register(Key, SyntaxInfo) with BukkitSyntaxInfos.Event.KEY.
static <E extends SkriptEvent> SkriptEventInfo<E>	registerEvent(String name, Class<E> c, Class<? extends org.bukkit.event.Event> event, String... patterns)	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.register(Key, SyntaxInfo) with BukkitSyntaxInfos.Event.KEY.
static <E extends Expression<T>, T> void	registerExpression(Class<E> expressionClass, Class<T> returnType, ExpressionType type, String... patterns)	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.EXPRESSION.
static <E extends Section> void	registerSection(Class<E> sectionClass, String... patterns)	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.SECTION.
static <E extends Structure> void	registerSimpleStructure(Class<E> structureClass, String... patterns)	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.STRUCTURE.
static <E extends Structure> void	registerStructure(Class<E> structureClass, String... patterns)	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.STRUCTURE.
static <E extends Structure> void	registerStructure(Class<E> structureClass, EntryValidator entryValidator, String... patterns)	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.STRUCTURE.
static <E extends Structure> void	registerStructure(Class<E> structureClass, EntryValidator entryValidator, DefaultSyntaxInfos.Structure.NodeType nodeType, String... patterns)	Deprecated, for removal: This API element is subject to removal in a future version. Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.STRUCTURE.
static boolean	testing()
static String	toString(double n)
static void	updateMinecraftVersion()	Check minecraft version and assign it to minecraftVersion field This method is created to update MC version before onEnable method
static void	warning(String warning)

Methods inherited from class org.bukkit.plugin.java.JavaPlugin

getClassLoader, getCommand, getConfig, getDataFolder, getDefaultBiomeProvider, getDefaultWorldGenerator, getDescription, getFile, getLifecycleManager, getLogger, getPlugin, getPluginLoader, getPluginMeta, getProvidingPlugin, getResource, getServer, getTextResource, init, init, isEnabled, isNaggable, onCommand, onLoad, onTabComplete, registerCommand, registerCommand, registerCommand, registerCommand, reloadConfig, saveConfig, saveDefaultConfig, saveResource, setEnabled, setNaggable, toString

Methods inherited from class org.bukkit.plugin.PluginBase

equals, getName, hashCode, namespace

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.bukkit.plugin.Plugin

getComponentLogger, getDataPath, getLog4JLogger, getSLF4JLogger

Field Details

m_invalid_reload

public static final Message m_invalid_reload

m_finished_loading

public static final Message m_finished_loading

m_no_errors

public static final Message m_no_errors

m_no_scripts

public static final Message m_no_scripts

SCRIPTSFOLDER

public static final String SCRIPTSFOLDER

See Also:

• Constant Field Values

EPSILON

public static final double EPSILON

A small value, useful for comparing doubles or floats.

E.g. to test whether two floating-point numbers are equal:

 Math.abs(a - b) < Skript.EPSILON
 

or whether a location is within a specific radius of another location:

 location.distanceSquared(center) - radius * radius < Skript.EPSILON
 

See Also:

• EPSILON_MULT
• Constant Field Values

EPSILON_MULT

public static final double EPSILON_MULT

A value a bit larger than 1

See Also:

• EPSILON
• Constant Field Values

MAXBLOCKID

public static final int MAXBLOCKID

The maximum ID a block can have in Minecraft.

See Also:

• Constant Field Values

MAXDATAVALUE

public static final int MAXDATAVALUE

The maximum data value of Minecraft, i.e. Short.MAX_VALUE - Short.MIN_VALUE.

See Also:

• Constant Field Values

UEH

public static final Thread.UncaughtExceptionHandler UEH

Constructor Details

Skript

public Skript()
       throws IllegalStateException

Throws:

IllegalStateException

Method Details

getInstance

public static Skript getInstance()

instance

public static Skript instance()

Returns:

The modern Skript instance to be used for addon registration.

updateMinecraftVersion

public static void updateMinecraftVersion()

Check minecraft version and assign it to minecraftVersion field This method is created to update MC version before onEnable method

getVersion

public static Version getVersion()

getWarningMessage

public static String getWarningMessage()

getRestartMessage

public static String getRestartMessage()

getServerPlatform

public static ServerPlatform getServerPlatform()

isHookEnabled

public static boolean isHookEnabled(Class<? extends ch.njol.skript.hooks.Hook<?>> hook)

Checks whether a hook has been enabled.

Parameters:

hook - The hook to check.

Returns:

Whether the hook is enabled.

See Also:

• disableHookRegistration(Class[])

isFinishedLoadingHooks

public static boolean isFinishedLoadingHooks()

Returns:

whether hooks have been loaded, and if disableHookRegistration(Class[]) won't error because of this.

disableHookRegistration

@SafeVarargs
public static void disableHookRegistration(Class<? extends ch.njol.skript.hooks.Hook<?>>... hooks)

Disables the registration for the given hook classes. If Skript has been enabled, this method will throw an API exception. It should be used in something like JavaPlugin.onLoad().

Parameters:

hooks - The hooks to disable the registration of.

See Also:

• isHookEnabled(Class)

experiments

public static ExperimentRegistry experiments()

Returns:

The manager for experimental, optional features.

getScriptsFolder

public File getScriptsFolder()

Returns:

The folder containing all Scripts.

getRuntimeErrorManager

public static RuntimeErrorManager getRuntimeErrorManager()

onEnable

public void onEnable()

Specified by:

onEnable in interface org.bukkit.plugin.Plugin

Overrides:

onEnable in class org.bukkit.plugin.java.JavaPlugin

getMinecraftVersion

public static Version getMinecraftVersion()

isRunningCraftBukkit

public static boolean isRunningCraftBukkit()

Returns:

Whether this server is running CraftBukkit

isRunningMinecraft

public static boolean isRunningMinecraft(int major,
 int minor)

Returns:

Whether this server is running Minecraft major.minor or higher

isRunningMinecraft

public static boolean isRunningMinecraft(int major,
 int minor,
 int revision)

isRunningMinecraft

public static boolean isRunningMinecraft(Version v)

classExists

public static boolean classExists(String className)

Tests whether a given class exists in the classpath.

Parameters:

className - The canonical name of the class

Returns:

Whether the given class exists.

methodExists

public static boolean methodExists(Class<?> c,
 String methodName,
 Class<?>... parameterTypes)

Tests whether a method exists in the given class.

Parameters:

c - The class

methodName - The name of the method

parameterTypes - The parameter types of the method

Returns:

Whether the given method exists.

methodExists

public static boolean methodExists(Class<?> c,
 String methodName,
 Class<?>[] parameterTypes,
 Class<?> returnType)

Tests whether a method exists in the given class, and whether the return type matches the expected one.

Note that this method doesn't work properly if multiple methods with the same name and parameters exist but have different return types.

Parameters:

c - The class

methodName - The name of the method

parameterTypes - The parameter types of the method

returnType - The expected return type

Returns:

Whether the given method exists.

fieldExists

public static boolean fieldExists(Class<?> c,
 String fieldName)

Tests whether a field exists in the given class.

Parameters:

c - The class

fieldName - The name of the field

Returns:

Whether the given field exists.

getMetrics

@Nullable
public static @Nullable org.bstats.bukkit.Metrics getMetrics()

closeOnDisable

public static void closeOnDisable(Closeable closeable)

Registers a Closeable that should be closed when this plugin is disabled.

All registered Closeables will be closed after all scripts have been stopped.

Parameters:

closeable -

onPluginDisable

public void onPluginDisable(org.bukkit.event.server.PluginDisableEvent event)

onDisable

public void onDisable()

Specified by:

onDisable in interface org.bukkit.plugin.Plugin

Overrides:

onDisable in class org.bukkit.plugin.java.JavaPlugin

outdatedError

public static void outdatedError()

outdatedError

public static void outdatedError(Exception e)

toString

public static String toString(double n)

newThread

public static Thread newThread(Runnable r,
 String name)

Creates a new Thread and sets its UncaughtExceptionHandler. The Thread is not started automatically.

isAcceptRegistrations

public static boolean isAcceptRegistrations()

checkAcceptRegistrations

public static void checkAcceptRegistrations()

registerAddon

@Deprecated(since="2.14",
            forRemoval=true)
public static SkriptAddon registerAddon(org.bukkit.plugin.java.JavaPlugin plugin)

Deprecated, for removal: This API element is subject to removal in a future version.

Use Skript.registerAddon(Class, String). Obtain a Skript instance with instance().

Registers an addon to Skript. This is currently not required for addons to work, but the returned SkriptAddon provides useful methods for registering syntax elements and adding new strings to Skript's localization system (e.g. the required "types.[type]" strings for registered classes).

Parameters:

plugin - The plugin

getAddon

@Deprecated(since="2.14",
            forRemoval=true)
@Nullable
public static @Nullable SkriptAddon getAddon(org.bukkit.plugin.java.JavaPlugin plugin)

Deprecated, for removal: This API element is subject to removal in a future version.

There is no exact replacement for this method. Consider using getAddon(String) with the name of the plugin (PluginBase.getName()). Obtain a Skript instance with instance().

getAddon

@Deprecated(since="2.14",
            forRemoval=true)
@Nullable
public static @Nullable SkriptAddon getAddon(String name)

Deprecated, for removal: This API element is subject to removal in a future version.

Use Skript.addon(String). Obtain a Skript instance with instance().

getAddons

@Deprecated(since="2.14",
            forRemoval=true)
public static @Unmodifiable Collection<SkriptAddon> getAddons()

Deprecated, for removal: This API element is subject to removal in a future version.

Use Skript.addons(). Obtain a Skript instance with instance().

getAddonInstance

@Deprecated(since="2.14",
            forRemoval=true)
public static SkriptAddon getAddonInstance()

Deprecated, for removal: This API element is subject to removal in a future version.

Use instance() instead.

Returns:

A SkriptAddon representing Skript.

getSyntaxOrigin

@Internal
@Deprecated(since="2.14",
            forRemoval=true)
public static Origin getSyntaxOrigin(Class<?> source)

Deprecated, for removal: This API element is subject to removal in a future version.

This method exists solely for compatibility reasons.

Attempts to create a SyntaxOrigin from a provided class.

registerCondition

@Deprecated(since="2.14",
            forRemoval=true)
public static <E extends Condition> void registerCondition(Class<E> conditionClass,
 String... patterns)
                                                    throws IllegalArgumentException

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.CONDITION. Create a SyntaxInfo with SyntaxInfo.builder(Class). Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

Registers a Condition.

Parameters:

conditionClass - The condition's class

patterns - Skript patterns to match this condition

Throws:

IllegalArgumentException

registerCondition

@Deprecated(since="2.14",
            forRemoval=true)
public static <E extends Condition> void registerCondition(Class<E> conditionClass,
 Condition.ConditionType type,
 String... patterns)
                                                    throws IllegalArgumentException

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.CONDITION. Create a SyntaxInfo with SyntaxInfo.builder(Class). Specify a custom priority (SyntaxInfo.Builder.priority(Priority)) to replace type. Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

Registers a Condition.

Parameters:

conditionClass - The condition's class

type - The type of condition which affects its priority in the parsing search

patterns - Skript patterns to match this condition

Throws:

IllegalArgumentException

registerEffect

@Deprecated(since="2.14",
            forRemoval=true)
public static <E extends Effect> void registerEffect(Class<E> effectClass,
 String... patterns)
                                              throws IllegalArgumentException

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.EFFECT. Create a SyntaxInfo with SyntaxInfo.builder(Class). Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

Registers an Effect.

Parameters:

effectClass - The effect's class

patterns - Skript patterns to match this effect

Throws:

IllegalArgumentException

registerSection

@Deprecated(since="2.14",
            forRemoval=true)
public static <E extends Section> void registerSection(Class<E> sectionClass,
 String... patterns)
                                                throws IllegalArgumentException

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.SECTION. Create a SyntaxInfo with SyntaxInfo.builder(Class). Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

Registers a Section.

Parameters:

sectionClass - The section's class

patterns - Skript patterns to match this section

Throws:

IllegalArgumentException

See Also:

• Section

getStatements

@Deprecated(since="2.14",
            forRemoval=true)
public static @Unmodifiable Collection<SyntaxElementInfo<? extends Statement>> getStatements()

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.syntaxes(Key) with SyntaxRegistry.STATEMENT. Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

getConditions

@Deprecated(since="2.14",
            forRemoval=true)
public static @Unmodifiable Collection<SyntaxElementInfo<? extends Condition>> getConditions()

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.syntaxes(Key) with SyntaxRegistry.CONDITION. Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

getEffects

@Deprecated(since="2.14",
            forRemoval=true)
public static @Unmodifiable Collection<SyntaxElementInfo<? extends Effect>> getEffects()

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.syntaxes(Key) with SyntaxRegistry.EFFECT. Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

getSections

@Deprecated(since="2.14",
            forRemoval=true)
public static @Unmodifiable Collection<SyntaxElementInfo<? extends Section>> getSections()

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.syntaxes(Key) with SyntaxRegistry.SECTION. Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

registerExpression

@Deprecated(since="2.14",
            forRemoval=true)
public static <E extends Expression<T>,
T> void registerExpression(Class<E> expressionClass,
 Class<T> returnType,
 ExpressionType type,
 String... patterns)
                                                            throws IllegalArgumentException

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.EXPRESSION. Create a DefaultSyntaxInfos.Expression with DefaultSyntaxInfos.Expression.builder(Class, Class). Specify a custom priority (SyntaxInfo.Builder.priority(Priority)) to replace type. Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

Registers an expression.

Parameters:

expressionClass - The expression's class

returnType - The superclass of all values returned by the expression

type - The expression's type. This is used to determine in which order to try to parse expressions.

patterns - Skript patterns that match this expression

Throws:

IllegalArgumentException - if returnType is not a normal class

getExpressions

@Deprecated(since="2.14",
            forRemoval=true)
public static Iterator<ExpressionInfo<?,?>> getExpressions()

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.syntaxes(Key) with SyntaxRegistry.EXPRESSION. Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

getExpressions

@Deprecated(since="2.14",
            forRemoval=true)
public static Iterator<ExpressionInfo<?,?>> getExpressions(Class<?>... returnTypes)

Deprecated, for removal: This API element is subject to removal in a future version.

There is no exact replacement for this method. Use SyntaxRegistry.syntaxes(Key) with SyntaxRegistry.SECTION and filter the results. Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

registerEvent

@Deprecated(since="2.14",
            forRemoval=true)
public static <E extends SkriptEvent>
SkriptEventInfo<E> registerEvent(String name,
 Class<E> c,
 Class<? extends org.bukkit.event.Event> event,
 String... patterns)

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.register(Key, SyntaxInfo) with BukkitSyntaxInfos.Event.KEY. Create a BukkitSyntaxInfos.Event with BukkitSyntaxInfos.Event.builder(Class, String). Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

Registers an event.

Parameters:

name - Capitalised name of the event without leading "On" which is added automatically (Start the name with an asterisk to prevent this). Used for error messages and the documentation.

c - The event's class

event - The Bukkit event this event applies to

patterns - Skript patterns to match this event

Returns:

A SkriptEventInfo representing the registered event. Used to generate Skript's documentation.

registerEvent

@Deprecated(since="2.14",
            forRemoval=true)
public static <E extends SkriptEvent>
SkriptEventInfo<E> registerEvent(String name,
 Class<E> eventClass,
 Class<? extends org.bukkit.event.Event>[] events,
 String... patterns)

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.register(Key, SyntaxInfo) with BukkitSyntaxInfos.Event.KEY. Create a BukkitSyntaxInfos.Event with BukkitSyntaxInfos.Event.builder(Class, String). Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

Registers an event.

Parameters:

name - The name of the event, used for error messages

eventClass - The event's class

events - The Bukkit events this event applies to

patterns - Skript patterns to match this event

Returns:

A SkriptEventInfo representing the registered event. Used to generate Skript's documentation.

registerStructure

@Deprecated(since="2.14",
            forRemoval=true)
public static <E extends Structure> void registerStructure(Class<E> structureClass,
 String... patterns)

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.STRUCTURE. Create a DefaultSyntaxInfos.Structure with DefaultSyntaxInfos.Structure.builder(Class). Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

registerSimpleStructure

@Deprecated(since="2.14",
            forRemoval=true)
public static <E extends Structure> void registerSimpleStructure(Class<E> structureClass,
 String... patterns)

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.STRUCTURE. Create a DefaultSyntaxInfos.Structure with DefaultSyntaxInfos.Structure.builder(Class). Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

registerStructure

@Deprecated(since="2.14",
            forRemoval=true)
public static <E extends Structure> void registerStructure(Class<E> structureClass,
 EntryValidator entryValidator,
 String... patterns)

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.STRUCTURE. Create a DefaultSyntaxInfos.Structure with DefaultSyntaxInfos.Structure.builder(Class). Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

registerStructure

@Deprecated(since="2.14",
            forRemoval=true)
public static <E extends Structure> void registerStructure(Class<E> structureClass,
 EntryValidator entryValidator,
 DefaultSyntaxInfos.Structure.NodeType nodeType,
 String... patterns)

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.register(Key, SyntaxInfo) with SyntaxRegistry.STRUCTURE. Create a DefaultSyntaxInfos.Structure with DefaultSyntaxInfos.Structure.builder(Class). Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

getEvents

@Deprecated(since="2.14",
            forRemoval=true)
public static @Unmodifiable Collection<SkriptEventInfo<?>> getEvents()

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.syntaxes(Key) with BukkitSyntaxInfos.Event.KEY. Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

getStructures

@Deprecated(since="2.14",
            forRemoval=true)
public static @Unmodifiable List<StructureInfo<? extends Structure>> getStructures()

Deprecated, for removal: This API element is subject to removal in a future version.

Use SyntaxRegistry.syntaxes(Key) with SyntaxRegistry.STRUCTURE. Obtain a SyntaxRegistry through SkriptAddon.syntaxRegistry().

dispatchCommand

public static boolean dispatchCommand(org.bukkit.command.CommandSender sender,
 String command)

Dispatches a command with calling command events

Parameters:

sender -

command -

Returns:

Whether the command was run

logNormal

public static boolean logNormal()

logHigh

public static boolean logHigh()

logVeryHigh

public static boolean logVeryHigh()

debug

public static boolean debug()

testing

public static boolean testing()

log

public static boolean log(Verbosity minVerb)

debug

public static void debug(String info)

debug

public static void debug(String message,
 Object... objects)

Sends a debug message with formatted objects if debug() returns true.

Parameters:

message - The message to send

objects - The objects to format the message with

See Also:

• String.formatted(Object...)

info

public static void info(String info)

See Also:

• SkriptLogger.log(Level, String)

warning

public static void warning(String warning)

See Also:

• SkriptLogger.log(Level, String)

error

public static void error(@Nullable
 @Nullable String error)

See Also:

• SkriptLogger.log(Level, String)

error

public static void error(String message,
 Object... objects)

Sends an error message with formatted objects.

Parameters:

message - The message to send

objects - The objects to format the message with

See Also:

• String.formatted(Object...)

error

public static void error(String error,
 ErrorQuality quality)

Use this in SyntaxElement.init(Expression[], int, Kleenean, ch.njol.skript.lang.SkriptParser.ParseResult) (and other methods that are called during the parsing) to log errors with a specific ErrorQuality.

Parameters:

error -

quality -

exception

public static EmptyStacktraceException exception(String... info)

Used if something happens that shouldn't happen

Parameters:

info - Description of the error and additional information

Returns:

an EmptyStacktraceException to throw if code execution should terminate.

exception

public static EmptyStacktraceException exception(@Nullable
 @Nullable Throwable cause,
 String... info)

exception

public static EmptyStacktraceException exception(@Nullable
 @Nullable Throwable cause,
 @Nullable
 @Nullable Thread thread,
 String... info)

exception

public static EmptyStacktraceException exception(@Nullable
 @Nullable Throwable cause,
 @Nullable
 @Nullable TriggerItem item,
 String... info)

markErrored

public static void markErrored()

Mark that an exception has occurred at some point during runtime. Only used for Skript's testing system.

exception

public static EmptyStacktraceException exception(@Nullable
 @Nullable Throwable cause,
 @Nullable
 @Nullable Thread thread,
 @Nullable
 @Nullable TriggerItem item,
 String... info)

Used if something happens that shouldn't happen

Parameters:

cause - exception that shouldn't occur

info - Description of the error and additional information

Returns:

an EmptyStacktraceException to throw if code execution should terminate.

getSkriptPrefix

public static String getSkriptPrefix()

info

public static void info(org.bukkit.command.CommandSender sender,
 String info)

broadcast

public static void broadcast(String message,
 String permission)

Parameters:

message -

permission -

See Also:

• adminBroadcast(String)

adminBroadcast

public static void adminBroadcast(String message)

message

public static void message(org.bukkit.command.CommandSender sender,
 String info)

Similar to info(CommandSender, String) but no [Skript] prefix is added.

Parameters:

sender -

info -

error

public static void error(org.bukkit.command.CommandSender sender,
 String error)

getUpdater

@Nullable
public @Nullable SkriptUpdater getUpdater()

Gets the updater instance currently used by Skript.

Returns:

SkriptUpdater instance.