Weapon Mod Rules - MeridiusIX/Modular-Encounters-Systems GitHub Wiki
Weapon Mod Rules Profiles in Modular Encounters Systems are used by mod authors to restrict their weapons from appearing on grids during weapon randomization. Some reasons they may want to do this is because a weapon is not suitable to use for combat (designator turret), or a weapon doesn't fit well with the rest of the grid when randomly placed (turrets with passage/crew areas beneath them).
These profiles are not attached to SpawnGroups, SpawnGroup Conditions, or Manipulation Profiles. If they are detected in the world, then they will apply to all grids spawned with randomized weapons.
Here is an example of how a Weapon Mod Rules Profile definition is setup:
<?xml version="1.0"?>
<Definitions xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<EntityComponents>
<EntityComponent xsi:type="MyObjectBuilder_InventoryComponentDefinition">
<Id>
<TypeId>Inventory</TypeId>
<SubtypeId>MES-ExampleWeaponRules</SubtypeId>
</Id>
<Description>
[MES Weapon Mod Rules]
[WeaponBlock:MyObjectBuilder_LargeInteriorTurret/SomeModdedWeapon]
[AllowInRandomization:false]
</Description>
</EntityComponent>
</EntityComponents>
</Definitions>
Below are the tags you are able to use in your Weapon Mod Rules Profiles.
Tag: | WeaponBlock |
---|---|
Tag Format: | [WeaponBlock:Value] |
Description: | This tag specifies the weapon that you want to apply the profile rules to. |
Allowed Values: | Any Weapon Block MyDefinitionId eg: MyObjectBuilder_InteriorTurret/SomeModdedWeapon
|
Multiple Tag Allowed: | No |
Tag: | AllowInRandomization |
---|---|
Tag Format: | [AllowInRandomization:Value] |
Description: | This tag specifies if the weapon is allowed to be used in Weapon Randomization at all. |
Allowed Values: |
true false
|
Multiple Tag Allowed: | No |
Tag: | AllowIfNonPublic |
---|---|
Tag Format: | [AllowIfNonPublic:Value] |
Description: | This tag specifies if the weapon is allowed to be used in Weapon Randomization even if it is not listed as a public block (ie: doesn't appear in G-Menu). |
Allowed Values: |
true false
|
Multiple Tag Allowed: | No |
Tag: | AllowOnlyIfExactSize |
---|---|
Tag Format: | [AllowOnlyIfExactSize:Value] |
Description: | This tag specifies if the weapon being chosen for weapon randomization must be an exact size match. |
Allowed Values: |
true false
|
Multiple Tag Allowed: | No |
Tag: | AllowedTargetBlocks |
---|---|
Tag Format: | [AllowedTargetBlocks:Value] |
Description: | This tag specifies one or more types of blocks that the specified weapon is only allowed to replace. |
Allowed Values: | Any Weapon Block MyDefinitionId eg: MyObjectBuilder_InteriorTurret/LargeInteriorTurret
|
Multiple Tag Allowed: | Yes |
Tag: | RestrictedTargetBlocks |
---|---|
Tag Format: | [RestrictedTargetBlocks:Value] |
Description: | This tag specifies one or more types of blocks that the specified weapon are never allowed to replace. |
Allowed Values: | Any Weapon Block MyDefinitionId eg: MyObjectBuilder_InteriorTurret/LargeInteriorTurret
|
Multiple Tag Allowed: | Yes |