Skip to content

xkoranate-CE 0.4.1

Choose a tag to compare

@github-actions github-actions released this 16 Sep 17:39
· 118 commits to main since this release
bcea140

OOC

First feature release since the port went stable, and it's a biggie that should be a big quality of life upgrade: knockout tournaments. Thanks to everyone who has been filing issues! Three of the fixes below came straight from them. -Mertagne

To download the program, scroll down to the Assets section at the bottom of this page and download the correct file for your operating system.

Downloads

These builds are unsigned/unnotarised, so your OS may warn on first launch (macOS Gatekeeper, Windows SmartScreen) - you'll need to explicitly allow the app to run.

  • macOS (Apple Silicon): xkoranate-0.4.1-macos-arm64.zip → unzip, then run xkoranate.app.
  • macOS (Intel): xkoranate-0.4.1-macos-x86_64.zip → unzip, then run xkoranate.app.
  • Windows: xkoranate-0.4.1-windows.zip → unzip, then run xkoranate\xkoranate.exe.
  • Linux: xkoranate-0.4.1-linux.tar.gz → extract, then run xkoranate/xkoranate.

xkoranate-CE 0.4.1

A feature and fix release on top of 0.4.0. Events, tables, signup lists and settings carry over untouched, and this release also goes the other way: files hand-edited or written by older versions that 0.4.0 had started refusing now load again.


Single-elimination tournaments

A new single-elimination competition type, offered for every head-to-head paradigm - association football, the esports sports, chess, judo, tennis, fencing, wrestling and the rest. Pick it and the event setup page becomes a bracket editor; each round's fixtures are derived from the winners of the round before. (#52, closes #22)

  • The first-round draw is yours to arrange. Three toolbar buttons fill the bracket, after which every pairing can still be dragged by hand:
    • 🎲 Dice - random draw.
    • Seed by skill - strongest against weakest, with the top two able to meet only in the final.
    • Keep top seeds apart - asks how many seeds, then spreads them across the bracket so none of them meet early. Seeds are placed before byes, so a bracket with byes still honours the promise.
  • Byes are real entrants - draggable rows you can drop into a particular slot, not tail padding. A bracket sized larger than the field spreads its byes rather than stacking them at the bottom, and competition types that don't understand byes strip them, so a group set up for a cup can be reused for a league without phantom participants.
  • Bracket size is a dropdown, snapped to a power of two and clamped to a size the draw can actually fill.
  • Round output names the next round's pairings rather than listing who advanced. View full schedule covers the whole bracket, with later rounds reading "Match 9 winner v Match 10 winner" until they are known.
  • Optional third-place playoff, played as its own matchday before the final.
  • Rearranging a bracket that already has results asks first, and a drag you decline is put back.

The draw maths is ported from the prototypes @blackmage37 attached to #22. Two-pot draws, same-nation avoidance, two-legged ties and Qusma seeding are not in this release. They might be in a future one, though!

Interface

  • Search the sport list. A filter box above the sport tree on the first step of the event editor, so a discipline can be found by typing instead of scrolling 117 rows. Matches at any level, case-insensitive, keeps a match's ancestors and subtree visible, and clearing it puts you back where you were. (#53)
  • Double click opens a dropdown, in one gesture. In every reorderable list, a double click on a row now opens its editor whether or not the row was already selected - previously an unselected row cost three clicks - and the list drops open with it. Choosing an entry closes the editor immediately, and the editor is sized to its row instead of covering the rows above and below. (#55)
  • A selected row now shows a small arrow when its editor is a dropdown rather than free text, on the sort-criteria and tiebreaker lists, the event setup participants, and the WC36 RP bonus ratings. (#55)

Fixes

  • Saved events loaded empty on some sports - opening an event whose paradigm doesn't use a maximum skill (FIBA-rules basketball, SQIS football) dropped every participant and result, leaving group members showing as "unknown participant". Association football was unaffected, which made it look sport-specific; the cause was 0.4.0's new "pin to max participant rank" checkbox writing an empty editor back over the signup list still being loaded. Hits every file saved by an earlier version, 0.4.0-pr3 and the old C++ program alike. (#51, fixes #48)
  • Hand-edited files read as truncated - a signup list whose indentation had been stripped, which is what a spreadsheet paste leaves behind, lost everything after the first signup, and groups then pointed at participants that were no longer there. The reader was running one token past each signup's end. (#58, fixes #56)
  • Decimal commas parse again - 1,5 is one and a half. A decimal point still wins where both appear, so commas beside a point group thousands. (#58, fixes #57)
  • math domain error crash mid-scorination - switching an event from a paradigm that passes skill through un-normalised (LISA) to one that rescales left a stale maximum behind, so skills entered on a 0-100 scale normalised to 27-92 instead of 0.27-0.92 and the random generator raised. Nine paradigms share that maths; the same hole in the Gaussian generator is closed too. (#52)
  • Competition type was overwritten on load - anything other than the first type in the list, round robin for football included, was silently replaced when a saved event was opened, and the event was rewritten on save. (#52)
  • "Add all available participants" duplicated the field in a bracket, so clubs ended up playing themselves. (#52)
  • Switching competition type destroyed your pools - every group was merged into one under the first group's name, with no undo. The pools are now given back. (#52)
  • BBCode stopped bolding winners for best-of-1 esports - the sport file used ASCII hyphens where every other sport file uses an en dash. Corrected in the file, deliberately rather than by widening the match, so Gaelic and Australian scorelines like Cork 2-08 (14) drew with Mayo 1-11 (14) are still left alone. (#52)
  • A coin-tossed tie is reproducible again where the sport has no generator of its own - the one result the paradigm can't derive was the one result that couldn't be repeated. (#52)

Under the hood

  • C++ inheritance boilerplate removed from the port - abstract stubs and a vestigial QObject base that the Python classes never needed. (#49, #50)
  • Duplicated logic shared - the odds paradigm lookup and the tiebreaker score accumulation each existed in more than one competition, and the braced-uuid conversions in seven modules. Two leftover debug prints that fired on every match of every round-robin event went with them. (#54)
  • 457 tests, up from 248 at 0.4.0, including a regression test for each fix above.
  • Docs cover the knockout format and the bracket editor.

Full changelog: v0.4.0...v0.4.1