Overview
Player variables provide a powerful way to display player-specific statistics and information in FUSE graphics. This guide covers adding player control variables, using player.data expressions to access player names, team logos, and detailed statistics (goals, tackles, shots), and handling missing data gracefully — all essential for building player stats overlays for live broadcasts.
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
Step 1: Add a Player control variable
In the FUSE editor, open the Control Variables panel and add a new Player type variable. This creates a dropdown in the Control Room listing all available players. Name it descriptively (e.g., selectedPlayer) so its purpose is clear to operators.
Step 2: Bind player name expressions
Create expressions to display the selected player's name. Use player.data.first_name and player.data.last_name to access the player's name fields. These expressions automatically update when a different player is selected.
Step 3: 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.
Step 4: Display team information
Access the selected player's team data using player.data.team expressions. This includes team name, abbreviation, and logo URL. Use player.data.team.logo_url to display the team logo alongside the player's statistics.
Step 5: 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.
Step 6: Preview and publish
Use the FUSE preview to test the player stats graphic with different player selections. Verify that all statistics display correctly and that the layout handles varying data lengths. Publish when satisfied.
Where player data comes from
Player roster data and statistics are configured in the Assets section of the LIGR platform. Navigate to Assets, then Players to add players to team rosters. Player data includes first name, last name, graphics position name, player number, position type, and player photo.
When player rosters are configured for teams in your match, you can assign match facts to specific players. Without player data, you cannot access player statistics in FUSE expressions.
Available player data fields
FUSE expressions can access the following player information through the player.data object:
* player.data.first_name
* player.data.last_name
* player.data.stats.goals
* player.data.stats.tackles
* player.data.stats.shots
* player.data.team.logo_url
* player.data.team.name
* player.data.team.abbreviation