- narrate "<&gradient[from=black;to=white]>these are the shades of gray <white>that solidifies to pure white"

- define x 3
# Narrates '3'
- narrate <[x]>

- definemap mymap:
    mykey: example
# Narrates 'example'
- narrate <[mymap.mykey]>

- webget <secret[my_secret_url]> "post:Message to secret address!"

# This example will narrate the same number every time it's ran, until "/ex reload" is used.
- narrate <static[<util.random_decimal>]>

# Spawns a debugblock to highlight every plank-type block in the area.
- debugblock <cuboid[my_cuboid].blocks[*planks]>

# Spawns a debugblock to highlight every block in the cuboid that has the location flag 'my_flag'.
- debugblock <cuboid[my_cuboid].blocks_flagged[my_flag]>

# Notes the polygon's bounding box to efficiently check when things are near the polygon, even if not exactly inside.
- note <polygon[my_poly].bounding_box> my_bound_box

# Checks to see if "my_cuboid" contains the player's location.
- if <cuboid[my_cuboid].contains[<player.location>]>:
     - narrate "You are within 'my_cuboid'!"
- else:
     - narrate "You are NOT within 'my_cuboid'!"

# Spawns a flash particle at the location of every axolotl in the cuboid.
- foreach <cuboid[my_cuboid].entities[axolotl]> as:entity:
    - playeffect effect:flash at:<[entity].location>

# Checks to see if "my_cuboid" is within "my_bigger_cuboid".
- if <cuboid[my_cuboid].is_within[<cuboid[my_bigger_cuboid]>]>:
     - narrate "It is fully within 'my_bigger_cuboid'!"
- else:
     - narrate "It is not fully within 'my_bigger_cuboid'!"

# Narrates the name of all the living entities within the area.
- foreach <cuboid[my_cuboid].living_entities> as:entity:
     - narrate <[entity].name>

# Narrates a list of NPCs' names that are within the area.
# For example: "List of NPCs in 'my_cuboid': steve, alex, john, jane"
- narrate "List of NPCs in 'my_cuboid': <cuboid[my_cuboid].npcs.formatted>"

# Narrates a list of players' names that are within the area.
# For example: "List of players in 'my_cuboid': steve, alex, john, jane"
- narrate "List of players in 'my_cuboid': <cuboid[my_cuboid].players.formatted>"

# Spawns a hollow sphere of fire around the player.
- playeffect effect:flame at:<player.location.to_ellipsoid[5,5,5].shell> offset:0

# Spawns a creeper at a random spawnable block within the area.
- spawn creeper <cuboid[my_cuboid].spawnable_blocks.random>

# Notes a copy of "my_cuboid" with the same coordinates transposed from the overworld to the end world.
- note my_new_cuboid <cuboid[my_cuboid].with_world[world_the_end]>

- narrate "The cuboid, 'my_cuboid', is in world: <cuboid[my_cuboid].world.name>!"

# Narrates '255'
- narrate <binary[000000ff].decode_integer>

- define data <binary[48454c4c4f20574f524c44]>
- define compressed <[data].gzip_compress>
- define decompressed <[data].gzip_decompress>
- if <[decompressed].to_hex> == <[data].to_hex>:
    - narrate "Everything works!"

- define data <binary[48454c4c4f20574f524c44]>
- define compressed <[data].gzip_compress>
- define decompressed <[data].gzip_decompress>
- if <[decompressed].to_hex> == <[data].to_hex>:
    - narrate "Everything works!"

# Narrates binary data "4b68507f1746b0e5f3efe99b8ef42afef79da017", the exact SHA-1 hash of ASCII "HELLO WORLD".
- narrate <binary[48454c4c4f20574f524c44].hash[SHA-1]>

# Narrates "f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8".
- narrate <element[The quick brown fox jumps over the lazy dog].utf8_encode.hmac[type=HmacSHA256;key=key].to_hex>

# Narrates 3
- narrate <binary[010203].length>

# narrates "HELLO WORLD"
- narrate <binary[48454c4c4f20574f524c44].text_decode[us-ascii]>

- define data <binary[48454c4c4f20574f524c44]>
- define encoded <[data].to_base64>
- define decoded <[encoded].base64_to_binary>
- if <[decoded].to_hex> == <[data].to_hex>:
    - narrate "Everything works!"

# Narrates 010203
- narrate <binary[010203].to_hex>

# narrates "HELLO WORLD"
- narrate <binary[48454c4c4f20574f524c44].utf8_decode>

- define data <binary[48454c4c4f20574f524c44]>
- define compressed <[data].zlib_compress>
- define decompressed <[data].zlib_decompress>
- if <[decompressed].to_hex> == <[data].to_hex>:
    - narrate "Everything works!"

- define data <binary[48454c4c4f20574f524c44]>
- define compressed <[data].zlib_compress>
- define decompressed <[data].zlib_decompress>
- if <[decompressed].to_hex> == <[data].to_hex>:
    - narrate "Everything works!"

# Reads a player ".dat" file's NBT data
- ~fileread path:data/<player.uuid>.dat save:x
- define data <entry[x].data.gzip_decompress.nbt_to_map>
# Now do something with "<[data]>"

# In a plains biome, this fills with 'RAIN'.
- narrate "The downfall type in plains biomes is: <biome[plains].downfall_type>!"

# In a plains biome, this fills with '0.4'.
- narrate "Humidity in a plains biome is <biome[plains].humidity>! So humid!"

# In a plains biome, this fills with 'plains'.
- narrate "You are currently in a <biome[plains].name> biome!"

# Narrates the types of entities of type MONSTERS that can spawn in the player's biome.
# For example, in a plains biome this could contain "SPIDER", "ZOMBIE", "CREEPER", etc.
- narrate <player.location.biome.spawnable_entities[MONSTERS].formatted>

# In a plains biome, this fills with '0.8'.
- narrate "Stay warm! In a plains biome, the temperature is <biome[plains].temperature>!"

# Adds 10 to the X and Z coordinates of the player's current chunk and loads it.
- chunkload <player.location.chunk.add[10,10]>

# Narrates the average height of each block in the player's chunk rounded.
- narrate "The average height of blocks in this chunk is <player.location.chunk.average_height.round>!"

# Spawns a debugblock to highlight every block in the chunk flagged "my_flag"
- debugblock <player.location.chunk.blocks_flagged[my_flag]>

# Plays the "flame" effect at the player's chunk as a cuboid outlined along the player's Y coordinate.
- playeffect effect:flame at:<player.location.chunk.cuboid.outline_2d[<player.location.y>]> offset:0.0

# Loops though the entities found in the player's chunk and narrates the name and location of it.
- foreach <player.location.chunk.entities> as:entity:
    - narrate "Found a <[entity].name> at <[entity].location.simple>!"

# Loops though the axolotls found in the player's chunk and narrates the name and location of it.
- foreach <player.location.chunk.entities[axolotl]> as:entity:
    - narrate "Found an axolotl at <[entity].location.simple>!"

- if <player.location.chunk.force_loaded>:
    - narrate "This chunk is being forced to stay loaded!"
- else:
    - narrate "This chunk is NOT being forced to stay loaded!"

# Narrates the height as a number of the highest block in the chunk.
- narrate "The block with the tallest height has a height of <player.location.chunk.height_map.highest>!"

# Narrates the time inhabited in the chunk by the player formatted into words.
# For example: "You have been in this chunk for a total of 2 hours 26 minutes!"
- narrate "You have been in this chunk for a total of <player.location.chunk.inhabited_time.formatted_words>!"

- if <player.location.chunk.is_flat>:
    - narrate "Wow! That is a flat chunk!"
- else:
    - narrate "Watch out! This chunk has a more rugged terrain!"

- if <player.location.chunk.is_flat[4]>:
    - narrate "Wow! This chunk's blocks are all less than 4 blocks apart in height!"
- else:
    - narrate "This chunk's blocks do not meet the criteria of being flat."

# Loops though the chunks surrounding the player in a 20x20 radius and loads the chunk if it has not been generated yet.
# Loading the chunk will generate it if it has not been generated already.
- repeat 20 from:-10 as:x:
    - repeat 20 from:-10 as:z:
        - if !<player.location.chunk.add[<[x]>,<[z]>].is_generated>:
            - chunkload <player.location.chunk.add[<[x]>,<[z]>]>

# Loops though the chunks surrounding the player in a 20x20 radius and loads the chunk if it is not already loaded.
- repeat 20 from:-10 as:x:
    - repeat 20 from:-10 as:z:
        - if !<player.location.chunk.add[<[x]>,<[z]>].is_loaded>:
            - chunkload <player.location.chunk.add[<[x]>,<[z]>]>

# Loops though the living entities found in the player's chunk and narrates the name and location of it.
- foreach <player.location.chunk.living_entities> as:entity:
    - narrate "Found a <[entity].name> at <[entity].location.simple>!"

# Narrates a list of players excluding the original player in the chunk formatted into a readable format.
# For example, this can return: "steve, alex, john, and jane".
- narrate "Wow! Look at all these players in the same chunk as you: <player.location.chunk.players.exclude[<player>].formatted>!"

# Narrates the list of plugin names keeping the player's chunk loaded formatted into readable format.
# Example: "Plugins keeping your chunk loaded: Denizen and Citizens".
- narrate "Plugins keeping your chunk loaded: <player.location.chunk.plugin_tickets.formatted>"

- if <player.location.chunk.spawn_slimes>:
    - narrate "Watch out! Slimes can spawn here!"
- else:
    - narrate "No slimes can spawn here! You are safe for now!"

# Subtracts 10 from the X and Z coordinates of the player's current chunk and loads it.
- chunkload <player.location.chunk.sub[10,10]>

# Spawns a creeper above a random surface block to prevent the creeper from suffocating.
- spawn creeper <player.location.chunk.surface_blocks.random.above>

# Spawns a debugblock to highlight every tile entity in the chunk.
- debugblock <player.location.chunk.tile_entities>

# Narrates the name of the player's chunk's associated world.
# For example, if the player was in <chunk[5,10,world]>, the world the chunk is in would be "world".
- narrate "The world your chunk is in is: <player.location.chunk.world.name>!"

# Narrates the player's chunk's X coordinate.
# For example, if the player was in <chunk[5,10,world]>, the X coordinate would be "5".
- narrate "Your current X chunk coordinate is: <player.location.chunk.x>!"

# Narrates the player's chunk's Z coordinate.
# For example, if the player was in <chunk[5,10,world]>, the Z coordinate would be "10".
- narrate "Your current Z chunk coordinate is: <player.location.chunk.z>!"

# Narrates "255".
- narrate <color[fuchsia].alpha>