Global Procs

Immediately terminates the running procedure, providing a stack trace with the given message, output to the /world/var/Log.

Displays a customizable alert message to a user (either a /mob or /client). It accepts a title, message, and up to three buttons as text. If no buttons are specified, the first defaults to "Ok".

If no user is explicitly provided, the current user is used and arguments are shifted. The function checks for a valid connection; if none exists, it returns "OK". Otherwise, it sends the alert and returns the user's interaction.

Returns the character corresponding to a UTF-32 character code - despite the name of this proc, it is not limited to ASCII characters.

world.log << ascii2text(5660) // ᘜ

This proc allows for us to get a list of the turfs within a specified area.

for(var/turf/my_turf in block(1, 1, 1, 10, 10, 10))
    my_turf.icon_state = "green"

This will change the /atom/var/icon_state of every turf, beginning at the turf located at X = 1, Y = 1, Z = 1 and finishing at the turf located at X = 10, Y = 10 and Z = 10, to "green". This list is inclusive of the Start and End turfs.

The ceiling is the largest integer greater than or equal to the provided number.

world.log << ceil(1.00001) // 2
world.log << ceil(-0.00001) // 0

The canonical form of a given key is composed of lowercase letters between A-Z, numbers between 0-9 and the @ symbol. This is pre-generated on both /mob/var/ckey and /client/var/ckey, based on the user's /client/var/key.

var/my_evil_key = "W0w!!IGotLots-ofFunCharacters!!!InHere@@"

world.log << ckey(my_evil_key) // w0wigotlotsoffuncharactersinhere@@

This is similar to ckey(), however, case is preserved, along with - and _ characters. All other special characters (apart from the @ symbol, as with ckey()) will be removed.

world.log << ckeyEx("OhSoWe'ReKeeping!MyCapitalLetters?Now") // OhSoWeReKeepingMyCapitalLettersNow

Constricts a number between the Low and High values provided. If the number is between those values, it is unchanged. If it exceeds the Low or High values, those will be returned.

world.log << clamp(5, 1, 10) // 5
world.log << clamp(1, 5, 10) // 5
world.log << clamp(15, 1, 10) // 10

When operating on a list, this functions as if clamp() has been run on each entry in the list.

var/my_list = list(1, 2, 3, 4, 5, 6, 7, 8, 9)
for(var/num in clamp(my_list, 1, 5))
    world.log << num // 1, 2, 3, 4, 5, 5, 5, 5, 5

This proc is case insensitive, unlike cmpTextEx(). Any number of arguments can be given to this proc, and it will return 1 if they are all the same.

if(cmptext("letsplayagame", "LETSPLAYAGAME", "letsPlayAGame"))
    world.log << "Yay!" // "Yay!" is printed

Copies characters in the provided string between the Start and End position. By default, the End value will copy the remainder of the string. You can also specify negative positions for the Start or End, which will cause it to work backwards.

world.log << copytext("Foo Bar", 5) // Bar
world.log << copytext("Foo Bar", 1, 4) // Foo

world.log << copytext("Foo Bar", -3) // Bar
world.log << copytext("Foo Bar", -7, -3) // Foo

For non-ASCII strings, where the string position does not necessarily correlate to character position, you will need the _char variant of this proc. copytext_char() works in text elements, and otherwise functions identically.

Moves Ref in direction Dir, respecting collision defined by /atom/var/density and /atom/proc/Cross().