# Gather the original data
- define playerdata <player.flag_map[flag1|flag2|taco|potato|waffle|etc]>
# Now reapply it elsewhere (eg a different Bungee server)
- flag <player> __raw:<[playerdata]>

ui_type: progress_bar
# The direction the bar moves in as its value increases, required.
direction: UP/RIGHT/DOWN/LEFT
# The texture used for the bar's background, optional.
background: <GUI Texture>
# The texture used for the bar's progress meter, optional.
bar: <GUI Texture>
# The amount of progress the bar made out of its max progress, optional.
value: <number>
# The max value a bar can have, a bar's value is counting up towards this value, optional.
max_value: <number>
# A tooltip to be shown when hovering over the bar.
tooltip: <text>

ui_type: box_panel
# The axis to sort the elements in the box panel along, required.
axis: HORIZONTAL/VERTICAL
# The box panel's insets, optional.
insets: <GUI Insets>
# The box panel's background, optional.
background: <GUI Background>
# The spacing between elements in the box panel, optional.
spacing: <number>
# The vertical alignment for elements in the box panel, optional.
vertical_alignment: TOP/CENTER/BOTTOM
# The horizontal alignment for elements in the box panel, optional.
horizontal_alignment: LEFT/CENTER/RIGHT
# The elements in the box panel, optional.
content:
    <key>: <GUI Element>

ui_type: button
# A label for the button, optional.
label: <text>
# An icon for the button, optional.
icon: <GUI Icon>
# The icon's size (width and height), optional.
icon_size: <number>
# Horizontal text alignment for the button's label, optional.
horizontal_text_alignment: LEFT/CENTER/RIGHT
# Code to run when the button is pressed, optional.
on_click:
- <script>

ui_type: dynamic_label
# The dynamically updating text for the label, required.
text: <text>
# The vertical alignment for the label's text, optional.
vertical_alignment: TOP/CENTER/BOTTOM
# The horizontal alignment for the label's text, optional.
horizontal_alignment: LEFT/CENTER/RIGHT
# The color for the label's text, optional.
color: <ColorTag>

ui_type: grid_panel
# The size of each cell in the grid, required.
grid_size: <number>
# The grid panel's insets, optional.
insets: <GUI Insets>
# The grid panel's background, optional.
background: <GUI Background>
# The horizontal spacing between grid cells, optional.
horizontal_spacing: <number>
# The vertical spacing between grid cells, optional.
vertical_spacing: <number>
# The GUI elements in the grid panel, optional.
content:
    <key>: <GUI Element>

# The color to use for the background, required.
color: <ColorTag>
# The contrast between the color and the bright/dark edges of the background, required.
contrast: <decimal>

# All 4 of these are required, and control the distance from different edges.
top: <number>
left: <number>
bottom: <number>
right: <number>
# Optionally replace all 4 of these with this single key, which sets a single inset for all edges.
all: <number>

# The sprite sheet to use a part of, required.
texture: <texture path>
# The left value of the top left point of the area to use, required.
u: <decimal>
# The top value of the top left point of the area to use, required.
v: <decimal>
# The width of the area to use, required.
width: <decimal>
# The height of the area to use, required.
height: <decimal>

ui_type: item
# The item (or list of items) to display, required.
items: <ListTag(ItemTag)>
# The duration to show each item for when more than one is specified, optional.
frame_duration: <DurationTag>

ui_type: label
# The text the label will show, optional.
text: <text>
# The vertical alignment for the label's text, optional.
vertical_alignment: TOP/CENTER/BOTTOM
# The horizontal alignment for the label's text, optional.
horizontal_alignment: LEFT/CENTER/RIGHT
# The label's text color, optional.
color: <ColorTag>

ui_type: labeled_slider
# A static unchanging label for the slider, optional.
label: <text>
# A dynamic label for the slider that updates every time the slider's value changes, optional.
# Provides <context.value>, returns an ElementTag(Number) of the slider value the label is being parsed for.
# Note that this overrides the normal label if specified.
dynamic_label: <text>

ui_type: plain_panel
# The plain panel's insets, optional.
insets: <GUI Insets>
# The plain panel's background, optional.
background: <GUI Background>
# The plain panel's contained elements, optional.
content:
    <key>: <GUI Element>

# The scroll panel's contained GUI element, required.
content: <GUI Element>
# The scroll panel's insets, optional.
insets: <GUI Insets>
# The scroll panel's background, optional.
background: <GUI Background>
# Whether the scroll panel should have a vertical scroll bar, optional (defaults to DEFAULT).
vertical_scroll: FALSE/DEFAULT (automatically add/remove based on the content's size)/TRUE
# Whether the scroll panel should have a horizontal scroll bar, optional (defaults to DEFAULT).
horizontal_scroll: FALSE/DEFAULT (automatically add/remove based on the content's size)/TRUE
# The scroll panel's vertical scroll speed, optional.
vertical_scroll_speed: <number>
# The scroll panel's horizontal scroll speed, optional.
horizontal_scroll_speed: <number>

ui_type: slider
# The minimum value the slider can hold, optional (defaults to 0).
min: <number>
# The maximum value the slider can hold, required.
max: <number>
# The axis the slider slides along, required.
axis: HORIZONTAL/VERTICAL
# The direction the slider slides in along its axis to increase its value, optional.
# Defaults to UP for vertical sliders, and RIGHT for horizontal sliders.
# Note that the direction must match the axis, UP/DOWN for VERTICAL, and LEFT/RIGHT for HORIZONTAL.
direction: UP/DOWN/LEFT/RIGHT
# The value the slider should be on, optional.
value: <number>
# Code to run when the slider's value is changed in the slightest (each number it goes through while dragging), optional.
# Provides <context.new_value>, returning an ElementTag(Number) of the slider's new value.
# Should generally prefer listening to the final value set instead of this.
on_change:
- <script>
# Code to run when the slider's value is set (the user finished changing it), optional.
# Provides <context.new_value>, returning an ElementTag(Number) of the slider's new value.
on_set:
- <script>

ui_type: sprite
# A single texture to display, optional (must specify either this or a list of frames).
texture: <GUI Texture>
# A list of frames to display, optional (must specify either this or a single texture).
frames:
    <key>: <GUI Texture>
# The duration to display each frame for, required when specifying frames.
frame_duration: <DurationTag>
# A tint to apply onto each texture shown by the sprite element, optional.
tint: <ColorTag>

ui_type: tab_panel
# The tab panel's background, optional.
background: <GUI Background>
# The tab panel's tabs, optional.
tabs:
    <tab id>:
        # A tab's content, required.
        content: <GUI Element>
        # A tab's title, optional.
        title: <text>
        # A tab's tooltip (shown when hovering over it), optional.
        tooltip: <ListTag>
        # A tab's icon, optional.
        icon: <GUI Icon>

ui_type: text_field
# Suggestion text to display in the text field until actual text is inputted, optional.
suggestion: <text>
# Pre-existing input text to set into the text field, optional.
text: <text>
# Whether the text field is editable, optional.
editable: <boolean>
# The maximum amount of characters a text field can hold, optional (defaults to 16).
max_length: <number>
# The color a text field's text should have when not editable, optional.
disabled_color: <ColorTag>
# The color a text field's text should have when editable, optional.
enabled_color: <ColorTag>
# The color a text field's suggestion text should have, optional.
suggestion_color: <ColorTag>
# A tag that determines whether an input is valid, blocking it otherwise. optional.
# Provides <context.new_text>, returning an ElementTag of the text field's text, as it would be with the new input.
input_checker: <tag, returning a boolean>
# Code to run when the text field's text is changed, optional.
# Provides <context.new_text>, returning an ElementTag of the text field's new text.
on_change:
- <script>

ui_type: text
# The text element's text, required.
text: <text>
# The text element's text color, optional.
color: <ColorTag>

ui_type: toggle_button
# The toggle button's label, optional.
label: <text>
# The texture to display when the toggle button is set to "true", optional.
on_texture: <GUI Texture>
# The texture to display when the toggle button is set to "false", optional.
off_texture: <GUI Texture>
# The texture to display when the toggle button is focused, optional.
focused_texture: <GUI Texture>
# The state the toggle button should be set to, optional (defaults to false).
state: <boolean>
# Code to run when the toggle button is toggled, optional.
# Provides <context.new_value>, returning an ElementTag(Boolean) of the toggle button's new value.
on_toggle:
- <script>

- animatechest [<location>] ({open}/close) (sound:{true}/false)

- repeat 3:
  - narrate "<[value]>"
  - narrate "everything spaced out as a sub-block (these two narrates) following a ":" ended command (that repeat) is for the <commands> input!"

- stop if:<player.has_flag[forbidden]>
# Equivalent to
- if <player.has_flag[forbidden]>:
  - stop

Custom_Script_Name:

    type: custom

    # Use 'inherit' to make this custom script container inherit from another custom object.
    inherit: some_object

    # This adds default field 'some_field' with initial value of 'some_value'.
    some_field: some_value

    # List additional fields here...

    # Use 'tags' to define scripted tags on the object.
    # Tags are subject to the same rules as procedure scripts:
    # NEVER change any external state. Just determine a value. Nothing else should change from the script.
    tags:

        # This would be read like <[my_object].my_tag>
        my_tag:
        # Perform any logic here, and 'determine' the result.
        - determine 3

        # list additional tags here...

    # Use 'mechanisms' to define scripted mechanisms on the object.
    # Note that these should only ever determine a new object,
    # with NO CHANGES AT ALL outside the replacement determined object.
    # (Same rules as tags and procedure scripts).
    mechanisms:

        # This would be used like custom@Custom_Script_Name[my_mech=3]
        my_mech:
        - adjust <context.this> true_value:<context.value.mul[2]> save:new_val
        - determine <entry[new_val].result>

        # list additional mechanisms here...

data_script_name:

    type: data

    # Your data here
    some_key: some value
    some_list_key:
    - some list value
    some_map_key:
        some_subkey: some value

# An example of a basic GUI script container, with a plain panel as its element.
my_gui:
    type: gui
    ui_type: plain_panel
    width: 200
    height: 200
    content: <GUI Element>

Proc_Script_Name:

    type: procedure

    # Optionally specify definition names to use with the 'context' input of the proc tag.
    definitions: def|names|here

    script:

    # Put any logic, then determine the result.
    - determine 5

script name:
    key: value
    list key:
        - list value
        - ...
    parent key:
        child key: value

a haiku script:
    type: task
    script:
      - narrate "A simple script,"
      - narrate "with a key value relationship."
      - narrate "Oh look, a list!"

script name:         <--- script name
  type: script_type
  script:            <--- base script
    - script entries
    - ...
  local script:      <--- local script path
    - script entries
    - ...

script name:
  type: script_type  <--- script type
  script:
    - script entries
    - ...

Task_Script_Name:

    type: task

    # When intending to run a task script via the run command with the "def:" argument to pass data through,
    # use this "definitions" key to specify the names of the definitions (in the same order as the "def:" argument will use).
    # You can optionally document a definition with [square brackets]
    definitions: name1|name2[description here]|...

    script:

    - your commands here

World_Script_Name:

    type: world

    events:

        # Any event label can be placed here
        # This includes generic labels like 'on entity death:',
        # Specified labels  like 'on player death:',
        # And detailed labels like 'on player death ignorecancelled:true priority:5:'
        some event label:
        # Write any logic that should fire when the event runs.
        # Optionally 'determine' any results to the event.
        - some commands

        # List additional events here

- if <player.exists>:

- define target <server.match_player[<context.args.get[1]>].if_null[null]>
- if <[target]> == null:
    - narrate "<&[error]>Invalid player!"
    - stop
- narrate "<&[base]>You chose <&[emphasis]><[target].name><&[base]>!"