OpenSoccerMania

OpenSoccerMania is a PC port of LEGO Soccer Mania that provides a new desktop launcher and an incremental path toward an open reimplementation.

README

OpenSoccerMania football and brick icon

OpenSoccerMania

Small bricks. Big match energy.

Status: experimental Windows Direct3D 11 Python and C++ Bring your own game

A preservation and modernization project for LEGO Soccer Mania / Football Mania (PC, 2002).

Prereleases · Changelog · Getting started · Graphics · Development · Current limits

OpenSoccerMania gives your own game files a new desktop launcher and an incremental path toward an open reimplementation. The current build runs the original x86 game with version-checked compatibility patches and a native rendering bridge. It is not a completed decompilation or static recompilation.

What works today

AreaImplementation and evidence
LauncherEnglish interface, rounded controls, textured football artwork and local settings.
ImportPrivate folder imports and content-checked ISO9660/raw-sector images, with read-only mounting or bounded extraction. See supported layouts and limits; real image acceptance remains open.
PreservationPrivate copies, executable hashes, original backups and reversible version-locked startup patches.
StartupThe supported private copy reaches menus and active gameplay. An ice-field match reaches final statistics and returns to Main Menu. The City Park → Western Junction Story checkpoint survives a fresh-process reload. Broader campaign/tournament persistence and load recovery remain open.
Modern outputD3D8 commands translated to Direct3D 11 through the bundled dgVoodoo backend; native instrumentation confirmed 1920×1080 render targets with 4× MSAA.
Window modesWindowed by default, borderless and explicit fullscreen. Windowed startup was checked with unchanged desktop dimensions.
LanguagesNine text variants and eight voice directories, including Spanish. American and English share one English voice directory; selection behavior remains under investigation.

Getting started

Current prerelease: 0.1.0-pre.9 — self-contained Windows portable launcher and source. See scope and verification.

For the portable build, download the Windows portable ZIP from the release page, extract the entire folder and run OpenSoccerMania.exe as a normal user. Keep its accompanying files. The launcher includes Python and its dependencies; you supply only your own valid game ISO or game folder. The graphics backend, default configuration and supported ISO reader are included; no separate dgVoodoo or 7-Zip installation is needed. This build targets Windows x64; the original game and compatibility bridges remain x86.

Administrator permission is not required. A writable portable folder keeps data in local/ beside the launcher. If that location is protected, the launcher uses %LOCALAPPDATA%\OpenSoccerMania for its library, preferences and logs. Game profiles and legacy registry settings stay inside the private game copy; no machine-wide installation or registry write is needed. The Compatibility page opens the active data/log folders. An existing library in a protected location is preserved; import your owned source into the writable library to use it there.

For development from source:

You need your own PC game files. Original executables, discs, voices and other game assets are not part of this project's source distribution.

git clone https://github.com/MatyMeatBoy/OpenSoccerMania.git
cd OpenSoccerMania
py -3.11 -m venv .venv
.venv\Scripts\python -m pip install -r requirements.txt

Build the native components first, using LLVM-MinGW:

powershell -ExecutionPolicy Bypass -File tools/build_native.ps1 -Toolchain "path\to\llvm-mingw"

Then run .venv\Scripts\python -m opensoccermania.launcher. Python 3.11 with Tkinter, Pillow, Windows 10/11 and LLVM-MinGW are required. MinHook is vendored; SDL3 is included with its license.

Choose a folder containing an extracted disc or installed game, or choose a disc image. The launcher imports into the active data folder's library/; your source remains unchanged. Image support is detected from content, including bounded single-track raw layouts and restricted CUE files. Supported images use the included ISO9660/Joliet reader. Damaged or zero-filled executables require a supported executable donor; usable assets are retained in the private import.

The portable includes an unmodified dgVoodoo 2.87.6 x86 backend and its default configuration for this specific game modification. Imports install them into the private game copy automatically, including on a fresh PC with an empty library. The bridge preserves its backend as d3d8_backend.dll. Existing unknown graphics or input DLLs are never silently overwritten. No graphics-component file picker or separate download is part of the normal import flow.

Graphics

  • Configurable internal rendering up to 3840 x 2160 and ultrawide formats. Both 1920x1080 and 3840x2160 target allocation have been observed. Live 4K presentation and hardware acceptance remain pending. Original low-resolution cinematics retain their source detail.
  • Display requests through 240 Hz. A display refresh request is not a claim of 240 independent gameplay frames per second.
  • MSAA through 16× when supported by the GPU, and up to 16× anisotropic filtering.
  • Windowed, borderless and exclusive fullscreen presentation. F11 / Alt+Enter toggle Windowed and Borderless while preserving the internal render resolution.
  • Widescreen is enabled by default, preserving the original vertical framing and camera position. Original-ratio presentation remains selectable. The wider world view and centered UI have selected scene checks; broader HUD, cinematic and camera-transition acceptance remains open.
  • Version-checked Hor+ lens conversion preserves vertical framing; background-layer raster/depth/fog corrections address the black sky, and a separate sprite path addresses tiled-image seams. See render-layer investigation.
  • Generated blue title sidebars for 16:9 and ultrawide, with private edge-color matching for both regional titles. The original 4:3 artwork remains unchanged. See title artwork and verification; transition coverage remains experimental.
  • The version-checked stencil shadow composite covers the full output instead of the old 4:3 center; focused GPU tests preserve ordinary HUD centering. Other shadow/effect paths still need scene coverage.

The intended video policy is matching black backgrounds for opening logos, original aspect ratios for cinematics, and integer scaling where practical. HUD elements must keep their shape and adjust to the selected aspect ratio. These are acceptance requirements, not completed feature claims.

Press F1 in the game, or Start + View/Select on a controller, to open internal settings. Experimental distant-camera presets are optional; the original camera framing remains the default. Controllers use A to confirm and B to go back; connected pads remain separate from the keyboard. See controls and device limits.

VRR, FreeSync and G-SYNC depend on monitor/driver configuration. Activation has not been measured here. VRS and temporal techniques such as TAA/DLAA need renderer information and integration that this build does not yet provide.

Development

.venv\Scripts\python -m unittest discover -s tests -v
.\tools\test_native.ps1 -Toolchain "path\to\llvm-mingw"
# Also run asset-free GPU and native input integration on isolated desktops:
.\tools\test_native.ps1 -Toolchain "path\to\llvm-mingw" -Gpu

These commands run fixture-based Python and native checks without opening the game. -Gpu requires built native DLLs and uses the pinned bundled backend, fresh synthetic fixtures and isolated Win32 desktops; it never switches the input desktop. Reports and captures remain under build/tests/gpu-*/. The optional -Python argument selects the Python interpreter (the project virtual environment is the default). Window verification tools start game windows; use the isolated-desktop harness when tests must not interrupt the desktop. Local evidence and game assets stay outside source control.

To build the portable launcher, install PyInstaller==6.22.3 in the build environment and run tools/build_launcher.ps1 with the LLVM-MinGW path. Its candidate folder is build/portable/OpenSoccerMania/. Source and portable packaging tools inventory every distributed file and refuse to replace an existing archive. The explicit --smoke-test-report <path> launcher option validates bundled resources and opens/closes all four pages using temporary preferences, without starting a game.

Native code lives in native/; import, guarded patching, configuration and the launcher live in opensoccermania/. Version-checked engine hooks separate the render wait from the original simulation rate. English and American modes both selected 50 Hz and were observed near 50 simulation steps/s with rendering above that rate. See timing evidence and the work board for limits and pending checks.

Current limits

The native HUD/settings, controller bridge and graphics corrections have automated and selected owner-game checks. Physical four-controller compatibility, broad disc-image intake, full-match timer/audio equivalence, live 4K presentation and hardware VRR acceptance remain pending. See the release notes and work board for the exact verified cases.

Some character animations and goalkeeper motion were reported to look too fast or jittery at high render rates. Smooth Mode remains disabled after visual regressions; first-snapshot camera initialization stays active independently. Full animation equivalence and locked 240-FPS gameplay remain unverified. An earlier nearly black replay exit is still open; a later completed match did not reproduce it. Development tests now verify the actual private Win32 desktop, with muted test-process audio and private input, without activating the user desktop. Earlier background-only probes have the limitations documented in the work board.

Credits

  • Original OpenSoccerMania icon/favicons are in assets/branding/; regenerate them with tools/build_icons.py. The same multi-size icon is embedded in the launcher and native game window without changing original game resources.
  • Launcher styling adapted from the owner's NewSnapRecomp, with its MIT notice retained in licenses/.
  • dgVoodoo2 by Dege supplies the legacy DirectX translation used by the owner's game copy.
  • Nunito is distributed under the SIL Open Font License in licenses/Nunito-OFL.txt.

OpenSoccerMania is an independent fan project. LEGO and the original game's names and assets belong to their respective owners.

Project code is provided under MIT; see third-party notices for separate licenses.