Focus the community repository and documentation on the original game (by Codex)

This commit is contained in:
Codex committed 2026-10-30 16:18:00 +01:00
1 parent 6b942a2293
commit e432f20ae7
17 files changed
+61 -652

No files matched your search

-44
View File
@@ -1,44 +0,0 @@
OpenBMH v0.1.0
===============
OpenBMH ist eine eigenstaendige Neuumsetzung der Engine von Bundesliga Manager
Hattrick und der englischen Fassung Football Limited. Die englische Unterstuetzung
ist experimentell. Originale Spielinhalte sind nicht enthalten; du benoetigst eine
eigene unterstuetzte Installation. Originale V2.20-Spielstaende der englischen
Fassung sind nicht mit dem unterstuetzten Speicherlayout austauschbar.
Start
-----
Paket in einen eigenen Ordner oder neben die Installation entpacken.
openbmh_play starten (unter Windows openbmh_play.exe). Der Dateidialog nimmt einen
Spielordner, die Programmdatei oder ZIP/7z mit einer einzelnen Installation an.
Aus einem Terminal:
openbmh_play --data "path/to/game" --save-directory "path/to/saves"
openbmh_cli --console --data "path/to/game" --saves "path/to/saves"
Unter Windows den Programmnamen um .exe ergaenzen. Ein beschreibbarer separater
Spielstandordner wird empfohlen. Vorhandene Spielstaende vorher sichern.
Tonoptionen: --mute, --no-music, --volume 0.5. --version zeigt die Programmversion.
In der Konsole zeigt ListOptions die aktuellen Befehle; eine eigene Zeile go.
fuehrt den eingegebenen Block aus. Help beschreibt die Parameter.
Dokumentation und Rueckmeldungen
-------------------------------
README.md enthaelt die Bauanleitungen fuer Windows, Linux und macOS.
Die Releasehinweise beschreiben den Umfang und die bekannten Grenzen.
Linux benoetigt je nach Paket Systembibliotheken, insbesondere GTK3 fuer den
Standard-Dateidialog. Plattform-Bauhinweise sind kein Nachweis eines nativen Tests.
Fehler mit Programmversion, Spielfassung und kurzen eigenen Schritten melden.
Keine Originaldateien, Spielbilder, Aufnahmen, Textlisten oder Spielstaende in
oeffentliche Issues hochladen.
Lizenz
------
Eigener OpenBMH-Code und Dokumentation: GNU GPL Version 3 ausschliesslich
(GPL-3.0-only). LICENSE enthaelt den vollstaendigen Text. Drittanbieter behalten
ihre Lizenzen; siehe THIRD_PARTY_NOTICES.md und docs/licenses/.
Diese Lizenzen gelten nicht fuer die separat benoetigten Originalinhalte.
OpenBMH ist ein unabhaengiges Projekt ohne Verbindung oder Billigung durch die
urspruenglichen Rechteinhaber, DFL oder Bundesliga.
-84
View File
@@ -1,84 +0,0 @@
# OpenBMH v0.1.2
OpenBMH reconstructs the Bundesliga Manager Hattrick engine in C++20. The graphical client uses SDL2; the console provides command batches and local manager-client transports over the same career session. This release needs a supported game installation supplied by the player. No original executable, artwork, music, text database, manual or saved game is included.
## Unreleased corrections
- Application exits ask for confirmation in a native German/English message
box, with Cancel selected by default, including window close events during
matches and dialogs ([#11](https://github.com/Weyoune/openbmh/issues/11)).
- Football Limited uses the correct enabled/disabled setup sprites, positive
balance colour and outside controls of the desktop shortcut bar ([#7](https://github.com/Weyoune/openbmh/issues/7)).
Its cached data is regenerated automatically for the corrected mapping.
- Filename dialogs reacquire the native SDL text editor on entry and window
focus, including the live settings dialog. macOS acceptance remains human QA
([#8](https://github.com/Weyoune/openbmh/issues/8)).
- Save-directory labels use portable `/` separators, avoiding the German bitmap
font's `Ö` glyph at the backslash position on Windows ([#9](https://github.com/Weyoune/openbmh/issues/9)).
- Setup ignores mouse releases without a matching press on that screen, so
window activation cannot toggle the initial league/national-team selection
through that input path ([#10](https://github.com/Weyoune/openbmh/issues/10)).
- Source builds include the standalone [OBW installation converter](https://github.com/Weyoune/openbmh/blob/v0.2.1/docs/formats/obw/import.md).
It produces intermediate database conversions; game integration remains
planned for 0.2.
These changes require a build from the updated source. The tagged 0.1.2 package
does not contain these subsequent corrections.
## Changes in 0.1.2
- The environment menu shows all six original artwork panels: three youth teams,
assistant coach, doctor and physio. Youth panels include their league and rank.
- All six monthly budgets can be set directly to zero through six stars. Youth
development, season promotion/relegation, finance previews and monthly accounts
share those values. Existing academy lump-sum saves retain their paid status.
- Match-minute pacing follows the loaded original delay setting; A9 in Settings
allows faster or slower progression. No fixed 250-ms pause is added. Retrace
animations use the original reference rate on different host monitors.
- External test fixtures are now recognised correctly by CMake instead of being
reported as unavailable despite configured paths.
See [compatibility decisions](../../COMPATIBILITY.md) for youth recruitment and
legacy contract handling. The previous UI corrections remain included.
## Changes in 0.1.1
- Live lineup navigation preserves the saved pitch view and allows repeated switches between the team list and pitch. Right-click can leave the dialog even when the pointer moves between press and release ([#1](https://github.com/Weyoune/openbmh/issues/1)).
- The instruction panel restores original control symbols, substitute information, red coverage on player hover and pitch-position hints ([#2](https://github.com/Weyoune/openbmh/issues/2)).
- Right-click cancels load/save dialogs, including settings and desktop-layout files ([#3](https://github.com/Weyoune/openbmh/issues/3)).
- Save filenames accept typing immediately, replace a selected existing name and support Ctrl+A/Cmd+A. This also applies to desktop layouts saved as MEN files ([#4](https://github.com/Weyoune/openbmh/issues/4)).
These corrections passed targeted UI/controller checks and Linux SDL input replays, including normal and Reality matches, substitutions, file writing and a fresh-process reload. Physical macOS window verification remains human QA. Use packages from 0.1.1 or later to test these fixes; older 0.1.0 builds do not include them.
## Scope
The engine includes career management, leagues and cups, transfers and contracts, finances, training and camps, stadium management, live match interventions, audio playback and normal saves. Supported actions remain subject to mode, manager and phase restrictions; an unimplemented path reports an explicit error rather than an invented result. The project aims for recognisable behaviour and plausible results, not a promise that every original version produces identical events.
German game editions are the primary compatibility target. **Football Limited support is experimental.** English installation loading and edition-specific text/layout data are supported paths, while original V2.20 save import, English audio and remaining competition/interface differences have limitations. A known limitation can reject an English save made after the first calendar
advance: the saved turn cursor may no longer match the active calendar. Initial
save/reload works; a complete English career is not yet verified. Check current
issues before relying on a particular English workflow.
## Compatibility decisions
OpenBMH uses shared rule values across supported German editions, with installation-specific content read from the selected data. It includes safety handling around invalid input, calendar boundaries, capacity checks and suspended operations. See [compatibility decisions](../../COMPATIBILITY.md) and [architecture](../../architecture.md). This is an independent reconstruction, not an official update to the original game.
## Running
Extract the package to a separate directory or alongside your installation. `openbmh_play` can select a game directory, executable or a ZIP/7z containing one supported installation. Use an explicit writable save directory when the original directory is read-only, and keep backups.
```sh
openbmh_play --data "path/to/game" --save-directory "path/to/saves"
openbmh_cli --console --data "path/to/game" --saves "path/to/saves"
```
Version 0.1 ships binary packages for Windows x64, macOS on Apple silicon (arm64, macOS 11 or later) and Linux x64. The Linux package passes the automated build and tests but has not yet been played natively; reports are welcome. The macOS package is not signed or notarized, so Gatekeeper asks for confirmation on first start: open it once via right-click → Open, or allow it under System Settings → Privacy & Security. Packages and their native platform results are listed with the release assets. The [build instructions](../../BUILDING.md) cover Windows, Linux and macOS source builds; an instruction is not a claim of native acceptance. Linux's default file dialog backend requires GTK3 system libraries. A macOS terminal executable is distinct from a signed application bundle.
## License
The matching application source tag is [v0.1.2](https://github.com/Weyoune/openbmh/tree/v0.1.2). Source/build and relinking materials for linked components must also accompany or be offered with binary releases under their licenses.
OpenBMH-owned code and documentation use GPL-3.0-only. Third-party components retain their licenses; the full texts accompany the package. Read [LICENSE](../../../LICENSE) and [THIRD_PARTY_NOTICES](../../../THIRD_PARTY_NOTICES.md). These licenses do not grant rights to original game content.
For reports, include the OpenBMH version, data edition, independently written steps and the observed result. Do not upload original files, game screenshots, recordings, text collections or saved games to public issues.
+2 -6
View File
@@ -4,14 +4,10 @@ Baseline: v0.1.2. The release branch keeps the existing public history; the base
| Later change | Decision |
|---|---|
| 8326a23: host filenames/path display, setup input guards | Included; direct-installation code, no launcher/converter dependency |
| 8326a23: host filenames/path display, setup input guards | Included; direct-installation code, uses direct original-installation data |
| e1d17d8: explicit quit confirmation | Included; cancellation preserves current owner/state |
| c8f04d0: reschedule undo replay bit | Included; restores original target-day availability |
| b879d5b: standalone original message texts | Included as a focused adaptation; no native-content dependency |
| 978a014: edition-specific restored match-group expansion | Pending compatibility verification; no OBW save changes will be taken |
| 0b2354c: native file flows and English media | OBW paths excluded; applicable legacy filename correction reviewed separately |
| 856d38c / 500354c: RmlUI/WARP startup | Not applicable to the restored SDL Classic application; do not bring back RmlUI |
| 0.3 Modern manager placement correction | Excluded; belongs to Dreierpack Manager, not faithful Classic behaviour |
| b879d5b: standalone original message texts | Included as a focused adaptation; reads the original message table |
Version 1.0 no longer rewrites loaded rule tables to a shared profile. Original strength ranges and environment price steps are installed from the supplied edition. Environment implementations outside verified program fingerprints remain unverified, never silently enabled by a directory name.
+22
View File
@@ -0,0 +1,22 @@
OpenBMH 1.0
Eigenstaendige Community-Umsetzung von Bundesliga Manager Hattrick mit der
Original-Oberflaeche. Originaldateien werden nicht mitgeliefert.
Das Paket vollstaendig entpacken und OpenBMH starten (Windows: OpenBMH.exe).
Die eigene Spielinstallation oder deren ausfuehrbare Datei auswaehlen.
Ein gesondertes, beschreibbares Verzeichnis fuer Spielstaende wird empfohlen.
Beispiel:
OpenBMH --data "path/to/game" --save-directory "path/to/saves"
Deutsche CD-kompatible Versionen und gepruefte Diamond-Ausgaben sind die
primaeren Ziele. Football Limited ist experimentell; die alte Disketten-EXE
wird nicht unterstuetzt. Bestehende Spielstaende vorher sichern.
Quellen, Plattformhinweise und bekannte Einschraenkungen stehen in README.md
und docs/release/1.0/RELEASE_NOTES.md. Reproduzierbare Fehler bitte ueber den
Issue-Tracker des Repositorys melden; keine Originaldateien hochladen.
Eigener Programmcode: GPL-3.0-only. Lizenzen und Hinweise fuer eingebundene
Komponenten stehen in LICENSE und THIRD_PARTY_NOTICES.md.
+2 -2
View File
@@ -1,10 +1,10 @@
# OpenBMH 1.0 release candidate
Classic direct-installation runtime restored from v0.1.2. No launcher, converter, OBW runtime or Modern UI. The game executable is OpenBMH / OpenBMH.exe; openbmh_cli remains available.
Classic direct-installation runtime restored from v0.1.2. The game executable is OpenBMH / OpenBMH.exe; openbmh_cli remains available.
Reviewed backports include host filename/path handling, explicit quit confirmation, original message text installation in standalone tools, and clearing the calendar replay flag after undoing a reschedule. German CD-compatible BMH and verified Diamond editions are the release targets. Football Limited remains experimental; the old floppy executable is unsupported.
This candidate is under compatibility validation, especially edition-dependent rules and environment behaviour. No complete platform or original-game acceptance is claimed before its recorded tests pass. Existing 0.2/editor releases remain historical; NextGen development moves to Dreierpack Manager.
This candidate is under compatibility validation, especially edition-dependent rules and environment behaviour. No complete platform or original-game acceptance is claimed before its recorded tests pass.
Diamond 3.7 foreign league crests use the supplied edition's original drawing gate, database selectors and W sheets. Older editions retain their original neutral foreign-club crest.
+7 -3
View File
@@ -3,7 +3,7 @@
Status: implementation candidate, not final-release acceptance.
- Linux x64 Release build: all targets compiled.
- CTest: 32 passed, 157 skipped, zero failures (189 registered tests). Skips require separately configured original-data or save fixtures; they are not acceptance passes.
- CTest: 33 passed, 157 skipped, zero failures (190 registered tests). Skips require separately configured original-data or save fixtures; they are not acceptance passes.
- Synthetic tests cover unchanged executable image loading, nine original strength ranges, atomic rejection of malformed ranges, unsupported environment guards, and legacy/extended/truncated crest gates.
- Public source scan: zero findings; generated differences catalogue matches source markers.
- Version output: both GUI and console identify 1.0.0-rc.1.
@@ -12,6 +12,10 @@ Status: implementation candidate, not final-release acceptance.
Still required: dedicated original-game/GUI/save roundtrips, completing the original-defect audit, per-edition gameplay review, Windows/macOS native checks and release-package acceptance. No final 1.0 tag is justified by these checks alone.
## Source export versus retained history
Source archives contain the audited current tree. The optional full-history audit is a separate check; published Git history has not been rewritten.
The restored Classic tree passes the source-only guard. The retained 0.2/0.3 history still contains launcher artwork and editor QA screenshots, which the old Classic guard classifies as binary content; this is not a clean all-history audit. CI checks the current tree actually exported by the source-package tool. The stricter `check_public_tree.py --history` command remains available for a separate repository-history audit. No history has been rewritten and no historical assets are added to the Classic source archive.
## Follow-up original-data checks
Twenty-six additional private-data checks passed across BMH CD and Diamond 3.6/3.7: exact loaded fixture tables, manager selection, standard dialogs, training camps, tactics, banking, settings and player cards. The Diamond 3.6 two-manager fixture also passed the human-buyer transfer and rescheduling suites. A currency-format fixture had assumed the Diamond resort price for all German editions; its fixed-price check now uses an explicit synthetic price, and the CD test passes without changing game data or product prices. These are automated render/interaction and engine checks, not a claim of complete interactive playthroughs.
The market-player retirement regression failed before the correction with an age wrap from 47 to 16 and passed afterward. It checks market boundaries, unique relocation, unaffected extra slots, new-career setup and unchanged random draw counts for a young club player.