> For the complete documentation index, see [llms.txt](https://xeavin.gitbook.io/the-insurgents-toolkit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xeavin.gitbook.io/the-insurgents-toolkit/features/battlepack-editor.md).

# Battlepack Editor

### Sections

The battlepack consists of 71 different sections which all hold general information about the game. It might look like some sections are missing in this editor, but those are either empty or contain only text like section 2 and 61 which this editor can not support.

### Usage

1. Decide what you want to edit (e.g. Weapon Formula).
2. Guess which group it might be located in (e.g. Equipment & Attributes).
3. Click on the according checkbox to expand the group.
4. Edit everything to your liking.

You can navigate through the list of entries by modifying the *Identifier*.

### Save Changes

1. Create the following directory structure: `ps2data\image\ff12\test_battle\us\binaryfile\battle_pack.bin.dir`
2. Click on the checkbox of *Export Section To File* to expand the group.&#x20;
3. Click on the value field of *Section Identifier* to open its drop-down list.
4. Select a section in the drop-down list (e.g. 13 : Equipment & Attributes).
5. Click on the checkbox of *Execute Script* to run the script.
6. Navigate into the directory from step 1: `battle_pack.bin.dir\...`
7. Confirm your choice by selecting save.

Repeat steps 3-7 if you wish to export another section. Once you are done, create an archive (.7z, .zip, .rar etc.) out of the root directory (ps2data) and install it (e.g. Vortex).

#### Language Directory Name

The name of the language directory created in step 1 needs to be adjusted according to one of the following, depending on the language you are playing with:

<table><thead><tr><th>Abbrevation</th><th width="249.33333333333331">Language</th></tr></thead><tbody><tr><td>ch</td><td>Traditional Chinese</td></tr><tr><td>cn </td><td>Simplified Chinese</td></tr><tr><td>de </td><td>German</td></tr><tr><td>es </td><td>Spanish</td></tr><tr><td>fr </td><td>French</td></tr><tr><td>﻿in </td><td>Japanese</td></tr><tr><td>﻿it </td><td>Italian</td></tr><tr><td>kr </td><td>Korean</td></tr><tr><td>us </td><td>English</td></tr></tbody></table>

### Notes

{% hint style="warning" %}
Since this editor works with the currently loaded battle\_pack.bin file in memory, all changes applied to the it via mods will already be present. Hence why you can simply export your changes, install it as a mod, and continue working where you left of the last time. However, this means that you have to be very mindful with which mods you have active while working on yours as otherwise you will unknowingly work on top of the changes of other mods.
{% endhint %}

{% hint style="info" %}
Loading the exported files of this editor require the [FF12 External File Loader](https://www.nexusmods.com/finalfantasy12/mods/170) to be installed.
{% endhint %}

{% hint style="info" %}
For a detailed list of all the information available in this editor, you can view the spreadsheet in [Resources](/the-insurgents-toolkit/getting-started/resources.md).
{% endhint %}

{% hint style="info" %}
The text fields are only links meaning that they do not contain the text itself, but point to an entry in another (text) section that contains it. So if you want to add new text, or modify the text itself, you have to do so with the ff12-text tool available from [here](https://www.nexusmods.com/finalfantasy12/mods/124).
{% endhint %}

{% hint style="info" %}
Only because some data can be modified with this editor, doesn't mean it is the only and proper way to do it. For example, modifying the text link of an entry in a section can technically change the text. However, doing that is kind of unnecessary as that is not really the intended purpose of it. A text link is meant to point to an entirely new text entry. If you want to change a text entry, you should edit the text itself with the ff12-text tool from [here](https://www.nexusmods.com/finalfantasy12/mods/124).&#x20;
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://xeavin.gitbook.io/the-insurgents-toolkit/features/battlepack-editor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
