Skip to content

xkoranate-ce-python 0.4.0-pr1

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 02 Jul 14:26
· 296 commits to main since this release
1bcf297

OOC

We've finally managed to leverage LLMs for good in the NS Sport community! Hopefully this is the start of some more committed development to xkoranate to bring it up to modern standards. -Mertagne

If you would like to buy me a beer as thanks, you can do so here.

xkoranate-CE 0.4.0-pr1

The first release of xkoranate-ce-python — a faithful Python/PySide6 port of xkoranate-CE, the sports "scorinator" used by NS Sports, the sports roleplay forum for NationStates. Originally written in Qt4/C++ by Commerce Heights, this port preserves the original program's behaviour — scorination math, competition formats, file formats, and general UI — while running on current macOS, Windows, and Linux via Python and Qt 6.

This is a pre-release (-pr1): the core port is functionally complete and tested, but it hasn't yet had a broad shakeout from the wider NS Sports community. Please report anything that looks or behaves differently in a bad way from the original xkoranate-CE, or any bugs. You can use the issues board in this repo to do this.

Highlights

  • Cross-platform builds — native builds for macOS, Windows, and Linux, produced by the same PyInstaller spec and built automatically by this release. (#18)
    -- Please test these, in particular the linux build!
  • Modernized UI — a light/dark theme toggle (via qdarktheme), Material Design icons (qtawesome), a discoverable File/View menu bar, and general UX polish (dialog button colors, dropdown scaling, participant wording). (#2, #10)
  • LISA paradigm ported and extended with a per-event home advantage override and a working schedule button. (#1, #17)
    -- Give this a test, too - much of the port was automated.
  • Automatic schedule output and an odds calculator for head-to-head match paradigms. (#12, #13)
  • Home advantage is now user-adjustable (magnitude, not just on/off) across NSFS, SQIS, Footba11er, and Howzzat, with the underlying NSFS math corrected to match the original formula, solving the well known "home advantage bug". (#9, #11, #14, #15)
  • Bug fixes: numeric athlete-list columns (rank, seed) now sort numerically instead of alphabetically; CSV/TXT athlete import no longer drops style mods and other extra columns, allowing for these to be imported. (#6, #8)
  • BBCode output — scorinated results can now be wrapped in [pre] tags for direct posting to the forum, with match winners automatically bolded ([b]...[/b]) in head-to-head result lines. (#7, #19)
  • Test suite + CI — unit and integration tests now run on every push, and build jobs verify the frozen app on all three target platforms. This ensures that future community changes to the repository are known to work before merging them to the main branch. (#16)
  • Licensed under GPLv3, with full attribution to the original xkoranate-CE authors and contributors — see NOTICE.md.

Compatibility

  • Scorination files (events/RPer lists/signups) and table generator files written by the original xkoranate-CE load unchanged, and files written by this port match the original format.
  • Settings are stored under the same thirdgeek.com/xkoranate identifier, so directory preferences from an existing installation carry over.

Downloads

Pick the build for your platform below. These builds are unsigned/unnotarised, so your OS may warn on first launch (e.g. macOS Gatekeeper, Windows SmartScreen) — you'll need to explicitly allow the app to run.

  • macOS: xkoranate-macos.zip → unzip, then run xkoranate.app.
  • Windows: xkoranate-windows.zip → unzip, then run xkoranate\xkoranate.exe.
  • Linux: xkoranate-linux.tar.gz → extract, then run xkoranate/xkoranate.

What's next

The issues board is a port of the issues from the existing C++ repo, and at some point I may begin tackling them. They are more complex, however!