Zanarkand Workshop is under active development, with new tools, improved workflows, and ongoing enhancements. Originally based on osdanova/FFXProjectEditor v1.2, it has grown into a significantly expanded editor.
Modify auto abilities, redesign monster battle AI, customize commands, adjust encounter formations, and more.
The current release is v0.4.1, featuring Auto Ability editing, expanded Monster Editor controls, safer recovery workflows, and clearer validation.
- Monster Editor
- Monster Battle Script Editor
- Auto Ability Editor
- Item Editor
- Player & Aeon Command Editor
- Enemy Command Editor
- Battle Formation Editor
- Rikku Mix Editor
- Sphere Grid Editor
- Treasure Chest Editor
- Live Memory Utilities
- Inventory Tracker
- Arena Tracker
- Live Battle Tracker
- Colors changes do not properly save to the sphere grid editor.
- Added several safety features to prevent in-game crashes with Sphere Grid editor. See sphere grid section for more details.
- Fixed the Previous Chest button in the Treasure Chest Editor. Users can now safely cycle between previous and next chest.
- Add a meta data folder.
- Add a weapon editor.
- Add a ply_save Editor.
Download the latest Windows package from the Releases section of this fork,
extract it, and run ZanarkandWorkshop.exe.
Extract the game files using an extractor such as VBF Browser.
The folder that the app uses (and needs to be loaded) is ffx_ps2/ffx/master.
Inside this folder are directories containing data for every region. Currently,
this tool only supports US game data; both new_uspc and jppc are needed.
I recommend using the External File Loader.
This creates a mods folder inside your FFX folder where custom files can be
loaded by the game. Once installed, copy your master folder to
mods/ffx_ps2/ffx/ and load that folder in the editor to immediately modify
the files used by the game.
It is also recommended that you keep a clean version of the master files, as they are needed for the recovery feature of this program.
Click Open Project Folder... and select your master folder. The app detects the running game automatically; the FFX Connected indicator shows the connection status.
- Live testing: Monster changes are loaded when combat starts, so a saved monster file applies to the next encounter.
Edit monster stats, elemental affinities, status resistances, loot drops, and other properties.
The Battle Script editor can change attacks, targets, conditions, jumps, shared
values, and other monster behavior. v0.2.0 adds safer structural copying,
insertion, replacement, and deletion; worker/function/jump navigation; protected
RETURN (3C) handling; transactional manual hex validation; and recoverable
rejected edits.
- Live testing: Loaded when the game starts. The Load Ingame button can be used to see changes without restarting.
Edit item names, descriptions, targeting, effects, formulas, elements, statuses, and related properties.
Edit the result command produced by any two usable items. Recipes are loaded
from jppc/battle/kernel/prepare.bin and command names come from
new_uspc/battle/kernel/command.bin.
Search or sort the recipe list, choose ingredients and results from dropdowns, then save the updated Mix table.
Edit the Auto Abilities used by weapons and armor. The editor reads
new_uspc/battle/kernel/a_ability.bin and the customization recipes stored in
jppc/battle/kernel/kaizou.bin.
Either file can be edited independently. If one is missing, its corresponding tab is disabled and saving updates only the file that was loaded. The editor refuses to open only when both files are missing.
The Properties & Effects tab includes:
- The ability name and description.
- Basic display and grouping properties.
- Elemental effects.
- Permanent, temporary, and extra status effects.
- Direct stat increases and the percentage increase amount.
- Separate Strength, Magic, Defense, and Magic Defense calculation bonuses.
- Confirmed special effects such as Sensor, Counterattack, Auto-Potion, Break Damage Limit, No Encounters, and Capture.
Direct stat increases change the stored combat stat and remain subject to that stat's normal cap. The four Bonus flags do not change the displayed combat stat; they apply separately during the game's calculations.
The Recipe tab controls whether the ability is customized onto weapons or
armor, the required item, and the required quantity. Recipe quantities are
limited to the game's inventory maximum of 99. Some auto abilities do not have
recipes and disable the Recipe tab.
Names and descriptions use the same supported-character, cyan-formatting, and
line-break rules described under General text editing. Saving rebuilds the
text offsets in a_ability.bin and writes the corresponding recipe changes to
kaizou.bin.
Use Restore Original Ability to recover only the selected ability's properties, text, and matching recipe. Other Auto Abilities remain unchanged, and Save rebuilds valid text offsets for the current file.
Edit the commands used by the party and Aeons.
Edit commands used by standard enemies.
Edit commands used by bosses.
Edit which monsters appear in a battle and adjust their positions.
Visually edit the Original, Standard, and Expert Sphere Grids. Select a node to change its type, section color, or position, or select a connecting line to edit its link. The editor can also create nodes and links, find and replace node types, and undo changes before saving.
For game stability, grids are limited to 860 nodes. Standard and Original grids support up to 1,021 total links, Expert supports up to 934, and each node can have up to five usable connections.
Use Recovery to restore the game's original grids. Start a new game when testing a redesigned Sphere Grid so the game loads the new grid data cleanly.
Current limitations:
- Max of 860 nodes per grid.
- Max of 1,021 links for the Standard grid.
- Max of 934 links for the Expert grid.
- Only 5 links can connect to a single node.
View treasure chests on interactive maps reconstructed from your own game files. Select a field, click a chest icon, or use Previous Chest and Next Chest to inspect every detected chest—even one without a visible map icon. Change the reward type, reward, and quantity for Gil, items, key items, weapons, and armor. Chest positions are shown for reference and are not edited.
Required files: jppc/battle/kernel/takara.bin, buki_get.bin,
jppc/map with mapout.vpa files, and jppc/event/obj with .ebp files.
Only takara.bin is changed when you save.
These rules apply across editable game-text fields in Zanarkand Workshop, including monster names, Sensor and Scan text, items, and command names and descriptions, as well as Auto Ability names and descriptions.
Wrap text in [cyan] and [/cyan] to use the game's cyan formatting:
Weak against [cyan]Fire[/cyan].
The tags are editor notation. In the game, Fire is displayed in cyan and the
brackets are not shown. Tags are case-insensitive, although the lowercase form
is recommended. Keep opening and closing tags paired and correctly ordered.
Press Enter in a multiline field to insert a game line break. Visual wrapping inside an editor field does not insert a line break unless Enter was pressed. The game controls the final text-box width and pagination, so review longer text in game.
FFX uses its own limited character table rather than Unicode. If text contains a character that cannot be encoded, Zanarkand Workshop reports an error instead of writing damaged text. Replace unsupported smart quotes, symbols, or accented characters with a supported equivalent and save again.
If you only want to use the Utilities, simply open the app when the game is open and use them, no need to set anything up.
- Available only while an active session of FFX is running.
- Zanarkand Workshop will automatically connect.
- Check FFX Connected in the top-right corner for confirmation.
- Utilities are only compatible with the Windows Steam version.
- Utilities are compatible with Untitled Project X.
- To refresh Utility data, it has to be reopened (excluding the Battle Tracker).
Tools to play around with the game.
Resides inside the Utilities menu. A configuration menu with debug options.
A menu to see and modify ally and enemy data. Autorefresh can be enabled, but editing and loading data is disabled while it is autorefreshing.
See all of your inventory and edit it as needed. You can also sell equipment in bulk.
Keep tabs on your arena captures.
- .NET
- Avalonia UI
- MemorySharp (compiled branch that supports x64 apps)
Requirements:
- Windows
- .NET 8 SDK
From the repository root:
dotnet restore .\ZanarkandWorkshop.sln
dotnet build .\ZanarkandWorkshop.sln -c Release --no-restoreThe executable is written to
ZanarkandWorkshop/bin/Release/net8.0/ZanarkandWorkshop.exe.
To create the ready-to-distribute, self-contained Windows ZIP used for GitHub Releases:
.\scripts\build-release.ps1 -Version 0.4.1The package is written to artifacts/ZanarkandWorkshop-v0.4.1-win-x64.zip.
Pushing a version tag such as v0.4.1 runs the same packaging process on
GitHub and creates a draft release for review.
Zanarkand Workshop is under active development. Back up modded game files before editing them and review the release notes before upgrading. Version 1.0.0 is reserved for a future stable milestone.
See CHANGELOG.md for release history and NOTICE.md for project provenance and licensing information.
The knowledge on the files was shared by the FFX community folks. Check out the Fahrenheit project to learn more.
Big thanks to Karifean/FFXDataParser and their knowledge of monster Battle Script structure.
Another big thanks to the Cid's Salvage Ship Discord community. They've been an enormous help with FFX modding. Check them out if you're interested.
You can find me in the Cid's Salvage Ship community discord. Questions and feedback about Zanarkand Workshop are welcome there.