How itsjokerzz/ps4-bo3-customs works
FFPorter converts BO3 PC custom maps into PS4 fastfiles and companion assets, while a separate PS4 SPRX makes converted user maps discoverable and provides in-game selection and input support. The main workflow is desktop selection of a PC map, CLI conversion through native loading, asset rewriting and zone/stream output, then copying the result to console storage and loading it in BO3. The graph preserves the converter’s distinct processing stages and the SPRX’s runtime features. Edges are limited to README statements and relationships visible in the provided excerpts or SOURCE INDEX; unsampled implementation details are not asserted.
Main entry points: T7Cli.cs T7 commands · main.cpp SPRX startup · T7ZonePort.cs Zone conversion · t7_maps.cpp Map discovery
Components 30
Desktop experience
- Desktop UI
Tool/src/FFPorter.Desktop.Shared/MainWindow.xaml.cs - Backend process
Tool/src/FFPorter.Desktop.Shared/Services/BackendProcess.cs
Map conversion
- CLI routing
Tool/src/FFPorter.Cli/Program.cs - T7 commands
Tool/src/FFPorter.Cli.T7/T7Cli.cs - Native game loaders
Tool/src/FFPorter.Core.T7/Harness/T7NativeTasks.cs - Asset traversal
Tool/src/FFPorter.Core.T7/Harness/T7Walk.cs - Walk index
Tool/src/FFPorter.Core.T7/Link/T7WalkIndex.cs - Zone linking
Tool/src/FFPorter.Core.T7/Link/T7ZoneBuilder.cs - Zone conversion
Tool/src/FFPorter.Core.T7/Port/T7ZonePort.cs - Asset catalog
Tool/src/FFPorter.Core.T7/T7AssetTypes.cs - World conversion
Tool/src/FFPorter.Core.T7/Port/Converters/T7GfxWorldConverter.cs - Shader translation
Tool/src/FFPorter.Core.T7/Shaders/T7DxbcTranslator.cs - Stream conversion
Tool/src/FFPorter.Core.T7/Streams/T7StreamConvert.cs - XPak format
Tool/src/FFPorter.Core.T7/Streams/XPak.cs - Sound conversion
Tool/src/FFPorter.Core.T7/Sound/T7SoundConvert.cs - Sound bank
Tool/src/FFPorter.Core.T7/Sound/T7SoundBank.cs - Movie validation
Tool/src/FFPorter.Core.T7/Formats/T7Movie.cs - Movie transcoder
Tool/src/FFPorter.Core.T7/Formats/T7MovieTranscoder.cs - Fastfile format
Tool/src/FFPorter.Core.T7/T7FastFile.cs - Fidelity reporting
Tool/src/FFPorter.Core.T7/Port/T7Fidelity.cs
Console runtime
- SPRX startup
SPRX/main.cpp - Map discovery
SPRX/t7_maps.cpp - Lua integration
SPRX/t7_lua.cpp - Map imagery
SPRX/t7_mapimages.cpp - Keyboard mouse
SPRX/t7_kbm.cpp - Runtime logging
SPRX/t7_log.cpp
Shared support
- Workspace paths
Tool/src/FFPorter.Core/Workspace.cs - Fidelity tracker
Tool/src/FFPorter.Core/Common/Fidelity/FidelityTracker.cs
Other components
- Map porter
- BO3 on PS4
Connections 26
- Map porter → Desktop UI: selects maps
Tool/src/FFPorter.Desktop.Shared/MainWindow.xaml.cs - Desktop UI → Backend process: starts conversion
Tool/src/FFPorter.Desktop.Shared/MainWindow.xaml.cs - Backend process → CLI routing: launches
- CLI routing → T7 commands: routes commands
Tool/src/FFPorter.Cli/Program.cs - T7 commands → Native game loaders: invokes loaders
Tool/src/FFPorter.Cli.T7/T7Cli.cs - T7 commands → Workspace paths: locates files
Tool/src/FFPorter.Cli.T7/T7Cli.cs - Native game loaders → Asset traversal: records traversal
- Walk index → Asset traversal: reads records
Tool/src/FFPorter.Core.T7/Link/T7WalkIndex.cs - Zone linking → Walk index: uses index
Tool/src/FFPorter.Core.T7/Link/T7ZoneBuilder.cs - T7 commands → Zone conversion: runs conversion
Tool/src/FFPorter.Cli.T7/T7Cli.cs - World conversion → Asset catalog: classifies assets
Tool/src/FFPorter.Core.T7/Port/Converters/T7GfxWorldConverter.cs - World conversion → Stream conversion: rewrites streams
Tool/src/FFPorter.Core.T7/Port/Converters/T7GfxWorldConverter.cs - Stream conversion → XPak format: converts entries
Tool/src/FFPorter.Core.T7/Streams/T7StreamConvert.cs - Sound conversion → Sound bank: reads banks
Tool/src/FFPorter.Core.T7/Sound/T7SoundConvert.cs - Movie transcoder → Movie validation: parses video
Tool/src/FFPorter.Core.T7/Formats/T7MovieTranscoder.cs - T7 commands → Movie validation: checks compatibility
Tool/src/FFPorter.Cli.T7/T7Cli.cs - Zone conversion → Fidelity reporting: reports fidelity
- Fidelity reporting → Fidelity tracker: updates grades
Tool/src/FFPorter.Core.T7/Port/T7Fidelity.cs - Zone conversion → Fastfile format: writes output
- Map porter → BO3 on PS4: copies map and launches
- BO3 on PS4 → SPRX startup: loads plugin
- SPRX startup → Map discovery: installs map hooks
- Map discovery → Lua integration: integrates scripts
SPRX/t7_maps.cpp - Map discovery → Map imagery: uses map images
SPRX/t7_maps.cpp - SPRX startup → Keyboard mouse: installs input support
- SPRX startup → Runtime logging: logs runtime