EVAUNIT02

弐 · Creation / Software

CreationSoftware

Most of my (non-video game) software projects are private but when I create public stuff, I'll present them here.


MAML Commissioner's Tools

I commission the Mid-Atlantic Mauling League, a Blood Bowl league, and I wrote the software that runs it. Commissioner's Tools is that software: a suite of tools behind maml.club, along with the bots and scheduled jobs that support it. Between them, they keep the league's website, Discord server, Twitch channel, YouTube channel, and social media up to date.

The suite tools are data driven

The big goal was to have the bookkeeping be result-driven. That is to say: I enter game results in to a database and those results drive everything else. Every game is a record. Standings, win-loss records, competition points, touchdown differentials, and even the Blood Bowl championship bracket are calculated from those records on demand. Nothing is tallied by hand. The site's navigation is generated from them, too. Competitions, rounds, and pages appear as a season needs them, and every past season stays browsable.

maml.club schedule for Week 3 of the Far Albion Cup
This week's schedule on maml.club.
maml.club standings for the Far Albion Cup
Competition standings, calculated from the results.

Come playoff time, the brackets fill themselves in as games are played. Each winner is marked and moved on to the next round, all the way to the champion.

The Blood Bowl V bracket for the Season 5 Championship, won by NC Snakes, with its consolation match and 3rd place bracket
The Blood Bowl V bracket, filled in from Season 5's results.

The league's whole history works the same way. Historical stats can be grouped by team, faction, or coach and sorted by points, win percentage, wins, losses, draws, touchdowns, etc.

maml.club Season 5 statistics grouped by team and sorted by points
League statistics, which can be grouped, sorted, and ordered by a variety of options.
maml.club Season 5 statistics grouped by faction and sorted by win percentage
Season 5's statistics grouped by faction and sorted by win percentage.

Every game's full box score is stored, too. That's where the finer numbers come from: passes, catches, running yards, blocks, knockouts, casualties, kills, fouls, and star player points for every player in every game. Each team's page lists its roster and every player's career stats, sortable by any column.

Career statistics for every Human Resources player, from games played to casualties
Every player's career statistics, on their team's page.

Then there's Tale of the Tape. Pick any two teams, coaches, or rosters and it puts them side by side on every one of those numbers (for a season or all time, as totals or per game) along with their head-to-head games. Comparing rosters lines up both teams' players.

Tale of the Tape comparing Human Resources and The Silent D, all time
Tale of the Tape comparing two teams.
Tale of the Tape comparing coaches EvaUnit02 and james_likes_snax, all time
Tale of the Tape comparing two coaches, all time. The better figure in each row is in bold.

Round scheduling

Once every game in a round has finished, a job checks for the next round and adds its games. Teams and coaches are tracked such that a renamed team or a new coach doesn't break anything: the records stay matched up. The new standings and schedule are posted to Discord along with an announcement that the round has begun and when it ends. Those posts then update themselves as games finish.

The Week 3 schedule posted to Discord
The new round's schedule, posted to Discord.
The Week 3 standings posted to Discord
The standings going into the new round.
The announcement in Discord that Round 3 has begun
The announcement that the round has begun and when it ends.

Divisional competitions get their divisions by vote. The tools deal every entered team in to three possible sets of divisions, give each coach a private, one-time voting code, and close the vote once everyone has voted. The winning divisions are written straight in to the database, ready for the first round.

Stream videos

Every streamed game gets its own set of videos: a VS card that doubles as the YouTube thumbnail, a side-by-side comparing the two teams, a "Did you know?" overlay for each coach, and a player spotlight for each team. One tool makes the whole week's set in one go. It reads the schedule for live-streamed games that haven't been played yet and pulls each matchup's numbers from the site. Then, it feeds all of that in to custom Lua scripts that plug in to my video editor.

VS card for Human Resources vs. The Silent D in the Far Albion Cup
A VS card, which is also the game's YouTube thumbnail.
Side-by-side comparing Human Resources' and The Silent D's standings
The side-by-side. Both teams are near the top; so, it compares their standings.

I feed the "Did you know?" facts in to the tool by hand. We're an inviting, friendly league. So, everything on screen stays positive. Each overlay leads with something a coach has done well, e.g., a title, an unbeaten run, or a defense that's hardly conceded.

Did you know? overlay: Human Resources top the standings, led by Grievance Greg's 2 touchdowns
A "Did you know?" overlay.

Player spotlights are made from recordings of the game's player screen. Each recording is checked against the team's roster before it's used. Team info (team name, primary color, coach name, and logo) is fed in to the tool ahead of time and saved for the duration of the competition. Then, the tool renders everything unattended. It also keeps track of what it's made; so, running it again later in the week only makes what's missing, e.g., the videos for a game that just got scheduled to stream.

Player spotlight for Passed-Over Paul, a Human Resources thrower, with his stats
A player spotlight, built around a recording of the game's player screen.

Stream interstitials

Between segments, the stream shows the round's schedule and the current standings full screen. Neither is ever made by hand. Each is an image drawn from the database every time the stream loads it; so, a result entered a minute ago is already on screen. The schedule shows each game's kick-off time or final score, marks the next game as "Up Next," and tags the games being streamed. During regulation play, the standings mark the cut for the playoff bracket. A divisional competition gets a table per division, and a round or table too big for one screen gets split across screens.

Stream interstitial of the Far Albion Cup I Week 3 schedule
The schedule interstitial, with the next game marked "Up Next."
Stream interstitial of the Far Albion Cup I Week 3 standings
The standings interstitial.

Game day

Scheduling a game is one form: set the kick-off time and whether it's streamed. That's it. That schedules the game's posts on Bluesky, X, and Facebook and adds it to the Twitch channel's schedule. Change the time and all of it moves. Clear the time and all of it goes away.

The Schedule form, with a game, its kick-off time, and Live, Unaired, and TBD broadcast options
The form for scheduling a game.

Twenty minutes before kick-off, the game-start post goes up in Discord and anyone who's signed up for game alerts on the site gets a browser or app notification. During the game, the live score and quarter are updated and coaches' followers get alerts as it changes. When the stream ends, the VOD is posted to Discord and social media automatically.

MAML News posts in Discord: a game going live on Twitch, then the game's VOD
A game-start post in Discord, followed by the game's VOD post.

The stream title is written for each game, too. When the stream goes live, the title becomes the competition, the round, and the matchup with each team's place in the standings, e.g., "MAML Far Albion Cup I Week 2: Dark Side of Nuffle (5th) vs. Cowmen and Hobs (7th)." The category gets set to Blood Bowl III. If a title is too long for Twitch, the places are dropped. The title carries over to the VOD; so, every past broadcast is labeled with its game.

A Twitch VOD titled MAML Far Albion Cup I Week 2: Dark Side of Nuffle (5th) vs. Cowmen and Hobs (7th), in the Blood Bowl III category
A game's VOD on Twitch, with the title set when its stream went live.

The Twitch channel also has a standings panel: a Twitch extension viewers can open from chat. It reads the standings straight from the site and checks for new ones every five minutes while it's open. So, it's never more than a few minutes behind a result and nobody has to touch it.

The MAML Standings Twitch extension showing the Far Albion Cup I standings for Week 3
The standings panel on Twitch.

After the game

Streams are exported from Twitch to the YouTube channel. The YouTube panel pairs each export with its game and sets the video's title and playlist in one step. Then, I add a thumbnail and a description. Any video that isn't clearly a game video (e.g., the second half of a stream that crashed) can be matched up by hand.

The YouTube panel with two game videos, their thumbnails, and their descriptions
The YouTube panel, with each video's thumbnail and description.

MAMLbot

MAMLbot is the league's chatbot in both Twitch chat and Discord. Its commands answer questions about coaches, teams, factions, skills, and odds. It rolls dice. It pulls up the current standings and schedule. Its timers post messages on a schedule, and it gives Twitch chat a heads-up before and after ad breaks.

MAMLbot's slash commands in Discord
MAMLbot's commands in Discord.
The /coach command suggesting coach names
The /coach command suggests the league's coaches as you type.
MAMLbot replying with EvaUnit02's all-time statistics
MAMLbot's answer.

Discord updates

When the site, MAMLbot, or the Twitch channel gets something new, a tool drafts a list of changes for me. It goes through every change since the last posted update and keeps only what coaches and viewers can see or use. Anything behind the scenes is left out. It then sorts the changes in to categories, and I write the "What's New" post for Discord from that. Once an update is posted, it's saved; so, the next one only picks up new changes.

A What's New post in Discord announcing MAMLbot, its slash commands, and its Twitch commands
A "What's New" post in Discord.

The MAML Gazette

The front page of maml.club is the MAML Gazette, the league's newsletter. I write each issue's articles. A tool handles the rest: it archives the issue, makes the Past Issues thumbnails, and rebuilds the RSS feed. Before it posts the new issue to Discord, it checks that everything has been uploaded, and it makes sure each issue is only ever posted once.

The front page of the MAML Gazette
An issue of the MAML Gazette.

The Gazette also has a Play Viewer for drawing plays on a pitch with Xs and Os. A play is a series of steps, each with its own caption, and arrows for moves, passes, blocks, and bounces. Players can be marked prone or stunned. During playback, the players move along their arrows and the ball flies along its pass. Open it from a game's page and it comes with both teams' rosters; so, every player has a name and a position. The whole play is stored in its link. Sharing a play is just sharing the link, and nothing is saved on the server. On a phone, the pitch turns upright to fit the screen.

The Play Viewer can also play back Blood Bowl III replays. Cyanide doesn't document the replay format; so, I worked it out by taking replay files apart. A replay is read in the browser and never uploaded. Every action in the game becomes a step with its own caption, from the kick-off to the result of each block. Replays can be played at different speeds or jumped to any turn. A Dice Rolls table, like the one at the end of a game in Blood Bowl III, counts every roll for both teams. "Share this turn" makes a link to a single turn that anyone can watch without the replay file. "Make a diagram from here" opens those steps in the editor to be written up as a play.

The Play Viewer playing a Blood Bowl III replay of Nosfera-WhoToo? vs. Human Resources at the kick-off of turn 6
A Blood Bowl III replay in the Play Viewer.