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-by-Step Guide
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.
Tips & Best Practices
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.
Related Articles
Setting Up Player Images in FUSE
Adding a Control Variable in FUSE
Exporting & Importing Fuse Expressions
