Repository navigation
Releases
0.9.0
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 | shInstall 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
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.jsonnow 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
oninstance.lockin 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 withSNOOK_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:mainhas 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 | shInstall 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... |
0.8.2
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_breakerin 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_foulreturns 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 newball_offonIllegalBreak, 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::Cushionsaysjaw; 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...
0.8.1
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'spenaltyends 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) andUi::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_PRODUCTStakesvip_month=<Store ID>; the start-up
log saysMicrosoft 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 amongstore_packs, so a game of 0.8.0 never shows it as a
pack of coins.- The staff portal: the purchase shows as
vip_monthamong 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_monthinSNOOK_LEGEND_MSSTORE_PRODUCTSonly 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.yamlnames the servicesnook-legend-server, its name on Render
(the address stayssnook-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 | shInstall 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
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::Brazilianand
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 }andset_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_CUPtakesofficial), 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(andcorr_choose/corr_chosein
daily games): the choice an official break leaves, made by the player to
move; the shot clock takes its first option./api/statuscounts the players online under each rules;
/api/leaderboard?rules=officialgives 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 | shInstall 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
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_listandladder_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 | shInstall 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
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_ADDRESSand
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;Registercarries the age
group) for games of protocol 21 (AGE_PROTOCOL); the server sendsAge
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 bytools/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 invendor/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 | shInstall 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
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, nowladder::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 | shInstall 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
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 | shInstall 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
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#gamefor 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 newx-forwarded-forwith 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 ...