Unofficial xkoranate user guide? Let's talk.

[The Republic of Maltaland]

My problem is that when I go in Scorinate event the Continue button does not work. Why ?

You've probably gone to the end of the screens. When you get to the scorinate screen, hit the black cube button (a die) under the white screen. That will generate your results

I hit the black cube and I received this message : Are you sure you want to generate ? You will lose your exist any results for this round if you regenerate them. Then I pressed OK and there was nothing.

[Frenline Delpha]

You've probably gone to the end of the screens. When you get to the scorinate screen, hit the black cube button (a die) under the white screen. That will generate your results

I hit the black cube and I received this message : Are you sure you want to generate ? You will lose your exist any results for this round if you regenerate them. Then I pressed OK and there was nothing.

Did you put anything in the participating screen?

[The Republic of Maltaland]

I hit the black cube and I received this message : Are you sure you want to generate ? You will lose your exist any results for this round if you regenerate them. Then I pressed OK and there was nothing.

Did you put anything in the participating screen?

Yes I put 5 teams.

[Drawkland]

Did you put anything in the participating screen?

Yes I put 5 teams.

Did you put the teams into Groups on the Groups screen

[Frenline Delpha]

My recommendation would be to read through this post. It is great for newbies to xkoranate.

viewtopic.php?p=7631203#p7631203

[The Republic of Maltaland]

Yes I put 5 teams.

Did you put the teams into Groups on the Groups screen

Yes in 1 group.

[Liventia]

Did you put the teams into Groups on the Groups screen

Yes in 1 group.

Save the .xml file and upload it somewhere (such as pastebin) – it's easier to help that way.

[The Republic of Maltaland]

Yes in 1 group.

Save the .xml file and upload it somewhere (such as pastebin) – it's easier to help that way.

What would I save and what is pastebin ?

[Barunia]

What would I save

Answer:

Save the .xml file

and what is pastebin ?

Google it.

[Damukuni]

Hello! Damukuni here.

I've noticed that both this guide and the Scorinators discussion thread lack a step-by-step guide to compiling xkoranate on Linux-based operating systems. (I've also noticed that most people use Windows or MacOS, for which there are compiled binaries.)

This guide pertains to the following software versions:

• xkoranate 0.3.3 (target build)
• Qt 4.8.7 (this is a legacy version, albeit the version xkoranate was built on, more on this later)
• GCC/g++: 5.3.1

How to Compile xkoranate on Linux

Step 1: Install the Qt 4 development chain. NOTE: With the introduction of Qt 5, Qt 4 is deprecated and no longer supported!

• Ubuntu, Debian: Install the qt4-default package.

  Code: Select all

  sudo apt install qt4-default

  
  
• openSUSE: Install the libqt4-devel package.

  Code: Select all

  sudo zypper in libqt4-devel

  
  
• Fedora: Install the qt-devel package. (Qt 5 development libraries, in contrast, are in the qt5-devel package.)

  Code: Select all

  sudo dnf install qt-devel

  
  
• Arch Linux, Manjaro: The Qt 4 development libraries are in the same package as the runtimes, the qt4 package. If you have Qt 4 apps already running in your install, you don't need to do anything. If you do not have other Qt 4 apps running in your install, install the qt4 package with sudo (if running as an unprivileged user) or as root:

  Code: Select all

  # pacman -S qt4

Step 2: Download the source (0.3.3) zip from the xkoranate landing page and extract it into the folder of your choice (hereby referred to as $DIR). A folder named "xkoranate" will be created inside $DIR.

Step 3: Reboot your computer and log in again. This may be important for the system to determine where all the development libraries are.

Step 4: Open your favourite terminal and change into the source tree:

Code: Select all

cd $DIR/xkoranate/src

• For example, if your username is "john" and you extracted the source into your Downloads folder:

  Code: Select all

  cd /home/john/Downloads/xkoranate/src

  NOTE: Remember, if you lose where you are, pwd will print the working directory (i.e., the one you're in)!

Step 5: Run QMake to generate the makefile necessary to compile the xkoranate binary.

Code: Select all

qmake-qt4

This is compulsory on Arch Linux, Manjaro, and modern systems where Qt 5 is the default.

• If Qt 4 is the only version of Qt installed, you may not necessarily need the trailing -qt4 at the end, hence:
  

  Code: Select all

  qmake

Step 6: Make the binary using make. Make sure you have GCC and g++ installed before you run this command.

Code: Select all

make

Step 7: Change to the parent directory (i.e., move up one level in the directory tree).

Code: Select all

cd ..

• This will place you in $DIR/xkoranate.

Step 8: Run xkoranate.

Code: Select all

./xkoranate

That's it! You now have a working copy of xkoranate 0.3.3 on Linux, inside $DIR/xkoranate.

NOTES

• If, when running the make command, it exits with the error "QTextCodec: No such file or directory", copy and paste the code block below into your terminal, then repeat Step 6:

  Code: Select all

  sed -i 's/QT\ \+\=\ xml/QT\ \+\=\ xml\ widgets/' $DIR/xkoranate/src/xkoranate.pro

  NOTE: Remember to replace $DIR with the directory the xkoranate folder is in!
• If you want to move your xkoranate binary to another location, remember to move the "sports" directory (located in the same place as the binary) with it! This is important, as xkoranate will only check the directory it's in for that folder.
• Remember to place custom sport XML files in their own directory in the sports folder (unless it's a variation on an existing sport, in which the XML should go in the appropriate existing folder).

This guide was tested using the above software versions on Ubuntu 16.04.2 LTS.

If you have questions about this specific guide, feel free to ask them here.

[South Indian Ocean Sports]

Under Baseball there are two formulas: NSFS3 and Xkoranate's own version.

My question is which one does everyone recommend? Does one give more random results the other?

[Free Republics]

Under Baseball there are two formulas: NSFS3 and Xkoranate's own version.

My question is which one does everyone recommend? Does one give more random results the other?

The xkoranate formula is so predictable in its results that it really isn't even a baseball scorinator (the last time it was used in the WBC, the #1 ranked nation went undefeated over the course of 40 games or so). It also completely lacks line scores and does not tell you if the game went into extra innings or not. On the other hand, the version of NSFS that is included with xkoranate is too random (so random that it led to several WBCs where unranked nations made deep runs in the tournament without ever RPing). You can find pages of discussion in the WBC's discussion thread about the problems with both of them.

Over the past 5 tournaments or so, the WBC has been using my adjusted version of NSFS, which lowers the randomness somewhat (to use it, just download that file and place it in your sports folder).

It works pretty well but I still wasn't satisfied with it so I wrote Baseinator, which supports style modifiers, park factors, 3 game series and alternating home & away (but the current version lacks the ability to save a tournament, to produce standings tables, to scorinate a round robin and is nowhere near as easy to use as xkoranate). If you're not comfortable using a command line, editing text files and either doing manual tables or using the xkoranate table generator, you're currently better off using adjusted NSFS (which is also a better choice if you want something that is extensively tested in tournaments where people actually RPed) but I've seen good things from Baseinator so far in my testing of it.

[South Indian Ocean Sports]

Great, thanks! I'll be sure to check out your Baseinator, but your adjusted formula for Xkoranate will most likely suit me perfectly, as I use it to simulate a day in real time and use a dummy league to extend the matchday length so teams have days off and the like.

I was pulling my hair out trying to find the ideal coefficients for the formulas concerned. NSFS3's was seeing too much randomness and coefficent levels were blowing out to what I considered acceptable with newly-promoted teams gunning for the title whilst with Xkoranate's formula, newly-promoted teams were going straight back down again without so much as a wimper. So frustrating.

Thank you.

[Ko-oren]

Thinking of getting back into it all, and messing with some of the xml files. Opening up one of my old domestic league files, I see the following:

<signup id="{6428ccd3-797e-a5da-c860-a94cf6254f5b}" name="Lava Bearers" nation="KOR" skill="5.417"/>

I can see where name, nation and skill come from. I can understand that the signup ID is some sort of unique ID, but how much can I mess with the signup ID so that it's still useable by xkoranate? Can I get away with just going 0000, 0001, to 000f, 1000, and so on?

[Osarius]

Thinking of getting back into it all, and messing with some of the xml files. Opening up one of my old domestic league files, I see the following:

<signup id="{6428ccd3-797e-a5da-c860-a94cf6254f5b}" name="Lava Bearers" nation="KOR" skill="5.417"/>

I can see where name, nation and skill come from. I can understand that the signup ID is some sort of unique ID, but how much can I mess with the signup ID so that it's still useable by xkoranate? Can I get away with just going 0000, 0001, to 000f, 1000, and so on?

Quick test suggests the signup id follows a pattern and you can't use 0000, for example. Tried it and got "unknown participant" in the set up groups page.
When I copied an existing signup id and changed one character (in both places the signup id is used) it seemed to work fine.
Then I tried replacing an existing signup id with "00000000-0000-0000-0000-000000000000" and it also appears to work fine.

Soo.... it looks like as long as you use hexadecimal values in the pattern 8-4-4-4-12 you're good. Presumably, if I'm wrong, CH will correct me if/when he sees this.

[Dunnes]

Can someone please help me understand how to “add sports” to xkoranate? I have .xml files but I can’t seem be able to paste/insert them into the sport folder in Xkoranate.

[Drawkland]

Can someone please help me understand how to “add sports” to xkoranate? I have .xml files but I can’t seem be able to paste/insert them into the sport folder in Xkoranate.

Have you created new folders within the Sports folder to place said xml files in? If you have and it still isn't working, it may be something with how your xml files are written.

What do you have for your .xml files right now?

[Liventia]

Can someone please help me understand how to “add sports” to xkoranate? I have .xml files but I can’t seem be able to paste/insert them into the sport folder in Xkoranate.

Have you created new folders within the Sports folder to place said xml files in? If you have and it still isn't working, it may be something with how your xml files are written.

What do you have for your .xml files right now?

It isn't that. The xml files are fine – I wrote them and they work in my xkoranate.
There's also no need to create new folders – I've told him to put the files in his cycling folder (since they're cycling scorinators anyway).
There's something else at play.

[Osarius]

Can someone please help me understand how to “add sports” to xkoranate? I have .xml files but I can’t seem be able to paste/insert them into the sport folder in Xkoranate.

Can you copy one of the existing .xml files and paste it in the same location?
If so, can you rename that copied file?

[Free Republics]

If the issue is that you simply can't put files into the folders, that's a permissions issue involving your computer's operating system and you need to use administrator privileges to override. If you're using Windows, you should ideally have xkoranate installed on your desktop or in your documents folder somewhere (not under "Program Files" and certainly not under "Windows"). If you're using OS X (Mac) or some Linux distro, there's no good reason to require admin permissions to write to xkoranate's sports directory.

If the issue is that your new sports files aren't showing up even though they are within your sports folder then you need to make sure the text contained within the "<name>" tag is unique and the combination of "<discipline>", "<event>" and "<scorinator>" are also unique. If two files have the exact same information for either the "<name>" tag or that combination of 3 tags, then only one of them will show up in xkoranate (and, as best as I can tell, which one shows up is random). Another thing to watch out for is any extra characters at the end of the file after "</sport>" such as a new line (which often shows up when you copy and paste XML off the Internet instead of downloading the file).

[Abanhfleft]

Hello there everyone, I need some help with Xkoranate.

I'm trying to import my teams into Xkoranate using text files but I have a problem with including the style mods into the file. When I import teams from text without style mods, it works just fine, but when I add a style mod, nothing appears when I try to import.

This is what I'm putting on my files to import my teams.

Participant;team;skill;style mod

Am I doing something wrong? Can someone please enlighten me on this? Thank you.

[Filindostan]

Hello there everyone, I need some help with Xkoranate.

I'm trying to import my teams into Xkoranate using text files but I have a problem with including the style mods into the file. When I import teams from text without style mods, it works just fine, but when I add a style mod, nothing appears when I try to import.

This is what I'm putting on my files to import my teams.

Participant;team;skill;style mod

Am I doing something wrong? Can someone please enlighten me on this? Thank you.

There is no current functionality I believe for importimg teams with style mods. The only way you can currently do is to manually input them one by one.

[Abanhfleft]

Thanks, Filindo. Guess I'll just do it the old-fashioned way then.

[95X]

Thanks, Filindo. Guess I'll just do it the old-fashioned way then.

I can offer a work-around I've done before that makes the manual style modifier entry process somewhat less tedious.

That workaround is using the "team" field for the style modifier, while manually and visually copying that number into the style mod field. (I use the "tab" key to quickly move through the teams.)

Obviously, use of the team field for its intended purpose is lost, and I'd suggest unchecking the box to show team names in results, otherwise results appear as "Team A (+2) 1-0 Team B (0)".

[Lisander]

Dull question. How are we supposed to read a results grid?