Add sortable editor ratings and payroll comparisons (by Codex)
This commit is contained in:
1 parent
a447d9282a
commit
221478b629
26 files changed
+1311
-43
No files matched your search
+31
-7
@@ -1,10 +1,10 @@
|
||||
# OpenBMH Editor 0.5.0
|
||||
# OpenBMH Editor 0.5.1
|
||||
|
||||
Der eigenständige, native Editor verwendet **RmlUI, SDL2 und OpenGL**. Er bearbeitet Startdatenbanken, keine laufenden Spielstände. Das Spiel und seine Classic-Prüfung bleiben unverändert. Editor 0.5.0 hat eine eigene Versionsreihe und den Release-Tag `editor-v0.5.0`; die Spielversion ist 0.2.0.
|
||||
Der eigenständige, native Editor verwendet **RmlUI, SDL2 und OpenGL**. Er bearbeitet Startdatenbanken, keine laufenden Spielstände. Das Spiel und seine Classic-Prüfung bleiben unverändert. Editor 0.5.1 hat eine eigene Versionsreihe und den Release-Tag `editor-v0.5.1`; die Spielversion ist 0.2.0.
|
||||
|
||||
## Starten und Daten öffnen
|
||||
|
||||
Das vollständige Paket `OpenBMHEditor-0.5.0-<plattform>.zip` entpacken und `OpenBMHEditor.exe` (Windows) beziehungsweise `OpenBMHEditor` (Linux/macOS) starten. `assets/editor` muss beim Programm bleiben. Auf macOS kann die unsignierte Anwendung über **Rechtsklick → Öffnen** gestartet werden. Eine Signatur/Notarisierung ist nicht Bestandteil dieser Version. `OpenBMHEditor --version` zeigt die Editorversion ohne Grafikstart.
|
||||
Das vollständige Paket `OpenBMHEditor-0.5.1-<plattform>.zip` entpacken und `OpenBMHEditor.exe` (Windows) beziehungsweise `OpenBMHEditor` (Linux/macOS) starten. `assets/editor` muss beim Programm bleiben. Auf macOS kann die unsignierte Anwendung über **Rechtsklick → Öffnen** gestartet werden. Eine Signatur/Notarisierung ist nicht Bestandteil dieser Version. `OpenBMHEditor --version` zeigt die Editorversion ohne Grafikstart.
|
||||
|
||||
**Öffnen** bietet OBW-Dateien und entpackte Welten an. **BMH / FLTD importieren** liest einen Ordner mit einer unterstützten BMH- oder Football-Limited-Installation durch den bestehenden Konverter. Das Original wird nicht überschrieben. Eine bestehende Classic-OBW wird zunächst überprüft und dann in eine bearbeitbare Editorwelt übernommen.
|
||||
|
||||
@@ -25,6 +25,28 @@ Das vollständige Paket `OpenBMHEditor-0.5.0-<plattform>.zip` entpacken und `Ope
|
||||
|
||||
Shortcuts: Ctrl/Cmd+O, Ctrl/Cmd+S, Shift+Ctrl/Cmd+S, Ctrl/Cmd+Z und Shift+Ctrl/Cmd+Z. In Textfeldern gilt die lokale Text-Rückgängig-Funktion.
|
||||
|
||||
## Stärken und Gehälter vergleichen
|
||||
|
||||
**Wertevergleich** in der Seitenleiste (oder die gleichnamige Schaltfläche bei Spielern, Vereinen und Wettbewerben) öffnet eine Übersicht mit drei Ansichten: **Spieler**, **Mannschaften**, **Ligen**. Spieler zeigen ihre einzelnen Spielwerte und das Gehalt je Saison; Mannschaften und Ligen zeigen Durchschnittswerte, Spielergehaltssummen, das Durchschnittsgehalt und die Anzahl bekannter Gehälter. Ein Klick auf eine Zeile öffnet ihren Datensatz zur Bearbeitung.
|
||||
|
||||
- Auf einen Spaltenkopf klicken, um auf- oder absteigend zu sortieren. Sortiert wird der gesamte gefilterte Bestand vor der Aufteilung auf Seiten mit bis zu 200 Zeilen. Suche sowie Land-, Liga- und Vereinsfilter grenzen die Ansicht ein. Fehlende Zahlen stehen in beiden Sortierrichtungen hinten.
|
||||
- **Spalten auswählen** blendet beliebige vorhandene Spielwerte ein. Bei vielen Spalten horizontal scrollen; Tabellenkopf und Werte bewegen sich gemeinsam. Die Wertebereiche stehen im Spaltenkopf, Gruppenwerte sind spielergewichtete Durchschnitte über bekannte Werte. Der gesamte Kader einschließlich Reserve zählt; reine Quellenduplikate mit `x-simulation.squad_role: source-only-duplicate` werden ausgeschlossen und ihre Anzahl angezeigt.
|
||||
- Verschiedene Attributsysteme bleiben getrennt. Bei einem einzigen System werden dessen Spielwerte automatisch angezeigt. Bei mehreren ein **Attributsystem** wählen, um dessen Spieler und die daraus gebildeten Mannschafts-/Ligawerte zu vergleichen. Das FC-Attribut `strength` heißt in einem System mit `overall` **Körperkraft**; es wird nicht als Classic-Gesamtstärke interpretiert. Es wird keine neue Stärkeskala berechnet.
|
||||
- **Gehälter gelten je Saison**, in der Währung und kleinsten Einheit aus dem OBW-Manifest. Berücksichtigt werden zum Saisonstart gültige Verträge des Spielers mit seiner aktuellen Mannschaft. Personalverträge, abgelaufene und zukünftige Verträge zählen nicht. Mehrere gleichzeitig gültige Verträge derselben Zuordnung sind unklar und werden nicht addiert. Ohne Vertragsangabe steht **—**, ein ausdrücklich gespeichertes Nullgehalt bleibt **0**.
|
||||
- Unvollständige Gehaltssummen und Durchschnitte tragen ein **\***. Sie berücksichtigen nur bekannte Spielergehälter; die Spalte **Gehälter bekannt** zeigt die Abdeckung. Auch Spielwertdurchschnitte verwenden nur bekannte Werte (Anzahl per Tooltip). Classic-Grunddaten liefern häufig keine konkreten Verträge: Der Editor erfindet diese Gehälter nicht.
|
||||
|
||||
[Native Vorher-/Nachher-Bilder](qa/editor-comparison/README.md) dokumentieren die Ansichten und Spaltenauswahl.
|
||||
|
||||
Die Übersicht verändert weder Daten noch Undo-Historie. Änderungen und Rückgängig aktualisieren ihre Werte automatisch. Alle drei Themes und beide Sprachen werden unterstützt.
|
||||
|
||||
Über MCP liefert **`editor_compare`** dieselbe schreibgeschützte Übersicht. Beispielargumente:
|
||||
|
||||
```json
|
||||
{"table":"players","sort":"attributes.overall","descending":true,"limit":200}
|
||||
```
|
||||
|
||||
`table` ist `players`, `clubs` oder `leagues`. Weitere Sortierschlüssel sind `name`, `salary` (Spieler), `salary_total`, `salary_average`, `salary_known`, `player_count`, `club_count` sowie `attributes.<feld>`. `attribute_set` grenzt das System ein, `search`, `nation`, `competition`, `team` filtern, `offset`/`limit` blättern. Die Antwort enthält Originalskalen, Stichtag, Währung und Abdeckung. Gehälter bleiben Integer in kleinster Währungseinheit; das Durchschnittsgehalt wird auf diese Einheit gerundet. Das entsprechende Session-Kommando für Command-Scripts heißt `compare`.
|
||||
|
||||
## Optionen und MCP
|
||||
|
||||
**Optionen** bietet Deutsch/Englisch, Midnight Glass/Silver Glass/Matchday und den integrierten MCP-Server. Die Sprache ändert die Oberfläche; Namen und Quelldaten werden nicht übersetzt. Einstellungen werden im Benutzerprofil gespeichert.
|
||||
@@ -41,7 +63,7 @@ Der MCP-Server ist standardmäßig aktiviert und bindet ausschließlich `127.0.0
|
||||
|
||||
Implementiert ist [MCP Streamable HTTP 2025-11-25](https://modelcontextprotocol.io/specification/2025-11-25/basic/transports), mit Aushandlung von 2025-06-18; JSON-Antworten, ohne optionale SSE-Sitzungen. Neuere MCP-Versionen werden nicht als unterstützt beworben. Der Server prüft Token, Host und gegebenenfalls Origin. Oberfläche und Agent bearbeiten dieselbe Welt, verwenden dieselbe Validierung und dieselbe Undo-Historie. Für konkurrierende Änderungen `expected_revision` aus `editor_info`/`editor_get` mitsenden.
|
||||
|
||||
Werkzeuge: `editor_info`, `editor_open`, `editor_new`, `editor_list`, `editor_get`, `editor_apply`, `editor_rules`, `editor_validate`, `editor_history`, `editor_save`, `editor_undo`, `editor_redo`, `editor_roster_move`, `editor_roster_swap`, `editor_roster_order`, `editor_review_resolve`, `editor_image_import`, `editor_image_edit`, `editor_image_preview`, `editor_image_export`. Die eingeblendeten Tools enthalten Parameterschemata und Beschreibungen. Öffnen einer anderen Welt verwirft ungespeicherte Änderungen nur mit `discard: true`.
|
||||
Werkzeuge: `editor_info`, `editor_open`, `editor_new`, `editor_list`, `editor_compare`, `editor_get`, `editor_apply`, `editor_rules`, `editor_validate`, `editor_history`, `editor_save`, `editor_undo`, `editor_redo`, `editor_roster_move`, `editor_roster_swap`, `editor_roster_order`, `editor_review_resolve`, `editor_image_import`, `editor_image_edit`, `editor_image_preview`, `editor_image_export`. Die eingeblendeten Tools enthalten Parameterschemata und Beschreibungen. Öffnen einer anderen Welt verwirft ungespeicherte Änderungen nur mit `discard: true`.
|
||||
|
||||
## Kompilieren
|
||||
|
||||
@@ -49,8 +71,8 @@ Voraussetzungen entsprechen dem Hauptprojekt: C++20-Compiler, Git, CMake ≥ 3.2
|
||||
|
||||
```sh
|
||||
cmake -S . -B build-editor -G Ninja -DCMAKE_BUILD_TYPE=Release -DOPENBMH_BUILD_EDITOR=ON
|
||||
cmake --build build-editor --target openbmh_editor editor_core_tests --parallel 2
|
||||
ctest --test-dir build-editor -C Release -R '^editor_(core_tests|version)$' --output-on-failure
|
||||
cmake --build build-editor --target openbmh_editor editor_core_tests editor_comparison_tests --parallel 2
|
||||
ctest --test-dir build-editor -C Release -R '^editor_(core_tests|comparison_tests|version)$' --output-on-failure
|
||||
```
|
||||
|
||||
macOS ARM zusätzlich bei der Konfiguration: `-DCMAKE_OSX_ARCHITECTURES=arm64 -DCMAKE_OSX_DEPLOYMENT_TARGET=11.0`. Unter Windows das Argument nach `-R` ohne einfache Shell-Anführungszeichen verwenden. Der Editor wird beim normalen Spiel-Build standardmäßig nicht mitgebaut.
|
||||
@@ -71,8 +93,10 @@ Pakete baut `tools/package/make_editor_package.py --build build-editor --out dis
|
||||
|
||||
Extract the complete package and run **OpenBMHEditor**. Open an OBW archive or an unpacked world, import a supported BMH/Football Limited installation, or open the synthetic demo. Use the sidebar, searchable/filterable list and property inspector; **Apply** records one shared, undoable transaction. **Save** writes only an **OBW 1.1 editor world**, not a playable Classic mod or a legacy installation.
|
||||
|
||||
Use **Comparison** to inspect sortable player, team and league ratings and per-season salaries. Select attribute columns and filter by country, league, club or attribute system. Group ratings are player-weighted means; salary totals and means use known player contracts only and explicitly flag incomplete coverage. Missing values remain unknown. The read-only MCP tool `editor_compare` returns the same data.
|
||||
|
||||
The editor retains full squads, original image data, source claims and unknown extensions. Its 24-player view does not remove players. Image import offers normalized crop, arbitrary rotation and mirroring; re-editing uses the preserved source. Classic portraits keep their frozen appearance recipe. Unsupported editing areas are preserved rather than replaced.
|
||||
|
||||
In **Options**, switch the interface to **English**, choose one of the three themes, and enable/disable the integrated local MCP server. **Copy connection** provides the authenticated configuration. The server defaults to loopback port 8765; use port 0 for a free port. GUI and MCP share the same world, validation and undo history. It supports MCP Streamable HTTP 2025-11-25/2025-06-18 and optional stdio mode. Use `expected_revision` for concurrent edits.
|
||||
|
||||
Build with the three commands above, including `-DOPENBMH_BUILD_EDITOR=ON`. The native application requires OpenGL 3.3 (macOS 4.1) and the platform development dependencies documented in the main README. Editor 0.5.0 is unsigned and does not bundle any real-world dataset or proprietary game assets.
|
||||
Build with the three commands above, including `-DOPENBMH_BUILD_EDITOR=ON`. The native application requires OpenGL 3.3 (macOS 4.1) and the platform development dependencies documented in the main README. Editor 0.5.1 is unsigned and does not bundle any real-world dataset or proprietary game assets.
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
This additive profile is a native editing interchange. It does **not** change
|
||||
`classic-installation-v1`, its seals, the Classic runtime or save files.
|
||||
It is implemented by OpenBMH Editor 0.5.0, whose application version is separate
|
||||
It is implemented by OpenBMH Editor 0.5.x, whose application version is separate
|
||||
from the OBW format version and the OpenBMH 0.2.0 game version.
|
||||
|
||||
## Identification
|
||||
@@ -61,6 +61,28 @@ Competition `trophy` and optional fallback remain logical asset references;
|
||||
images are indexed just like crests and portraits. Arbitrary new competitions
|
||||
can use their own trophy or a package-supplied generic trophy.
|
||||
|
||||
### Read-only comparisons (Editor 0.5.1)
|
||||
|
||||
The editor's `compare` command / `editor_compare` MCP tool projects ratings and
|
||||
salaries without writing an additional OBW table. Player attributes retain their
|
||||
set and range. Club and league attributes are player-weighted means of known
|
||||
values within one set; mixed sets require a filter. Full rosters include reserves,
|
||||
except source evidence explicitly marked
|
||||
`x-simulation.squad_role: "source-only-duplicate"`. League membership uses a club's
|
||||
explicit league, or an unambiguous league `members` reference as fallback.
|
||||
|
||||
`contracts.salary` is per season, in integer `manifest.currency` minor units.
|
||||
Only contracts active on `manifest.start_date` and matching the player's current
|
||||
team count; absent bounds are open and explicit date bounds are inclusive.
|
||||
Multiple matching active contracts are ambiguous, not summed. Missing or invalid
|
||||
salary remains null, independently of an explicit zero. Club/league payrolls
|
||||
exclude staff and use known player salaries only. `salary_known`,
|
||||
`salary_unknown`, `salary_ambiguous`, `salary_complete` and `salary_overflow`
|
||||
describe coverage; a missing/empty/overflowed sum is null. Means of known salaries
|
||||
round to the nearest minor unit. Attribute means separately report their sample
|
||||
sizes in `attribute_counts`. No current date, invented contract or foreign-club
|
||||
strength-band interpretation is substituted for missing data.
|
||||
|
||||
## Sources, conflicts and images
|
||||
|
||||
- `x-source/` can contain unchanged or losslessly gzipped normalized source
|
||||
|
||||
@@ -0,0 +1,51 @@
|
||||
# Editor 0.5.1 — ratings and salaries
|
||||
|
||||
These are actual 1440×900 SDL2/OpenGL/RmlUI captures on Linux under Xvfb
|
||||
with software OpenGL. All content is the synthetic `World::demo()` fixture:
|
||||
52 invented players, two invented clubs, one league and 50 explicitly synthetic
|
||||
per-season contracts (one unknown salary per club). No real-world data, original
|
||||
game images, personal paths, settings or credentials are included. This editor
|
||||
uses starting worlds, not a career save; reproduce the data with `--demo`.
|
||||
|
||||
| View | Evidence |
|
||||
|---|---|
|
||||
| Before, released Editor 0.5.0 | [Player inspector](before-players-0.5.0.png), without a ratings/payroll overview |
|
||||
| Players, Midnight Glass / German | [Salary descending](players-midnight-de.png) |
|
||||
| Teams, Silver Glass / English | [Player-weighted means, payroll and coverage](teams-silver-en.png) |
|
||||
| Leagues, Matchday / German | [League aggregate](leagues-matchday-de.png) |
|
||||
| Attribute selection | [Choose columns](columns-midnight-de.png) |
|
||||
| Horizontal navigation | [Further attributes](players-scroll-midnight-de.png); header and values remain aligned |
|
||||
|
||||
The after views use Editor 0.5.1. The before capture uses the released 0.5.0
|
||||
Linux executable and its own assets. No screenshot is a browser mockup.
|
||||
|
||||
Validation:
|
||||
|
||||
- `editor_core_tests`, `editor_comparison_tests`, `editor_version` pass locally.
|
||||
The comparison suite checks 36 outcomes, including actual currency units,
|
||||
unknown versus zero salaries, date/team selection, conflicting contracts,
|
||||
staff exclusion, complete reserves, duplicate evidence, player-weighted means,
|
||||
coverage, empty groups, numeric sorting across more than 200 rows, stable ties,
|
||||
nulls last in both directions, different rating systems, overflow, read-only
|
||||
session state, cache refresh after editing/undo and the shared MCP tool.
|
||||
- `tests/editor_gui_smoke.py` performs real keyboard/mouse operations. It selects
|
||||
a rating column via its label, sorts ratings and salaries, opens the first row
|
||||
and edits it. MCP verifies the expected stable player/club/league identifier
|
||||
changed, then undoes it. The existing inspector/search/JSON/undo/save checks
|
||||
still pass. The comparison leaves the saved world clean.
|
||||
- All three themes and both languages were inspected. Header arrows do not rely
|
||||
on missing font glyphs; horizontal scrolling keeps column alignment.
|
||||
- The completed private season was checked independently: 18,920 eligible
|
||||
player rows, 545 teams, 32 leagues; 832 source-only duplicate rows excluded.
|
||||
Every eligible player has one known current-team salary in that package.
|
||||
These are dataset estimates, not verified real wages. No private rows or
|
||||
screenshots are distributed in this public directory.
|
||||
|
||||
Build the targets and run the CTest commands in [the editor guide](../../EDITOR.md).
|
||||
For the native input test, run `python3 tests/editor_gui_smoke.py <OpenBMHEditor>`
|
||||
inside a graphical session or Xvfb with xdotool. `OpenBMHEditor --demo --page
|
||||
comparison` opens the overview; the three buttons choose players, teams or
|
||||
leagues. **Choose columns** selects additional attributes.
|
||||
|
||||
Windows/macOS native build and core tests run in the editor CI. The Linux
|
||||
window checks do not establish human acceptance on those operating systems.
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 203 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 130 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 137 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 189 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 184 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 149 KiB |
@@ -1,5 +1,21 @@
|
||||
<!-- SPDX-License-Identifier: GPL-3.0-only -->
|
||||
# OpenBMH Editor 0.5.0
|
||||
# OpenBMH Editor 0.5.1
|
||||
|
||||
Adds **Ratings & salaries / Wertevergleich**: sortable player, team and league
|
||||
overviews, searchable and filterable by country/league/club and attribute system.
|
||||
Choose the attribute columns and scroll horizontally for additional metrics.
|
||||
Click a row to open its existing editor. All three themes and both interface
|
||||
languages are supported.
|
||||
|
||||
Player values retain their native scales. Group ratings are player-weighted
|
||||
means; salaries are per-season amounts from contracts active at the world start
|
||||
date. Partial wage bills are marked, unknown values stay unknown, explicit zero
|
||||
salaries remain zero. All reserves are included; source-only duplicate evidence
|
||||
is excluded. Different rating systems are not combined. The read-only MCP tool
|
||||
`editor_compare` exposes the same results and pagination. Comparison caches
|
||||
refresh after edits and undo/redo without changing the world.
|
||||
|
||||
## Initial editor 0.5.0
|
||||
|
||||
The first standalone editor release uses SDL2, RmlUI and OpenGL on Windows x64,
|
||||
Linux x64 and macOS ARM64. Its version is independent of OpenBMH 0.2.0.
|
||||
|
||||
Reference in new issue
Block a user