# Use to create a fake explosion.
- playeffect effect:EXPLOSION_HUGE at:<player.location> visibility:500 quantity:10 offset:2.0

# Use to play a cloud effect.
- playeffect effect:CLOUD at:<player.location.add[0,5,0]> quantity:20 data:1 offset:0.0

# Use to play some effects at spawn.
- playeffect effect:FIREWORKS_SPARK at:<world[world].spawn_location> visibility:100 quantity:375 data:0 offset:50.0

# Use to spawn a cloud of rainbow-colored ENTITY_EFFECT particles around yourself.
- foreach <util.color_names> as:color:
    - playeffect effect:ENTITY_EFFECT at:<player.eye_location> quantity:25 special_data:[color=<[color]>]

# Use to shoot particles in to the direction you're looking at.
- repeat 10:
    - playeffect effect:TRAIL at:<player.eye_location> quantity:1 offset:0 special_data:[color=red;target=<player.eye_location.ray_trace[default=air]>;duration=5s]
    - wait 1t

# Use to spawn a SCULK_CHARGE effect upside down.
- playeffect effect:SCULK_CHARGE at:<player.eye_location.add[0,1,0]> quantity:1 offset:0 special_data:[radians=<element[180].to_radians>]

# Use to play a SHRIEK effect with a 5-second delay.
- playeffect effect:SHRIEK at:<player.eye_location.add[0,1,0]> quantity:1 special_data:[duration=5s]

# Use to take an arrow from the player's enderchest
- take item:arrow from:<player.enderchest>

# Use to take the current holding item from the player's hand
- take iteminhand

# Use to take 5 emeralds from the player's inventory
- take item:emerald quantity:5

# The name of the map script is used by the map command.
Map_Script_Name:

    type: map

    # Whether to display the original map below the custom values. Defaults to true.
    # | Some map scripts should have this key!
    original: true/false

    # Whether to constantly update things. Defaults to true.
    # | Some map scripts should have this key!
    auto update: true

    # Whether this map script renders uniquely per-player. Defaults to true.
    # | Some map scripts should have this key!
    contextual: true

    # Lists all contained objects.
    # | Most map scripts should have this key!
    objects:

        # The first object...
        1:
            # Specify the object type
            # Type can be IMAGE, TEXT, CURSOR, or DOT.
            type: image
            # Specify an HTTP url or file path within Denizen/images/ for the image. Supports animated .gif!
            image: my_image.png
            # Optionally add width/height numbers.
            width: 128
            height: 128
            # Specify a tag to show or hide custom content! Valid for all objects.
            # Note that all inputs other than 'type' for all objects support tags that will be dynamically reparsed per-player each time the map updates.
            visible: <player.name.contains_text[bob].not>

        2:
            type: text
            # Specify any text to display. Color codes not permitted (unless you know how to format CraftMapCanvas byte-ID color codes).
            text: Hello <player.name>
            # Specify the color of the text as any valid ColorTag.
            color: red
            # | Optionally, specify the following additional options:
            # Specify a font to use, which allows using special characters/other languages the default font may not support.
            font: arial
            # Specify a text size (only available with a custom font).
            size: 18
            # Specify a style, as a list that contains either "bold", "italic", or both (only available with a custom font).
            style: bold|italic
        3:
            type: cursor
            # Specify a cursor type
            cursor: red_marker
            # Optionally, specify a cursor direction. '180' seems to display as up-right usually.
            direction: 180
            # Supported on all objects: x/y positions, and whether to use worldly or map coordinates.
            x: 5
            # If 'world_coordinates' is set to 'true', the 'y' value corresponds to the 'z' value of a location.
            y: 5
            # If true: uses world coordinates. If false: uses map local coordinates. (Defaults to false).
            world_coordinates: false
            # If true: when the object goes past the edge, will stay in view at the corner. If false: disappears past the edge (defaults to false).
            show_past_edge: false

        4:
            type: dot
            # Specify the radius of the dot.
            radius: 1
            # Specify the color of the dot as any valid ColorTag.
            color: red

# Destroys whatever solid block the player is looking at.
- define target <player.eye_location.ray_trace[return=block]||null>
- if <[target]> != null:
    - modifyblock <[target]> air

# Spawns a heart wherever the player is looking, no more than 5 blocks away.
- playeffect effect:heart offset:0 at:<player.eye_location.ray_trace[range=5;entities=*;ignore=<player>;fluids=true;nonsolids=true;default=air]>

# Spawns a line of fire starting at the player's target location and spewing out in the direction of the blockface or entity hit, demonstrating the concept of a normal vector.
- define hit <player.eye_location.ray_trace[entities=*;ignore=<player>;fluids=true;nonsolids=true]||null>
- if <[hit]> != null:
    - playeffect effect:flame offset:0 at:<[hit].points_between[<[hit].forward[2]>].distance[0.2]>

# Use to put snow on the block at the player's feet.
- adjustblock <player.location.below> snowy:true

# Use to switch on the lever that the player is looking at, without actually providing redstone power.
- adjustblock <player.cursor_on> switched:true no_physics

# Use to copy the block the player is looking at to their current location
- copyblock <player.cursor_on> to:<player.location>

# Use to move the block the player is looking at to their current location (removing it from its original location)
- copyblock <player.cursor_on> to:<player.location> remove_original

# Use to show a debug block where the player is looking.
- debugblock <player.cursor_on>

# Use to show a transparent green debug block in front of the player for five seconds.
- debugblock <player.eye_location.forward[2]> color:0,255,0,128 d:5s

# Use to remove all debug blocks,
- debugblock clear

# Makes the NPC throw their fishing line out to where the player is looking, with a 50% chance of catching fish.
- fish <player.cursor_on> catch:fish chance:50

# Makes the NPC stop fishing.
- fish stop

# Use to open a chest inventory, at a location.
- inventory open d:<context.location>

# Use to open a virtual inventory with a title and some items.
- inventory open d:generic[size=27;title=BestInventory;contents=snowball|stick]

# Use to open another player's inventory.
- inventory open d:<[player].inventory>

# Use to remove all items from a chest, except any items in the specified list.
- inventory keep d:<context.location.inventory> o:snowball|ItemScript

# Use to remove all sticks and stones from the player's inventory.
- inventory exclude origin:stick|stone

# Use to clear the player's inventory entirely.
- inventory clear

# Use to swap two players' inventories.
- inventory swap d:<[playerOne].inventory> o:<[playerTwo].inventory>

# Use to adjust a specific item in the player's inventory.
- inventory adjust slot:5 "lore:Item modified!"

# Use to set a single stick into slot 10 of the player's inventory.
- inventory set o:stick slot:10

# Use to set a temporary flag on the player's held item.
- inventory flag slot:hand my_target:<player.cursor_on> expire:1d

# Use to attach a leash to the player's target.
- leash <player.target> holder:<player>

# Use to attach the closest cow in 10 blocks to the fence the player is looking at.
- leash <player.location.find_entities[cow].within[10].first> holder:<player.cursor_on>

# Use to release the target entity.
- leash cancel <player.target>

# Use to change the block a player is looking at to stone.
- modifyblock <player.cursor_on> stone

# Use to modify an entire cuboid to half stone, half dirt.
- modifyblock <player.location.to_cuboid[<player.cursor_on>]> stone|dirt

# Use to modify an entire cuboid to some stone, some dirt, and some left as it is.
- modifyblock <player.location.to_cuboid[<player.cursor_on>]> stone|dirt 25|25

# Use to modify the ground beneath the player's feet.
- modifyblock <player.location.add[2,-1,2].to_cuboid[<player.location.add[-2,-1,-2]>]> RED_WOOL

# Use to place a fake gold block at where the player is looking
- showfake gold_block <player.cursor_on>

# Use to place a stone block right on player's head, that only stays for a second.
- showfake stone <player.location.add[0,1,0]> duration:1s

# Use to place fake lava that the player is standing in, for all the server to see
- showfake lava <player.location> players:<server.online_players>

# Make the linked NPC sit at the player's cursor location.
- sit <player.cursor_on>

# Make the linked NPC sleep at the player's cursor location.
- sleep <player.cursor_on>

# At the player's location, switch the state of the block to on, no matter what state it was in before.
- switch <player.location> state:on

# Opens a door that the player is looking at.
- switch <player.cursor_on> state:on

# Toggle a block at the player's foot location.
- switch <player.location>

# Use to teleport a player to the location their cursor is pointing at.
- teleport <player> <player.cursor_on>

# Use to teleport a player high above.
- teleport <player> <player.location.above[200]>

# Use to teleport to a random online player.
- teleport <player> <server.online_players.random.location>

# Use to teleport all players to your location.
- teleport <server.online_players> <player.location>

# Use to teleport the NPC to a location that was noted with the <@link command note> command.
- teleport <npc> my_prenoted_location

# Use to teleport a player to some location, and inform events that it was caused by a nether portal.
- teleport <player> <server.flag[nether_hub_location]> cause:nether_portal

# Use to teleport the player without closing their currently open inventory.
- teleport <player> <player.location.below[5]> entity_options:retain_open_inventory