Setup Instructions

Follow these steps to set up automatic stat tracking for your streams.

Requirements

Setup Time: 5-15 minutes

GameStats Setup Instructions

Follow these step-by-step instructions to get your streaming analytics up and running.

Expand All Steps
1

Install GameStats

Easy

Download and run our all-in-one installer that automatically sets up everything you need.

  1. Download the "GGWP.Live GameStats Installer" zip file from the downloads page
  2. Extract the zip file to a temporary location (like your Desktop or Downloads folder)
  3. Double-click "Run-GGWP-GameStats-Installer.bat" to start the installation:
  4. Click "Yes" when Windows asks for administrator privileges
  5. The installer will automatically:
    • Install Tesseract OCR (if not already installed)
    • Install Streamer.bot to C:\Streamer.bot\ (if not already installed)
    • Copy GGWP DLLs and GameStats files
    • Create "Streamer.bot" desktop shortcut
  6. Wait for the "Installation completed successfully!" message:

Note: The installer is safe to run multiple times (i.e. for upgrades) and won't overwrite your existing Streamer.bot settings.

2

Download API & License Keys

Easy

Your API key enables the software to update your statistics. Your license determines which features you can access.

2a. Download API Key

  • Go to your licensing page and download config.json
  • Save the API file to: C:\Streamer.bot\ggwp.live\config.json

2b. Download License Key

  • Go to your licensing page and download ggwp_license.json
  • Save the license file to: C:\Streamer.bot\ggwp.live\ggwp_license.json

Important: Keep your API Key and License file secure and don't share them with others.

3

Configure Streamer.bot

Medium

Streamer.bot is the core application that connects everything together. We installed this in Step 1.

3a. Configure Streamer.bot

  • Follow the "Initial Setup Guide" link above to connect Streamer.bot to your OBS instance, and connect your streaming platform(s)

3b. Link "Capture Stash Value" Action to Your Game

Configure your game capture settings: Streamer.bot needs to know your OBS Scene and Source for game capture:

  • In Actions select "Capture Stash Value"
  • Double-click the first sub-action "OBS Studio Take Screenshot..."
  • Select your OBS Scene and Source which has your game capture and click OK:

3c. Choose Stats Session Trigger Method

You can have your stats session start automatically or control it manually:

Auto-Start (default)

Automatically starts your stats session when OBS goes Live or starts Recording

Manual Control

Use Stream Deck buttons to control stats session

  • If you prefer manual control, disable the Trigger for both the "Start Stats Session" and "End Stats Session" Actions:

You can right click the taskbar icon for Streamer.bot and 'Pin to taskbar' for ease of use to open next time.

4

Configure Stream Deck

Medium

Set up Stream Deck buttons for easy control of your stats tracking.

Install Streamer.bot plugin Configure Streamer.bot instance

4a. Install Streamer.bot Plugin

  • Open Stream Deck software
  • Follow the instructions in the "Install Streamer.bot plugin" link above

4b. Configure Streamer.bot Instance

  • Follow the instructions in the "Configure Streamer.bot instance" link above

4c. Create Control Buttons

"Capture Stash" Button
  • Drag Streamer.bot "Action" to a spare Stream Deck button:
  • Under the button's Actions choose an "Action:" of "Capture Stash Value" (the dropdown lists all the Actions from Streamer.bot - if it's not listing any actions then you probably need to "Configure Streamer.bot instance" - link above):
  • Set custom icon:
    (right click the image above and choose "Save image as..." to download locally and set as your Stream Deck button)
"Start/End Stats" Buttons (Optional)

Only if you chose "Manual Control" in Step 3c

  • Create action: "Start Stats Session":
  • Repeat the above step with another Stream Deck button for the "End Stats Session"
5

Test Your Setup

Easy
  1. Verify everything is working correctly before going live.
  2. The easiest way to test your stats session is by clicking "Start Recording" button in OBS (by default we start a stats session when OBS is live or recording, ref Step 5d).
  3. Then go to your page and you should see that your stats session is "Live":
  4. Launch Delta Force Operations and go to your Profile page that shows your Total Assets, and then press your Stream Deck button to "Capture stash":
  5. You should now see your latest stash value updated in your page:
  6. Optional: If you want your profit/loss showing on your stream, you have two options:
    • OBS Overlay Browser Source: follow the instructions on the OBS Overlay page to customize your overlay and add it to your OBS Scene:
    • Animated OBS Overlay: Follow the OBS Animation Setup Guide here.

Testing Checklist:

🔧 Troubleshooting

Stats not appearing?

  • Check your license file is in the correct location
  • Verify Tesseract is installed correctly
  • Ensure both OBS and Streamer.bot are open and connected

Streamer.bot errors?

  • Make sure all DLL files are imported
  • Check Windows Defender isn't blocking files
  • Run Streamer.bot as administrator

Stream Deck button not working?

  • Restart Stream Deck software
  • Check Streamer.bot plugin is installed
  • Verify Streamer.bot is connected

Follow these steps to set up animated stat values in OBS Studio. This creates smooth animations when your stash value and stream profit change during your broadcasts.

Requirements

Setup Time: 3-9 minutes

OBS Animation Setup Instructions

Create smooth animations for your profit tracking that will impress your viewers.

Expand All Steps

Gold License Required

Upgrade to Gold or Red to unlock animated OBS overlays with smooth counting animations.

Upgrade to Gold
1

Create Text Sources in OBS

Easy

Create three text sources in OBS Studio with specific names that the animation script will recognize.

  1. Open OBS Studio and go to your streaming scene
  2. Add three "Text (GDI+)" sources with these exact names:
    Stash Value - displays your current total assets
    Stream Profit - displays positive profit (recommend green color)
    Stream Loss - displays negative profit (recommend red color)
  3. Position the "Stream Profit" and "Stream Loss" sources in the exact same location (only one will be visible at a time - this is so that it shows a smooth transition from e.g. a negative red value to a positive green value)
  4. Style each text source with your preferred font, size, and colors

Important: The source names must be exactly as shown above for the script to work properly.

2

Download Animation Script

Easy

Download the Lua animation script that creates smooth counting animations for your statistics.

  1. Download the "GGWP.Live OBS Animated Values Script" from the downloads page
  2. Extract the ggwp-animated-values.lua file
  3. Copy the file to your OBS scripts folder:
    Default Windows location:
    C:\Program Files\obs-studio\data\obs-plugins\frontend-tools\scripts\
    Portable OBS:
    [OBS folder]\data\obs-plugins\frontend-tools\scripts\
3

Install Script in OBS

Easy

Add the animation script to OBS Studio so it can control your text sources.

  1. In OBS Studio, go to Tools → Scripts
  2. Click the "+" button to add a new script
  3. Navigate to where you saved ggwp-animated-values.lua and select it
  4. Click "OK" to add the script
  5. The script should appear in your scripts list and be automatically loaded

Note: If you created the text sources with the correct names in Step 1, the script should work immediately with default settings.

4

Configure Animation Settings (Optional)

Easy

Customize how your animated statistics look and behave. The default settings work great, but you can personalize them to match your style.

  1. In the Scripts window, select the "Animated Stat Counter" script
  2. Configure the settings in the right panel

Text Source Names

  • Stash Value Text Source: "Stash Value" (default)
  • Stream Profit Text Source: "Stream Profit" (default)
  • Stream Loss Text Source: "Stream Loss" (default)

Animation Settings

  • Animation Duration: 4.0 seconds (default)
  • Update Frequency: 33ms (~30fps, default)

Number Formatting

  • Add Commas for Thousands: ✓ Enabled (default)
  • Decimal Places: 2 (default)
  • Million Suffix Text: " million " (default)
  • Show '+' for Profit: ✓ Enabled (default)

File Checking

  • Enable File Checking: ✓ Enabled (default)
  • File Check Interval: 5.0 seconds (default)

File paths are automatically configured to match your GameStats setup.

5

Test Your Animated Statistics

Easy

Test that everything is working correctly and see your animations in action.

  1. Make sure your GameStats system is running (from the main setup guide)
  2. Start a stats session by going live or recording in OBS
  3. Capture your stash value using your Stream Deck button
  4. Watch for smooth animations in your text sources
  5. Test profit changes to see the color-coded animations

Testing Checklist:

🔧 Troubleshooting

Script not loading?

  • Check the lua file is in the correct scripts folder
  • Restart OBS Studio after adding the script
  • Verify text sources have exact names: "Stash Value", "Stream Profit", "Stream Loss"

No animations showing?

  • Ensure your main GameStats system is working
  • Check file paths in script settings
  • Try manually updating a text source value to test

Wrong colors showing?

  • Check "Stream Profit" and "Stream Loss" sources are in same position
  • Verify profit source is green and loss source is red
  • Only one profit/loss source should be visible at a time

🎨 Customization Tips

Animation Speed

Adjust "Animation Duration" for faster (1-2 seconds) or slower (5-8 seconds) counting animations.

Number Format

Change "Million Suffix Text" to "M" for a shorter display, or "m" for lowercase styling.

Profit Display

Disable "Show '+' for Profit" if you prefer not to show the plus sign on positive values.

Font Styling

Use bold fonts and drop shadows on your text sources to make them stand out on stream.

Set up Stream Deck buttons that increment/decrement a counter displayed on your stream via OBS text overlay, with the current count also shown on the Stream Deck button itself.

Requirements

Setup Time: 5-10 minutes

Red Counter Setup Instructions

Create Stream Deck buttons to control a live counter display on your stream.

Expand All Steps

Purple License Required

Upgrade to Purple to unlock Stream Deck counter controls with live display updates.

Upgrade to Purple
1

Install Streamer.bot Actions

Easy

Download and import the Red Counter Actions into your Streamer.bot installation.

  1. Download the "Red Counter Streamer.bot Import Code" file from the downloads page
  2. Extract the downloaded file and open the Red Counter Streamer.bot Import Code.txt file
  3. Copy all the text from the file (Ctrl+A, Ctrl+C)
  4. Open Streamer.bot and click the Import button
  5. Paste the copied import code (Ctrl+V) into the import field
  6. You'll see 3 new Actions - click the Import button to add them:
    • Red Counter - Increment
    • Red Counter - Decrement
    • Red Counter - Reset

Note: These Actions will control your counter and update both the OBS overlay and Stream Deck button displays.

2

Add Stream Deck Buttons

Easy

Create three Stream Deck buttons to control your Red Counter.

Add three Streamer.bot Action buttons to your Stream Deck:

1st Button: Main Reds Counter (Increment)
  1. Drag the Streamer.bot "Action" to a Stream Deck button:
  2. Note: If you don't see the Streamer.bot Action you might be missing the plugin - follow the Game Stats "4a. Install Streamer.bot Plugin" guide.

  3. Set your button styling. In our example:
    • Font Size: 18 pt
    • Text Color: White
  4. Set the button Title to "Reds 0"
  5. Set the button Background Color: Red (#aa0000)
  6. Set the Action to: "Red Counter - Increment"
2nd Button: Decrement Counter
  1. Drag another Streamer.bot "Action" to a Stream Deck button
  2. Set the Action to: "Red Counter - Decrement"
  3. Style as desired (we recommend a minus symbol)
    (right click the image above and choose "Save image as..." to download locally and set as your Stream Deck button)
3rd Button: Reset Counter
  1. Drag another Streamer.bot "Action" to a Stream Deck button
  2. Set the Action to: "Red Counter - Reset"
  3. Style as desired (we recommend a reset/zero symbol)
    (right click the image above and choose "Save image as..." to download locally and set as your Stream Deck button)
3

Setup OBS "Red Counter" Overlay

Easy

Create text sources in OBS to display your Red Counter on stream.

3a. Create Counter Number Source

  • In OBS, go to your main streaming scene
  • Add a new "Text (GDI+)" source
  • Name it exactly: "RedCounterText" (this exact name is required for the Streamer.bot actions to work)
  • Set the text to "0" temporarily to see the styling
  • Configure your font styling. In our example:
    • Font: Arial
    • Font Style: Black
    • Size: 45
    • Color: White
  • Click OK to save

3b. Create Title and Background

  • Add another "Text (GDI+)" source (name can be anything, we used "Red Counter Title") and drag this source under your "RedCounterText" source layer
  • Set the text to: " REDS:   " (include extra spaces to expand the background color)
  • Configure the same font styling:
    • Font: Arial Black
    • Size: 45
    • Text Color: White
    • Background Color: Red (#aa0000) or your preferred color
  • Position the layers in the OBS Preview

Note: The "RedCounterText" source name is case-sensitive and must be exact for the Streamer.bot integration to work.

4

Link Stream Deck to Streamer.bot

Easy

Link actions, buttons and OBS together.

2b. Configure Button IDs

Link your Stream Deck buttons to the Streamer.bot Actions for display updates:

  1. Click your Main Increment button in Stream Deck software
  2. In the button's action settings, copy the "Button ID" value
  3. Go to Streamer.bot, select the "Red Counter - Increment" Action:
    1. In the Sub-Actions panel, double-click the "OBS Studio GDI Text" sub-action:
    2. Change the Scene to your main OBS Scene and click OK
    3. In the Sub-Actions panel, double-click the "Stream Deck Set Title" sub-action:
    4. Paste the Button ID value you copied into the "Button ID" field and click OK
  4. Repeat the same process for the "Red Counter - Decrement" and "Red Counter - Reset" Actions:
    1. Update each of these two remaining Action's sub-actions "OBS Studio GDI Text" and "Stream Deck Set Title" with your OBS Scene, and your Button ID

Note: Make sure you set both the OBS Source ("OBS Studio GDI Text") and Button ID ("Stream Deck Set Title") for the three actions.

5

Test Your Buttons

Easy

Verify that your Red Counter system is working correctly.

  1. Make sure both OBS and Streamer.bot are running
  2. Press your Stream Deck button labeled "Reds 0"
  3. The button should update to show "Reds 1"
  4. The OBS overlay should also update to show "1"
  5. Press the button multiple times to test increments
  6. Test the decrement button (it should reduce the count by 1)
  7. Test the reset button (it should set the count back to 0)

Testing Checklist:

🔧 Troubleshooting

Button not updating display?

  • Check that Button ID is correctly copied to Streamer.bot
  • Verify Stream Deck plugin is connected to Streamer.bot
  • Restart Stream Deck software if needed

OBS text not updating?

  • Ensure text source is named exactly "RedCounterText"
  • Check OBS is connected to Streamer.bot
  • Verify the text source is in the correct scene

Actions not working?

  • Make sure all three Actions were imported correctly
  • Check Streamer.bot logs for any errors
  • Verify Stream Deck actions are linked to correct Streamer.bot Actions

🎨 Customization Tips

Button Styling

Customize your Stream Deck buttons with different colors, fonts, and icons to match your brand.

OBS Positioning

Position your counter overlay wherever looks best on your stream layout - corners, bottom, or integrated into your design.

Multiple Counters

You can create multiple independent counters by duplicating the Actions and using different OBS text source names.

Hotkeys

If you don't have a Stream Deck, you can assign hotkeys to these Actions in Streamer.bot for keyboard control.

Follow these comprehensive setup instructions to get your GameStats software up and running.