The following update breaks comparability between the Community Library and dependent mods that add delegates to the Community Library's Pathfinding system. These mods will need to update to account for the changes to these system.

This update introduces two new mod options that you will wish to set as desired. these are:
- Auto-Relaunch on Mod List Change (default false): If set to true, the Community Library will automatically close the game whenever the mod list is changed, and relaunch it using an external batch file that is included in the mod's root folder. It will appear as a console window opening briefly while the game closes and relaunches.
- - Batch Files can pose a security risk to your system if they were written with malicious intent. If you are not comfortable with this feature, and do not know how to read the batch file yourself, leave it turned off.
- Realistic Trade Routes (default false): If set to true, an alternative set of weights will be used when creating trade routes. These alternate paths prioritise cities and sea trade, while avoiding areas of low- habitability.

The bulk of this update is a vast collection of updates, improvements and fixes for the both the Community Library itself, and for the Vanilla game's code.
Community Library Updates:
- (DLC) Enhanced Trade Route Links now correctly transition to transparency when crossing map layers.
- (DLC) Fixed `NullReferneceException` in the Community Library's pathfinding system that could occur under very rare circumstances.
- (DLC) Completely restructured the code that manages diplomatic national actions between the surface and underground map layers while awareness of the underground is below 100%.
- - All social Groups are valid for diplomatic actions if they share a map layer with the society or orc social group that is populating their diplomatic actions.
- - The Dark Empire and Ophanim's Theocracies, can always see across map layers.
- - Greatly improved performance.
- (Base Game & DLC) A new mod option allows you to opt in to having the game auto-relaunch when the mod list is changed.
- - The default for this mod option is "false", as it makes use of an external batch file that is packaged with the mod.
- (Base Game & DLC) Introduced "Realistic Trade Routes" mod option that uses a different, and hopefully more realistic, set of weights for calculating trade routes.
- - The defailt for this mod option is `false`.
- (Base Game & DLC) Fixed function of rand store with `ChallengeData` and `TaskData` object types. This should prevent utilities changing every time you look, and improve performance.
- (Base Game & DLC) Reduced utility for orc upstarts to use the cease war ritual. This should reduce the likelihood of orcs starting and then immediately stopping a war.
- (Base Game & DLC) Completely replaced pathfinding system with A* pathfinding algorithm that interacts with mod hooks and delegates.
- (Base Game & DLC) Completely replaced trade route generation system with new A* pathfinding algorithm that interacts with mod hooks and delegates.

Vanilla Game Updates:
- (DLC) Links that transition map layers now fade out correctly when a map mode dims links.
- (DLC) If awareness of the underground is below 100%, the Fund Outpost local action will only be usable on another map layer if the funder is the Dark Empire, is an Ophanim Theocracy, or if the funder's social group has territory adjacent to the target outpost and on its map layer.
- (DLC) Prevent trade routes from running through the Underground from the surface, and vice-versa, while awareness of the underground is less than 100%.
- (DLC) Dwarven capitols now have trade routes between them if possible.
- (DLC) Mammon's tomb now always has a trade route to both the surface and the underground at the start of the game.
- (DLC) Ophanim's Smite now works on all map layers, only effecting hexes on the same map layer as the target location.
- (DLC) The following are all fixes to powers of The Evil Beneath.
- - Bring the Food now cannot target an agent in a location that has no death.
- - Defend the Heart now cannot target tentacle segment armies that don't have a valid military target at their location.
- - Drag Bodies Under now correctly finds the nearest tentacle segment when cast.
- - Sinkholes is now only valid on a location that is at most two steps from an army that does not belong to The Dark, and is not in combat.
- - Sinkholes no longer effects armies that belong to The Dark, as stated in its description.
- - Vile Secretions now cannot target the underground, as stated in its restriction text.
- - Withdraw Agent is now valid for all map layers that are not the underground. This change better supports modded map layers.
- (DLC) The Monarch can now also be recruited in Dwarven capital cities, if they are fully enshadowed.
- (DLC) Restriction Text and challenge validity for building orc mines now properly accounts for adjacency of specialised camps.
- (Base Game & DLC) Restriction Text and challenge validity for building an orc menagerie now properly accounts for adjacency of specialised camps.
- (Base Game & DLC) The Repeat button now shows up when completing a challenge that can be, and is, claimed by multiple claimants.
- (Base Game & DLC) Added Event conditions for the remaining gods; `is_god_deathgame` for the Death's Games, `is_god_maker` for The Broken Maker, `is_god_cordyceps` for Cordyceps, and `is_god_evilbeneath` for The Evil Beneath.
- - The `is_god_evilbeneath` condition is also compatible with the base game, and will simply always return false. Thus there is no need to have two versions of the event, provided the event's contents do not reference any DLC unique graphics or features.
- (Base Game & DLC) Cordyceps' Infested Drone power now selects the newly created drone when cast. This fixes a bug where you could cast it repeatedly if you didn't select a different target in between casts.
- (Base Game & DLC) The "Raiding Party" ritual now only selects the raiders upon completion if the Warlord was the selected unit.
- (Base Game & DLC) The "Death of the Sun" geomancy ritual now properly accounts for progress accelerators when determining the effect to apply each turn.
- (Base Game & DLC) When an army razes a location with a ruler, the ruler will now be added to that army's commander's kill count.
- (Base Game & DLC) Fixed Null Reference Exception that arises when using the dismiss hotkey on popup messages that are already scheduled for removal.
- (Base Game & DLC) Fixed Null Reference Exception that could arise when an AI attempts to get the complexity of the Infiltrate challenge.

Version 2.1.04 (Vanilla Fixes Pt2):
Work has continued on fixes for issues in the code of the base game and DLC. This update contains a smaller number of more challenging fixes:
- (Base Game & DLC) Added The Whisperer agent to vampireTypes collection.
- (Base Game & DLC) Fixed Orc Hordebanner Attack challenge being usable even when the hordebanner's associated orcs have been wiped out.
- (Base Game & DLC) Fixed "Enshadowed Population outside of Dark Empire" victory score counting those inside the Dark Empire. This will make the game noticeably harder when aiming for Dark Empire wins.
- (Base Game & DLC) Fixed Null reference exception when searching houses in the House map mode.
- (DLC) Fixed a typo in the Xerxes event chain that prevented the image from being loaded.

As always, I will continue working on these, in no particular order, as I have time. Expect a Part 3 some time in the future.

Version 2.1.03 (End Turn Battle Fix):
- (Base Game & DLC) Implemented tweak to end turn button code that allows custom agent battles to be created when the player ends turn while a battle is pending.

Version 2.1.02 (onUIScroll_Unit_populateUM Fix):
- (Base Game & DLC) Fixed error that was preventing `onUIScroll_Unit_populateUM` hook from operating correctly.

Version 2.1.01 (Hotfix):
- Fixed error that was preventing the Community Library from Loading correctly.

This update changes the signature of several hooks in the Base Game branch of the Community Library (for game version 1.1). These changes will require dependent mods that are using these hooks to update to maintain comparability:

The changes and steps required are as follows:
- Any dependent mod that makes use of the Community Library's AgentAI in the base game will need to be recompiled. The data structs associated with the AI are now classes.
- The following hooks for the Community Library's pathfinding solution have been changed. Any mod that makes use of these hooks will need to change their overrides to account for these changes:

This update also brings out the first batch of fixes and feature improvements for the vanilla experience, across both the Base Game and the DLC. The following fixes have been implemented. Expect more in future.
- (Base Game) Renames `Human Soul ` to `Soul` in properties map mode to match DLC.
- (Base Game & DLC) When a Warlord that is a Prophet of a religion forms an orcish raiding party, the religion no longer believes they are dead.
- (DLC) Make agents prefer their current layer when retreating from combat.
- (DLC) Prevent Diplomatic actions (war, improve relations, worsen relations) between factions on the surface and underground if awareness is below 100%.
- (DLC) Prevent Diplomatic actions (war) between Orcs and another faction when one is on the surface and the other underground, and the orcs do not yet have access to the underground (have not ever had a mine).
- (DLC) Opportunistic Encroachment now cannot effect Dwarven cities, and considers if orcs have knowledge of the underground before operating across links connecting the surface and underground.
- (Ixthus (Base Game)) Eternal Cities will no longer cause a crash when a shipwreck expires in that location.
- (Covens, Curses, and Curios (Base Game)) Cursed Boots will now also check for pending agent battles where the player agent is the attacker in the battle.

Finally, this update includes a new series of hooks for creating and managing custom agent battles. these are considered experimental and have not yet been documented.
A showcase/example mod will be coming out soon as part of Shadows of Forbidden Gods' first community ModJam, which has been running in the official discord server for the past two weeks.
All those playing or interested in the game are always welcome to join: https://discord.gg/zZ53wttn

Version 2.0.05 (Hotfix):
This update effects the basse game and dlc.
- Fixed missing handling for escort being dead in `Task_AttackUnitWithCustomEscort`.

Version 2.0.04 (Hotfix):
This update only effects the dlc.
- Holy Orders no longer gain double influence.

Version 2.0.03 (Hotfix):
This update effects both the base game and the dlc.
- Fixed null error in `Task_ReturnToTheDeep.getLong()` when target is null.

Version 2.0.02 (Hotfix):
This update effects both the base game and the dlc.
- Fixed null exception error in `getTravelTime` to that occurs when no valid path is found.