Animalai

Added
- **New Game Objects**:
- **Movable: `HollowBox`** A hollow box that agents can move within the arena, enabling the creation of more complex environments and challenges. It also supports spawning rewards inside or just above the box, offering diverse use cases.
- **Movable: `BadGoalMulti`** An experimental valenced goal that can be used to penalize the agent for collecting it (similar to BadGoal). The current reward value is set to `-0.003` and is non-configurable.
- **Ability to Customise Colors**: Users can now customize the colors of the following game objects in the YAML configuration file (via the `colors` parameter):
- Movable
- LightBlock
- HeavyBlock
- JBlock
- LBlock
- Unlock
- HollowBox
- Rewards
- BadGoal
- BadGoalMulti
- BadGoalBounce
- GoodGoal
- GoodGoalMulti
- GoodGoalBounce
- DecoyGoal
- DecoyGoalMulti
- DecoyGoalBounce
- ShrinkGoal
- GrowGoal
- Spawners/Dispensers
- SpawnerContainerShort
- SpawnerDispenserTall

Changed
- **Visual:**
- **`LightBlock` & `HeavyBlock`** New textures are applied to these objects. The new unique stone wall textures allow for these two objects to be distinguished more easily, and adds a visual flair to the environment.

Fixed
- Resolved a bug where the materials of all objects were dimmed. This was due to a shader issue that has been fixed. The materials now appear as intended (brighter and more visible).
- Resolved `HollowBox` issue not spawning in the arena. The issue was due to the HollowBox prefab not being added to the list of acceptable objects that can be spawned in the Unity scene. This has been rectified, and the HollowBox now spawns correctly in the arena.
- Fixed a bug where `SignBoard` game object would not rotate when specified in the YAML configuration file. The issue was due to the SignBoard prefab not having a rotation range specified (between 0 and 360). This has been fixed, and the SignBoard now rotates as intended.
- Minor performance improvements and bug fixes.

Notes
_This version introduces a breaking change for YAML configuration files. The syntax for defining arenas has been updated to be more user-friendly and intuitive but is not backward compatible with `v4.0.0`. Please refer to the documentation for more information._

Added
- **New Game Objects**:
- **Movable: `DecoyGoal` and `DecoyGoalBounce`** These objects can be used similarly to `GoodGoal or BadGoal` except that they have no effect on the agent's reward (no reward values).
- **Movable: `DataZone`** The primary use case for this new game object is for data collection upon being entered by the agent or player.
- **New UI Element: `AAI Build Version`**: Displays the Animal-AI Build Version in the bottom-right corner of the UI for quick reference.
- **New Feature**: `LogDataToCSV` an automatic data logging system that activates during both play and train modes. This system meticulously logs data about the environment, as well as the agent’s observations and actions, into a well-organized CSV file located in the root folder of AAI, specifically under `ObservationLogs`.

Changed
- **YAML Syntax Changes**:
- `"t"` parameter renamed to `"timeLimit"` for clarity.
- `"pass_mark"` parameter renamed to `"passMark"` for consistency.
- **UI Text Elements**: UI elements now use the same font and style for coherency.

Fixed
- Resolved agent getting stuck near the SpawnerButton.
- Corrected incorrect Unity game object tags.
- Prevented crashes from game objects positioned at (0,y,0) or (40,y,40) in YAML. Temporary fix applied; permanent solution in progress.
- Fixed incorrect collision settings for movable objects.
- Adjusted low mass settings for movable objects.

---

Notes
- _This release is a major update that moves away from the experimental phase and introduces a stable version of the Animal-AI environment._
- _This release is also backward incompatible with the previous versions (i.e. `v3.1.4.exp`), and agents trained on the previous version may not work with this new version._

Added
- **New Valanced Game Objects:** `DecayGoal` and `DecayGoalBounce`.
- **New Feature: `mergeArenasEpisodes`**. Allows users to merge multiple arenas into one, enabling more complex environments. Merged arenas will be in the same scene, allowing seamless agent movement between them. See the documentation for an example YAML configuration file.

Changed
- Updated to TMPro package for text rendering in Unity, for better performance and flexibility.
- Changed the layout of the UI to be more user-friendly and intuitive.
- Changed UI text colours to be more accessible and readable.

Fixed
- Fixed object tag being incorrectly set for game object `RAMP` (from `IMMOVABLE` to `RAMP`).

---

[3.1.4.exp] - 2023-12-22
Added
- More Unit Tests for Unity codebase.

Fixed
- Fixed a bug where randomizeArenas was not cycling through all available arenas if set to true.
- Added measures to make sure if the randomizeArenas feature is set to true, the same arena is not selected twice in a row.

Changed
- Minor improvements to the UI layout and design.

---

Added
- Arena randomization via `randomizeArenas` feature.
- More robust error-checking for arena ID's and cycling.
- Visual elements for reinforcing cues (colors, short GIFs).

Changed
- Shortened end-of-episode notification durations to 2.5 seconds.
- Updated visual cues like colors and short GIFs for reinforcement for feature end-of-episode notifications (more user-friendly).
- Minor Unity script optimizations (Animal-AI runs smoother now with more FPS on average).

Fixed
- Resolved rare SpawnerTree Clock desync issue.
- Fixed Multiple Arenas cycling issue (via enhanced error-checking).
- Rectified the invisibility of the SignBoard prefab (now visible and functional).

---

[3.1.2.exp] - 2023-09-11

Added
- "Camera and Reset Buttons" feature.

Changed
- Updated End-of-Episode Notification to be more user-friendly and fun.
- Increased next episode spawn (if end-of-episode notifcation is set to true) delay before next episode from 2 to 5 seconds.
- Improved SpawnerButton game object logic for better handling of missing values.

Fixed
- Hotfix for a bug affecting the SpawnerTree (where the SpawnerTree game object would have inconsistent behavior).
- Fixed bug with multiple GIFs playing when health is 0 (if end-of-episode notification is set to true).

---

Added
- "End of Episode Notification" feature.
- "SpawnerButton" feature
- Added additional "Interactive Button" feature parameters for customization.

Fixed
- Bug (minor) affecting the SpawnerTree.
- Bug (minor) affecting the SpawnerButton parameters.

---

Added
- Unit tests on Unity csharp scripts.

Changed
- Upgraded MLagents to 2.3.0-exp3 (MLagents python version 0.30.0).
- Upgraded Unity Engine Editor to 2021.3.21f1.
- Updated `README.md` with more added information.

Fixed
- Fixed bug where objects had dark shadows during arena initialisation.


--- Legacy Versions: ---