1
0
mirror of https://github.com/EDCD/EDMarketConnector.git synced 2025-07-14 15:41:09 +03:00

Actually outline what a new user must do.

* Emphasise what a user needs to do for EDMC to start working.
* Ask for issues if people see weirdness during the Frontier
  Authorization flow.
Athanasius 2020-07-11 22:55:32 +01:00
parent 794486d0c3
commit 3d033de21c

@ -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). might encounter. See also [Troubleshooting](Troubleshooting.md).
## You need to have logged into the game at least once ## 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 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 name for your Commander, you will not be able to access all of the
settings for this application. This notably includes: 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 think you've never logged in. It uses the *latest* Journal file to
determine the Commander name to use. determine the Commander name to use.
## First time Commander So, if in doubt, run Elite Dangerous (with or without Horizons or any
If it is your very first time playing Elite Dangerous then need to other expansion) and log all the way in (i.e. select 'Open Play',
have completed the initial tutorial to the point where you dock 'Private Group', or 'Solo' mode and end up in space, docked at a
your ship in a different star system and get awarded your pilots station, or on a planet/moon surface).
license. This will trigger you having to choose your Commander name, as
well as a few other things.
At this stage this application knows enough to ask your to authorize it
to utilise the Frontier CAPI service, necessary for several functions of ## Some Frontier Authentication Quirks
this application. 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 *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.* twice. Just ignore the first tab/window and use the second.*
See [Issue #583](https://github.com/EDCD/EDMarketConnector/issues/583). 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 Once you've entered your Frontier Account credentials and approved this
application's request for access with the 'Approve' button the browser 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 tab will not change, just close it once you've confirmed it worked as