Built-in features
print(selector, ...any)
Click to view
Prints the given values to the given selector.
printTitle(selector, ...any)
Click to view
Prints the given values to the given selector as a title.
printSubtitle(selector, ...any)
Click to view
Prints the given values to the given selector as a subtitle.
printActionbar(selector, ...any)
Click to view
Prints the given values to the given selector as an actionbar message.
Math
Click to view
- Math.sqrt(int | float): float
- Math.isqrt(int | float): int
- Math.cbrt(int | float): float
- Math.exp(int | float): float
- Math.fastexp(int | float): float
- Math.ipow(int | float, int): int | float
- Math.sin(int | float): float
- Math.cos(int | float): float
- Math.tan(int | float): float
- Math.arcsin(int | float): float
- Math.arccos(int | float): float
- Math.arctan(int | float): float
- Math.fastarcsin(int | float): float
- Math.fastarccos(int | float): float
- Math.fastarctan(int | float): float
- Math.factorial(int | float): int
- Math.floor(int | float): int
- Math.ceil(int | float): int
- Math.round(int | float): int
- Math.min(...(int | float)): int | float
- Math.max(...(int | float)): int | float
- Math.random(int min=1, int max=2147483647): int
- Math.frandom(int min=1, int max=2147483647): float
Formatting texts
Click to view
In radon, you can print text to the chat using the print() function. Formatted texts allow you to make the output colored, underlined, bold etc. Here's a simple example that prints a red and bold text with the content Hello, world!:
print( fmt(red, bold, "Hello, world!") )tellraw @a {"text":"Hello, world!","color":"red","bold":true}To add text events like click or hover you can use the .click and .hover functions attached to the fmt() function call. Here's a simple example that redirects the player to Radon's documentation when they click on the text:
print(
fmt("Click me to view the Radon documentation!")
.click("open_url", "https://oguzhanumutlu.github.io/radon")
.hover("show_text", "Hello, world!")
)tellraw @a {"text":"Click me to view the Radon documentation!","clickEvent":{"action":"open_url","value":"https://oguzhanumutlu.github.io/radon"},"hoverEvent":{"action":"show_text","contents":"Hello, world!"}}You can also add child text components by using the .extend function attached to the fmt() function call. Child components will inherit the style of the parent. Here's a simple example that prints a red Hello and a red bold world:
print(
fmt(red, "Hello, ")
.extend(
fmt(bold, "world!")
)
)tellraw @a {"text":"Hello, ","color":"red","extra":[{"text":"world!","bold":true}]}Here's an example that includes everything that fmt() can offer:
print(
fmt(red, "Hello, ")
.extend(
fmt(bold, "world!")
.hover("show_text", "Hello, world!")
.click("open_url", "https://oguzhanumutlu.github.io/radon")
)
)
// Every style
print(fmt(#123456, "Custom colored text"))
print(fmt(black, "Black text"))
print(fmt(dark_blue, "Dark blue text"))
print(fmt(dark_green, "Dark green text"))
print(fmt(dark_aqua, "Dark aqua text"))
print(fmt(dark_red, "Dark red text"))
print(fmt(dark_purple, "Dark purple text"))
print(fmt(gold, "Gold text"))
print(fmt(gray, "Gray text"))
print(fmt(dark_gray, "Dark gray text"))
print(fmt(blue, "Blue text"))
print(fmt(green, "Green text"))
print(fmt(aqua, "Aqua text"))
print(fmt(red, "Red text"))
print(fmt(light_purple, "Light purple text"))
print(fmt(yellow, "Yellow text"))
print(fmt(white, "White text"))
print(fmt(bold, "Bold text"))
print(fmt(italic, "Italic text"))
print(fmt(underlined, "Underlined text"))
print(fmt(strikethrough, "Strikethrough text"))
print(fmt(obfuscated, "Obfuscated text"))tellraw @a {"text":"Hello, ","color":"red","extra":[{"text":"world!","bold":true,"hoverEvent":{"action":"show_text","contents":"Hello, world!"},"clickEvent":{"action":"open_url","value":"https://oguzhanumutlu.github.io/radon"}}]}
tellraw @a {"text":"Custom colored text","color":"#123456"}
tellraw @a {"text":"Black text","color":"black"}
tellraw @a {"text":"Dark blue text","color":"dark_blue"}
tellraw @a {"text":"Dark green text","color":"dark_green"}
tellraw @a {"text":"Dark aqua text","color":"dark_aqua"}
tellraw @a {"text":"Dark red text","color":"dark_red"}
tellraw @a {"text":"Dark purple text","color":"dark_purple"}
tellraw @a {"text":"Gold text","color":"gold"}
tellraw @a {"text":"Gray text","color":"gray"}
tellraw @a {"text":"Dark gray text","color":"dark_gray"}
tellraw @a {"text":"Blue text","color":"blue"}
tellraw @a {"text":"Green text","color":"green"}
tellraw @a {"text":"Aqua text","color":"aqua"}
tellraw @a {"text":"Red text","color":"red"}
tellraw @a {"text":"Light purple text","color":"light_purple"}
tellraw @a {"text":"Yellow text","color":"yellow"}
tellraw @a {"text":"White text","color":"white"}
tellraw @a {"text":"Bold text","bold":true}
tellraw @a {"text":"Italic text","italic":true}
tellraw @a {"text":"Underlined text","underlined":true}
tellraw @a {"text":"Strikethrough text","strikethrough":true}
tellraw @a {"text":"Obfuscated text","obfuscated":true}Listener.on("firstJoin", callback)
Click to view
Runs the callback when a player joins the world for the first time. Runs at and as the player.
Listener.on("firstJoin", () => {
print(@s, "Welcome!")
})Listener.on("join", callback)
Click to view
Runs the callback when a player joins the world. Runs at and as the player.
Listener.on("join", () => {
print(@s, "Welcome!")
})Listener.on("rejoin", callback)
Click to view
Runs the callback when a player rejoins the world. Runs at and as the player.
Listener.on("rejoin", () => {
print(@s, "Welcome back!")
})Listener.on("die", callback)
Click to view
Runs the callback when a player dies. Runs at and as the player.
Listener.on("die", () => {
print(@s, "You died!")
})Listener.on("respawn", callback)
Click to view
Runs the callback when a player respawns. Runs at and as the player.
Listener.on("respawn", () => {
print(@s, "You respawned!")
})Listener.on("carrot_on_a_stick", callback)
Click to view
Runs when a player right clicks holding a carrot on a stick. Runs at and as the player.
Listener.on("carrot_on_a_stick", () => {
print(@s, "You clicked!")
})Listener.on("warped_fungus_on_a_stick", callback)
Click to view
Runs when a player right clicks holding a warped fungus on a stick. Runs at and as the player.
Listener.on("warped_fungus_on_a_stick", () => {
print(@s, "You clicked!")
})Listener.on("any_scoreboard_event", callback)
Click to view
Runs when any scoreboard event happens. Runs at and as the player.
Listener.on("jump", () => {
print(@s, "You jumped!")
})raycast(callback on_hit_entity = null, callback on_hit_block = null, callback on_step = null, callback on_fail = null)
Click to view
Runs raycast at the current scope's position. Entity callback will be called as the entity. Block callback will be called positioned at the block.
You can configure the starting position and rotation using the execute macros:
as @p positioned 10 5 4 facing 8 5 2 {
success = raycast(() => {
print("Hit an entity with the following uuid: ", @s.UUID)
}, () => {
print("Hit a block at the following position: ", getpos())
}, () => {
print("Raycaster is stepping...")
}, () => {
print("Raycaster didn't hit anything! Infinity and beyond...")
})
print("Raycaster's succession as a boolean: ", success)
}Data.get(type, location)
Click to view
Returns the value at the given location.
Examples:
a = Data.get(int, @s.SelectedItem.count)Data.set(location, expression)
Click to view
Sets the value at the given location.
Examples:
a = 5
Data.set(@s.Health, 10 + 5 - a)Data.append(location, expression)
Click to view
Appends the value at the given location.
Examples:
a = 5
Data.append(some_storage path, 10 + 5 - a)Data.merge(location, expression)
Click to view
Merges the value at the given location.
Examples:
Data.merge(@s, {Health: 10})
Data.merge(@s.attributes, [{"id": "minecraft:generic.movement_speed", "base": 0.1}])Recipe.add(object)
Click to view
WARNING
This is a macro function, so it will run in compile time and bypass flow controls.
pyeval(pythonCode)
Click to view
Executes the given python expression.
pyexec(pythonCode)
Click to view
Executes the given python code.
Adds the given object to the recipes.
swap(non-literal, non-literal)
Click to view
Executes the given python code.
Adds the given object to the recipes.
success(minecraft command)
Click to view
Returns whether the given minecraft command runs successfully.
time(): int
Click to view
Returns the current time in game ticks.
ftime(): float
Click to view
Returns the current time in seconds as a float.
getpos(): float[]
Click to view
Returns the current position the function is running from. Works by summoning a marker and using its Pos NBT.
exit(any)
Click to view
Lets you return in the main scope.
true
Click to view
Macro for 1.
false
Click to view
Macro for 0.
null
Click to view
Macro for 0.
vset(expression, value)
Click to view
Sets the value of a variable. Allows macros.
Examples:
a = 10
b = 3
vset(a, $(b + 10)$(b + 5))mset(expression, data location)
Click to view
Sets the value of a variable from a data location. Allows macros.
Examples:
a = 10
mset(a, player_storage points."$(@s.UUID)")mstr(macro)
Click to view
Gives the result of the given input as a string using vanilla macros.
Examples:
b = 10
c = 20
d = "hello!"
result = mstr(b is: $(b), c is: $(c), d is: $(d))
// result = "b is: 10, c is: 20, d is: hello!"runCommand(macro)
Click to view
Runs the command using macros. This is only useful if the command itself is a macro.
Examples:
myCommand = "say "
runCommand($(myCommand) Hello, world!)