Aoe2scenarioparser

**Support for the new 50292 update!**

Added

- Support for the new `1.42` scenario file version.
- The new attribute for conditions: `object_state` (Used in `objects_in_area`)
- The new `ChangeColorMood` effect (`trigger.new_effect.change_color_mood(...)`).
- The `ColorMood` and `ObjectState` dataset.

---

**More datasets! Including some from the newest [47820] update!**

[47820]: https://www.ageofempires.com/news/aoe2de-update-47820/

Added

- The `HOTKEY_ID` property to the `UnitInfo`, `BuildingInfo`, `HeroInfo` and `TechInfo`.
Example: `UnitInfo.ARCHER.HOTKEY_ID`. Or: `UnitInfo.from_hotkey_id(...)`
- The `Hotkey` dataset. These values can be used for static key assignments.
- The `HeroStatusFlag` dataset. Use `HeroStatusFlag.combine(...)` for combinations in the dataset.
- The `BlastLevel` dataset.
- The `DamageClass` dataset. (Credits: Alian713)
- The `ProjectileInfo` dataset. Thanks **[Alian713](https://github.com/KSneijders/AoE2ScenarioParser/pull/16)**!

Fixed

- Removed `location_object_reference` from the `Change View` effect.
- Trigger docs not updated with the new `UnitInfo` dataset.
- `Unit.name()` when a unit wasn't present in the datasets. Thanks **[newtonerdai](https://github.com/KSneijders/AoE2ScenarioParser/pull/13)**!
- The ID for `FARMING_GOLD_TRICKLE` from 235 to 236.
- A typo `TechInfo.FELMISH_REVOLUTION` to `TechInfo.FLEMISH_REVOLUTION`

Changed

- Renamed ObjectAttribute `ICON_GRAPHICS_ANGLE` to `GRAPHICS_ANGLE`.
- Renamed all `area_1_x` attributes to `area_x1`. Same goes for: `area_1_y`, `area_2_x`, `area_2_y`.
- **BACKEND** - retrievers attribute on sections has been swapped out for retriever_map.
It's now a `dict` instead of a `list` with the retriever name as keys. Reason: **Improve performance**.

---

Updated

- Several speed improvements

Fixed

- Hint in exception message when it was clearly not the cause of the error.
- A typo in the condition dataset `OBJECT_IN_AREA` to `OBJECTS_IN_AREA`.
- Unit docs not updated with the new `UnitInfo` dataset - [Issue 12].

[issue 12]: https://github.com/KSneijders/AoE2ScenarioParser/issues/12

---

Added

- Functions to the `UnitInfo` and `TechInfo` dataset.
- `UnitInfo.vils()` for all villagers (Male/Female and all their professions).
- `UnitInfo.unique_units()` for all unique units (Both castle and non castle unique units).
- `TechInfo.unique_techs()` for all unique technologies.
- Error messages when accidently setting a value to `UnitInfo.ARCHER` instead of `UnitInfo.ARCHER.ID` (as an example).

Fixed

- A recursion issue with the `copy_trigger` related functions - [Issue 10]

[issue 10]: https://github.com/KSneijders/AoE2ScenarioParser/issues/10

---

Fixed

- An issue which renamed all variables to: "VariableStruct" - [Issue 9]

[issue 9]: https://github.com/KSneijders/AoE2ScenarioParser/issues/9

Changed

- The datasets `UnitInfo`, `BuildingInfo`, `HeroInfo`, `TechInfo` and `OtherInfo` replace the following datasets:
- UnitId, GaiaUnitId, UnitIcon and GaiaUnitIcon
- BuildingId, GaiaBuildingId and BuildingIcon
- HeroId, HeroIcon
- TechId
- UnitOtherId, GaiaUnitOtherId
- The `ButtonLocation` dataset has changed it's properties.
- From: `LOCATION_<C>_<R>` (`<C>` = Column number, `<R>` = Row number)
- To: `r<R>c<C>`
- Example (Row 1, col 4):
- Old: `LOCATION_3_0`. Old numbering started from 0.
- New: `r1c4`. New numbering starts from 1.

Please check the [datasets cheatsheet] page or the [readthedocs dataset] page on how to use the new datasets.

[datasets cheatsheet]: https://github.com/KSneijders/AoE2ScenarioParser/blob/master/cheatsheets/DATASETS.md
[readthedocs dataset]: https://aoe2scenarioparser.readthedocs.io/en/master/

---

Fixed

- An issue with `\x00` suffixes

---