diff --git a/Docs/Userdocs/first_time_setup.md b/Docs/Userdocs/first_time_setup.md new file mode 100644 index 0000000000..f0d0d6de2c --- /dev/null +++ b/Docs/Userdocs/first_time_setup.md @@ -0,0 +1,18 @@ +# First-Time Setup + +If you have a previous SM5 installation using GrooveStats Launcher, follow the [StepMania 5.1 to ITGmania Migration Guide](./sm5_migration.md). + +Otherwise, all you need to do is configure `GrooveStats.ini` in your profile folder as originally documented for the [GrooveStats Launcher](https://github.com/GrooveStats/gslauncher/blob/main/README.md). This can be done in one of two ways: + +1. Enter the Music Select screen when logged into a profile. This will automatically generate the file for you. +2. Identify your LocalProfile, and manually create a GrooveStats.ini with the following contents: + ``` + [GrooveStats] + ApiKey=YOUR_API_KEY + IsPadPlayer=1 + ``` + `IsPadPlayer=1` indicates that you are playing on a pad (and not a keyboard). If you're using a keyboard, then set this to 0. In that case your scores will not be submitted to GrooveStats, but other functionality will be active. + +To obtain your API key to make requests to the GrooveStats service, log into your GrooveStats account and visit the [Update Profile](https://groovestats.com/index.php?page=register&action=update) page to generate and copy your API key. Paste the API key after the `ApiKey=` in the `GrooveStats.ini` file. + +![GS API Key](./images/gs-api-key.png) diff --git a/Docs/Userdocs/images/gs-api-key.png b/Docs/Userdocs/images/gs-api-key.png new file mode 100644 index 0000000000..f63caba05b Binary files /dev/null and b/Docs/Userdocs/images/gs-api-key.png differ diff --git a/Docs/Userdocs/sm5_migration.md b/Docs/Userdocs/sm5_migration.md index a421913d5e..2eb0850f5a 100644 --- a/Docs/Userdocs/sm5_migration.md +++ b/Docs/Userdocs/sm5_migration.md @@ -1,7 +1,7 @@ StepMania 5.1 to ITGmania Migration Guide ========================================= -This guide explains how to migrate from StepMania 5.1 to ITGmania without losing access to your settings and songs. +This guide explains how to migrate from StepMania 5.1 to ITGmania without losing access to your settings and songs. If you don't have an existing SM5 setup and are starting from scratch, follow [First-Time Setup](./first_time_setup.md) instead. The steps are as follows: