ClaudeandClaude Opus 5.5 baa3562eab Fix two data tests and the Windows package allowlist for 0.1
- ui_series_records_tests installs the authored fixture tables, since the
  public tree no longer carries built-in schedule tables (uncaught throw).
- training_camp_app_tests no longer compares against the removed built-in
  resort constants; it checks that the content comes from the EXE.
- make_package.py accepts the api-ms-win-core forwarders that the
  app-local UCRT redist installs (Windows CI packaging failure).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 21:57:42 +02:00

OpenBMH

A modern and faithful open source rebuild of the Bundesliga Manager Hattrick engine.

OpenBMH is a standalone C++20 engine with an SDL2 interface for Bundesliga Manager Hattrick (1994/95) and its English edition, Football Limited. The project develops a playable reconstruction alongside a platform for new rules, content and interfaces. Keeping the familiar game enjoyable and making it easier to extend are equally important goals.

The engine reads a game installation supplied by the player. Game data, artwork, music, manuals and the original executable are not distributed with OpenBMH. Its aim is recognisable behaviour and plausible results; documented compatibility decisions and safety fixes take precedence over reproducing every original fault.

This is an independent community project, with no affiliation with or endorsement by the original rights holders, the DFL or the Bundesliga. It is an engine implementation, not an official source release or a remaster.

Get started

Check the releases page for available packages and their platform notes. A Windows package uses the name OpenBMH-<version>-windows-x64.zip. Availability and native validation are stated for each release; source build instructions do not establish platform support on their own.

  1. Have your own supported game installation available.
  2. Extract the OpenBMH package into a separate directory, or alongside the game files.
  3. Start openbmh_play (openbmh_play.exe on Windows). Select the game directory or executable when prompted. A ZIP or 7z containing one game installation can also be selected.

From a terminal:

openbmh_play --data "path/to/game" --save-directory "path/to/saves"
openbmh_cli --console --data "path/to/game" --saves "path/to/saves"

Use a writable save directory and keep backups of existing games. German editions are the primary compatibility target. Football Limited / English data support is experimental; original V2.20 save import and some edition-specific behaviour remain limited. See the 0.1 release notes.

Features and direction

The graphical client and console share career management, matches, transfers, contracts, finances, training, stadium management and save handling. The console supports command batches, structured views and multiple manager clients. Audio is decoded from the user's installation where supported.

Version 0.1 establishes the playable engine and development interfaces. Later milestones introduce an open data format and typed model, configurable rules, a scalable interface and independently distributable content. These are goals rather than delivery dates; the roadmap describes their dependencies.

Build from source

The following recipes target v0.1.0. They require Git, CMake 3.24 or newer and a C++20 compiler. The first configure fetches pinned open-source dependencies. Native build and package results are documented for each release; these instructions do not claim an untested platform result.

Clone the public repository, then run the commands for your system:

git clone https://github.com/rezmer/openbmh.git
cd openbmh

Windows

Install Visual Studio 2022 or its Build Tools with Desktop development with C++, a Windows SDK and CMake. From Developer PowerShell, using the Visual Studio generator:

cmake -S . -B build-windows -G "Visual Studio 17 2022" -A x64
cmake --build build-windows --config Release
ctest --test-dir build-windows -C Release --output-on-failure
.\build-windows\Release\openbmh_play.exe --data "path/to/game" --save-directory "path/to/saves"

Linux

On Debian or Ubuntu, install the compiler and development libraries. This example uses the default GTK3 file dialog backend:

sudo apt install build-essential git cmake ninja-build pkg-config libgtk-3-dev libx11-dev libxext-dev libxrandr-dev libxcursor-dev libxi-dev libxfixes-dev libxss-dev libasound2-dev libpulse-dev libgl1-mesa-dev libudev-dev
cmake -S . -B build-linux -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build-linux
ctest --test-dir build-linux --output-on-failure
./build-linux/openbmh_play --data "path/to/game" --save-directory "path/to/saves"

Use a newer CMake if your distribution ships a version older than 3.24. A Linux binary can still require system libraries such as GTK3; a ZIP is not a guarantee of portability across distributions.

macOS

Apple's Command Line Tools supply the compiler and SDK; full Xcode is not required. Install CMake and Ninja separately, for example with Homebrew. On Apple Silicon:

xcode-select --install
brew install cmake ninja
cmake -S . -B build-macos -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_OSX_ARCHITECTURES=arm64
cmake --build build-macos
ctest --test-dir build-macos --output-on-failure
./build-macos/openbmh_play --data "path/to/game" --save-directory "path/to/saves"

On Intel Macs omit the arm64 setting or select x86_64. These commands build terminal executables; they do not create a signed application bundle.

Game-data tests are optional: add -DBMH_DATA="path/to/game" when configuring to supply your own installation. The repository includes no original test data. See BUILDING for test skips, system SDL2 and packaging details.

Documentation

Contribute

Reports with reproducible steps, documentation corrections and focused patches are welcome. Discuss larger design changes in an issue before implementing them. CONTRIBUTING.md explains the review and testing conventions. Do not upload original game files, screenshots, recordings, copied text databases or saved games to public issues or pull requests.

How the project was developed

The implementation grew from study of file formats and behaviour of a legally obtained game installation. The public repository contains independently written implementation and format documentation. It does not contain the proprietary implementation or its extracted resources.

License and thanks

OpenBMH's own code and documentation are licensed under GNU GPL version 3 only, SPDX GPL-3.0-only. LICENSE contains the unchanged GPLv3 text; the example wording in its appendix does not change this project's version choice. Game content has separate ownership and is not covered by this license.

Release source is identified by the matching version tag: v0.1.0 for this version. Binary releases must accompany or offer the corresponding source and build/relinking materials required by the applicable licenses. The tag identifies application source; it does not replace required materials for linked third-party components.

Bundled components retain their own licenses, including Nuked OPL3 under LGPL-2.1-or-later. See THIRD_PARTY_NOTICES.md and ACKNOWLEDGEMENTS.md.

S
Description
No description provided
Readme GPL-3.0
107 MiB
0 Stars 1 Watchers 0 Forks
Languages
C++ 98.4%
Python 0.8%
CMake 0.8%