Full Build
Full Build generates the modified bundle files that you install in Football Manager. This is the final step before testing your skin in-game.
Running Full Build
Toolbar
Click the Build button in the toolbar.
Build button in toolbar
Screenshot ID: build-button
Menu
Build > Output > Build Skin
Build Process
Build progress panel
Screenshot ID: build-progress
Steps
- Validation - Check config and CSS syntax
- Scanning - Analyze FM bundles (uses cache after first run)
- Matching - Find selectors in stylesheets
- Patching - Apply your changes to bundles
- Assets - Process icons, backgrounds, fonts
- Output - Write modified bundles to
packages/
Progress Indicators
| Status | Meaning |
|---|---|
| Spinner | Step in progress |
| ✓ Check | Step completed |
| ⚠ Warning | Non-fatal issue |
| ✗ Error | Build failed |
Build Output
packages/ Folder
After successful build:
my-skin/
└── packages/
└── [modified .bundle files]Contents:
- Modified Unity bundle files
Packages folder contents
Screenshot ID: packages-folder
Changes Panel
The Changes panel shows what was modified:
Changes panel after build
Screenshot ID: changes-panel-build
Build Log
The Output panel shows detailed information:
[Build] Starting build...
[Build] Validating config.json ✓
[Build] Loading CSS files...
- colours/base.uss (24 variables, 3 selectors)
[Build] Scanning bundles...
- Using cache (last scan: 2 hours ago)
[Build] Matching selectors...
- :root (--primary) → 3 stylesheets
- .green → 1 stylesheet
[Build] Patching bundles...
- FMColours.bundle ✓
- UIStyles.bundle ✓
[Build] Processing assets...
- icons: 2 replacements
[Build] Writing output to packages/
[Build] Build completed successfully!Build Performance
First Build
The first build is slower because it scans all FM bundles and creates a cache:
[Build] Scanning bundles...
- Scanning 300+ bundle files
- This may take a moment...
[Build] Scan complete. Cache created.Expected time: 30 seconds to 2 minutes
Subsequent Builds
Later builds use cached scan data:
[Build] Using cache (last scan: 1 hour ago)Expected time: 5-15 seconds
Factors Affecting Speed
| Factor | Impact |
|---|---|
| First build vs cached | Major |
| Number of CSS files | Minor |
| Asset processing | Moderate |
| Debug mode enabled | Moderate |
| System speed | Moderate |
Build Options
Debug Mode
Enable in Settings to get additional output:
Debug mode toggle
Screenshot ID: debug-mode-setting
With debug mode:
- Original stylesheets extracted to
debug/original/ - Patched stylesheets to
debug/patched/ - Asset information exported
- Detailed logs
Clean Build
Force a fresh build (ignores cache):
- Clear cache in Settings
- Run Build
Use when:
- FM updated to new version
- Bundles may have changed
- Troubleshooting cache issues
Handling Warnings
Warnings don’t stop the build but indicate potential issues:
“Selector matched multiple stylesheets”
⚠ Warning: Selector '.green' matched stylesheets in multiple bundlesMeaning: Your change applies to multiple places.
Action: Expected if you want global changes. Use mapping for targeting.
”Asset not found”
⚠ Warning: Asset 'missing_icon' referenced but not foundMeaning: Mapping references non-existent asset.
Action: Check mapping.json and file names.
”Variable not matched”
⚠ Warning: Variable '--custom-var' not found in any stylesheetMeaning: CSS variable doesn’t exist in FM.
Action: Check variable name or use Asset Catalogue to find correct names.
Handling Errors
Errors stop the build:
“Invalid config.json”
✗ Error: Invalid JSON syntax in config.json at line 5Action: Fix JSON syntax errors in config file.
”CSS parse error”
✗ Error: CSS parse error in base.uss at line 12: Unexpected tokenAction: Fix CSS syntax (missing semicolons, braces, etc.).
”Cannot write output”
✗ Error: Cannot write to packages/ - permission deniedAction: Check folder permissions or close other programs using those files.
After Building
Verify Output
Check packages/ folder:
- Files should be present
- Reasonable file sizes
- Recent timestamps
Next Steps
- Apply to Game - Install in FM
- Test in FM - Verify changes work
- Iterate - Make adjustments as needed
Tips
Build Often
Small changes, frequent builds:
- Easier to identify what broke
- Faster iteration
- Less frustration
Preview First
Use Preview Build to catch errors before full build.
Check the Summary and Changes Output
Always read summary and changes output:
- Errors and warnings summarised
- Summary match counts show what’s changing by type
- Detailed overview of all changes in a table format
Check the Logs
Always read full build log output for advanced troubleshooting:
- Warnings can show additional logs
- Errors need immediate attention and you can follow the flow
- This can pinpoint issues quickly with specific files processed before errors or warnings show
Next: Applying to Game - Install your skin in FM.