Skip to content

Lesson 0

Kamzik123 edited this page Jul 20, 2022 · 3 revisions

Introduction

This lesson will teach you the basics of the AnvilToolkit program, so that you can start creating or installing mods as soon as possible.

.NET Requirement pop-up

If you get a pop-up saying you need to install .NET in order to start the program, you must download and install the Microsoft .NET5 Desktop runtime, which can be found here.

Console

This window will tell you everything AnvilToolkit is doing, including when something goes wrong.
When unpacking or repacking files, you should wait for the console to display a message saying the unpack/repack process was successful.

Game Selector

1. Game Entries

This element contains all of the currently loaded game entries, to open the Game Explorer, double click on one of the entries.
If you add more than 10 items, you can scroll down to see the rest of the added entries.

2. Game Entry Edit Button

Clicking this will open the Game Editor for the selected Game Entry.

3. Add Game Entry Button

This will add a blank Game Entry and open the Game Editor for it.

4. Settings Button

As the name suggests, this will open the Settings window.
If you plan on creating mods using the toolkit, it is recommended to enter your name or nickname in the "User nickname" field, as it is used in the data file signing.

5. Extra Utilities Button

This button opens a pop-up menu containing additional utilities the toolkit has.
Currently the utilities are: "Hash Converter" and "Export FGFL". However, there will probably be more utilies added in the future.
The Hash Converter can be used to hash any string using various different algorithms, or to access the toolkit's hash database, which can turn a numerical value into its original string, granted the toolkit has that numerical value in its database.
The Export FGFL utility serves for exporting FGFL files, which can be found here, into human readable text files. These text files can then be used to find files and their duplicates in the game by just simply searching by the file ID.

6. Information Button

As the name suggests, this opens a window containing the information about the program and a special thanks section.

Game Editor

1. Game Presets

Provides basic presets to fill the rest of the values with default ones.

2. Name

This is the name of the entry, which will apear under the image in the Game Selector.

3. Path To Game Executable

This field contains the path to the executable of the game you are planning on editing, to change the path, click on the three dots next to the text box and navigate to the game directory, then double click on the executable file.

4. Path To Entry Icon

This field contains the path to the icon that will appear on the Game Entry in the Game Selector, to edit the path, click on the three dots next to the text box and navigate to the directory containing the desired image, then double click on the image.

5. Icon Preview

This allows you to visualise the icon as it will appear in the Game Selector.

Game Explorer

1. Search Bar

Searches the folder for the specified text, same as Windows Explorer search. To search for mutiple terms, separate each term with an asterisk (*).

2. Folder Navigation

Same folder navigation functionality as Windows Explorer.

3. Home Button

Reopens the Game Selector window.

4. Open Folder

Opens the game directory in Windows Explorer.

5. Start Game

Runs the executable you have specified in the Game Entry.

6. Settings Button

As the name suggests, this will open the Settings window.
If you plan on creating mods using the toolkit, it is recommended to enter your name or nickname in the "User nickname" field, as it is used in the data file signing.

7. Extra Utilities Button

This button opens a pop-up menu containing additional utilities the toolkit has.
Currently the utilities are: "Hash Converter" and "Export FGFL". However, there will probably be more utilies added in the future.
The Hash Converter can be used to hash any string using various different algorithms, or to access the toolkit's hash database, which can turn a numerical value into its original string, granted the toolkit has that numerical value in its database.
The Export FGFL utility serves for exporting FGFL files, which can be found here, into human readable text files. These text files can then be used to find files and their duplicates in the game by just simply searching by the file ID.

8. Information Button

As the name suggests, this opens a window containing the information about the program and a special thanks section.

9. Shut Down

Closes the entire program.

10. File Context Menu

Contains file specific actions and some basic file manipulation actions.

11. File Information

Contains all information about the currently selected file or folder.

12. Action Buttons

Displays a set of buttons, each corresponding to an action which can be executed on the selected file or folder.