XanatosX / IL2-Career-Reviver

Tool to revive a dead pilot from a IL-2 Sturmovik Great Battles campain
MIT License
2 stars 0 forks source link
console dotnet7 il-2 sqllite

IL 2 Career Toolset

Codacy Badge Nightly Develop Build Live build

Type Package
Toolset Toolset Badge
Model Model Badge

:warning: This tool can only be used with the Game L-2 Sturmovik Great Battles. To get the game please go to the game website or steam.

This readme is still WIP I did want to get nighly build's up ASAP.

This tool will provide you different commands to performe on your save file. One of the major features is to revive a dead pilot by resetting the carreer to the day before death.

:warning: Warning :warning:

This tool will change, delete and move data in your save file around, which can corrupt it. This can lead to unwanted behaviors of the game or break the save completly, which will affec all other careers as well. Those errors could appear later on and may be invisible directly after usage.

:warning: Since I do not play in multiplayer I have no clue if editing the database will cause any errors with the servers you play on. I would guess that this is not the case but I'm not able to confirm it just yet.

:information_source: Command's which change your save file will present you a warning you need to comfirm before the command will run.

Installation

Via zip

To install the tool head over to the releases or use the latest release. Download the asset containing the tool, which is a zip file. As soon as the tool is downloaded unzip it to a folder on your computer.

Continue with the Command list section

Using dotnet cli

:information_source: This is only interessting for other developers who want to install this via dotnet cli as a global tool.

You will need the dotnet cli installed. Run the following command to get the tool dotnet tool install --global IL2CareerToolset.

Command list

You need to open a command line or powershell to run the commands, to do so press windows key and search for powershell or cmd. Navigate to the folder contaning the exe of the toolset by cd {Folder name you extracted the zip to}. Use the commands listed below to use the tool

If you need any additional information or need help with the usage please create a issue.

Settings

Set Log level

IL2CareerToolset.exe settings loglevel {loglevel}

The following log levels are allowed:

On default the app will use warning. The logfile is getting saved in %appdata%\IL2CareerToolset. Just enter the string into the navigation bar in your explorer to get there.

Automatic search for steam savegame

IL2CareerToolset.exe settings auto

This command will try to automatically detect your database file, this will only work if you use a steam installation.

Keep in mind that this command will scan all your discs and folders to find the game, no data will be uploaded.

Enter Savegame manually

IL2CareerToolset.exe settings manuell

This command will allow you to set the game folder yourself.

Pilots

Get Pilots

IL2CareerToolset.exe save game pilot [Arguments] [Flags]

This command will list all the pilots of all your save games. there are some possibilities for filtering

Arguments
Position Required Description
1 OPTIONAL The name of the pilot to search for
Flags
Flag Description
-p|--player Only show player pilots

Revive Pilots

IL2CareerToolset.exe save game pilot [Flags]

Revive a pilot from your save game, please create a backup first. Keep in mind that this action could destroy your save. The command will ask you which pilot to revive as you run it. It will ask you to confirm the revive and give you an overview if it was successful.

Flags
Flag Description
-i|--ironman Include iron man characters

Backup

List Backup's

IL2CareerToolset.exe save backup list

Get a table with all the backups created for your game.

Create Save Backup

IL2CareerToolset.exe save backup create [Arguments]

Create a new backup for your game and store it to the backup folder %appdata%\IL2CareerToolset\backups.

Arguments
Position Required Description
1 OPTIONAL The name of the backup to create

Delete Backup

IL2CareerToolset.exe save backup delete [Arguments] [Flags]

Delete a single backup or all of them, if no arguments provided the program will ask for a backup to delete.

Arguments
Position Required Description
1 OPTIONAL The guid of the backup to delete

:information_source: To get the guid for a backup use the list command first

Flags
Flag Description
-a|--all Delete all the backups for the game

Rename Backup's

IL2CareerToolset.exe save backup rename [Arguments]

Rename a backup. If no arguments provided the program will ask you for a backup to rename and the new name to use

Arguments
Position Required Description
1 OPTIONAL The guid of the backup to rename
2 OPTIONAL The new name to use for the backup

:information_source: To get the guid for a backup use the list command first

Restore Backup

IL2CareerToolset.exe save backup restore [Arguments]

Restore a backup. If no argument provided the program will show a list with all the backups you could restore

Arguments
Position Required Description
1 OPTIONAL The guid of the backup to restore

:information_source: To get the guid for a backup use the list command first

App

Open Repository in Browser

IL2CareerToolset.exe app open

Open the code repository in your default browser.

Open Issues in Browser

IL2CareerToolset.exe app issue

Open the issue page for the application in your default browser.

Open Help in Browser

IL2CareerToolset.exe app help

Open this readme in your default browser.

Using the model library

You are a developer who want to use the library used as a backend for this tool? Go to the Readme for the model to get more information and how to get started.

Report Bugs

Go to issues to report any bugs you encounter.

License

Read the license file for more information