Getting started
When you open Decima Workshop for the first time, you will be welcomed with an empty window. The first thing you need to is to create a new project.
In the main menu, use File ⇒ New ⇒ Project... to open the project creation dialog:
Don't worry, you will understand the purpose of each field in a moment.
| Field | Description |
|---|---|
| Project ⇒ Name | Name of the project presented in the navigator |
| Project ⇒ Type | Which game this project is working with |
| Game ⇒ Executable file | Path to the game's binary executable. For most games, it's the only .exe file located in the game's root folder |
| Game ⇒ Data directory | Path to the game's archives folder. For most games, it's a folder in the game's root folder that contains a bunch of .bin files |
| Game ⇒ Oodle library | Path to the compressor library used for compressing/decompressing game data. For most games, it's a file in the game's root folder called oo2core_XXX.dll |
Note
When running Decima Workshop on Linux or macOS, you'll either have to rely on software emulations tools like Wine or Parallels, or obtain the Oodle library for your platform. Fortunately, this process can somewhat be done by the tool itself; for more information, please refer to https://github.com/ShadelessFox/decima/wiki/CLI#getting-oodle
Once you have filled in all the required fields, press the OK button to continue. On the left, you will see the project you can double-click on to expand and explore its files.
In the navigator, right-click on a file you want and select an appropriate action:
- Replace Contents... to replace file contents with another file from the filesystem
- Export Contents... to export file contents to the filesystem
Otherwise, you can edit data using Core Editor.
In the main menu, use File ⇒ Repack... to open the "Persist Changes" dialog:
Several options are present to control how the changes are persisted:
| Name | Description |
|---|---|
| Strategy ⇒ Update changed packfiles | Repacks only the packfiles whose files were changed. Big packfiles might take significant time to repack. |
| Strategy ⇒ Collect changes into a single packfile | Creates a single packfile that contains all changes from modified packfiles. This option cannot be used when changing the same file across different packfiles |
| Options ⇒ Create backup if exists | Creates backup for every modified packfile so they can be restored later |
| Options ⇒ Append if exists | If the selected packfile exists, appends changes rather than truncates it |
| Archive format | The output format of the archive: either encrypted or not; HZD does not support encrypted archives |
| Compression level | Controls how powerful the data compression is. See the description of each compression level for a brief overview |
Once done, press the Persist button to start the repack process.