diff --git a/Getting-started.md b/Getting-started.md index b045581..765e01f 100644 --- a/Getting-started.md +++ b/Getting-started.md @@ -1,63 +1,54 @@ **Important Note before you launch DCS Liberation :** +DCS Liberation will modify the following file in your DCS installation: `/Scripts/MissionScripting.lua`. This allows Liberation to record information about mission events. This will **not** prevent you from passing the integrity check to join multiplayer servers. -``` -Be aware that DCS Liberation will modify the following file in your DCS installation : +This file will be modified whenever DCS Liberation is opened and the original will be replaced when DCS Liberation is closed. -/Scripts/MissionScripting.lua. - -However, i believe this should not trigger integrity check failure when joining MP servers. - -But be aware that this file will be modified. This is to allow communication between DCS scripting engine and the DCS Liberation executable. - -This modification open up the possibility to edit file from the lua script executed in DCS mission scripts - -So you might want to re-add the original file before opening untrusted mission file in DCS, or before joining untrusted MP servers. - -``` +**You must always launch DCS Liberation before you launch DCS.** If you do not DCS will load the file before it is changed and Liberation will not be able to retrieve mission progress. ## Installation : -1 - Download the latest release from this repository (either the zip or exe). (Releases are listed here : https://github.com/Khopa/dcs_liberation/releases and you can find them in the Assets section) +1. Download the [latest release](https://github.com/Khopa/dcs_liberation/releases). Download the `dcs_liberation..zip` file from the Artifacts section. +2. Extract the zip file to a new directory. DCS Liberation does not need to be separately installed; the extracted directory _is_ your DCS Liberation install. This can be extracted anywhere, but it should be a directory that you can access without Administrator privileges to ensure that Liberation runs correctly. +3. Then launch `liberation_main.exe` to launch DCS Liberation. -2 - Extract the zip file to a new folder where liberation will be installed. (or use the .exe installer, however you'll have a Window security warning if you use the installer) - -3 - Then launch liberation_main.exe to launch DCS Liberation 2.0. - -DCS Liberation should launch ! - -![](https://i.imgur.com/hej6vu1.png) +![DCS Liberation first launch screenshot](https://user-images.githubusercontent.com/315852/102664953-bd030d80-4138-11eb-989b-824b7a8d4f8c.png) ## Start your first campaign In the top left corner, click on File/New Game to start the new campaign wizard. -![](https://imgur.com/XvGTF1f.png) +![New Game screenshot](https://user-images.githubusercontent.com/315852/102665743-35b69980-413a-11eb-87c4-d140a83e3b0d.png) Click on next to start campaign configuration : -![](https://imgur.com/B3iGjE3.png) +![New game wizard](https://user-images.githubusercontent.com/315852/102665683-1ae42500-413a-11eb-9e52-4257c6a8d849.png) -Choose your faction, and the ennemy faction. -I recommend USA 2005 vs Russia 1965 for an easy first scenario. +Choose your faction, and the enemy faction. For an easy first game, choose USA 2005 vs Russia 1965. -![](https://imgur.com/3lbakWi.png) +![Faction selection](https://user-images.githubusercontent.com/315852/102665647-0b64dc00-413a-11eb-95e4-9823394a505b.png) -Choose the Theater, for now please use one of the recommended one. +Choose a campaign. Note that we **strongly** recommend against any of the "full" maps as these are extremely demanding in terms of performance. "Start at mid game" will cause the player's faction to own more control points than they normally would at the beginning of the campaign. "Invert map" will allow the player to play through the campaign in the opposite direction. -![](https://imgur.com/R1Yw0zq.png) +Note that at the time of writing these two options cannot currently be used together. See [Issue 572](https://github.com/Khopa/dcs_liberation/issues/572) for more information. -Click on next, do not check "Start at mid game", this is still WIP +![image](https://user-images.githubusercontent.com/315852/102665531-d8224d00-4139-11eb-8ebf-ec139f1e4913.png) -![](https://imgur.com/wI2JEjM.png) +Select any additional generation options you'd like to use. Note that the supercarrier option can be enabled or disabled later in the game settings. -Click on finish, to start the campaign generation, it might take up to a minute or two to generate the campaign depending on selected settings. +![Generator options](https://user-images.githubusercontent.com/315852/102665937-ab226a00-413a-11eb-9d31-007047cb5a04.png) -**Note :** Someone reported random crash on this step, if it happens, relaunch the program, and try again, it should work. +Adjust difficulty and economic options as desired. Increasing enemy income and budget can increase the campaign difficulty, while reducing it can improve mission performance by reducing the number of units that the enemy can use at once. -![](https://imgur.com/W6ITnuE.png) +The player assists section allows the player to enable automatic economic management for their faction so they can focus on other aspects of the campaign. These options can be toggled later in the game settings. These options are described in detail in [the manual](https://github.com/Khopa/dcs_liberation/wiki/Auto-purchase-options). -That's it, your new campaign scenario has been generated ! +![Difficulty and economic options](https://user-images.githubusercontent.com/315852/102666226-41569000-413b-11eb-9512-fa9ad21d92a2.png) -![](https://imgur.com/VXmznT9.png) +Click finish to start the campaign generation. It may a few minutes to generate the campaign depending on selected settings. + +![Finish page](https://user-images.githubusercontent.com/315852/102666295-68ad5d00-413b-11eb-9247-084281708b3a.png) + +Your campaign has been generated! We recommend you save your game at this point. + +![Screenshot of generated campaign](https://user-images.githubusercontent.com/315852/102666347-85e22b80-413b-11eb-85e6-61fc77d2e8f2.png)