The idea is that you recover something else than what you see on the battlescape.
Can be used for example:
1. to recover weapon fragments instead of weapons, a la xcom2012
2. to recover tons of various loot instead of a loot box (and skip the manufacturing project to open a loot box)
3. to recover some alien body parts instead of alien corpse (and skip dissection manufacturing project)
4. etc.
Sample ruleset:
items:
- type: STR_PLASMA_PISTOL
recoveryTransformations:
STR_WEAPON_FRAGMENTS: [0, 50, 35, 15] # 0% to recover 0 items, 50% to recover 1 item, 35% for 2 items, 15% for 3 items
STR_RANDOM_BITS_OF_KNOWLEDGE: [10] # always recover exactly 10 items
Specifying just one number means "recover that many items".
Specifying two or more numbers gives weights to recover 0, 1, 2, 3, 4, 5, etc. items, for example:
- [0, 50, 35, 15] = 0% to recover 0 items, 50% to recover 1 item, 35% for 2 items, 15% for 3 items
- [25, 25, 25, 25] = 25% for 0, 25% for 1, 25% for 2, 25% for 3 items
- [1, 1, 1, 1] = means the same as above = 25% for 0, 25% for 1, 25% for 2, 25% for 3 items
On the "transformed into" side, you cannot specify to recover live aliens from some random unorganic junk.
Also, you can (but should not) recover special items (alien alloys, food, entertainment, etc.) or bounty items, because the debriefing summary is done before the transformations and will not show correct values to the player.
The "transformed from" side supports transformation of:
- weapons
- ammo
- consumable medikits
- non-consumable medikits
- alien corpses
- corpses of live aliens who die because of lack of alien containment
- civilians recovered as items (which don't represent a live alien)
- bounty item
Not supported or irrelevant:
- live aliens EDIT: partially supported since March 25th 2020, OXCE v6.5, live aliens can now be recovered as items (not as other live aliens)
- civilians recovered as items (which do represent a live alien)
- special items (alien aloys, alien food, alien entertainment, etc.)
- xcom vehicles (HWP/SWS)
- xcom vehicle ammo
- automatically replaced armor of KIA xcom soldiers
- automatically replaced armor of MIA xcom soldiers