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

# Narrates a translatable of a diamond sword's name.
- narrate "Reward: <&translate[key=item.minecraft.diamond_sword]>"

# Narrates a translatable with some input data.
- narrate <&translate[key=commands.give.success.single;with=32|<&translate[key=item.minecraft.diamond_sword]>|<player.name>]>

# Narrates a custom translatable (from something like a resource pack), with a fallback in case it can't be translated.
- narrate <&translate[key=my.custom.translation;fallback=Please use the resource pack!]>

- 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>

# Converts a base64 encoded string into an ImageTag, commonly used in web APIs.
- define image <[base64].base64_to_binary.to_image>

# 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 '0.8'.
- narrate "Stay warm! In a plains biome, the base temperature is <biome[plains].base_temperature>!"

# Tells the linked player what the downfall type at their location is.
- narrate "The downfall type at your location is: <player.location.biome.downfall_at[<player.location>]>!"

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

# Sends the player a message in their current biome's fog color.
- narrate "You are currently seeing fog that looks like <&color[<player.location.biome.fog_color>]>this!"

# Tells the linked player whether there's a possibility of rain.
- if <player.location.biome.has_downfall>:
  - narrate "It might rain or snow!"
- else:
  - narrate "It will be dry."

# 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>

# Gives the player water if they are standing in a warm location.
- if <player.location.biome.temperature_at[<player.location]> > 0.5:
  - give water_bucket

# Sends the player a message in their current biome's water fog color.
- narrate "If you are underwater, everything looks like <&color[<player.location.biome.water_fog_color>]>this!"

# 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>!"