ClaudeandClaude 81046f89f2 Name the per-league stride of the results block; document the world layout
kLeagueResultsStride (records.hpp) replaces the literal 0x17C at 17 places, a
static_assert ties the block size to the league count. docs/architecture.md
describes WorldLayout, LeagueSystem and what is still fixed for a larger world.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-11-11 08:34:41 +01:00
2026-11-08 19:22:56 +01:00
2026-11-08 19:22:56 +01:00

OpenBMH

Classic-Version: 1.0.12. Die originalgetreue Linie bleibt in diesem Repository. Erweiterte Ligen, die gemeinsame deutsche/englische Karriere und der Dateneditor werden separat als OpenBMH-Extended 1.0 Beta entwickelt.

A faithful, standalone community reconstruction of Bundesliga Manager Hattrick, using the player's original installation and SDL2 interface.

OpenBMH 1.0 builds on v0.1.2 with reviewed bug fixes and starts directly with the original game data. Original game files, graphics, audio, texts and manuals are not distributed. German CD-compatible BMH and verified Diamond editions are the primary release targets. Football Limited remains experimental; the older floppy executable is not supported.

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. OpenBMH needs its asset files (texts, master database, pictures, fonts, sounds) and either BMH.EXE (FLTD.EXE for the English game) or openbmh.dat, which ships next to the programs in the release package and holds the game texts of the original executables; the numbers of those executables are built into OpenBMH. If both are there, the executable is used. If neither is there, OpenBMH asks for the game directory or for BMH.EXE.
  2. Extract the OpenBMH package into a separate directory, or alongside the game files.
  3. Start OpenBMH (OpenBMH.exe on Windows). Select the game directory (or BMH.EXE) when prompted. A ZIP or 7z containing one game installation can also be selected.

From a terminal in the extracted package on Linux or macOS:

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

In Windows PowerShell, use .\OpenBMH.exe and .\openbmh_cli.exe instead.

To report a problem, start the game with -debug. It then writes openbmh-debug.log (timestamped events, errors and refused actions) and openbmh-stderr.log into the debug sub folder of the save directory, and saves the game there after every match day (DBG00001.FBM, DBG00002.FBM, ...). Attach the log and the last save to the report.

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 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.

OpenBMH focuses on original-game compatibility, stability and community contributions. See the contribution guide and maintenance roadmap.

Build from source

The following recipes build OpenBMH 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/Weyoune/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.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 --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 --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 also contains the numeric tables and constants of the Diamond edition 3.7 executable (rates, positions, prices; src/formats/diamond_constants.inc, generated by tools/diamond_constants) so that the game runs from its asset files alone. It does not contain the executable's program code or any original game text, graphics, audio or master data.

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.

Every published binary release identifies its matching source tag and provides a corresponding source archive. 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.

The supplied project start artwork is embedded at native resolution; see start-screen artwork. It replaces the original title image while the game continues to use your own original data and assets.

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%