Skip to content

Releases

0.9.0

Choose a tag to compare

@github-actions github-actions released this 22 Nov 00:18
e937c09

Release Notes

The game in 27 languages, with every script drawn as it is written.
The protocol and the server are unchanged: 0.8.3 and 0.9.0 play together.

The game in 27 languages

  • 24 new interface languages, for the world's most spoken languages and
    more: Portuguese of Portugal, French, German, Italian, Dutch, Swedish,
    Polish, Czech, Hungarian, Romanian, Greek, Russian, Ukrainian, Turkish,
    Indonesian, Filipino, Vietnamese, Thai, Hindi, Bengali, Arabic, Chinese
    (Simplified), Japanese and Korean — every text, the rules of both games,
    "what's new" and the countries' names (iso-codes). The system's language
    is picked on the first start (Austria and Switzerland get German, Angola
    and Mozambique the Portuguese of Portugal).
  • Every script is drawn: Chinese, Japanese and Korean from Noto Sans CJK
    (cut down to the common characters, so chat and names read too), and
    Arabic, Devanagari, Bengali and Thai shaped as a browser would (rustybuzz,
    a port of HarfBuzz), with Arabic read right to left and the numbers and
    Latin names inside it left to right. Lines break between Chinese and
    Japanese characters, never before their closing punctuation, and at the
    word breaks of Thai.
  • The language is chosen from a list in Settings → Game (a row of
    buttons no longer fits them), each language in its own name.
  • Dates are written the way each language writes them; the rules' names
    inside a sentence are each translation's own ("die brasilianischen
    Regeln"). The terms of use and the privacy policy stay in Portuguese,
    Spanish and English (legal texts are not machine-translated).

Install snook-legend 0.9.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/allansomensi/snook-legend/releases/download/v0.9.0/snook-legend-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/allansomensi/snook-legend/releases/download/v0.9.0/snook-legend-installer.ps1 | iex"

Download snook-legend 0.9.0

File Platform Checksum
snook-legend-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
snook-legend-x86_64-apple-darwin.tar.xz Intel macOS checksum
snook-legend-x86_64-pc-windows-msvc.zip x64 Windows checksum
snook-legend-x86_64-pc-windows-msvc.msi x64 Windows checksum
snook-legend-aarch64-unknown-linux-gnu.tar.xz ARM64 Linux checksum
snook-legend-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum

0.8.3

Choose a tag to compare

@github-actions github-actions released this 21 Nov 19:35
482df14

Release Notes

Two more reviews of the whole game and what players asked for: an item
earned is shown, the pockets are finished cleanly, the zoom stays into the
3D view, one game at a time on a computer, and the 8 on a break handed
over is the 8 of any shot. Protocol 24, the oldest let in too: the rules a
replay is played back with changed (the 8 on a Brazilian break handed
over), and a game of 0.8.2 would show other tables than the server's, so
it is asked to update. No new migration.

A fourth review

The game:

  • A break that hits nothing and loses the cue ball was told as "cue
    ball in hand behind the head string": it is played from the head spot,
    and the table says so.

  • A rematch moves the alternating break on: after a rematch at this
    computer, the next game started was broken by the same side again.

  • A click on the cue aims at the ball, or calls the pocket, lying under
    the stick (it was swallowed along the whole stick); on bare cloth it does
    nothing. No cue is grabbed while a decision after the break is pending
    (none is drawn).

  • A five-round arena that ended before 0.8.2 stays ended: it reopened
    at "round 6 of 7" (cup.json now says how many rounds its arena has).

  • A tournament game left while its last shot rolls counts as that shot
    ends it, not as a game lost.

  • A game saved by 0.8.1 resumes with the breaker it had.

  • The 8 on a break handed over (the cue ball lost on the break, the
    balls lying where they stopped) is the 8 of any shot: hit first it is a
    foul, and made it loses the game. The incoming player could win at once
    by potting it straight in, and the computer went for it. Only the break
    of the rack (the game's first shot, or a break passed over with the balls
    still racked) has the 8 alone winning (EightBallGame::break_on_rack).
    The rules book in three languages says so.

Online, in the game:

  • A table joined after its game ended (back from a lost connection,
    or watching a friend at the end panel) shows the end and its result, not
    a turn nobody can play: the server sends the result again.
  • Both back after the server restarted: the first one back saw a shot
    clock of minutes, and lost a ball with time apparently left. The clock
    shown starts afresh when the opponent is back, as the server's does.
  • A rematch the server refused (it is closing, a cooldown) left
    "Waiting for…" for ever, with no way to accept the opponent's.
  • A shot that left as the clock ran out isn't kept as the last shot, and a
    stroke queued while reconnecting isn't sent to a table that changed
    meanwhile.

The server:

  • The break alternates by who broke last between two players (within a
    day), not by the parity of their games: a game under the official rules,
    a correspondence game ending or the day's count rolling over gave the
    same player two breaks running.
  • A knockout's host away while it filled up lost the first round at
    once: the time away before the start no longer counts.
  • A game dropped with both players gone can't be rebuilt from its saved
    copy; a player back at a finished table doesn't announce it to an
    opponent who is already elsewhere.
  • A month of VIP given counts from the payment, not from when the
    payment page was opened (a boleto paid three days later gave 28 days). A
    delivery that stopped half way still records and announces the present
    (and the welcome to VIP) when it comes again.
  • Friendships accepted and removed at the same moment no longer end up
    one-way (PostgreSQL); a moderator can't act on a listed administrator
    who hasn't signed in yet.

Things asked for

  • An item earned is shown: one that comes with an achievement (a level
    reached, say) only turned up in the shop. A dialog now says
    "Congratulations!", shows it and offers to use it at once (after the
    game, one after another when there are several).
  • The pockets are finished cleanly: the facing of a jaw follows the
    rubber's cut-back under its nose (it stood out in front of the cushion
    like a fin), and the hole's wall and its leather lip stop with the
    casting (they ran on over the rubber, a centimetre proud of it).
  • From the overhead view to 3D the zoom stays: dragging into 3D jumped
    back to the whole table.
  • The profile's note on the two ratings takes the room the buttons
    leave: it ran under "Daily game".
  • The staff portal draws the countries' flags from the game's own
    atlas (/admin/flags.png, /admin/flags.css): the flag emoji aren't in
    every system's fonts, and Windows showed two letters.

One game at a time

  • A second start of the game doesn't open another one: it brings the
    window of the game that is running to the front (Windows) and ends.
    Two games on one computer shared the settings, the saved game and the
    account's session, each writing over the other's. The game holds a lock
    on instance.lock in its settings folder while it runs (the system
    frees it however the game ends); a start right after an update waits a
    few seconds for the old game to close. Development builds can still run
    side by side with SNOOK_LEGEND_MANY=1.

A fifth review

  • A private arena asks for its password once it is running too (joining
    it was refused, each try counting as a wrong password).
  • Signed out after changing the game server in the settings, the game
    signs in to the server chosen.
  • Microsoft Store build: no purchase begins while the Store is still
    being asked what was bought (the click was swallowed).
  • The shop's dialogs leave Enter and Esc to a dialog drawn over them (a
    present arriving bought the item underneath).
  • The wheel at the zoom bar's far end no longer zooms in; a size dragged as
    the settings close isn't shown as chosen; a LAN address pasted with
    "http://" in front connects.

The server and what it shares with the game (the same review):

  • An account deleted while it signed in from another place left that
    connection online under a name that was free again, out of the staff's
    reach: it is closed, with any session made meanwhile, and a session of
    a deleted account can't be resumed.
  • Watching a friend's games ends with the friendship (only a block
    ended it), and a minor's status message and note on the board go when
    their chat is turned off.
  • The address of a player behind a proxy is read from every line of the
    forwarding header (a proxy adding its own line left the client's word
    first); profiles asked for before signing in count per address; a
    trusted-proxy entry that can't be read is said at startup.
  • The tour's achievement gives its experience, as every other does.
  • A flag emoji can't carry a long run of invisible tag characters past
    the chat's filters; drill sessions are scored a couple at a time; a
    first drill with nothing made is no place on the challenge table.
  • The shot analysis, the ghost's style and a shot's difficulty count a
    break handed over on scattered balls as the ordinary shot it now is.
  • The staff portal's report counts work for a player called
    "constructor".

Notes

  • What's new in the game (three languages) and the Store listing's notes
    for 0.8.3: the item earned, the pockets, the zoom into 3D, one game at a
    time and the fixes. The Store notes keep 0.8.2's and drop 0.8.1's.
  • Left as they are, for another version: a refunded VIP month always
    takes back 31 days; a subscription ended with its event delivered late
    can take time from the next one; a daily game begun under 0.8.1 whose
    break lost the cue ball may not rebuild to the table its players saw;
    the staff portal's actions go by name, not by account id.

Deploying

  • The server and the game go out together: once this server is up, a game
    of 0.8.2 is asked to update (protocol 24), so publish the release (and the
    Store package) when the server goes out. Render builds the service from
    main: main has to get this commit along with the tag.
  • The staff portal serves two new files (/admin/flags.png,
    /admin/flags.css); nothing to configure.

Install snook-legend 0.8.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/allansomensi/snook-legend/releases/download/v0.8.3/snook-legend-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/allansomensi/snook-legend/releases/download/v0.8.3/snook-legend-installer.ps1 | iex"

Download snook-legend 0.8.3

File Platform Checksum
snook-legend-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
snook-legend-x86_64-apple-darwin.tar.xz Intel macOS checksum
snook-legend-x86_64-pc-windows-msvc.zip x64 Windows checksum
snook-legend-x86_64-pc-windows-msvc.msi x64 Windows [checksum](https://github.com/allansomensi/snook-legend/releases/download/v0.8.3/snook-legend-x86_64-pc-win...
Read more

0.8.2

Choose a tag to compare

@github-actions github-actions released this 21 Nov 13:47
ee8ebe5

Release Notes

The Brazilian break and shot clock, the break taken in turn, the cue
grabbed anywhere along it, a seven-round arena, and three reviews of the
whole game. Protocol 23, the oldest let in too: the rules a replay is
played back with changed, and a game of 0.8.1 would show other tables than
the server's, so it is asked to update. Two migrations (0023: indexes;
0024: the room a match was played in and the lounge's id of a tournament,
so each is recorded once), which the server runs as it starts.

The Brazilian rules: the break

  • A break that loses the cue ball (down or off the table) with no ball
    made, or with balls of both groups, passes the break to the opponent with
    the cue ball on the head spot, not in hand: the balls stay where they
    stopped (the ones made stay down), no ball is owed, the table stays open
    and the shot is a new break. With balls of one group only, the first one
    down still decides the groups and it is an ordinary foul: the opponent's
    lowest ball comes off and they play from the head spot. A break that hits
    no ball still hands over the cue ball in hand behind the head string.
  • The break alternates: one break each. Offline the game remembers who
    broke last (next_breaker in the settings) for games against the
    computer, the ladder and two players at one computer; a rematch is broken
    by the other player; the rounds of a cup alternate; online, two players
    who meet again on the same day take turns (the rematch in a room already
    did), in tournaments too.
  • The rules book in three languages says so, and the table explains a
    break passed over and a clock run out on the break.

The game

  • The arena against the computer is seven rounds for everyone, on
    points.
  • The shop's icon is a cart: the bag looked like a padlock.
  • The cue can be grabbed anywhere along the stick: only the first
    70 cm or so, about half of it, took a click, at a guessed height. The
    test now follows the cue as it is drawn (its real elevation, drawn back
    while charging) from the tip to the butt, a bit wider where the stick is
    thicker, and the cue swings from where it was grabbed without jumping
    in a low view.

The Brazilian rule: the shot clock gives a ball

  • The shot clock running out is a foul that gives a ball: the
    opponent's lowest ball comes off (with none left for them, the 8 pays and
    the game is lost, as with any foul), the cue ball goes back to the head
    spot, not in hand, and the turn passes. With the table still open
    nothing is owed; on the break, the break passes to the opponent with the
    cue ball on the head spot, not in hand, and no ball owed. Online, the server no
    longer plays the shot at full power where the player was aiming: the
    clock is a foul under both rules (the room's last aim, kept only for that,
    is gone).
  • EightBallGame::time_foul returns the balls it gave, and the penalty of
    a foul and of the clock is paid in one place (pay_penalty). A clock
    that ends the game finishes the match on the server (result, ratings)
    and in the game (offline, in replays and online), and the table says
    which ball came off, or that the 8 paid.
  • The rules book in three languages and the README say so.

Fixes from a review of the whole game

The rules:

  • The official rules: after an illegal break that also drove a ball off
    the table, the incoming player may take the cue ball in hand behind the
    head string as well (a new ball_off on IllegalBreak, which older
    games skip); the clock gives the cue ball in hand from a place it can be
    played from; on an open table a shot at the 8 no longer hands the shooter
    the other group. The rules book says so.
  • A saved table with the 8 gone while the game goes on, or with groups that
    don't go together, is refused.
  • A ball that only rattles in a pocket's jaws no longer counts as a bank in
    the drills and the shot assessment (Event::Cushion says jaw; the
    rules still count the jaws as cushions).

The game:

  • A clock that ends the game counts the win; drills and the daily challenge
    can't be resigned into the ordinary end panel; seeking a stored game
    resets its score and history.
  • The chat's dialog holds the keyboard; the pointer works on the table
    while the chat has the keyboard; the HUD's keys wait under the pause
    menu; the e-mail offer over the invitation dialog gets the pointer.
  • A clock or a choice refreshes the saved game; a tournament game asks
    before replacing a saved one, and its computer plays in the cup's form
    from its first shot.
  • The ping shown is the game's own round trip: the connection's keepalive
    answers no longer pass for it (they made it look shorter).
  • The official choice after the break takes the keys 1 to 4.

Online:

  • Under 18 without the chat, friends' status messages and what came before
    the age are hidden; another account signing in forgets the last one's
    e-mail, wallet, offers and warnings; invitations and the table code end
    with the session; the server set in Settings isn't overwritten at sign
    in; "NaN" in the settings file is ignored; the restart notice goes away.
  • A LAN host can't open payment pages or rewrite the wallet, and a bracket
    with an impossible winner is refused.
  • Passwords need 8 characters, not bytes, and digits of any script count
    as digits; more invisible characters are cleaned from texts; the shot
    analysis credits the ball the shot was about, not a kissed one that
    dropped first.

The server:

  • A player who lets the shot clock run out three times in a row leaves
    the game
    (it ends as abandoned): a game nobody plays (the official
    rules never end on the clock) no longer runs forever, nor holds up a
    tournament.
  • A player put back at a restored game loses their open table, place in
    the queue, invitations, note on the board and the game they were
    watching (someone could have sat down at the table).
  • The rate limits (chat, invitations, lounge actions, reactions, the
    board) outlive the connection for ten minutes: signing in again no
    longer fills them up.
  • Banned players are off the daily challenge's, the drills' and the
    challenge rating's tables while the ban lasts, as on the leaderboard; a
    player's place on the leaderboard follows its order on a tie (the wins,
    then the name).
  • The staff's audit log follows a renamed account (by the player or the
    staff), and a deleted one goes under its deleted name: whoever takes the
    name next doesn't inherit its history.
  • Moderators no longer get recovery e-mails from player actions, payment
    references and Stripe customers, nor sign-in addresses through the audit
    search.
  • Stripe: a cancelled subscription takes back only the unused period, a
    refunded month (bought or given) only that month; VIP time is added and
    taken back in one step (two months at once add up); the account's first
    Stripe customer stays; a subscription started for an account deleted
    meanwhile is cancelled, and a month given to one is logged for a refund.
  • Two friend requests sent to each other at once make friends.
  • A database hiccup no longer deletes a saved game; a game finished here
    is never played again from its saved copy.
  • Arena standings rank those who played above those who didn't; the
    metrics count official and casual games too; the career in the memory
    store skips games with no shots.

A deeper review

The rules and the physics:

  • An official game whose break made the 8 no longer gets stuck: the
    table waiting for the choice (the 8 to spot or a new rack) is read back
    when it is sent or saved (it was refused, and the game stopped there).
  • The ball hit first is the one the cue ball touched first: two balls
    touched in the same sub-step were taken in the order of their numbers
    (the 8 against an 11 was "the 8 first" whatever the geometry). Contacts
    carry the moment they happened.
  • A ball lying against a cushion and pushed into it isn't driven to it
    (the official rail after the contact, the Brazilian cushion before the
    ball): it has to leave the cushion and come back. The rules books say so.
  • The computer no longer puts the cue ball in hand for a ball behind the
    head string it may not hit from there (official rules).
  • The Brazilian book's sentence on fouls while on the 8 says what the rule
    does (the usual penalty; you lose only if it gives more than they have).

Payments (Stripe):

  • A renewal adds its month to the VIP there is: a month given, bought in
    the Store or from the staff isn't swallowed by it. A cancellation after a
    renewal that was never paid takes back nothing unpaid for.
  • VIP time and its coins are given or taken back in one step, once: a
    delivery that stops half way gives (or takes) both when it comes again.
  • The customer a subscription is under is the account's (the one its page
    is managed and cancelled through); a second subscription isn't sold over
    one Stripe still tries to charge; only a VIP subscription's invoice gives
    VIP; a refund Stripe couldn't be asked about is tried again; a welcome
    pack paid twice keeps its items when one is refunded; a deleted account's
    subscription is cancelled, never another product's.

The server:

  • A result is stored once, its game's saved copy deleted in the same
    step, and the write is tried for minutes (a database's trouble no longer
    loses it, nor does an answer lost on the way store it twice).
  • Games two friends farm, or resigned before they were played, give no win,
    streak or feat (the rating keeps its own rules for them); the golden
    break is only for a win on a break.
  • Deploys: a game a player left while a shot was played moves to the next
    server; a game that just ended isn't handed over; one finished while its
    copy was being rebuilt isn't pla...
Read more

0.8.1

Choose a tag to compare

@github-actions github-actions released this 20 Nov 04:30
45291fe

Release Notes

The Brazilian rule's penalty paid with the 8, windows that close with a
click outside them, and a month of VIP sold in the Microsoft Store version.
Still protocol 22 (two new fields, which games of 0.8.0 skip) and no new
migration: games of 0.8.0 keep playing with this server, which can go out
first (a game of 0.8.0 still shows a foul the 8 paid as going on until the
server's table comes in), and only this game sells the month of VIP.

The Brazilian rule: the 8 pays what the opponent doesn't have

  • A foul that gives more balls than the opponent has left loses the
    game
    : their balls come off and the 8 pays the rest. With only the 8 left
    for them (and so with only the 8 on the table), any foul that gives a
    ball loses: a miss, the cue ball down or off the table, the wrong ball
    first. Two balls owed with one left: that one and the 8 come off. On the
    8 with the opponent still holding balls, a foul takes their lowest off and
    passes the turn, as before. (Until now the penalty stopped at the last
    ball and the 8 never came off.)
  • The game ends as a foul on the 8 (EightPocketedOnFoul, "fouled on the
    8"), the report's penalty ends with the 8, and the table says why: the
    opponent had fewer balls left than the foul gives. The computer, which
    plays to win, now steers clear of such fouls by itself.
  • The rules book says so in the three languages. The rule is not versioned:
    a game stored before in which this happened no longer replays past it.

Windows close with a click outside them

  • Panels at the table close when the button is pressed anywhere else:
    the match's chat (what was typed stays), the game history, and the spin
    and elevation panels (the setting stays). The press goes on to what is
    under it, so a click on the table closes the chat and aims; a list the
    chat opened (quick phrases, reactions) closes first, on its own.
  • Dialogs over a dimmed screen close when the dimmed part is pressed,
    as with their Cancel, Close or Esc, and that press does nothing else: the
    pause menu (back to the game), the controls, the rules book and what's
    new, the invitation dialog, Settings, the shop's confirmation, the friend
    to give a present to and "Great!", the country and picture pickers, a
    present received, "a game against the computer is saved", and the chat's
    dialog ("Not now"). The report, the account and the recovery e-mail close
    that way only while nothing has been typed. The first choice of rules, a
    warning from the staff and the wait for the server still need their own
    answer.
  • Ui::pressed_outside (panels: the press goes on) and Ui::dismissed
    (dialogs: the press is spent) do it everywhere; the quick phrases use it
    too, so a faded or covered HUD no longer closes them.
  • The chat's dialog now holds the pointer like the other dialogs: a click on
    it no longer reaches the lounge or the game under it.

A month of VIP in the Microsoft Store

  • The Store version sells VIP a month at a time: a fifth add-on,
    vip_month, a developer-managed consumable like the coin packs, bought and
    confirmed the same way (the server asks Microsoft, consumes the purchase
    and credits it once). Each purchase gives 31 days of VIP and the month's
    400 coins; nothing renews by itself. Bought while VIP, the month starts when
    the current one ends.
  • The VIP tab of the Store version shows "A month of VIP · {price}" (the
    Store's price, in the player's currency), and "Add a month · {price}" under
    the end date while VIP ("The new month starts when this one ends."); the
    perk about cancelling becomes "A month at a time: nothing renews by
    itself". Without the add-on on the server it still
    says VIP isn't sold in this version. The notices while Microsoft confirms
    talk about the VIP month, and the one when it arrives says until when.
  • SNOOK_LEGEND_MSSTORE_PRODUCTS takes vip_month=<Store ID>; the start-up
    log says Microsoft Store purchases on (4 packs, VIP month).
  • ShopInfo.store_vip (the add-on's Store ID, empty when not on sale) and
    StoreRedeemed.vip_until (when VIP ends, when a month was credited). The
    month is never among store_packs, so a game of 0.8.0 never shows it as a
    pack of coins.
  • The staff portal: the purchase shows as vip_month among a player's
    Microsoft Store purchases and as VIP among the payments; the Store's count
    in Economy reads "purchases in 30 days".
  • docs/MSSTORE.md: the fifth add-on, its texts in three languages, and the
    titles and descriptions of every add-on; docs/STORE-LISTING.md: the VIP
    month in the "in-game purchases" paragraph.

Notes

  • What's new in the game (three languages) and the Store listing's notes
    for 0.8.1: the 8 paying the penalty and closing with a click outside. The
    month of VIP is left out of both until the server sells it.

Deploying

  • Put vip_month in SNOOK_LEGEND_MSSTORE_PRODUCTS only once this server is
    out: a server of 0.8.0 doesn't know it, refuses the whole list and turns
    the Store's coin packs off too.
  • render.yaml names the service snook-legend-server, its name on Render
    (the address stays snook-server.onrender.com).

Install snook-legend 0.8.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/allansomensi/snook-legend/releases/download/v0.8.1/snook-legend-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/allansomensi/snook-legend/releases/download/v0.8.1/snook-legend-installer.ps1 | iex"

Download snook-legend 0.8.1

File Platform Checksum
snook-legend-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
snook-legend-x86_64-apple-darwin.tar.xz Intel macOS checksum
snook-legend-x86_64-pc-windows-msvc.zip x64 Windows checksum
snook-legend-x86_64-pc-windows-msvc.msi x64 Windows checksum
snook-legend-aarch64-unknown-linux-gnu.tar.xz ARM64 Linux checksum
snook-legend-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum

0.8.0

Choose a tag to compare

@github-actions github-actions released this 19 Nov 22:45
90f8b55

Release Notes

The official rules of the World Pool-Billiard Association next to the
Brazilian rule, chosen by each player, with a rating and a ranking for each,
everywhere in the game, online and in the staff portal. Protocol 22 is the
only one let in, so the server and the game go out together (a game of
0.7.x is told to update). Migration 0022 adds the official ratings and the
rules of every stored game; everything stored so far was played under the
Brazilian rule. No code is kept for older games any more.

Two rules

  • The rules are a choice, not a version: Rules::Brazilian and
    Rules::Official. The Brazilian rule is the former ruleset 7, bit for
    bit (the physics, rules and computer fingerprints are unchanged); the
    older rulesets, tables and physics, kept only to replay old games, are
    gone. A game, a replay and a game in progress record their rules.
  • The official rules follow the WPA Rules of Play (2025-09-15): every
    shot but the break is called (a pocket; none is a safety, and whatever
    goes in on it stays down), a legal break makes a ball or drives four
    balls to a cushion, the break never decides the groups, the choices a
    break can leave (an illegal break, the 8 on the break, the 8 on a foul
    break, a ball off the table on the break: play the table as it lies,
    rack and break again, the other player breaks, the cue ball in hand
    behind the head string), the 8 made on the break spotted, ball in hand
    anywhere after any foul and no penalty balls, the cue ball in hand behind
    the head string crossing it before hitting a ball behind it (the ball
    nearest the head string spotted when every ball that may be hit lies
    behind it), object balls off the table staying off (the 8 comes back),
    and the 8 lost on a foul, too soon, in a pocket not called or off the
    table. Under them the shot clock running out is a foul.
  • The computer plays both: under the official rules it calls the
    pocket of the shot it chose (or plays a safety) and makes the break's
    choices. A free game, the tour and the tournaments against the computer
    are played under the player's rules (the daily challenge and the drills
    set their own tables).
  • Tests for every official rule, random official games checked after every
    shot, and the Brazilian rule's tests unchanged.

The Brazilian rule: the break with balls of both groups

  • On the break, the cue ball down (or off the table) together with balls of
    both groups, a solid and a stripe in either order, now hands the break to
    the opponent, as when it goes down alone: no penalty ball, the groups
    still open, the balls made stay down, the cue ball in hand behind the
    head string and the opponent's shot is a break. With one ball, or balls of
    one group only, it stays an ordinary foul: the first ball decides the
    groups, the opponent's lowest ball is owed and the cue ball is played from
    the head spot, without ball in hand. The rules book says so in the three
    languages.

Online

  • hello { version, rules } and set_rules: the rules a player plays, shown
    in the lounge (and who is looking for a game). Invitations, tables, "Play
    now" (which pairs only players of the same rules), tournaments, the weekly
    cup (SNOOK_LEGEND_CUP takes official), the staff's themed tournaments,
    invitation codes, notes on the board, daily games and replays all carry
    their rules.
  • A rating, peak and record under each rules (PlayerInfo.standings):
    Elo, the queue's rating window, tournament seeding and the lounge's TV use
    those of the game's rules; the ranking, ranks, rating charts and history
    are kept per rules. Level, coins, achievements and missions are shared.
  • choose { turn, option } / chose (and corr_choose / corr_chose in
    daily games): the choice an official break leaves, made by the player to
    move; the shot clock takes its first option.
  • /api/status counts the players online under each rules;
    /api/leaderboard?rules=official gives the official ranking (the
    Brazilian one when left out).
  • The version gates for older games (social, activity, analysis, age,
    correspondence, the tour) and the gift toast for older games are gone.

The game

  • First start of 0.8.0: "How do you like to play?", a card for each rules
    with what changes and how many play them now. The choice is kept in the
    settings and switched from the main menu (a switch under the title, with
    the players online under each), the lounge's header, the screen against
    the computer, the two-players setup and Settings → Game.
  • The main menu's "Play online" and "Against the computer" count the
    players of the player's rules; the player card shows the rating under
    them.
  • The lounge: a rules pill in the header (a click switches), "Play now"
    with the players waiting under these rules, players and notes of the other
    rules marked, an invitation dialog (rated or casual, and the rules), and
    the rules on invitations, tables, tournaments, daily games and the TV.
  • At the table: the rules' badge in the top bar (it opens them), notices
    that say what a foul gives under the game's rules, the official break's
    choice as buttons (or 1, 2, 3), the computer's own choice told, and the
    official calls: the called pocket follows the aim (a ring on it) until
    another is clicked, the top bar says which is called, and Safety calls
    nothing.
  • Ranking with a tab for each rules; the profile with a rating card
    for each (the one lit sets the rank, the league and the chart), and the
    rules of every game in the history.
  • The rules book has a tab for each: the Brazilian rule and the official
    (WPA) rules, in English, Portuguese and Spanish.
  • Every new text in Portuguese and Spanish; a rules' name inside a
    sentence is in lower case except for the capital of "Brazilian" in
    English.
  • The table no longer changes from one game to another (every game is
    played on the same table now): the code that swapped it is gone.

The staff portal

  • A player's rating under each rules everywhere: the list of players (a
    column for each, with the tier and the games, sortable by either), the
    search, the profile (a card for each with the peak and the record, and
    which they play now) and the players online.
  • The rules of every game: a player's games (filtered by rules), live
    games, tournaments, reports and the replay viewer; a themed tournament is
    scheduled under either (and says so). The viewer understands the official
    calls, safeties and choices after the break, and the Brazilian rule's
    penalty balls.
  • The dashboard, Live, Metrics and Server pages split the players online,
    the games of the last 24 hours, the games now and the queue by rules; the
    Server page shows the protocol and the server's settings (no longer
    called its "rules"), and the weekly cup's rules.
  • A role badge no longer touches the name in the list of players (the
    name and its badges keep a gap and wrap when narrow); players online and
    the search do the same. Rating changes in a player's games are green or
    red.

Install snook-legend 0.8.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/allansomensi/snook-legend/releases/download/v0.8.0/snook-legend-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/allansomensi/snook-legend/releases/download/v0.8.0/snook-legend-installer.ps1 | iex"

Download snook-legend 0.8.0

File Platform Checksum
snook-legend-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
snook-legend-x86_64-apple-darwin.tar.xz Intel macOS checksum
snook-legend-x86_64-pc-windows-msvc.zip x64 Windows checksum
snook-legend-x86_64-pc-windows-msvc.msi x64 Windows checksum
snook-legend-aarch64-unknown-linux-gnu.tar.xz ARM64 Linux checksum
snook-legend-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum

0.7.4

Choose a tag to compare

@github-actions github-actions released this 19 Nov 17:00
420e969

Release Notes

The chat with other players is asked for when it is used, invitations as a
card in the top right corner on every screen, and a player's record against
the computer in the staff portal. No new migration, no new messages: the
protocol stays 21, and games of 0.7.3 and 0.7.4 play together with this
server (a game of 0.7.2 still plays, with its chat off). The server can go
out first.

The chat with other players, asked for when it is used

  • Signing up no longer asks the age group, nor does the lounge. The chat
    with other players (the lounge's and the games' chat, notes on the board,
    status messages, gift messages) starts off for everyone, both ways, and is
    turned on in context: writing with it off (or the "Turn the chat on"
    button in the empty lounge chat) opens a dialog, over any screen, that asks
    the age group once ("18 or older", "Under 18", "Not now"; it can't be
    changed from the game afterwards). 18 or older turns it on at once and what
    was written goes out; under 18, the dialog goes on to the parent's or
    guardian's declaration, as before. Whoever never writes is never asked.
  • "Not now" keeps the chat off: a line comes back to the lounge's field, a
    gift goes without its message, a note without its text, a status message
    is dropped. The lounge's chat shows "The chat with other players is off
    until you turn it on." and the field "Write to turn the chat on…".
  • The server turns the rule around (User::chat_restricted): the chat is
    off until the account says 18 or older, or a parent or guardian turned it
    on (it was on unless the account said under 18). Turned on or off, the
    lounge's chat comes again with or without what players wrote. Accounts
    that answered with 0.7.3 keep their answer.
  • A game of 0.7.2 (protocol 20, which can't ask) has its chat off and is told
    "Update the game to chat with other players." when it writes.
  • A LAN server's guests chat as before: they are the players of a local
    network, with no account to keep an answer.
  • Under 18 with the chat on, a "For a parent or guardian…" button in the
    lounge's chat lets the parent or guardian turn it off again (it could not
    be reached before).
  • The terms of use (section 4 and the summary), the privacy policy, the
    README and the Store notes say so, in the three languages.

Invitations, like the system's notifications

  • One card in the top right corner, on every screen: the main menu, the
    lounge (under its side's tabs), the shop, the profile, the ranking… and
    over any game (under the online count in a game against the computer,
    which accepting keeps; at an online table it can only be declined). It
    used to show in a different place on each screen and on none of the
    others, and not while the game's menu was open.
  • The card slides in from the right with the player's picture, flag and
    name, "invites you to a casual game" (in two lines if it needs them) and
    Decline / Accept along the bottom; up to three, then "{n} more
    invitations". A new invitation rings once (the turn's chime). Nothing under
    the cards takes the click. Focus mode and the settings keep them away, as
    before.
  • Windows notifications at once when the game is not in front: the game
    asks the system whether its window is the foreground one and not
    minimised; behind another window or minimised, the notification (and the
    flashing taskbar button) comes at once. It used to wait until nobody had
    touched the game for 12 seconds, which is still how other systems tell.

The staff portal: a player's record against the computer

  • A new tab on a player's page, "Against the computer": whether they won
    the tour (when, with its cue and achievement) and how many finals the
    server dealt them (of the latest 16 kept, and when the last was); the
    medals of the tournaments against the computer, knockout and arena apart,
    gold, silver and bronze, and the latest thirty with their date; the
    drills' stars (of 72) and best score in each, by name in the portal's
    language; the daily challenges they topped. The stages of the tour before
    its final are kept by the game, not the server, so they don't show.
  • New store queries for it: cup_medal_list and ladder_finals (both
    stores; no migration).

Tests

  • Tests that switch the game's language hold a lock while they do
    (i18n::lang_lock): run side by side, they changed each other's language
    and the translation tests failed now and then.

Install snook-legend 0.7.4

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/allansomensi/snook-legend/releases/download/v0.7.4/snook-legend-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/allansomensi/snook-legend/releases/download/v0.7.4/snook-legend-installer.ps1 | iex"

Download snook-legend 0.7.4

File Platform Checksum
snook-legend-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
snook-legend-x86_64-apple-darwin.tar.xz Intel macOS checksum
snook-legend-x86_64-pc-windows-msvc.zip x64 Windows checksum
snook-legend-x86_64-pc-windows-msvc.msi x64 Windows checksum
snook-legend-aarch64-unknown-linux-gnu.tar.xz ARM64 Linux checksum
snook-legend-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum

0.7.3

Choose a tag to compare

@github-actions github-actions released this 19 Nov 13:30
3109c3c

Release Notes

Ruleset 7 (the break handed over, the cue ball off the table costs a ball), terms of use, an age group and the chat
of players under 18, more drills without a ranking, and new profile
pictures. The server lets in protocol 20 and 21: games of 0.7.2 keep
playing (they are not asked the age group, and play ruleset 6). The server
goes out first. One new migration (0021_age).

The rules (ruleset 7)

  • A break that hits no ball, or that loses the cue ball (down or off the
    table) with no ball made, hands the break to the opponent
    : the balls
    stay where they are (still racked after a break that hit nothing), the
    cue ball is in hand behind the head string, and their shot is a break
    (any ball may be hit first, the 8 alone wins, it may be struck as hard).
    A break that makes a ball along with the cue ball is an ordinary foul, as
    before.
  • The first ball made on the break decides the groups even when the
    cue ball goes down with it
    : the 11 and the cue ball, stripes for the
    breaker; the turn passes, the cue ball goes back to the head spot and the
    scratch costs the opponent's lowest solid, as any scratch does (the table
    stayed open before).
  • The cue ball knocked off the table gives the opponent a ball, as a
    scratch does (it only cost the turn before): their lowest comes off, the
    turn passes and the cue ball goes back to the head spot. With a miss, two. The rules in the game say so, in the three languages; the game
    tells the players ("No ball was hit on the break: … breaks").
  • The computer breaks a full rack as before and plays a break handed
    over on scattered balls like any shot, the cue ball behind the head
    string.
  • Games between 0.7.3 and 0.7.2 play ruleset 6 (ruleset_for, the
    newest rules both games know); daily games stay on ruleset 6 while 0.7.2
    is let in (each player's game replays them); the tour's final is
    accepted under ruleset 6 or 7. Games keep the ruleset they began with.

Terms of use and privacy

  • The server publishes the terms of use (/termos, /terms,
    /terminos) and the privacy policy (/privacidade, /privacy,
    /privacidad, Spanish new), in the game's colours, each linking the
    others. The terms cover the provider (Decreto 7.962/2013), accounts,
    minors, the community rules and sanctions, coins and items, paid
    purchases with 7 days to change one's mind (CDC art. 49), VIP and its
    cancellation, availability, the code's licence and credits, liability,
    the law and the forum. The privacy policy now says everything the server
    keeps (age group, the guardian's permission, presence, results of drills
    and daily challenges, medals, ghost styles…), the legal bases, the rights
    (LGPD art. 18) and how long data is kept.
  • Who provides the game comes from the server's configuration:
    SNOOK_LEGEND_PRIVACY_CONTROLLER (name), SNOOK_LEGEND_LEGAL_DOCUMENT
    (CPF or CNPJ), SNOOK_LEGEND_LEGAL_ADDRESS and
    SNOOK_LEGEND_PRIVACY_CONTACT; a line whose value isn't set is left out,
    and with payments on the server warns about the missing ones.
  • The game links to them: under the button that creates an account
    ("creating an account means accepting…"), in the shop's Coins and VIP tabs
    (with the 7 days to change one's mind and the renewal of VIP), and in
    Settings → Game → About, with the credits (DejaVu, flag-icons, Twemoji,
    iso-codes).

Age group and chat (Lei 15.211/2025, the ECA Digital)

  • Signing up asks the age group: 18 or older, or under 18. Accounts
    made before are asked once, in the lounge. It can't be changed from the
    game afterwards.
  • Under 18, the chat is off both ways until a parent or guardian turns it
    on
    : the lounge's and the games' chat, notes on the "looking for a game"
    board, status messages and gift messages. The server refuses what such an
    account writes and passes on nothing others write; the game shows "Chat
    off: under 18" and a button for the guardian, who turns it on (with a
    declaration) or off again below the lounge's chat. Reactions, invitations,
    friends and games are not affected. The server keeps the date of the
    permission; deleting the account deletes both.
  • New messages (SetAge, AllowChat, Age; Register carries the age
    group) for games of protocol 21 (AGE_PROTOCOL); the server sends Age
    to those only.

Drills

  • 24 drills, nine new: the far corner (a cut back into a head corner),
    long into the side, cue ball on the cushion, the plant, the carom, the
    long draw, on the tangent line, two-cushion bank (a bank now asks for a
    number of cushions) and fifteen in a row. A test finds a way to do each.
  • No more ranking on the drills tab: completing everything only tied
    first place. The tab shows the stars earned (out of 72) with a bar, the
    drills in two columns and, where the tables were, the drill's position
    drawn from above (the pocket to play in gold, the circle for the cue
    ball in green). The stars are kept in the account as before.

Emoji, tabs and the online count

  • Emoji show as pictures wherever the game draws text (the chat, the
    match chat, statuses, notes, names of tables and tournaments, text
    fields): 1878 Twemoji in an atlas made by tools/gen_emoji.py, flags,
    keycaps and joined sequences included (skin tones drawn as the base
    emoji), measured, wrapped, shortened and edited as whole characters.
    Text without emoji is drawn as before. The server keeps the joiners and
    selectors that belong to an emoji and still removes them elsewhere.
  • On Windows, emoji typed from the emoji panel reach the game: a
    character beyond U+FFFF comes in two halves, which miniquad dropped
    (patched in vendor/miniquad).
  • Tabs whose labels all have one size: each tab as wide as its label,
    the labels shrinking together only when the row is too narrow (the
    computer screen's tabs, the lounge's, the profile's switch).
  • The online count is a green dot, a person and the number; hovering
    says "Users online" and who.

Profile pictures

  • Drawn again: the 32 portraits are illustrated head-and-shoulders
    busts (shaded faces, eyes with highlights, hair in strands, beards,
    glasses, earrings and clothes of many kinds), each keeping who it was
    (skin, hair, glasses, beard, colours); the 12 objects too, in the same
    style. 20 new pictures of pool things (a medal, a laurel, the 1 and
    the 15, a flaming 8, a ball dropping into a pocket, the lamp over the
    table, chalk on a tip, a crown over the 8, a rocket, a comet…): 64 in
    all, shown in the picker as people, then things.
  • They come from an atlas drawn by tools/gen_avatars.py (SVG rendered by
    Chromium) instead of shapes drawn by the game; small sizes stay smooth.
  • The player's picture shows on the card at the top right of the start
    screen when an account is signed in.

Install snook-legend 0.7.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/allansomensi/snook-legend/releases/download/v0.7.3/snook-legend-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/allansomensi/snook-legend/releases/download/v0.7.3/snook-legend-installer.ps1 | iex"

Download snook-legend 0.7.3

File Platform Checksum
snook-legend-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
snook-legend-x86_64-apple-darwin.tar.xz Intel macOS checksum
snook-legend-x86_64-pc-windows-msvc.zip x64 Windows checksum
snook-legend-x86_64-pc-windows-msvc.msi x64 Windows checksum
snook-legend-aarch64-unknown-linux-gnu.tar.xz ARM64 Linux checksum
snook-legend-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum

0.7.2

Choose a tag to compare

@github-actions github-actions released this 19 Nov 00:44
6edf1c6

Release Notes

A harder tour, medals for the tournaments against the computer and a
showroom camera like the table's. 0.7.2 plays only with 0.7.2: the server
lets in protocol 20 only (older games are told to update), since it checks
the tour's final against the new last opponent. One new migration
(0020_cup_medals).

The tour

  • Harder at every stage, and the final very hard. An opponent's
    strokes were played with 60% of their usual error on every stage; now
    with about half of it on the first and a quarter on the final. From the
    fifth stage every opponent looks at every shot (the widest search;
    before, those who usually see few shots never did), from the sixth they
    see bank shots (it was the seventh), and position play counts more the
    further up the tour, the most on the final.
  • Viktor, in the final, also values a safety more and plays one
    sooner when a pot is in doubt.
  • Measured over 40 games, a very good computer player (steadier than Hard)
    wins about one final in five (8 of 40), against about one in three before
    (14 of 40). A Viktor with no error at all wins no more often: what makes
    him hard is his choice of shots and position.
  • Tournaments against the computer keep the strength they had (the
    tour's former form, now ladder::cup_form).
  • The server checks a final against the new Viktor, hence protocol 20; the
    final's fixture is recorded again (record_the_fixture), and an ignored
    test measures the final (measure_the_final, SNOOK_LEGEND_FINAL_GAMES).

Medals of the tournaments against the computer

  • A tournament played to its end gives a medal to the first three: gold
    for the champion, silver for second, bronze for third (in a knockout both
    semi-final losers take the bronze). The finished tournament shows it, in
    its colour, and the game says it ("A gold medal!").
  • The Tournament tab counts them, knockout and arena apart, gold, silver
    and bronze: under the sign-up and under a finished tournament. They are
    shown there only, not on the profile.
  • They are kept in the account. A medal is kept in the game at once,
    for the account signed in (or whose session is saved; with none, the next
    one to sign in takes it), and sent to the server the next time it is
    online; the server's count comes back and shows offline too. Until then
    the tab says "Kept in your account the next time you're online." (or
    "Sign in to keep them in your account.").
  • The server keeps one medal per tournament (its draw's number), refuses a
    place outside the first three or an unknown format, and takes at most 40
    a day per account. Deleting an account deletes its medals.

The showroom's camera

  • It turns like the camera at the table: drag with the right button
    (the left one turns too, and a click on a ball still picks it), smoothly,
    with the wheel to come closer. Nothing moves the whole view sideways any
    more: the camera always looks at the item.
  • It never goes under the floor or the table: it stops just above the
    stage, and above the table's top for a table, a cloth or an item shown on
    the player's table. The arrow keys turn it the same way.

Install snook-legend 0.7.2

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/allansomensi/snook-legend/releases/download/v0.7.2/snook-legend-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/allansomensi/snook-legend/releases/download/v0.7.2/snook-legend-installer.ps1 | iex"

Download snook-legend 0.7.2

File Platform Checksum
snook-legend-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
snook-legend-x86_64-apple-darwin.tar.xz Intel macOS checksum
snook-legend-x86_64-pc-windows-msvc.zip x64 Windows checksum
snook-legend-x86_64-pc-windows-msvc.msi x64 Windows checksum
snook-legend-aarch64-unknown-linux-gnu.tar.xz ARM64 Linux checksum
snook-legend-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum

0.7.1

Choose a tag to compare

@github-actions github-actions released this 18 Nov 22:37
6368773

Release Notes

New games play ruleset 6: two house rules on the break and the cue ball.
0.7.1 plays only with 0.7.1: the server lets in protocol 19 only (older
games are told to update), so the server and the game go out together. No
new migrations.

The rules (ruleset 6)

  • The first ball made decides the groups, on the break too. The 3 and
    then the 13 on the break: the breaker takes the solids, and the 13, the
    opponent's, stays down for them and passes the turn (as on any shot).
    Ruleset 5 left the table open after a break with both kinds.
  • The cue ball is in hand on the break only, behind the head string.
    One that goes down or leaves the table, on the break or later, goes back
    to the head spot (right behind a ball lying there, towards the head rail)
    and is played from there, with the foul's penalty balls as before; the
    opponent no longer places it anywhere.
  • A break that makes only the cue ball is no longer racked again: the
    balls stay where they went, and the opponent plays on from the head spot.
  • The game says when the cue ball comes back to the head spot. The rules in
    the game say all of it, in the three languages; the computer's remarks no
    longer thank anyone for a ball in hand.
  • Games keep the ruleset they began with (replays and daily games started
    before play on as they were). The fingerprints of ruleset 6 are pinned.

Playing the computer, with the lounge in sight

  • How many are online shows in a discreet corner under the top bar
    during any game played here (against the computer, its tournaments, the
    tour, drills), with who is there on hover; for a few seconds after
    someone comes online it says who, in gold. The invitations show under
    it, over the game, as before.
  • Focus mode (Settings → Game, off by default): no invitations while a
    game is played. The game tells the server, which withdraws the
    invitations waiting and turns new ones away with the reason; the lounge
    shows the player "in focus mode" and offers no invitation button.
    Invitations' desktop notifications keep quiet too.

The shop's showroom

  • "Look at it closely" opens a showroom instead of turning round the
    table: the item alone on a dark stage under the table's lamps, with soft
    shadows on a floor that melts into the dark. A cue floats over its
    shadow; a cube of chalk (modelled, its paper printed with the game's
    name, its top worn hollow) stands with the player's cue chalking it; a
    ball set is racked with the cue ball beside it; a table or a cloth stands
    on its own with the player's balls.
  • The camera turns round it by itself until it is taken: drag to turn,
    the right button (or Shift) to move, the wheel to come closer to what is
    under the pointer, a double click to look closely at a point; a play and
    pause button, zoom buttons, a way back to the start (R), the keyboard
    (arrows, + and −, Space, 1–4), and a clean view with the interface hidden
    (H). Ready-made views per item: a cue's tip, joint and butt; the chalk's
    top and the tip it chalked; a set from above or low down; a table's
    corner, side pocket and leg; the cloth close up and its cushion.
  • A ball of a set (clicked, or picked from a row of the sixteen) rises
    over the rack and turns on itself, its number upright.
  • Settings: a cue, a chalk or a set also on the player's own table; a
    table or a cloth in the studio or in any of the eight halls (the hall is
    built while the view stays, with a spinner).
  • The price and the button to buy or use the item stay at hand; items for
    VIP members or earned with an achievement say so. Each item has a line
    on what it is (a table's wood and castings, a hall's room, a set's
    finish).
  • Ball sets show their finish on every table: pearl sets a soft pearly
    sheen, metal ones a mirror-like gloss, the old ivory ones a soft matte.

The balls

  • The 7 and the 15 are brown, not a darker red: under the lamps they
    read as the 3 and the 11. The same in the shop's sets where the two were
    close (TV set, Vintage, Earth tones, Pastel, Forest, Candy, Chrome,
    Royal; Forest's 3 is a brick red and its 4 a slate grey, to keep its
    browns apart). The sets made of shades of one colour stay as they were; a
    test keeps the 3 and the 7 apart in the others.

The staff portal

  • An administrator answers reports about themselves (with one
    administrator nobody could, and they stayed open for ever); the answer
    goes in the audit log like any other, with no sanctions on oneself. A
    moderator's reports about themselves stay an administrator's: the
    portal says so on the report instead of offering answers that fail, in
    the three languages.

Install snook-legend 0.7.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/allansomensi/snook-legend/releases/download/v0.7.1/snook-legend-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/allansomensi/snook-legend/releases/download/v0.7.1/snook-legend-installer.ps1 | iex"

Download snook-legend 0.7.1

File Platform Checksum
snook-legend-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
snook-legend-x86_64-apple-darwin.tar.xz Intel macOS checksum
snook-legend-x86_64-pc-windows-msvc.zip x64 Windows checksum
snook-legend-x86_64-pc-windows-msvc.msi x64 Windows checksum
snook-legend-aarch64-unknown-linux-gnu.tar.xz ARM64 Linux checksum
snook-legend-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum

0.7.0

Choose a tag to compare

@github-actions github-actions released this 18 Nov 16:32
87054a0

Release Notes

New games play ruleset 5, with a new house rule on the break. 0.7.0 plays
only with 0.7.0: the server lets in protocol 18 only (older games are told
to update), so the server and the game go out together. The server runs
migrations 0016 (indexes for profiles), 0017 (the tour's finals it deals),
0018 (the staff's notes) and 0019 (events) when it starts.

Events

  • Scheduled from the staff portal: experience ×2 or ×3, coins from
    games ×2 or ×3 (the day's cap too), and themed tournaments — a knockout
    or an arena organised by the server like the weekly cup, with a prize the
    house adds on top of the entry fees (70% to the champion, 30% to the
    runner-up; with four players or more, to players who won at the table).
    Each with a start and an end; called off at any time.
  • Players see them on the main menu and in the lounge (what each does,
    when it starts or ends), and experience and coin notices say "(×2)"
    while a boost runs. A tournament's prizes show also without an entry fee.
  • Migration 0019 keeps the events.

The staff portal, made again

  • A new portal at /admin, in Portuguese, English and Spanish (from
    the browser, or chosen), dark or light: a sidebar of sections with the
    open reports counted, a search for players (and #game for a replay) on
    every page, an address for every page and filter, keyboard shortcuts,
    dialogs that ask before anything destructive and say what the player
    will see, and a layout for phones. See docs/ADMIN.md.
  • Players: filtered (online, staff, banned, muted, deleted) and sorted;
    each player's page in tabs (overview, moderation, games, economy,
    achievements) with every staff action on the account in a timeline.
  • New actions: warnings the player sees at once or at their next
    sign-in; notes among the staff; a rename by the staff that doesn't use
    the player's own changes; items taken back; chat lines deleted (or
    removed without a trace) from the portal; tournaments called off before
    they start (fees back). Reports are answered with a warning, a mute or a
    ban from the report itself.
  • New pages: the lounge chat as the staff see it, the economy (coins
    given and spent by reason, the largest balances, everyone's latest
    payments, the shop's catalogue), the server (version, memory, health,
    rules, the weekly cup, the staff); metrics show where players come from.
    The audit log is searched, filtered, paged and exported as CSV.
  • Migration 0018 keeps the notes and warnings (and indexes the players'
    list by rating and by last seen).

The rules (ruleset 5)

  • On the break only one kind may go down. A break that makes balls of
    both groups (the 3 and the 14, or the 5, the 13 and the 14) passes the
    turn and leaves the table open; one kind only sets the groups and the
    breaker shoots again, as before. The game says so when it happens.
  • What ruleset 4 got wrong in rare cases: an open table with no group ball
    left puts both players on the 8; a time foul after a scratch on the break
    leaves the cue ball in hand as it was; the cue ball in hand may touch a
    cushion but never sit in a pocket's mouth; a ball that jumps onto the
    rail beside a pocket is off the table. The computer is stronger.
  • Games keep the ruleset they began with (replays and daily games started
    before play on as they were). The rules in the game say all of it, in the
    three languages.

Rewards that can't be made at home

  • The tour's final is played from a rack the server deals to the account,
    the computer breaking: a rack searched for at home, or a game shared
    between accounts, no longer earns the exclusive cue. The game asks for
    the final when it starts (a word on screen for a moment); signed out, or
    if the server doesn't answer, the final is played but says it won't earn
    the reward. "Try again" on the final asks for a new one.
  • A drill session played for the tables is started by the server: each
    try's cue ball lies a little off its place, different from session to
    session, so one stroke that worked can't be sent for every try. A session
    counts once.

Accounts and payments

  • Changing the recovery e-mail takes the password, always (a stolen
    session could move where the account is recovered from), also for the
    e-mail of the account's own payment, offered after it.
  • An account can't be deleted in the middle of a game, at a table, in the
    queue or in a tournament (leave first).
  • Deleting an account ends its VIP subscription first (it went on billing
    an account that was gone); if Stripe can't be reached, the account stays
    and the player is asked to try again.
  • A refund or a dispute of a VIP month is found from the payment's invoice
    (VIP and its coins stayed after a chargeback).

Watching and blocks (server)

  • The lounge's TV shows public games only, and only the game on it can be
    watched that way (not any game whose number someone guesses); who watched
    it follows its player into public games only.
  • A resignation or an abandonment while a shot was being played waits for
    the shot: the stored game showed a different game from the result.
  • Blocking withdraws the invitations between the two; an invitation or a
    daily-game challenge accepted after a block is refused; nobody watches a
    game where a player blocked them; the chat history hides a blocked
    player's lines also after they left.
  • A player online when their game is rebuilt after a restart is put back at
    the table at once (they lost it for not coming back).
  • Deleted accounts leave the daily challenge's, the drills' and the
    challenge rating's boards; profiles ask the database for much less.

Security

  • Notifications never run text as code. On Windows a desktop
    notification put its text inside a PowerShell script, escaping only the
    plain apostrophe; PowerShell also takes ‘ ’ ‚ ‛ for quotes, so a
    tournament named with them could run a command on the computer of every
    player who joined it and was away from the game when it started. The
    text now goes to the notifier as data only (the environment on Windows,
    an argument on macOS, after "--" for notify-send).

  • The updater's own PowerShell doubles every kind of quote (a profile
    folder such as "O’Brien" stopped the game from coming back), and the
    Windows installer is checked against its SHA-256 again right before it
    runs.

  • "Reset to defaults" kept the session but not the server that gave it, so
    a session from another server was then sent to the default one.

  • An administrator's name stays theirs: a listed administrator could rename
    their account, and whoever registered the old name became an
    administrator. Staff can't rename, and a listed name can't be registered.

  • Signing in is limited per address and per account across connections;
    wrong passwords in "change password" and "delete account" count like
    wrong sign-ins; names that can't exist and passwords longer than any are
    turned away before they cost anything; the limits' memory has a ceiling.

  • Private tournaments' and tables' passwords can't be guessed: lounge
    actions are limited for every way in, and five wrong passwords lock that
    table or tournament for the player for ten minutes.

  • Chat lines, names and status messages lose the characters that show
    nothing (Hangul fillers, the braille blank, tags, variation selectors): a
    line or a tournament's name made only of them was blank, not empty. The
    aim a player's game sends is passed on within a cue's range (a modified
    game could send absurd numbers to the opponent's).

  • A server, or a game on the local network, that names a seat no table has
    is ignored (the game stopped on it); a game snapshot no game could be in
    is refused when it is read; the list of games on the local network can't
    be flooded.

  • Address headers are believed from the proxies only
    (SNOOK_LEGEND_TRUSTED_PROXIES, by default private networks, where a
    host's proxy connects from): a client connecting straight to the server
    could send a new x-forwarded-for with every connection and escape every
    limit per address.

  • Eight wrong passwords from anywhere locked an account for 15 minutes, so
    anyone could keep its owner out. They are now counted per account and
    address (8), per address (20) and per account from everywhere (60).

  • Moderators no longer see players' e-mails, payments and Store purchases
    or where the staff sign in from, nor find an account by its e-mail;
    nobody answers reports about themselves, and moderators act on players
    only (reports about staff, administrators' notes). The staff can't
    rename or delete an account in the middle of a game, a table, the queue
    or a tournament.

  • A line break in the chat or a name turns into a space (the words were
    glued together); a few more characters that show nothing are left out.

Server

  • The weekly cup and the staff's tournaments were never recorded (the
    database refused a tournament without a host): they now count among the
    tournaments played and won, and on the trophy shelf.
  • A weekly cup the staff called off opened again a minute later; it now
    stays off until next week's.
  • A finished game whose saved copy couldn't be deleted for a moment came
    back when a player signed in again; the delete (and recording a
    tournament) is tried again. A server going away no longer rebuilds the
    games it has just handed over, and rebuilt games stay off the lounge's TV
    (whether they were private isn't saved).
  • A knockout match neither player showed up for no longer sends the first
    of them through; a guest who leaves is taken off waiting lists too; a
    themed tournament called off for want of players is named (not "the
    cup"); events are read one reload at a time.
  • A break that made balls of both groups counted ...
Read more