Updated Getting started (markdown)

rabauke80 2021-11-09 17:00:55 +01:00
parent e5e7c9986b
commit 7271b468ad

@ -1,4 +1,21 @@
**The tutorial is out of date for DCS Liberation 3.0.** See the other sections of [the manual](https://github.com/dcs-liberation/dcs_liberation/wiki) for help. If you want to help us update the tutorial, [join the #doc-maintenance channel in our discord](https://discord.gg/fpJRYBV9).
09.11.2021: **The tutorial is out of date for DCS Liberation >= 3.0. updates pending**
# How to get DCS Liberation?
## Download:
You have two choices, either download a stable or a preview release:
1. [Stable release](https://github.com/dcs-liberation/dcs_liberation/releases)
2. [Preview release](https://github.com/dcs-liberation/dcs_liberation/actions/workflows/build.yml)
#
## Installation:
1. 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.
2. Then launch `liberation_main.exe` to launch DCS Liberation.
First launch splash screen
![DCS Liberation first launch screenshot](https://user-images.githubusercontent.com/67376231/140951014-5dab4087-35e5-404e-a4e5-007db927bdb6.png)
**Important Note before you launch DCS Liberation :**
@ -6,51 +23,93 @@ DCS Liberation will modify the following file in your DCS installation: `<DCS In
This file will be modified whenever DCS Liberation is opened and the original will be replaced when DCS Liberation is closed.
**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.
**You must always launch DCS Liberation before you launch DCS.**
## Installation :
If you don't, DCS will load the file before it is changed and DCS Liberation will not be able to retrieve mission progress.
#
# Start your first campaign
1. Download the [latest release](https://github.com/Khopa/dcs_liberation/releases). Download the `dcs_liberation.<version>.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.
In the top left corner, click on **File** --> **New Game** to start the new campaign wizard.
![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.
![New Game screenshot](https://user-images.githubusercontent.com/315852/102665743-35b69980-413a-11eb-87c4-d140a83e3b0d.png)
![New Game screenshot](https://user-images.githubusercontent.com/67376231/140951212-056c6ff1-21f0-47f8-8846-d3698c4af6c6.png)
Click on next to start campaign configuration :
![New game wizard](https://user-images.githubusercontent.com/315852/102665683-1ae42500-413a-11eb-9e52-4257c6a8d849.png)
![New game wizard](https://user-images.githubusercontent.com/67376231/140951605-5f377f3f-055d-4636-91e5-f63daa6066aa.png)
Choose your faction, and the enemy faction. For an easy first game, choose USA 2005 vs Russia 1965.
![Faction selection](https://user-images.githubusercontent.com/315852/102665647-0b64dc00-413a-11eb-95e4-9823394a505b.png)
Theater configuration - choose your campaign/map and start date
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.
![Theater configuration](https://user-images.githubusercontent.com/67376231/140952505-bc3dbcc3-2cea-4cf9-b5a2-9fbd9c583c7a.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.
1. Choose your campaign (implies the DCS map)
2. Campaign author & remarks
3. Performance impact
4. Invert the factions starting positions
5. Time period / starting date (start date will affect weapon availability if turned on via options at a later stage)
Choose your faction, and the enemy faction. Based on the campaign configuration, either chose the authors intended, or select any faction of your choosing.
![Faction selection](https://user-images.githubusercontent.com/67376231/140954024-397020b8-ce3f-4c67-b99b-6b71da71f205.png)
![image](https://user-images.githubusercontent.com/315852/102665531-d8224d00-4139-11eb-8ebf-ec139f1e4913.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.
![Generator options](https://user-images.githubusercontent.com/315852/102665937-ab226a00-413a-11eb-9d31-007047cb5a04.png)
![Generator options](https://user-images.githubusercontent.com/67376231/140954756-830238ea-cbcd-48f9-bb69-3014612a211e.png)
Generator settings:
* No Aircraft carriers - select if you don't want any CVNs in your campaign, even if the faction you selected has them available
* No LHA - select if you don't want any LHAs in your campaign, even if the faction you selected has them available
* Use Supercarrier module - if you own the DCS Supercarrier module, you can select which CVN type will generated in your campaign
* No Player Navy - select whether you want combat ships in your campaign being generated or not
* No Enemy Navy - select whether you want enemy combat ships in your campaign being generated or not
Mod settings:
* If you want any of these mods considered during your campaign generators, please select accordingly
* You are required to have the selected mods already installed and operational prior to DCS Liberation campaign generation
![Difficulty and economic options](https://user-images.githubusercontent.com/67376231/140956004-d4967da9-66ea-454f-a2ef-4e34eaf7d08f.png)
Economy options:
* Player income multiplier - defines the multiplier of the player per-round income which depends on the type and number of objectives held (tbd <linkToObjectives)
* Enemy income multiplier - defines the multiplier of the enemies per-round income which depends on the type and number of objectives held (tbd <linkToObjectives)
* Player starting budget - amount of available money at the beginning of the campaign, to procure aircraft / ground units
* Enemy starting budget - amount of available money at the beginning of the campaign, to procure aircraft / ground units
Player assists:
* Automate runway repairs - system will automatically repair player owned, destroyed runways if enough budget is available
* Automate front-line purchases - system will automatically buy front-line ground units
* Automate aircraft purchases - system will automatically buy aircraft
_the system currently will spend 50% on aircraft and 50% on ground unit purchases_
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.
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).
![Difficulty and economic options](https://user-images.githubusercontent.com/315852/102666226-41569000-413b-11eb-9512-fa9ad21d92a2.png)
Click finish to start the campaign generation. It may a few minutes to generate the campaign depending on selected settings.
Conclusion
![Finish page](https://user-images.githubusercontent.com/315852/102666295-68ad5d00-413b-11eb-9247-084281708b3a.png)
![image](https://user-images.githubusercontent.com/67376231/140957674-45cfd319-a2dc-4f96-b109-4bf6c0387b77.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)
Air Wing Configuration aka Squadrons
![Squadrons](https://user-images.githubusercontent.com/67376231/140958086-897dab55-f9e7-43a7-87fe-703afa32bf9e.png)
The list of available squadrons is affected by the following factors:
* Campaign configuration, done by the campaign author
* Chosen faction
* Available squadrons (custom & auto generated)
See (tbd <linkToSquadrons) for more detailed information on squadrons
If you are happy with your choices, close the squadrons window and trigger the campaign generation.
![Screenshot of generated campaign](https://user-images.githubusercontent.com/67376231/140958913-4c35cb4c-4b1f-4b39-9d2d-918d2d3bafcf.png)
Voila! Your campaign has been generated! We recommend you save your game at this point.