ATO - Auto Tourney Organizer

[Open Assets] ATO - Auto Tourney Organizer v1.4

What permissions do you give others to modify and/or maintain your submission?
Modify: YES - Maintain: YES - I give permission for my entire submission to be modified by others or used in their own work. I give permission for my entire submission to be maintained by others as well.
I made sure my file(s) follow the Submissions Guidelines
  1. Yes
ATO - Auto Tourney Organizer

ATO is a set of tools to help real, human tournament organizers run a successful tournament with the least amount of hiccups possible.

What does ATO do?
  • Automates running through a set of maps without needing to manually enter commands yourself.​
  • Announces to players when a new set is starting, and what map is coming up next.​
  • Automatically resets player scores at the start of a new set.​
  • Logs player scores to everyone's console in a neat, formatted table after every single race in a set.​
  • Disconnect protection! If a player disconnects during a set, the disconnect is logged with their score. If they reconnect, ATO gives their saved score back to them.​
Disclaimer!

ATO is meant to be a stable tool to try to handle all scenarios, but things like server crashes are completely out of my control. Remember to take screenshots of match results and save copies of server log files just in case!

Gamemode Mod Support
  • Friendmod
    • Shows a special scoreboard that separates and color codes players by teams.
    • Keeps track of each team's scores through the entire length of the set.
      • Remember to set team names via the Friendmod commands fr_orangename & fr_bluename. Friendmod does not expose the random team names and the score report will simply read "Team Blue vs Team Orange" otherwise.
  • Elimination & HPMod
    • Shows a special scoreboard that also shows item damage, combo score, and kill bonus points
Recommended Additional Addons
  • Maplist - Lets you look up in game MapIDs for use in ATO's commands.
FAQ
  • Someone left mid race. Can I restart the level safely?
    • Yes, you can restart the level or even change maps entirely via the console, and ATO won't lose it's place in the set.
Standard Score Printout
kart0001.png

Friendmod Score Printout
kart0003.png

Automatic Set and Map Chat Announcements
kart0002.png

ATO_StartSet [MAPID1] [MAPID2] ...
  • Begins a tournament set that runs through the specified maps following the command.
  • Usage : ATO_StartSet MAPXX MAPXX MAPXX ...
    • You can enter any amount of map IDs following the command, the set will run through all of them.
  • Map IDs will be validated before the set is started to try to stop typos.
    • The list of upcoming maps will be displayed after the command is validated and the set has begun in the console.
ATO_StartRandomSet [Number of maps to play]
  • Begins a tournament set that runs through the defined number of maps.
  • Usage: ATO_StartRandomSet [Number]
  • Best run with your server set with "advancemap 2" for random maps, but this could be run with the voting screen active too.
ATO_ShowSetMaps
  • Shows a printout of upcoming maps in the active tournament set, provided they've been defined by ATO_StartSet.
ATO_ClearSet
  • Stops an active tournament set and resets all associated flags. Players are notified via cSay announcement.
ATO_ClearScores
  • Simple command for running clearscores. Called by other ATO functions but open for use by admins. Prints a message to chat when used.

ATO_PausingOnSetEnd [On (Default) /Off]
  • Determines if ATO should automatically pause the server at the last second of the results screen for the last map in a set.
    • Ensure that ATO_IntermissionTimer is set to match your intermission duration minus 1 second.
ATO_LogSpectatorScores [On/Off (Default)]
  • Determines if spectators should be logged in the console score printouts at the end of a map.
    • This parameter's primary purpose is to avoid adding log records for TOs and streamers who would be spectating an active tournament.

ATO exposes the following variables and flags under the global variable "aTourney." I highly recommend you treat all of these values as read only unless you enjoy chaos.
  • aTourney.tourneyInSet - Boolean
    • If true, a tourney set is currently ongoing.
  • aTourney.tourneyMapList - Array
    • A listing of the maps currently loaded and running in the tournament set, stored in numerical map ID format. The map at index 1 is the upcoming map in intermission, and the current map in game. Be aware that this array is modified by ATO at the start of intermission to remove the map at index 1 as the tournament set progresses.
  • aTourney.isRandomSet - Boolean
    • If true, the current tournament set is running with random maps. aTourney.tourneyMapList will have no ids in it.
  • aTourney.raceNumber - Numerical
    • The current race number in the set. Does not increment until the start of intermission.
  • aTourney.totalMaps - Numerical
    • The total number of maps in the set.
  • aTourney.bluetotalscore / aTourney.orangetotalscore - Numerical
    • Friendmod specific values that store the scores of both teams through the entire set. Unused if Friendmod is not active.

Credits
  • Freeman - Friendmod/Elimination scoreboard logging code.
Leave a message on the discussion board for this mod, or reach me on Discord - Montblanc#2569
Author
Onyo
Downloads
834
Views
4,456
Extension type
pk3
File size
6.8 KB
MD5 Hash
1793433f344ceef0abd0cfd477e33850
First release
Last update
Rating
5.00 star(s) 2 ratings

More resources from Onyo

Share this resource

Latest updates

  1. v1.4

    ATO now reads the server's inttime setting and performs map changes at the end of intermission...
  2. v1.3

    Adds a global variable "aTourney" which can be accessed by other addons to get data about...
  3. v1.21

    Renamed command "ato_pauseonsetend" to "ato_pausingonsetend" to avoid netid conflict with Haya's...

Latest reviews

I organize an SRB2Kart tournament for almost three years and I always needed to take screenshots at the end of the races and keep note of the scores in Notepad so as not to miss anything. This add-on is a blessing!
Upvote 1
While I don't play much Kart myself, I do know Tournaments are rather common, so a tool like this is sure to be super useful for those who do play a lot. Hoping this is a major positive addition to Kart tourneys!
Welcome Aboard!
Upvote 1
Back
Top