Let your IoT lights flash in your team colors when you hit a goal in Rocket League.

goal-lights is heavily based on lifelights made by jjensn. I had the idea to let my desk lamp flash whenever I hit a goal in Rocket League. When I saw jjsesn solution I had to adapt it to work with Rocket League. All I did was switch the watcher to detect changes in the goal display. If you want to control your IoT lights with game health bars head over to lifelights!

• Microsoft Windows
• Python 2.7 (link)
• API endpoint to control lights, like Home Assistant

• Clone this repository to a directory on your machine (how-to)
• Start > cmd > cd to the source code directory
• pip install -r requirements.txt

• Not compatible with OSX
• Game must be run as "windowed fullscreen" or "windowed"
• API POST requests will always be in JSON format
• Rocket League scale factor has to be 1.0

Currently there is no input sanitation or verification, so drifting from the guidelines below will likely break the script.

• window_title (string): Title of the window that will be monitored

• scan_interval (float): Interval in seconds to take a screenshot

• watchers: List of different 'watchers' to calculate.

  • name (string): Common name of what you are monitoring. Used for logging but can be anything that makes sense to you
  • change_threshold (float): Percentage (0.0 - 1.0) that determines when a goal is detected and an API request should fire off. If there is change in 8% (0.08) of the pixels to the previous capture of the goal number it is considered to be a goal.
  • requests: List of RESTful events that should be fired when the change_threshold is passed
    • endpoint (string): API endpoint
    • method (string): POST or GET
    • delay (float): Interval in seconds to sleep after sending the API request. Use 0.0 for no delay.
    • payloads: Collection of keys/values to send to the API endpoint. Currently supports the following special values:
      • RGB_PLACEHOLDER: Array of an RGB color (is set automatically to your team color)

The program takes a screenshot of the left goal number, displayed on the top of the ingame screen. It cannot detect if a game has started or not, so it will take screenshots even when you are in the menu. It compares the number of changed pixels to the previous screenshot. If the percentage of changed pixels is higher than the configured threshold it is considered to be a goal.

To compare the changed pixels the screenshot is converted to grayscale, blurred, a threshold is applied and compared to the previous image.

For example when you play and no goal is detected the images of the steps look like this:

When the number changes from 0 to 1 the difference is significant:

If a goal is detected the average color of the screenshot is calculated to get the team color. Then an API call is made to Home Assistant to trigger the lights.