What are the divisions of "issub" in the new release?

[Jason Drake]

In the release notes for 2.0.20123 there's a new XML feature to "Divide isSub into Attributes (#4831)". I'm excited to use this-- can someone direct me to whatever guide provides the syntax for these divided attributes? I normally use the Pact of Steel 2 with all of its rich examples, but it doesn't seem to have been updated since this release.

Thanks!
-- Jason

[wc_sumpton]

@Jason-Drake

From PoS2:
isSub values: allows the unit to roll dice before other units and submerge or retreat from battle even on defense this is a shortcut option that sets the below 6 unit options based on the global sub properties specifically:
sets canEvade and isFirstStrike to true
sets canNotTarget to all air units
sets canNotBeTargetedBy to all air unit types if "Air Attack Sub Restricted"
sets canBeMovedThroughEnemies to true if "Ignore Sub In Movement"
sets canMoveThroughEnemies to true if "Submersible Subs"
canEvade values: whether the unit can submerge or escape battle
isFirstStrike values: whether to roll dice and take casualties before regular units
canNotTarget values: colon delimited list of units that this unit can't target in battles, ex. subs not being able to target air units
canNotBeTargetedBy values: colon delimited list of units that can't target this unit, ex. air units not being able to target subs
canMoveThroughEnemies values: whether unit is unblockable and treats hostile territories as friendly
canBeMovedThroughByEnemies values: whether enemies can move through territories if only these types of units are present (would also need blitz for enemy land territories)

Hope this helps.

Cheers...

[RogerCooper]

@wc_sumpton What if I wanted a unit to be able to retreat after 1 round of battle like subs in the Classic edition? What values would I set?

[wc_sumpton]

@RogerCooper

I believe that this property is the one you are looking for:

<!-- Allows option for subs to withdraw from battle prior to the combat rolls -->
<property name="Sub Retreat Before Battle" value="false" editable="false">
    <boolean/>
</property>

Cheers...

P.S. The canEvade <option> is for retreat/withdraw submerge.

[Cernel]

@RogerCooper said in What are the divisions of "issub" in the new release?:

@wc_sumpton What if I wanted a unit to be able to retreat after 1 round of battle like subs in the Classic edition? What values would I set?

I've not tested it, but, if I'm right to suppose v1 should be the standard, what I understand you should do is assigning the unit the "canEvade" option as true, while missing or having false every property that would modify such behaviour (namely, "Submersible Subs" and "Sub Retreat Before Battle").

[RogerCooper]

In first edition, subs can retreat only after 1 round of combat. How is that handled?

[Trevan]

@RogerCooper

canEvade allows a unit to leave the battle either at the beginning or the end of the round. The property "Sub Retreat Before Battle" indicates whether the units with canEvade will attempt to retreat at the beginning of the round (if the value is true) or at the end of the round (if the value is false).

So, it sounds like you want the unit to have canEvade = true and the map to have "Sub Retreat Before Battle" = true