From 142568b079e0ddb420e4f92fea593131f8638fbe Mon Sep 17 00:00:00 2001
From: Flugente <Flugente@4f8fa57e-7814-0410-bad4-adc449f26b7c>
Date: Sun, 15 Apr 2018 14:34:33 +0000
Subject: [PATCH] New feature: bloodcat/zombie/bandit raids on
 player-controlled sectors

For more info, see http://thepit.ja-galaxy-forum.com/index.php?t=msg&th=23711&goto=353154&#msg_353154

git-svn-id: https://ja2svn.mooo.com/source/ja2_v1.13_data@2420 4f8fa57e-7814-0410-bad4-adc449f26b7c
---
 gamedir/Data-1.13/Ja2_Options.INI             |  45 +++++++++++
 .../Data-1.13/TableData/Map/SectorNames.xml   |  74 ++++++++++++++++++
 gamedir/Data/Interface/SMFACES.STI            | Bin 0 -> 27303 bytes
 3 files changed, 119 insertions(+)
 create mode 100644 gamedir/Data/Interface/SMFACES.STI

diff --git a/gamedir/Data-1.13/Ja2_Options.INI b/gamedir/Data-1.13/Ja2_Options.INI
index fc240bf51..c7cee1852 100644
--- a/gamedir/Data-1.13/Ja2_Options.INI
+++ b/gamedir/Data-1.13/Ja2_Options.INI
@@ -3864,6 +3864,51 @@ ENEMYHELI_MANPADS_DAMAGE_VAR			= 80
 ;******************************************************************************************************************************
 ;******************************************************************************************************************************
 
+[Raid Settings]
+
+;******************************************************************************************************************************
+; These settings control whether randomized raids occur in player-controlled sectors
+;******************************************************************************************************************************
+
+;------------------------------------------------------------------------------------------------------------------------------
+; If the player doesn't defend his city sectors/SAM sites enough, opportunistic forces can attack them at night.
+; These attacks occur if these sectors have only very few mercenaries or militia present.
+; Raids can be done by 
+; - bloodcats
+; - zombies (requires zombie feature to be active)
+; - bandits
+; These forces will attack anyone in a sector and can also fight in autoresolve. If your forces are defeated, this will result
+; in a severe morale loss.
+; 
+; Whether a raid can happen in a sector at all is set in TableData\Maps\SectorNames.xml with the 
+; <bloodcatraidpossible>/<zombieraidpossible>/<banditraidpossible>-tags.
+; 
+; NOTE: THIS WILL MAKE THE GAME HARDER!!!
+;------------------------------------------------------------------------------------------------------------------------------
+; set to TRUE to enable raids
+RAID_BLOODCATS = FALSE
+RAID_ZOMBIES = FALSE
+RAID_BANDITS = FALSE
+
+; base value determining how fast the forces are replenished daily. Higher means more forces.
+; Values from 1 to 100, default 3.
+RAID_REPLENISH_BASEVALUE = 3
+
+; how many troops are allowed in a raid at maximum?
+; If the size of a bloodcat or bandit raid is lower than the defensive force' size, they will not attack.
+; Zombies have no such inclination and will attack regardless.
+RAID_MAXSIZE_BLOODCATS = 8
+RAID_MAXSIZE_ZOMBIES = 12
+RAID_MAXSIZE_BANDITS = 6
+
+; How many attacks can happen potentially in a single night? Note that if player forces are strong enough, no attack will occur.
+RAID_MAXATTACKSPERNIGHT_BLOODCATS = 3
+RAID_MAXATTACKSPERNIGHT_ZOMBIES = 3
+RAID_MAXATTACKSPERNIGHT_BANDITS = 3
+
+;******************************************************************************************************************************
+;******************************************************************************************************************************
+
 [Militia Training Settings]
 
 ;******************************************************************************************************************************
diff --git a/gamedir/Data-1.13/TableData/Map/SectorNames.xml b/gamedir/Data-1.13/TableData/Map/SectorNames.xml
index 9994a79ba..42e811968 100644
--- a/gamedir/Data-1.13/TableData/Map/SectorNames.xml
+++ b/gamedir/Data-1.13/TableData/Map/SectorNames.xml
@@ -54,6 +54,11 @@
 	
 	<maxworkers>
 	Maximum number of workers that can be employed in this sector.
+	
+	<bloodcatraidpossible>0</bloodcatraidpossible>
+	<zombieraidpossible>0</zombieraidpossible>
+	<banditraidpossible>0</banditraidpossible>
+	Bloodcats/zombies/bandits can attack this sector.
 -->
 <SECTOR_NAMES>
   <SECTOR>
@@ -70,6 +75,9 @@
 	<snowchance>0</snowchance>
 	<snakechance>0</snakechance>
 	<numsnakes>0</numsnakes>
+	<bloodcatraidpossible>0</bloodcatraidpossible>
+	<zombieraidpossible>0</zombieraidpossible>
+	<banditraidpossible>0</banditraidpossible>
   </SECTOR>
   <SECTOR>
     <SectorGrid>A2</SectorGrid>
@@ -82,6 +90,9 @@
     <usCivilianPopulation>70</usCivilianPopulation>
 	<rainchance>70</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
   <SECTOR>
     <SectorGrid>A3</SectorGrid>
@@ -268,6 +279,9 @@
 	<rainchance>70</rainchance>
 	<sandstormchance>0</sandstormchance>
 	<maxworkers>50</maxworkers>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
   <SECTOR>
     <SectorGrid>B3</SectorGrid>
@@ -395,6 +409,9 @@
     <usCivilianPopulation>50</usCivilianPopulation>
 	<rainchance>50</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
   <SECTOR>
     <SectorGrid>B14</SectorGrid>
@@ -577,6 +594,9 @@
     <usCivilianPopulation>200</usCivilianPopulation>
  	<rainchance>50</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>C14</SectorGrid>
@@ -638,6 +658,9 @@
     <sRadioScanModifier>2</sRadioScanModifier>
  	<rainchance>70</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>D3</SectorGrid>
@@ -768,6 +791,9 @@
  	<rainchance>50</rainchance>
 	<sandstormchance>0</sandstormchance>
 	<maxworkers>100</maxworkers>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>D14</SectorGrid>
@@ -792,6 +818,9 @@
     <sRadioScanModifier>2</sRadioScanModifier>
  	<rainchance>50</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>  
    <SECTOR>
     <SectorGrid>D16</SectorGrid>
@@ -1078,6 +1107,9 @@
     <usCivilianPopulation>200</usCivilianPopulation>
  	<rainchance>45</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>F9</SectorGrid>
@@ -1090,6 +1122,9 @@
     <usCivilianPopulation>100</usCivilianPopulation>
  	<rainchance>40</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>0</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>F10</SectorGrid>
@@ -1263,6 +1298,9 @@
     <usCivilianPopulation>200</usCivilianPopulation>
  	<rainchance>40</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>G9</SectorGrid>
@@ -1279,6 +1317,9 @@
     <usCivilianPopulation>200</usCivilianPopulation>
  	<rainchance>40</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>G10</SectorGrid>
@@ -1395,6 +1436,9 @@
  	<rainchance>50</rainchance>
 	<sandstormchance>0</sandstormchance>
 	<maxworkers>200</maxworkers>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>H4</SectorGrid>
@@ -1455,6 +1499,9 @@
  	<rainchance>35</rainchance>
 	<sandstormchance>2</sandstormchance>
 	<maxworkers>160</maxworkers>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>H9</SectorGrid>
@@ -1513,6 +1560,9 @@
     <usCivilianPopulation>200</usCivilianPopulation>
  	<rainchance>40</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>0</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>H14</SectorGrid>
@@ -1526,6 +1576,9 @@
     <usCivilianPopulation>100</usCivilianPopulation>
  	<rainchance>45</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>H15</SectorGrid>
@@ -1641,6 +1694,9 @@
     <sRadioScanModifier>2</sRadioScanModifier>
  	<rainchance>5</rainchance>
 	<sandstormchance>80</sandstormchance>
+	<bloodcatraidpossible>0</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>I9</SectorGrid>
@@ -1712,6 +1768,9 @@
     <usCivilianPopulation>200</usCivilianPopulation>
  	<rainchance>40</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>0</bloodcatraidpossible>
+	<zombieraidpossible>0</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
     <SECTOR>
     <SectorGrid>I14</SectorGrid>
@@ -1725,6 +1784,9 @@
  	<rainchance>45</rainchance>
 	<sandstormchance>0</sandstormchance>
 	<maxworkers>150</maxworkers>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>I15</SectorGrid>
@@ -2257,6 +2319,9 @@
     <usCivilianPopulation>150</usCivilianPopulation>
  	<rainchance>70</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>L12</SectorGrid>
@@ -2269,6 +2334,9 @@
     <usCivilianPopulation>150</usCivilianPopulation>
  	<rainchance>70</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>1</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>L13</SectorGrid>
@@ -2536,6 +2604,9 @@
     <usCivilianPopulation>100</usCivilianPopulation>
  	<rainchance>60</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>0</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>N4</SectorGrid>
@@ -2550,6 +2621,9 @@
     <usCivilianPopulation>50</usCivilianPopulation>
  	<rainchance>60</rainchance>
 	<sandstormchance>0</sandstormchance>
+	<bloodcatraidpossible>0</bloodcatraidpossible>
+	<zombieraidpossible>1</zombieraidpossible>
+	<banditraidpossible>1</banditraidpossible>
   </SECTOR>
    <SECTOR>
     <SectorGrid>N5</SectorGrid>
diff --git a/gamedir/Data/Interface/SMFACES.STI b/gamedir/Data/Interface/SMFACES.STI
new file mode 100644
index 0000000000000000000000000000000000000000..3b7594ca58bb0dea7ada747c2e888de70f3b9f3f
GIT binary patch
literal 27303
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%0Dr+@O%!9(v{
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
DH2MJn

literal 0
HcmV?d00001