diff --git a/New-user-guide.md b/New-user-guide.md index cad4119..b0fe2d6 100644 --- a/New-user-guide.md +++ b/New-user-guide.md @@ -6,6 +6,14 @@ For now it's mostly going to document the various caveats and issues you might encounter. See also [Troubleshooting](Troubleshooting.md). ## You need to have logged into the game at least once +The very first thing you should so is ensure you have logged into the +game fully, including having chosen Commander name, at least once. + +If you're a completely new player this will entail playing through the +initial tutorial until you've jumped to another system and docked. It +is at this point that you're awarded your Pilot's License and are +prompted to choose a Commander name (and a few other things). + Until you have fully logged into the game, including having chosen a name for your Commander, you will not be able to access all of the settings for this application. This notably includes: @@ -17,21 +25,31 @@ NB: Moving/Deleting all your Journal files will make this application think you've never logged in. It uses the *latest* Journal file to determine the Commander name to use. -## First time Commander -If it is your very first time playing Elite Dangerous then need to -have completed the initial tutorial to the point where you dock -your ship in a different star system and get awarded your pilots -license. This will trigger you having to choose your Commander name, as -well as a few other things. +So, if in doubt, run Elite Dangerous (with or without Horizons or any +other expansion) and log all the way in (i.e. select 'Open Play', +'Private Group', or 'Solo' mode and end up in space, docked at a +station, or on a planet/moon surface). -At this stage this application knows enough to ask your to authorize it -to utilise the Frontier CAPI service, necessary for several functions of -this application. + +## Some Frontier Authentication Quirks +Once this application knows your Commander name it will prompt you to +authorize it to use the Frontier CAPI service by opening a web browser +window/tab. *There is a known bug where the browser tab/window for this might open twice. Just ignore the first tab/window and use the second.* See [Issue #583](https://github.com/EDCD/EDMarketConnector/issues/583). +We have also had reports of the application acting weirdly during the +Frontier Authorization flow. Please [report an issue](https://github.com/EDCD/EDMarketConnector/issues/new/choose) +if you experience any weirdness with this! In particularly we'll need +to know your default web browser, any anti-virus of software firewalls +installed and active on your system and the contents of your +`%TEMP%\EDMarketConnector.log` immediately after you experience the +problem. + + +## After you have Authorized the Application Once you've entered your Frontier Account credentials and approved this application's request for access with the 'Approve' button the browser tab will not change, just close it once you've confirmed it worked as