Overview
Player variables provide a dropdown in the Control Room that lists all available players from a team roster. Use player.data expressions in FUSE to access player names, team logos, and detailed statistics like goals, tackles, and shots. This allows you to build player stats overlays that update dynamically based on which player the operator selects during a live broadcast.
You need this when building graphics that display individual player information - such as player stats lower-thirds, player profiles, or head-to-head comparison graphics.
Prerequisites
* Access to the FUSE graphics editor
* A graphic designed for player statistics display
* Player roster data with statistics configured in the LIGR platform
* Understanding of basic FUSE expression syntax
How to Add a Player Control Variable
1. In the FUSE editor, open the Control Variables panel
2. Add a new Player type variable
3. Name it descriptively (e.g., selectedPlayer) so its purpose is clear to operators
This creates a dropdown in the Control Room listing all available players. The dropdown shows the full roster of players from the teams involved in the match.
How to Bind Player Name Expressions
Create expressions to display the selected player's name:
* Use player.data.first_name to access the player's first name
* Use player.data.last_name to access the player's last name
These expressions automatically update when a different player is selected from the dropdown in the Control Room.
How to Access Player Statistics Data
FUSE provides access to detailed player statistics through the player.data object. Common statistics include goals, tackles, shots on target, passes, and more.
Use expressions like player.data.stats.goals to display specific statistics in your graphic.
How to Display Team Information
Access the selected player's team data using player.data.team expressions:
* Team name
* Team abbreviation
* Team logo URL
Use player.data.team.logo_url to display the team logo alongside the player's statistics.
How to Handle Missing Data
When a player has no data for a particular statistic, the expression returns 0 by default.
Design your graphic to handle this gracefully - either by displaying 0 or by hiding the element when data is unavailable.
How to Preview and Publish
1. Use the FUSE preview to test the player stats graphic with different player selections
2. Verify that all statistics display correctly
3. Check that the layout handles varying data lengths
4. Publish when satisfied
After publishing, the graphic appears in the Control Room with the player dropdown ready for operator use during live broadcasts.
Tips
* Player statistics data (goals, tackles, shots) comes from the LIGR platform roster - ensure stats are kept up to date
* Missing statistics return 0 by default, which is generally appropriate for numerical stats displays
* Use player.data.team.logo_url to display the player's team branding alongside their statistics
* You can combine player variables with control variables - for example, a ShowStats Boolean to toggle the stats panel on/off
* For multi-player graphics (e.g., head-to-head comparisons), add multiple Player variables (playerA, playerB) and bind each to different sections