diff --git a/docs/credentials_web_version.md b/docs/credentials_web_version.md new file mode 100644 index 000000000..9b5da84c5 --- /dev/null +++ b/docs/credentials_web_version.md @@ -0,0 +1,58 @@ +# FCM Credentials Documentation (Web Version) + +> To be able to use an instance of the bot properly, you need to set up your FCM Credentials. Adding these credentials makes it possible for you to pair with servers as well as connecting to them. Note that unlike the previous .exe version, the web version requires Chrome or Firefox browsers. + +## **❗️Before You Start** +> Make sure you are using **`Chrome or Firefox browsers`** before starting the credential setup process. +> This is because the web version uses browser extensions to simplify the process, which is more lightweight and convenient compared to the relatively heavy .exe application. + +## Retrieving FCM Credentials + +1. **First, navigate to the [rustplusplus-credentials page](https://rustplusplus-credentials.netlify.app/).** + +2. **Click the Install Extension button located at the top right corner of the page to install the extension, then refresh the page. (After installation, the Log In button should be visible)** + +> [rustPlusPlus-Credentials Chrome Extension](https://chromewebstore.google.com/detail/rustplusplus-credential-a/ooahmkklkanfgfmphpknpcgdpdcoikhe) + +> [rustPlusPlus-Credentials Firefox Extension](https://addons.mozilla.org/en-US/firefox/addon/rustplusplus-credential-app) + + ![rustplusplus Click Install Extension Image](images/bot_setup/click_install_extension.png) + + ![rustplusplus After Click Install Extension Image](images/bot_setup/after_click_install_extension.png) + +3. **Click the Log In button to proceed with the Steam login.** + + ![Steam Account login Image](images/bot_setup/steam_login_web.png) + +4. **After logging in, you will be redirected to the display page where the slash command will be shown `/credentials add ....`** + + ![rustplusplus Display Page](images/bot_setup/rustplusplus_display_page.png) + +5. **Click `Copy` to copy the Slash Command.** + + ![Credentials copy Image](images/bot_setup/click_copy_to_clipboard.png) + +6. **Paste the Slash Command in your Discord Server Text Channel. The specific Text Channel does not matter, as long as the bot has access to it.** + + ![FCM Credentials discord Image](images/bot_setup/credentials_discord.png) + +7. **This process is the same for the owner of the bot as well as any teammate that wants to register their credentials (mainly to extend the usage of the leader command). Once a teammate has registered their credentials, they need to go inside the game and pair with the server. Teammates paired with the server can be seen in the information channel, indicated by the P icon beside their name, as shown below:** + + ![Teammates Paired with Server](images/bot_setup/teammates_paired.png) + +## Why are FCM Credentials Necessary? + +FCM Credentials are necessary to enable the following features: + +* Server Pairing Notifications +* Smart Devices Pairing Notifications +* Smart Alarm Notifications +* Player Offline Death Notifications +* Teammate Login Notifications +* Facepunch News + +Without these, the bot would not operate properly. + +> **Note**: This process requires Chrome or Firefox browsers for the web version. Ensure your browser is up to date for the best experience. + +> Rust Companion API returns a refreshed Steam Auth Token which expires after 2 weeks. You can visit the [rustplusplus-credentials display page](https://rustplusplus-credentials.netlify.app/display) at any time to check how much time is left on your token. diff --git a/docs/documentation.md b/docs/documentation.md index ee39930e8..d5eb9b511 100644 --- a/docs/documentation.md +++ b/docs/documentation.md @@ -4,7 +4,7 @@ * [**Installation**](installation.md) * [**Discord Bot Setup**](discord_bot_setup.md) -* [**FCM Credentials**](credentials.md) +* [**FCM Credentials**](credentials.md) OR [**FCM Credentials(WebVersion)**](credentials_web_version.md) * [**Pair & Connect Server**](pair_and_connect_to_server.md) * [**Commands**](commands.md) * [**Discord Text Channels**](discord_text_channels.md) diff --git a/docs/images/bot_setup/after_click_install_extension.png b/docs/images/bot_setup/after_click_install_extension.png new file mode 100644 index 000000000..a895dc958 Binary files /dev/null and b/docs/images/bot_setup/after_click_install_extension.png differ diff --git a/docs/images/bot_setup/click_copy_to_clipboard.png b/docs/images/bot_setup/click_copy_to_clipboard.png new file mode 100644 index 000000000..db7d2feb1 Binary files /dev/null and b/docs/images/bot_setup/click_copy_to_clipboard.png differ diff --git a/docs/images/bot_setup/click_install_extension.png b/docs/images/bot_setup/click_install_extension.png new file mode 100644 index 000000000..14f351a99 Binary files /dev/null and b/docs/images/bot_setup/click_install_extension.png differ diff --git a/docs/images/bot_setup/rustplusplus_display_page.png b/docs/images/bot_setup/rustplusplus_display_page.png new file mode 100644 index 000000000..9844b19a3 Binary files /dev/null and b/docs/images/bot_setup/rustplusplus_display_page.png differ diff --git a/docs/images/bot_setup/steam_login_web.png b/docs/images/bot_setup/steam_login_web.png new file mode 100644 index 000000000..c6f9bcc52 Binary files /dev/null and b/docs/images/bot_setup/steam_login_web.png differ