Sound The Alarm
Bannerlord Alert System
Sound The Alarm aims to bring the important information to the player by displaying a popup automatically if one of their fiefs are under attack (either directly owned by the player, or if the player is the leader of the kingdom whose fiefs are under attack) and when a war/peace declaration is signed, either by the AI, or by the faction that the player is currently in.

Helpful for those who might miss the small banner that appears when one of the fiefs are raided/under siege, or the message that appears as text in the bottom left when war/peace is declared.

By default, when the popup appears the game is paused automatically. This functionality however can be toggled on/off via the config file, or by using ModLib or Mod Configuration Menu v4 (depending on the version).

As of Version 1.0.6, Sound The Alarm now contains a version that fully integrates ModLib for easily changing mod values in-game. 

As of Version 1.5.1a, the ModLib integration is replaced with Mod Configuration Menu v4 as a dependency to reduce issues with Mod updates breaking the mod/game.

If you enjoy the mod, leaving a comment or endorsement is the best way to show your support.

How to use
At any time, if one of your fiefs are attacked either under siege or being raided, an alert will show up informing you that this is the case and you can respond either by closing the window, or by selecting the 'Track' option to track where that fief is located. Likewise, whenever a war is declared or when peace is signed between empires.

Installation
Install via Vortex mod manager or by dragging and dropping the SoundTheAlarm folder into the Mount & Blade II Bannerlord/Modules folder.

For those using the ModLib Integrated version, you will need to have ModLib installed and loaded before Sound The Alarm.

For those using the Mod Configuration Menu v4 dependent versions, you will need to have MCMv4 and it's dependencies (Harmony, ButterLib, and UIExtender) installed and loaded before Sound the Alarm. ModLib is no longer required for this version.

Translations
For those wishing to create translations for this mod, you are free to do so, however you must list Sound The Alarm as a requirement and the files you wish to upload to nexus must only be the sta_strings.xml file located in the SoundTheAlarm\ModuleData folder.
Thus your folder structure should look like the following:
 - Modules
- SoundTheAlarm
- ModuleData
                        - Languages
                                - <your_language_code> (for example: "DE", "PL", "TR")
                - sta_strings.xml

Compatibility
If you are experiencing crashes on startup, please read and act on all the information below. If the problem still persists, please let me know by leaving a post with as much information as possible.



Credits
Huge thanks to the following supporters:

• iPherian for their huge support to the code base of the mod.
• daedalus1pl for their implementation of localisation and translation functionality of the mod. Also for creating the Polish translation.
• SweazyZ for creating the Russian translation.

And to all the kind people who donated and endorsed the mod.

Features to implement

• Instead of the popup immediately displaying, change to the less intrusive notifications on the right hand side, similar to the election vote notification, and when clicked, display the original popup (thanks to konstrukter for the suggestion).
• Replace the "Sound The Alarm" title for the popup with a relevant title such as "Declaration of War".
• Leader name for declaration of peace and war changed to the actual instigator of that declaration (currently just says the leader of the faction which declared war/peace).
• Alert for if/when an army in your kingdom is attacked.
• Integration with ModLib.
• Notification for declaration of war (both for AI vs AI, and for AI vs faction containing the player).

See the Trello Board for updates and future features.

Changelog

e1.5.1a

• Updated for Beta 1.5.1 and converted to MCMv4 (with Harmony, ButterLib, and UIExtender as additional dependencies).

e1.4.1

• Updated to game version Beta 1.4.1.

v1.0.9

• Updated to game version 1.4.0.
• Incorporated ModLib v1.4 changes. ModLib Integration now works with Sound The Alarm.
• Fixed a bug with EnableMinorFactionPopup option set to false would not show popups for declarations of war or peace regardless of faction status.

v1.0.8

• Updated to game version 1.3.0.
• Incorporated ModLib v1.3.4 changes. ModLib Integration now works with Sound The Alarm.

v1.0.7

• Fixed a bug that would show town and castle sieges as "The castle of ATTACKER_NAME is under siege by ATTACKER_NAME of the ATTACKER_FACTION."
• Fixed the bug relating to EnableMinorFactionPopup not working which was causing issues for players using the Custom Spawns mod. Functionality of EnableMinorFactionPopup was not included in the ModLib Integrated version accidentally. This issue is now resolved.

v1.0.6

• Added localisation functionality (courtesy of daedalus1pl). The editable strings can be found in SoundTheAlarm\ModuleData\Languages\sta_strings.xml.
• Added another version of Sound The Alarm with full integration with ModLib. The standalone version can still be downloaded for those who do not with to use ModLib. This version is the main file to download as it offers the most seamless experience for users.
• Added EnableMinorFactionPopup tag to config XML file to turn on/off popups for minor factions declaring war/peace (default is true).

v1.0.5

• Fixed a bug where an alert for attacks would incorrectly not be sent. (Thanks to iPherian again for submitting their pull request on GitHub with the fix: https://github.com/AlpineSoftworks/bannerlord-mods/pull/4)

v1.0.4

• Added EnableVillagePopup tag to config XML file to turn on/off popups for villages (default is true).
• Added EnableCastlePopup tag to config XML file to turn on/off popups for castles (default is true).
• Added EnableTownPopup tag to config XML file to turn on/off popups for towns (default is true).
• Added PauseGameOnPopup tag to config XML file to pause the game when a popup displays (default is true).
• Added TimeToRemoveVillageFromList tag to config XML file, this is the time in in-game hours before a village is removed from the list (helps alleviate popup spam for villages, the AI tends to raid, leave and raid again multiple times which results in popup spam. Default is 10.0).
• "Sound The Alarm" title for popups have been replaced with relevant titles such as "Declaration of War".

v1.0.3

• Added a popup notification for declaration of wars and peace.
• Added a config XML file for turning on/off the different popups. Can also turn on debug messages to debug and troubleshoot.
• Reorganised the code base. See Source Code section for more details.

v1.0.2

• Fixed alert not showing if you are not the king and your fief is attacked. (Many thanks to iPherian for submitting their pull request on GitHub with the fix: https://github.com/AlpineSoftworks/bannerlord-mods/pull/2)

v1.0.1

• Updated the method used for checking if a settlement is being raided/sieged. Previously updated via ApplicationTick method which caused a lot of crashes for people, now using OnGameLoaded to initialise event listeners that fire only when the settlement is being raided/sieged. If this method does not work and people continue having issues, I have also made a HarmonyLib version that currently works, however this is there as a last resort.

v1.0.0

•  Added to nexus.

Source code
The source code for the mod can be found on my GitHub here:

• ModLib Integrated Version: https://github.com/AlpineSoftworks/bannerlord-mods/tree/master/SoundTheAlarm_ModLibIntegration
• Standalone Version: https://github.com/AlpineSoftworks/bannerlord-mods/tree/master/SoundTheAlarm_Standalone