SotA Companion: Android Setup Guide

By default, Shroud of the Avatar restricts the companion chat so it can only be accessed on the exact PC running the game. To view the live chat on your Android device, you need to run a lightweight Proxy Bridge on your PC and use a 1-click browser bookmark to sync your session token.

Prerequisite: Ensure your PC and your Android device are connected to the same local network (Wi-Fi).

Step 1: Find Your PC's Local IP Address

Both your browser bookmark and your Android app need to know your PC's local Wi-Fi IP address.

  1. Open a Command Prompt on your PC (Press Win + R, type cmd, and press Enter).
  2. Type ipconfig and press Enter.
  3. Look under your active network adapter (usually "Wireless LAN adapter Wi-Fi" or "Ethernet adapter").
  4. Find the IPv4 Address line (for example, 192.168.1.101) and note it down.

Step 2: Start the PC Proxy Bridge

Run the proxy script on your PC before connecting your phone so it can bridge your local network to the game.

  1. Download and install Node.js if you haven't already.
  2. Download the sota-proxy.js file to your PC (right-click and select Save link as...).
  3. In your Command Prompt, navigate to the folder where you saved the file and run it by typing:
    node sota-proxy.js
  4. Leave this Command Prompt window open while playing.
Proxy Bridge running in PowerShell
Command Prompt / PowerShell running the proxy bridge
First-Time Setup: Windows Firewall may pop up asking for permission to let Node.js communicate on your private network. Make sure to click Allow access.

Step 3: Add the 1-Click Sync Bookmark to Your PC Browser

When you launch the companion in-game, the game creates a hidden session token in your PC's web browser and immediately erases it from the address bar. Adding this bookmark lets you send that token to the Proxy Bridge with a single click.

  1. Show your PC browser's Bookmarks Bar (press Ctrl + Shift + B in Chrome, Edge, or Firefox).
  2. Right-click your Bookmarks Bar and select Add page... (or Add bookmark...).
  3. Set the Name to: Sync SotA to Phone
  4. In the URL field, paste the following code, making sure to replace 192.168.1.101 with your PC's actual IPv4 address from Step 1: 
    javascript:fetch('http://192.168.1.101:8080/sync?port='+location.port+'&token='+sessionStorage.getItem('sotaCompanionToken')).then(function(r){return r.text();}).then(alert);
Adding the Sync bookmark in the browser
Adding the 1-Click Sync bookmark to your browser favorites / bookmarks bar

Step 4: Launch the Game Chat & Sync

  1. Launch Shroud of the Avatar on your PC and log in with your character.
  2. In the in-game chat window, type:
    /companion
    In-game chat window showing /companion
    In-game chat window showing the companion bridge opened
  3. When the Companion tab opens in your PC browser, click the Sync SotA to Phone bookmark you created in Step 3.
  4. A pop-up message will confirm: Synced SotA Companion (Port ...) to LAN Proxy!
    Browser alert confirming successful sync
    Browser confirmation alert confirming the session synced with the proxy

Step 5: Connect the Android App

  1. Open the Elene Sali SotA Companion app on your Android device and go to the Live Chat view.
  2. Tap the IP Settings button in the top header.
  3. Enter your PC's IPv4 address from Step 1 followed by :8080 (for example, 192.168.1.101:8080).
  4. Tap Reconnect.

✓ Success! The status indicator in your Android app will turn green and say connected. You can now read and send in-game chat messages directly from your Android device.

Android companion app connected to in-game chat
Elene Sali SotA Companion app connected and receiving live chat on Android

Troubleshooting