Configuration

Configuration

There are several configurable options which are all loaded from the {game}/x64/scripts/config/TheInsurgentsLearnableFoecraftConfig.lua file when opening the game.

This configuration file can be modified via any text editor. The following configuration is the default and equivalent to not having a learnable action at all:

Default Configuration

local function config(statusEffects, augments, foes, actions, contents)
  local statusEffects = {
    statusEffects.ko,
    statusEffects.stone,
    statusEffects.stop,
    statusEffects.sleep,
    statusEffects.confuse,
    statusEffects.blind,
    statusEffects.disable,
    statusEffects.berserk,
    statusEffects.xZone
  }

  local dialogId = 102
  local augmentId = augments.essentials
  local soundEffectId = 104
  local learnables = {
    --{foeId, {action0, content0, chance0}, {...}, {actionX, contentX, chanceX}}
    --{foes.happyBunny, {actions.cure, contents.magicks.cure, 10.00}, {actions.protect, contents.magicks.protect, 5.00}}
  }

  return statusEffects, dialogId, augmentId, soundEffectId, learnables
end

return config

Below is a list of all configurable options and what they are used for:

Status Effects

The status effects that prevent a party member from learning an action.

For example: If the status effects Sleep (4), Blind (7), and Berserk (27) should prevent a party member from finding an item, the parameter statusEffects would be set to the following:

local statusEffects = {4, 7, 27}

Dialog Identifier

The dialog of the combat log that will be shown when an action is learned.

As this is an entirely new dialog, it needs to be added to the game first by doing the following:

1. Follow the setup instructions of The Insurgent's Workshop.

2. Extract the ps2data/image/ff12/test_battle/us/binaryfile/battle_pack.bin file via the VBF Browser (us directory differs depending on your game language).

3. Paste it into the The Insurgent's Workshop/files/source directory while keeping its directory structure intact (files/source/ps2data/.../binaryfile/battle_pack.bin).

4. Run The Insurgent's Workshop.exe.

5. Select option 1. Unpack Packages.

6. Delete all files in the files/source/ directory except .../battle_pack.bin.dir/section_002.bin.

7. Select option 3. Unpack Files.

8. Add a new dialog to the .../battle_pack.bin.dir/section_002.txt file. For example:

{dialog 102, arg0type=7, arg1type=1, flags1=128}
Learned {rgb:50,122,118}{arg:0,0,0}{rgb:128,128,128} from {rgb:128,95,26}{arg:1,0,0}{rgb:128,128,128}!
{/dialog}

Feel free to change the text, but there is no point in modifying the arguments as their types and purpose is hardcoded into the script anyway. Argument 0 is the learned action (e.g. Cure) while argument 1 is the foe which cast it (e.g. Giza Rabbit).

1. Select option 4. Pack Files.

2. Create an archive (.7z, .zip, .rar etc.) out of the ps2data directory inside files/newpack and install it (e.g. Vortex).

3. Set the dialog identifier of the configuration file to the one you added in step 8 (e.g. 102).

Augment Identifier

Only party members with a specific augment have a chance to learn an action. This augment can either be acquired by unlocking a license node, using an equipment that grants it, or by default for a party member.

Sound Effect Identifier

The sound effect that will be played when an action has successfully been learned.

A value of -1 equals no sound effect.

Learnables

The learnable actions of all foes. A foe is defined by its bestiary identifier and can have infinite learnable actions.

Every action in the game has a required content which is usually acquired through shops, treasures, and so on. A party member is only able to cast an action if the player has its required content in their inventory (licenses aside). The required content of every action is defined in Battlepack -> Section 14 and can be modified with either The Insurgent's Toolkit or The Insurgent's Workshop.

Learning an action will add the configured content to the player's inventory, which should of course equal the required content of the action the party is supposed to learn and therefore unlock its usage.

Each action has its own learn chance and can only be learned once from a foe, but also only if its required content was not acquired otherwise (e.g. shop, treasure, etc.).

Every party member has their own chance of learning an action, but once its learned, every party member with the required license node can use it. The more party member's have the required augment, the higher the chance of course to learn the action.

A party member can only have a chance to learn an action from a foe if it is in their visible range. So if a party member is on the other side of the map, while another is in battle with a foe that uses a learnable action, only the one that actually sees the foe will have a chance to learn it.

Notes

Parameters are processed from top-left to bottom-right, which defines their priority. For example:

• If a foe is listed more than once, only the last one will actually have an effect.

• If an action is listed more than once for a foe, only the first one will actually have an effect.

For a list of status effect and augment identifiers, you can view the battlepack spreadsheet in Resources.

For a list of foe (bestiary) identifiers, you can view the bestiary spreadsheet in Resources.

Only the identifiers 0 -> 511 are supported.

For a list of content identifiers, you can view the inventory content spreadsheet in Resources.

Only the following content types are supported: Magicks, Technicks, Mist.

For a list of sound effect identifiers, you can do the following:

1. Extract the ps2data/sound/se/sead_data_win/se000/se000.win.sab file via the VBF Browser.

2. Download and open foobar2000.

3. Open the extracted se000.win.sab file with it.

4. Select and play any track you want.

Once you like one, you can use the track identifier as the sound identifier (e.g. se000.win#65 -> 65).