Action scripts - AngerNodes manipulation

CREDITS.md

@@ -151,6 +151,7 @@ This page lists all the individual contributions to the project by their author.
   - Warhead activation target health thresholds enhancements
   - Event 606: AttachEffect is attaching to a Techno
   - Linked superweapons
+  - Script actions for modifying AI anger against other houses
 - **Starkku**:
   - Misc. minor bugfixes & improvements
   - AI script actions:

Phobos.vcxproj

@@ -70,6 +70,7 @@
     <ClCompile Include="src\Ext\ParticleType\Hooks.cpp" />
     <ClCompile Include="src\Ext\Scenario\Hooks.cpp" />
     <ClCompile Include="src\Ext\Scenario\Hooks.Variables.cpp" />
+    <ClCompile Include="src\Ext\Script\Body.AngerNodes.cpp" />
     <ClCompile Include="src\Ext\Sidebar\Body.cpp" />
     <ClCompile Include="src\Ext\Sidebar\Hooks.cpp" />
     <ClCompile Include="src\Ext\Surface\Body.cpp" />

docs/AI-Scripting-and-Mapping.md

@@ -382,6 +382,174 @@ In `aimd.ini`:
 x=14003,0
 ```
 
+### `14005` Override OnlyTargetHouseEnemy Value
+
+- The value of the tag `OnlyTargetHouseEnemy` in AI triggers can be modified for the new attack & move actions. Only affects the next new attack or move action script.
+- These anger values are applied only in the house owner of the team.
+- Only works for new Phobos actions, not vanilla YR or Ares actions.
+
+In `aimd.ini`:
+```ini
+[SOMESCRIPTTYPE]  ; ScriptType
+x=14005,n         ; integer n=-1
+```
+
+- The possible argument values are:
+
+| *Argument* | *Description*                                 |
+| :--------: | :-------------------------------------------: |
+| -1         | Use default value specified in `OnlyTargetHouseEnemy` |
+| 0          | Force `OnlyTargetHouseEnemy` value to `FALSE` |
+| 1          | Force `OnlyTargetHouseEnemy` value to `TRUE`  |
+| 2          | Force `OnlyTargetHouseEnemy` value to `TRUE` or `FALSE` randomly |
+
+### `14006` Set House Hate Value Modifier
+
+- Affects how much hate applies to a selected house (depends of the script action).
+- Positive values increase hate and negative values decrease hate.
+- Affects script actions: `14007`, `14008`, `14009`, `14010`, `14011` & `14012`.
+
+In `aimd.ini`:
+```ini
+[SOMESCRIPTTYPE]  ; ScriptType
+x=14006,n         ; integer n=0
+```
+
+### `14007` Modify House Hate Using House Index
+
+- Modifies the team's hate towards a specific house using its house index.
+
+In `aimd.ini`:
+```ini
+[SOMESCRIPTTYPE]  ; ScriptType
+x=14007,n         ; integer n >= 0
+```
+
+### `14008` Modify Hate Values From A List Of Countries
+
+- The house team picks a list of countries from the `rulesmd.ini` section called `[AIHousesList]`.
+- The house team modify the hate towards all houses in the map that use the countries in that list.
+
+In `aimd.ini`:
+```ini
+[SOMESCRIPTTYPE]  ; ScriptType
+x=14008,n         ; integer n >= 0
+```
+
+The second parameter is a 0-based index for the `AIHousesList` section that specifies the list of possible `Countries` that can be evaluated. The new `AIHousesList` section must be declared in `rulesmd.ini` for making this script work:
+
+In `rulesmd.ini`:
+```ini
+[AIHousesList]  ; List of Countries lists
+0=SOMECOUNTRY,SOMEOTHERCOUNTRY,SAMPLECOUNTRY
+1=ANOTHERCOUNTRY,YETANOTHERCOUNTRY
+; ...
+```
+
+### `14009` Modify Hate Value Against A Random Country From A List Of Countries
+
+- Like action `14008` but the house owner of the Team only picks 1 house randomly from the specified list of countries.
+- The house team modify the hate towards all houses in the map that use the selected country.
+
+In `aimd.ini`:
+```ini
+[SOMESCRIPTTYPE]  ; ScriptType
+x=14009,n         ; integer n >= 0
+```
+
+### `14010` Set The Most Hated House ("<" Comparison)
+
+- Increases the team house hate against an enemy house making that enemy house as the main target.
+
+In `aimd.ini`:
+```ini
+[SOMESCRIPTTYPE]  ; ScriptType
+x=14010,n         ; integer
+```
+
+The possible argument values are:
+
+| *Argument* | *Description*                        |
+| :------: | :-------------------------------------------: |
+| -10      | The house with less factories is selected (excluded the aircraft factories) |
+| -9       | The house with less aircraft docks is selected |
+| -8       | The house with less naval units is selected |
+| -7       | The house with less house kills is selected |
+| -6       | The house with less free power (free = production - consumption) is selected |
+| -5       | The house with less power production is selected |
+| -4       | The house with less power consumption is selected |
+| -3       | The nearest enemy Human base is selected |
+| -2       | The poorest house is selected |
+| -1       | The enemy house with nearest unit to the Team Leader is selected |
+| > 0      | *Target Type#* index. The house with less threat of the selected *Target Type#* (sum of all the units of the same checked type * threat value) |
+
+### `14011` Set The Most Hated House (">" Comparison)
+
+- Increases the team house hate against an enemy house making that enemy house as the main target.
+
+In `aimd.ini`:
+```ini
+[SOMESCRIPTTYPE]  ; ScriptType
+x=14011,n         ; integer
+```
+
+The possible argument values are:
+
+| *Argument* | *Description*                        |
+| :--------: | :-------------------------------------------: |
+| -10        | The house with more factories is selected (excluded the aircraft factories) |
+| -9         | The house with more aircraft docks is selected |
+| -8         | The house with more naval units is selected |
+| -7         | The house with more kills is selected |
+| -6         | The house with more free power (free = production - consumption) is selected |
+| -5         | The house with more power production is selected |
+| -4         | The house with more power consumption is selected |
+| -3         | The farthest enemy Human base is selected |
+| -2         | The richest house is selected |
+| -1         | The enemy house with farthest unit to the Team Leader is selected |
+| > 0        | *Target Type#* index. The house with more threat of the selected *Target Type#* (sum of all the units of the same checked type * threat value) |
+
+### `14012` Set The Most Hated House Randomly
+
+- Increases the Team house hate against an enemy house picked randomly.
+
+In `aimd.ini`:
+```ini
+[SOMESCRIPTTYPE]  ; ScriptType
+x=14012,0
+```
+
+### `14013` Reset Hate Against Other Houses
+
+- All hate levels in the team house against every House are set to 0.
+
+In `aimd.ini`:
+```ini
+[SOMESCRIPTTYPE]  ; ScriptType
+x=14013,0
+```
+
+### `14014` Set A House As The Most Hated House Of The Map
+
+- A House will become the most hated House of the map (the effects are only visible if the other houses are enemies of the selected house)
+
+In `aimd.ini`:
+```ini
+[SOMESCRIPTTYPE]  ; ScriptType
+x=14014,n         ; integer
+```
+
+The possible argument values are:
+
+| *Argument* | *Description*                                 |
+| :--------: | :-------------------------------------------: |
+| -5         | Selects a random House, including civilians. The own house is excluded in the selection of the most hated by everyone |
+| -4         | Any random civilian house   |
+| -3         | All Human players will be hated by everyone   |
+| -2         | The Team House will be the most hated by everyone (allies won't pick allies as enemies) |
+| -1         | Selects a random House. The own house & civilians are excluded in the selection of the most hated by everyone |
+| >= 0       | House index that will be hated by everyone    |
+
 ### `16000-16999` Flow Control
 
 #### `16000` Start a Timed Jump to the Same Line

docs/New-or-Enhanced-Logics.md

@@ -2608,7 +2608,10 @@ OmniFire.TurnToTarget=no  ; boolean
 
 - In addition to allowing custom radiation types, several enhancements are also available to the default radiation type defined in `[Radiation]`, such as ability to set owner & invoker or deal damage against buildings. See [Custom Radiation Types](#custom-radiation-types) for more details.
 
-### Strafing aircraft weapon customization
+### `500 - 523` Edit Variable
+- Operate a variable's value
+    - The variable's value type is int16 instead of int32 in trigger actions for some reason, which means it ranges from -2^15 to 2^15-1.
+        - Any numbers exceeding this limit will lead to unexpected results!
 
 ![image](_static/images/strafing-01.gif)
 *Strafing aircraft weapon customization in [Project Phantom](https://www.moddb.com/mods/project-phantom)*

docs/Whats-New.md

@@ -241,6 +241,15 @@ HideLightFlashEffects=false      ; boolean
   10102=Regroup Temporarily Around the Team Leader,20,0,1,[LONG DESC]
   10103=Load Onto Transports,0,0,1,[LONG DESC]
   10104=Chronoshift to Enemy Base,20,0,1,[LONG DESC]
+  14006=Set House Hate Value Modifier,20,0,1,[LONG DESC]
+  14007=Modify House Hate Using House Index,20,0,1,[LONG DESC]
+  14008=Modify Hate Values From A List Of Countries,28,0,1,[LONG DESC]
+  14009=Modify Hate Value Against A Random Country From A List Of Countries,28,0,1,[LONG DESC]
+  14010=Set The Most Hated House ("<" Comparison),20,0,1,[LONG DESC]
+  14011=Set The Most Hated House (">" Comparison),20,0,1,[LONG DESC]
+  14012=Set The Most Hated House Randomly,0,0,1,[LONG DESC]
+  14013=Reset Hate Against Other Houses,0,0,1,[LONG DESC]
+  14014=Set A House As The Most Hated House Of The Map,20,0,1,[LONG DESC]
   18000=Local variable set,22,0,1,[LONG DESC]
   18001=Local variable add,22,0,1,[LONG DESC]
   18002=Local variable minus,22,0,1,[LONG DESC]
@@ -321,6 +330,10 @@ HideLightFlashEffects=false      ; boolean
   25=Local variables,-4
   26=Global variables,-5
   27=Global variables,-6
+  28=AI Houses List, -7
+
+  [ScriptParamTypes]
+  7=AIHousesList,1,1,0
   ```
 ````
 
@@ -941,6 +954,7 @@ New:
 - Script action to regroup temporarily around the Team Leader (by FS-21)
 - Script action to randomly skip next action (by FS-21)
 - Script action for timed script action jumps (by FS-21)
+- Script action for modifying AI anger against other houses (by FS-21)
 - ObjectInfo now shows current Target and AI Trigger data (by FS-21)
 - Shield absorption and passthrough customization (by Morton)
 - Limbo Delivery of buildings (by Morton)

src/Commands/ObjectInfo.cpp

@@ -13,6 +13,7 @@
 
 #include <Ext/TechnoType/Body.h>
 #include <Ext/Techno/Body.h>
+#include <Ext/Script/Body.h>
 
 const char* ObjectInfoCommandClass::GetName() const
 {

src/Ext/Rules/Body.cpp

@@ -3,6 +3,8 @@
 #include <Utilities/TemplateDef.h>
 #include <FPSCounter.h>
 #include <GameOptionsClass.h>
+#include <HouseTypeClass.h>
+#include <GameStrings.h>
 
 #include <Ext/BulletType/Body.h>
 #include <Ext/TechnoType/Body.h>
@@ -350,6 +352,24 @@ void RulesExt::ExtData::LoadBeforeTypeData(RulesClass* pThis, CCINIClass* pINI)
 
 		this->AIScriptsLists.emplace_back(std::move(objectsList));
 	}
+
+	// Section AIHousesList
+	int houseItemsCount = pINI->GetKeyCount("AIHousesList");
+	for (int i = 0; i < houseItemsCount; ++i)
+	{
+		std::vector<HouseTypeClass*> objectsList;
+
+		char* context = nullptr;
+		pINI->ReadString("AIHousesList", pINI->GetKeyName("AIHousesList", i), "", Phobos::readBuffer);
+
+		for (char* cur = strtok_s(Phobos::readBuffer, Phobos::readDelims, &context); cur; cur = strtok_s(nullptr, Phobos::readDelims, &context))
+		{
+			if (const auto pNewHouse = HouseTypeClass::Find(cur))
+				objectsList.emplace_back(pNewHouse);
+		}
+
+		this->AIHousesLists.emplace_back(std::move(objectsList));
+	}
 }
 
 // this should load everything that TypeData is not dependant on
@@ -389,6 +409,7 @@ void RulesExt::ExtData::Serialize(T& Stm)
 	Stm
 		.Process(this->AITargetTypesLists)
 		.Process(this->AIScriptsLists)
+		.Process(this->AIHousesLists)
 		.Process(this->Storage_TiberiumIndex)
 		.Process(this->HarvesterDumpAmount)
 		.Process(this->InfantryGainSelfHealCap)

src/Ext/Rules/Body.h

@@ -31,6 +31,7 @@ class RulesExt
 	public:
 		std::vector<std::vector<TechnoTypeClass*>> AITargetTypesLists;
 		std::vector<std::vector<ScriptTypeClass*>> AIScriptsLists;
+		std::vector<std::vector<HouseTypeClass*>> AIHousesLists;
 
 		Valueable<int> Storage_TiberiumIndex;
 		Valueable<float> HarvesterDumpAmount;