Name | <util.available_processors> |
Returns | ElementTag(Number) |
Description | How many virtual processors are available to the server.
(In general, Minecraft only uses one, unfortunately.) |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L783 |
Name | <util.color_names> |
Returns | ListTag |
Description | Returns a list of all color names recognized by ColorTag. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L430 |
Name | <util.current_tick> |
Returns | ElementTag(Number) |
Description | Returns the number of ticks since the server was started.
Note that this is NOT an accurate indicator for real server uptime, as ticks fluctuate based on server lag. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L794 |
Name | <util.current_time_millis> |
Returns | ElementTag(Number) |
Description | Returns the number of milliseconds since Jan 1, 1970.
Note that this can change every time the tag is read! Use util.time_now if you need stable time. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L831 |
Name | <util.debug_enabled> |
Returns | ElementTag(Boolean) |
Description | Returns whether script debug is currently globally enabled. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L996 |
Name | <util.default_encoding> |
Returns | ElementTag |
Description | Returns the name of the default system text encoding charset, such as "UTF-8". |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L611 |
Name | <util.delta_time_since_start> |
Returns | DurationTag |
Description | Returns the duration of delta time since the server started.
Note that this is delta time, not real time, meaning it is calculated based on the server tick, which may change longer or shorter than expected due to lag or other influences. If you want real time instead of delta time, use util.real_time_since_start. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L805 |
Name | <util.disk_free> |
Returns | ElementTag(Number) |
Description | How much remaining disk space is available to this server, in bytes.
This counts only the drive the server folder is on, not any other drives. This may be limited below the actual drive capacity by operating system settings. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L702 |
Name | <util.disk_total> |
Returns | ElementTag(Number) |
Description | How much total disk space is on the drive containing this server, in bytes.
This counts only the drive the server folder is on, not any other drives. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L715 |
Name | <util.disk_usage> |
Returns | ElementTag(Number) |
Description | How much space on the drive is already in use, in bytes.
This counts only the drive the server folder is on, not any other drives. This is approximately equivalent to "disk_total" minus "disk_free", but is not always exactly the same, as this tag will not include space "used" by operating system settings that simply deny the server write access. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L727 |
Name | <util.e> |
Returns | ElementTag(Decimal) |
Description | Returns e (Euler's number): 2.7182818284590452354 |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L410 |
Name | <util.empty_list_entries[<#>]> |
Returns | ListTag |
Description | Returns a list of the specified size where each entry is blank (zero characters long). |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L315 |
Name | <util.event_stats> |
Returns | ElementTag |
Description | Returns a simple debuggable stats report for all ScriptEvents during this server session. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L591 |
Name | <util.event_stats_data> |
Returns | ListTag(MapTag) |
Description | Returns the raw data for util.event_stats, as a ListTag of MapTags. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L601 |
Name | <util.has_file[<name>]> |
Returns | ElementTag(Boolean) |
Description | Returns true if the specified file exists. The starting path is /plugins/Denizen. |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L642 |
Name | <util.int_max> |
Returns | ElementTag(Number) |
Description | Returns the maximum value of a 32 bit signed integer (a java 'int'): 2147483647 |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L350 |
Name | <util.int_min> |
Returns | ElementTag(Number) |
Description | Returns the minimum value of a 32 bit signed integer (a java 'int'): -2147483648 |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L360 |
Name | <util.java_class_context> |
Returns | ListTag |
Description | Returns a list of class names in the current stack history.
More stable than util.stack_trace This contains a lot of stray content, the first 4 to 20 or so classes in this list are likely irrelevant to what you're searching for. Each entry in the list is a raw class name, like "com.denizenscript.denizencore.tags.core.UtilTagBase". Class names may appear multiple times in a row if that class contains methods that call each other. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L981 |
Name | <util.java_version> |
Returns | ElementTag |
Description | Returns the current Java version of the server. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L632 |
Name | <util.last_reload> |
Returns | TimeTag |
Description | Returns the time that Denizen scripts were last reloaded. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L924 |
Name | <util.list_denizen_commands> |
Returns | ListTag |
Description | Returns a list of all currently loaded Denizen commands. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L420 |
Name | <util.list_files[<path>]> |
Returns | ListTag |
Description | Returns a list of all files (and directories) in the specified directory. The starting path is /plugins/Denizen. |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L663 |
Name | <util.list_numbers[to=<#>;(from=<#>/{1});(every=<#>/{1})]> |
Returns | ListTag |
Description | Returns a list of integer numbers in the specified range.
You must specify at least the 'to' input, you can optionally specify 'from' (default 1), and 'every' (default 1). Note that this generally should not be used as input to the 'foreach' command. Instead, use repeat. |
Example |
|
Example |
|
Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L265 |
Name | <util.list_numbers_to[<#>]> |
Returns | ListTag |
Description | Returns a list of integer numbers from 1 to the specified input number (inclusive).
Note that you should NEVER use this as the input to a "foreach" command. Instead, use repeat. In most cases, there's a better way to do what you're trying to accomplish than using this tag. Consider instead using util.list_numbers |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L297 |
Name | <util.list_tag_bases> |
Returns | ListTag |
Description | Returns a list of all currently loaded Denizen tag bases (including "player", "context", "util", "server", etc). |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L440 |
Name | <util.long_max> |
Returns | ElementTag(Number) |
Description | Returns the maximum value of a 64 bit signed integer (a java 'long'): 9223372036854775807 |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L370 |
Name | <util.long_min> |
Returns | ElementTag(Number) |
Description | Returns the minimum value of a 64 bit signed integer (a java 'long'): -9223372036854775808 |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L380 |
Name | <util.mongo_connections> |
Returns | ElementTag |
Description | Returns a list of all Mongo connections opened by mongo. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L902 |
Name | <util.notes[<type>]> |
Returns | ListTag |
Description | Lists all saved notable objects of a specific type currently on the server.
Valid types: locations, cuboids, ellipsoids, inventories, polygons This is primarily intended for debugging purposes, and it's best to avoid using this in a live script if possible. |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L843 |
Name | <util.parse_yaml[<yaml>]> |
Returns | MapTag |
Description | Parses the input YAML or JSON text into a MapTag. |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L566 |
Name | <util.pi> |
Returns | ElementTag(Decimal) |
Description | Returns PI: 3.14159265358979323846 |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L390 |
Name | <util.queues> |
Returns | ListTag(QueueTag) |
Description | Returns a list of all currently running queues on the server. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L581 |
Name | <util.ram_allocated> |
Returns | ElementTag(Number) |
Description | How much RAM is allocated to the server, in bytes (total memory).
This is how much of the system memory is reserved by the Java process, NOT how much is actually in use by the minecraft server. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L741 |
Name | <util.ram_free> |
Returns | ElementTag(Number) |
Description | How much RAM is unused but available on the server, in bytes (free memory). |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L762 |
Name | <util.ram_max> |
Returns | ElementTag(Number) |
Description | How much RAM is available to the server (total), in bytes (max memory). |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L752 |
Name | <util.ram_usage> |
Returns | ElementTag(Number) |
Description | How much RAM is used by the server, in bytes (free memory).
Equivalent to ram_max minus ram_free |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L772 |
Name | <util.random_boolean> |
Returns | ElementTag(Boolean) |
Description | Returns a random boolean (true or false). Essentially a coin flip. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L204 |
Name | <util.random_chance[<percent>]> |
Returns | ElementTag(Boolean) |
Description | Returns a random boolean (true or false) with the given percent chance (from 0 to 100). |
Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L189 |
Name | <util.random_decimal> |
Returns | ElementTag(Decimal) |
Description | Returns a random decimal number from 0 to 1. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L179 |
Name | <util.random_gauss> |
Returns | ElementTag(Decimal) |
Description | Returns a random decimal number with a gaussian distribution.
70% of all results will be within the range of -1 to 1. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L214 |
Name | <util.random_simplex[x=<#.#>;(y=<#.#>);(z=<#.#>);(w=<#.#>)]> |
Returns | ElementTag(Decimal) |
Description | Returns a pseudo-random decimal number from -1 to 1, based on a Simplex Noise algorithm. See https://en.wikipedia.org/wiki/Simplex_noise
Input map is like "x=1.0", or "x=1.0;y=2.0", or "x=1.0;y=2.0;z=3" or "x=1;y=2;z=3;w=4" (That is: 1d, 2d, 3d, or 4d). |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L235 |
Name | <util.random_uuid> |
Returns | ElementTag |
Description | Returns a random unique ID. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L225 |
Name | <util.random.boolean> |
Returns | ElementTag(Boolean) |
Description | Deprecated in favor of util.random_boolean |
Deprecated | use 'util.random_boolean' with a '_' |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L124 |
Name | <util.random.decimal> |
Returns | ElementTag(Decimal) |
Description | Deprecated in favor of util.random_decimal |
Deprecated | use 'util.random_decimal' with a '_' |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L112 |
Name | <util.random.decimal[<#.#>].to[<#.#>]> |
Returns | ElementTag(Decimal) |
Description | Returns a random decimal number between the 2 specified decimal numbers, inclusive. |
Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L85 |
Name | <util.random.duuid[(<source>)]> |
Returns | ElementTag |
Description | Returns a random 'denizen' unique ID, which is made of a randomly generated sentence.
Optionally specify the source context to base the value on. There is no guarantee of format or content of the returned value - generally, use any other random tag instead of this. |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L160 |
Name | <util.random.gauss> |
Returns | ElementTag(Decimal) |
Description | Deprecated in favor of util.random_gauss |
Deprecated | use 'util.random_gauss' with a '_' |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L136 |
Name | <util.random.int[<#>].to[<#>]> |
Returns | ElementTag(Number) |
Description | Returns a random integer number between the 2 specified integer numbers, inclusive. |
Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L58 |
Name | <util.random.uuid> |
Returns | ElementTag |
Description | Deprecated in favor of util.random_uuid |
Deprecated | use 'util.random_uuid' with a '_' |
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L148 |
Name | <util.real_time_since_start> |
Returns | DurationTag |
Description | Returns the duration of real time since the server started.
Note that this is real time, not delta time, meaning that the it is accurate to the system clock, not the server's tick. System clock changes may cause this value to become inaccurate. In many cases util.delta_time_since_start is preferable. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L818 |
Name | <util.redis_connections> |
Returns | ListTag |
Description | Returns a list of all Redis connections opened by redis. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L890 |
Name | <util.reflect_class[<name>]> |
Returns | JavaReflectedObjectTag |
Description | Returns a reflected reference to the class of the given full class name.
Note that the class-name input is case-sensitive. This can be used like having an object of that class, but cannot read non-static fields. |
Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L934 |
Name | <util.runlater_ids> |
Returns | ListTag |
Description | Returns a list of all scheduled task IDs for runlater.
Note that usages of runlater that didn't specify an ID will not show up here. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L621 |
Name | <util.scripts> |
Returns | ListTag(ScriptTag) |
Description | Gets a list of all scripts currently loaded into Denizen. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L914 |
Name | <util.short_max> |
Returns | ElementTag(Number) |
Description | Returns the maximum value of a 16 bit signed integer (a java 'short'): 32767 |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L330 |
Name | <util.short_min> |
Returns | ElementTag(Number) |
Description | Returns the minimum value of a 16 bit signed integer (a java 'short'): -32768 |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L340 |
Name | <util.sql_connections> |
Returns | ListTag |
Description | Returns a list of all SQL connections opened by sql. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L866 |
Name | <util.stack_trace> |
Returns | ElementTag |
Description | Generates and shows a stack trace for the current context.
This tag is strictly for internal debugging reasons. WARNING: Different Java versions generate different stack trace formats and details. WARNING: Java internally limits stack trace generation in a variety of ways. This tag cannot be relied on to output anything. For gathering stable context, prefer util.java_class_context |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L967 |
Name | <util.started_time> |
Returns | TimeTag |
Description | Returns the time the server started. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L692 |
Name | <util.tau> |
Returns | ElementTag(Decimal) |
Description | Returns Tau: 6.28318530717958647692 |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L400 |
Name | <util.time_now> |
Returns | TimeTag |
Description | Returns the current system date/time.
This value may be wrong if a server is currently heavily lagging, as it only updates once each tick. Use util.current_time_millis if you need sub-tick precision. |
Generated Example |
|
Source | https://github.com/DenizenScript/Denizen-Core/blob/master/src/main/java/com/denizenscript/denizencore/tags/core/UtilTagBase.java#L473 |