Arena-Objects.yaml

### IMPORTANT! ###
# This YAML file contains every object in the arena that is spawnable. 
# Each object has it's own properties such as name, position, rotation, size, and color, as well as their default values.
# You can use this file to see how to define each and every object in the arena. 
# Simply copy the object you want to use and paste it into your own YAML file, either changing the default values or leaving them as they are.

!ArenaConfig
arenas:
  0: !Arena
    #pass_mark: 0 # This syntax is only supported for AAI builds less than or equal to v4.0.0. If you are using newer versions, please use the 'passMark' syntax.
    passMark: 0 # The pass mark for the arena. The agent must achieve this score to pass the arena.
    #t: 250 # This syntax is only supported for AAI builds less than or equal to v4.0.0. If you are using newer versions, please use the 'timeLimit' syntax.
    timeLimit: 250 # The time limit for the arena in seconds. In other words, the time limit for the agent to complete the task (the arena resets after this time).
    items:  # This line indicates the start of the items list
    - !Item 
      name: Agent # Note that the agent will always be spawned first regardless of its position in the configuration.
      positions:
      - !Vector3 {x: 2, y: 1, z: 2}   # The position of the item. This is a Vector3 object with x, y, and z coordinates. Leave values for random spawning.
      rotations: [0] # The rotations of the items. It can be in any angle but default is 0 degrees.

# IMMOVABLE OBJECTS (Note: RAMP is 'Immovable' but has a special tag of "ramp" for the agent to detect).

    - !Item
      name: CylinderTunnel
      positions:
      - !Vector3 {x: 37, y: 2, z: 37}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}
      colors:
      - !RGB {r: 255, g: 0, b: 255}

    - !Item
      name: CylinderTunnelTransparent
      positions:
      - !Vector3 {x: 27, y: 17, z: 36}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}
      colors:
      - !RGB {r: 255, g: 0, b: 255}

    - !Item
      name: Ramp
      positions:
      - !Vector3 {x: 8, y: 20, z: 39}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}
      colors:
      - !RGB {r: 255, g: 0, b: 255}
      
    - !Item
      name: Wall
      positions:
      - !Vector3 {x: 19, y: 23, z: 2}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}
      colors:
      - !RGB {r: 255, g: 0, b: 255}

    - !Item
      name: WallTransparent
      positions:
      - !Vector3 {x: 16, y: 12, z: 24}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}
      colors:
      - !RGB {r: 255, g: 0, b: 255}

# MOVABLE OBJECTS 

    - !Item
      name: HeavyBlock
      positions:
      - !Vector3 {x: 18, y: 34, z: 23}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: LightBlock
      positions:
      - !Vector3 {x: 34, y: 25, z: 10}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: JBlock
      positions:
      - !Vector3 {x: 22, y: 31, z: 22}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: LBlock
      positions:
      - !Vector3 {x: 29, y: 7, z: 32}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: UBlock
      positions:
      - !Vector3 {x: 22, y: 33, z: 34}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: HollowBox
      positions:
      - !Vector3 {x: 10, y: 0, z: 10}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

# SIGNBOARD

    - !Item
      name: SignBoard
      positions:
      - !Vector3 {x: 39, y: 18, z: 27}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}
      symbolNames:
      - default # this is the default symbol that will be displayed if not changed in this parameter (blank signboard).
      # The list of symbols that can be used are: "transparent", "right-arrow", "left-arrow", "up-arrow", "down-arrow",
      # ..."u-turn-arrow", "letter-a", "letter-b", "letter-c", "square", "triangle", "circle", "star", "tick", "cross".

# VALANCED REWARDS SPAWNERS/DISPENSERS

### ATTENTION! READ BEFORE USE! ###
# A special note on the SpawnerButton: The SpawnerButton is defined uniquely in the arena with the major difference being that each SpawnerButton can be used to define a single instance of the object.
# For example, for other objects you can define multiple instances of the object by simply adding more positions, rotations, sizes, etc. However, for the SpawnerButton, you can only define one instance of the object. 
# Therefore, if you want to have multiple SpawnerButtons in the arena, you will need to define each SpawnerButton separately.
    - !Item
      name: SpawnerButton # Interactive button that spawns rewards when pressed by the agent.
      positions:
      - !Vector3 {x: 32, y: 31, z: 30}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}
      moveDurations: [0.1] # the time it takes for the button to move forwards. This impacts the time the button can be pressed again.
      resetDurations: [1.0] # the time it takes for the button to move backwards. This impacts the time the button can be pressed again.
      rewardNames: ["GoodGoal", "BadGoal", "GoodGoalMulti"] # the list of rewards that can be spawned. The names must match the names of the rewards.
      rewardWeights: [100, 0, 0] # the weights of each reward in the rewards list respectively. The sum of all weights must be 100.
      spawnProbability: 1.0 # the probability of spawning the reward. 1.0 means 100% chance of spawning. 0.0 means 0% chance of spawning ANY reward.
      maxRewardCounts: [-1, -1, -1] # the maximum number of times each reward can be spawned. -1 means no limit respectively for each reward.
      rewardSpawnPos: !Vector3 {x: 25, y: 0, z: 23} # the position where the reward will be spawned upon pressing the button.

    - !Item
      name: SpawnerDispenserTall
      positions:
      - !Vector3 {x: 10, y: 39, z: 38}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}
      colors:
      - !RGB {r: 255, g: 0, b: 255}
      initialValues: [2.5]
      finalValues: [0.5]
      timesBetweenSpawns: [0.0]
      doorDelays: [0.0]
      spawnCounts: [10]

    - !Item
      name: SpawnerContainerShort
      positions:
      - !Vector3 {x: 16, y: 28, z: 30}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}
      colors:
      - !RGB {r: 255, g: 0, b: 255}
      initialValues: [2.5]
      finalValues: [0.5]
      timesBetweenSpawns: [0.5]
      doorDelays: [1.0]
      spawnCounts: [1]

    - !Item
      name: SpawnerTree
      positions:
      - !Vector3 {x: 1, y: 15, z: 2}
      rotations: [0]
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}
      initialValues: [2.5]
      finalValues: [0.5]
      ripenTimes: [4.0]
      timesBetweenSpawns: [0.5]
      spawnCounts: [10]

# REWARDS

    - !Item
      name: GoodGoal
      positions:
      - !Vector3 {x: 35, y: 15, z: 9}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: GoodGoalBounce
      positions:
      - !Vector3 {x: 7, y: 0, z: 5}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: BadGoal
      positions:
      - !Vector3 {x: 25, y: 39, z: 8}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: BadGoalBounce
      positions:
      - !Vector3 {x: 20, y: 37, z: 14}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: GoodGoalMulti
      positions:
      - !Vector3 {x: 12, y: 22, z: 33}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: GoodGoalMultiBounce
      positions:
      - !Vector3 {x: 4, y: 22, z: 13}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: BadGoalMulti
      positions:
      - !Vector3 {x: 12, y: 40, z: 5}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: BadGoalMultiBounce
      positions:
      - !Vector3 {x: 16, y: 5, z: 31}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: RipenGoal
      positions:
      - !Vector3 {x: 38, y: 25, z: 11}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: DecoyGoal
      positions:
      - !Vector3 {x: 4, y: 14, z: 23}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}
  
    - !Item
      name: DecoyGoalBounce
      positions:
      - !Vector3 {x: 4, y: 14, z: 23}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: DecayGoal
      positions:
      - !Vector3 {x: 5, y: 16, z: 29}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}
      initialValues: [1]
      finalValues: [1.5]
      delays: [300]
      changeRates: [-0.007]

    - !Item
      name: DecayGoalBounce
      positions:
      - !Vector3 {x: 6, y: 22, z: 40}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}
      initialValues: [1]
      finalValues: [1.5]
      delays: [300]
      changeRates: [-0.007]

    - !Item
      name: GrowGoal
      positions: 
      - !Vector3 {x: 3, y: 20, z: 38}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}
      initialValues: [1] # the initial size of the object.
      finalValues: [3.5] # the final size of the object.
      delays: [100] # any delay in seconds before the object starts to grow.
      changeRates: [0.01] # the rate at which the object grows.

    - !Item
      name: ShrinkGoal
      positions:
      - !Vector3 {x: 9, y: 26, z: 16}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}
      initialValues: [2.5] # the initial size of the object.
      finalValues: [1.5] # the final size of the object (after shrinking).
      delays: [400] # any delay in seconds before the object starts to shrink.
      changeRates: [-0.2] # the rate at which the object shrinks.

# ZONES

    - !Item
      name: HotZone
      positions:
      - !Vector3 {x: 1, y: 18, z: 36}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}

    - !Item
      name: DeathZone
      positions:
      - !Vector3 {x: 14, y: 34, z: 18}
      sizes:
      - !Vector3 {x: 1, y: 1, z: 1}