- a special animal's pattern has four colours, as its presets do: the
pattern tab's 1 to 4 each have a colour table
- the Item Giver opens in the game again; the Item Maker's previews keep
their own colours instead of the giver's colour box
- the drawn trading sign is gone
- sign-up, the terms and the privacy policy say 18 and over (terms
version 2026-10-24)
- builds 92
the switch took the animals out of the list by index, as if the one in use
were always first; one of the other kind, just adopted, goes first instead.
the list is now rebuilt by which animal is which. builds 87
- egg stands sell an egg again; a bought egg hatches and is named at once
- pets whose bits name no pet the game has no longer stop loading
- the adopt-a-pet gift path opens with nothing adopted yet
- Spider Zapper and Wind Rider start with their players: spiders can be
shot, and Wind Rider is played; Spider Zapper's waves are answered
- Phantom's Treasure can be left from its title screen and level choice
- the Touch Pool's fact window always closes
- the last key in Return of the Phantoms lies where it can be reached
- the Alpha HQ's bios and relics open and close
- a land animal in water (and a sea one on land) is drawn when it stands
- a seasonal theme's room has today's shops in it (lib/themerooms.js)
- the Forgotten Archive sells its own stock, not unfinished pieces
- custom items whose def is gone stay out of trade lists
- the captcha is always shown, and tried again when it fails
- builds 85
- the eco den items work: the Eco Shop sells the real eco items, solar
panels and wind turbines placed in the den in use earn eco credits, lamps
switch on while there is power for them, and the eco score earns the
three eco plaques; a first look gives an account its first credits
- the item giver row opens the web item giver
- a painting that cannot be shown is the Burrow logo, not a wait for good
- Jammer Central's buttons work; What's New shows the newest Jamaa Journal
- the Jammer Wall opens even while the HUD is checking the player's own; a
photo of an animal wearing nothing is kept; a wall photo of an animal the
game does not know no longer stops the wall
- the photo booth's paid picture is answered
- emoji no longer push the line off centre; "\" keeps an emote or a
":name:" as typed; a repeated line with emoji is sent as it was said
- the emoji button hides with the HUD, not a moment after
- the join date on a player's card stays in its corner
- den items whose def is gone no longer garble the den and the inventory;
custom pictures in a den no longer stop walking
- the den editor's switch and recycle buttons are always there
- the den inventory scrolls to an eleventh item
- codes made in the admin panel (Messages) give an item, gems or
diamonds through the game's Redeem Code window, which was never
answered; its "need help?" says what codes are here
- the number of worlds is set in the admin panel (Debug), live
- a den's owner is told how many are in it: the HUD's count and doorbell
- the map counts the player's buddies in each land of their world
- gifts whose item no longer exists, or with a nonsense amount, are no
gift at all, rather than a window that will not close
- custom item pictures are 256 pixels and 100 KB at most
- the account page's buddies and den visitors fold away
- shops no longer count down "X days left"
recordings of the official game (tools/recorder.js) had its game table and
several generic lists in them:
- lib/games.json follows the official table: the print kits, Brady's lab,
the carnival games (in the room) and the buddy games have their real
ids, and every game its "Play!" picture
- lists the server has nothing of its own for are answered as the official
server did (lib/official-lists.json): the Journey Book's facts, and its
pages and four of the Chamber of Knowledge's books rebuilt from the media
files; Jam-A-Gram stamps are the official ones
- feedback windows send to the staff panels' feedback, over the game's own
connection; museum gem donations are taken (cd)
- fact cards and museum exhibits missing from a list are had by their id
(factDefs), and their arrows do nothing past the list
- a completed trade no longer plays the failure sound over the success one
- a sign over players who are trading, seen by everyone in the room
- every item added to a trade list is shown; lists keep up to 200 items
- the drink, popcorn and cotton candy machines always hand over what they
made (the game sent nothing when it was like the last one it gave), the
smoothie machine even when the game it is was not noted down, and the
server takes a game's message for a moment after it is left
- claw machine, Phantom Invasion and Sky High prizes are the game's own
items only: a custom item could be missing from the winner's game
- Jam-A-Gram privacy: the inbox's options were taken the wrong way round
- report window: no instruction text over the reason
- the museum's theatre and other unnamed rooms get names; every shop a title
- "How did you hear?" is never offered (its window soft locked the game)
- video spots with nothing to play open a "Your Video" box on the game page;
the trade list's help plays a video; the theatre's box no longer vanishes
- emotes, actions and phrases are limited per player, as typed chat is
- phrases from the menus come in the sender's chat bubble style
- settings: WASD, blocked players and custom items as two-sided switches,
graphics at their best by default, a switch for bubble animations, and
Manage Account beside two-step sign-in opens the account page
- pressing a @mention in a bubble no longer walks the player there
colours from a dump of a beta-era inventory, added after each item's own
so the colours already given keep their place: Rare Eyeball Hat, Creature
Mask, Tiara (two), Arctic Hood, Elf Helmet, Furry Hat and Turquoise Ring.
the shop shows a list's first 8, so these are had from the item givers.
/account/items, linked from the account page and using its sign-in, gives
items to the account signed in:
- clothing: the item's own colours, or four colours of your own as a
picker, #RRGGBB, or AJ's numbers (palette places, or the whole item's
colour id signed or unsigned), converted as you type; hex colours not in
the palette become an exact custom colour
- den items: the variants their art has (lib/den-variants.json, made by
tools/den-variants.sh) and a whole-item tint with a strength, kept in the
item's version above the variant and drawn by DenItemHelper (build 83)
- a preview of each: clothing icons coloured on the page as the game
colours them, den items played by Ruffle in a sandboxed frame through
public/item-preview.swf (tools/preview-host)
a give with a custom colour id that does not exist is refused.
"Sign in with the Burrow client" on the account page's sign-in screen
opens burrow://account?n=<nonce>; the browser asks whether to open
Burrow. The client asks for a ticket with its login token
(POST /account/api/client-ticket) and opens /account/client?ticket= in
the browser, which signs in there. A ticket lasts 2 minutes, is good
once, and signs in only the browser holding the nonce's cookie, so a
burrow:// link from elsewhere signs nobody in and a ticket sent to
someone else opens nothing. The tab that started it follows by itself;
once it has worked in a browser, the page asks for Burrow by itself.
A computer is taken for a banned one, and an account for an alt, only
when they share at least 3 hardware IDs (system, board, disk, the
client's own); one or two in common was too often someone else's.
Network card addresses still do not count. A hardware ban is refused
for an account with fewer than 3 IDs known, as it could match nobody.
MAC-only ("weak") alts no longer exist, so the flag is gone from the
panels.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
The VIDEOS sign's window threw on Play and Stop since 8babe9c
(onTheatreControl read _loc1 for _loc1_, ReferenceError #1065), so a
room video never started. It is now drawn as the page's Your Video box:
cream panel, outlined title, a white link box, green "Play for room"
and red "Stop" pills and the red round close button, over the middle of
the theatre's screen, with no dark cover over the stage. Enter plays,
Escape closes.
ajclient.swf is built with this and the two commits before it;
buildVersion 82.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
- server: a typed name the filter (lib/chat-filter.txt) stops is
refused at xrn, with the game's warning and a line in the log; one
saved before is cleared at login (the animal takes the username, the
pet is "Pet"). the game's own word-id names are never looked at.
- client: LocalizationManager.translateAvatarName and translatePetName
pass a typed name through the player's own filter
(AJClient.filterName), wherever the game shows it. a name cannot be
left out, so with "Hide the whole message" its words are starred.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Playing as a pet showed the pet's name over it whatever the settings
menu said. Now it shows the player's username, as the switch does by
default, or the pet's name with Animal Names, and changes when the
switch is flipped.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
The website's sign-up box, the Terms of Service and the Privacy Policy
said 13 and over; they say 16 now, as the client does. The privacy
policy's "or the higher age your country sets (up to 16)" is gone, 16
being that highest age. termsVersion 2026-10-21.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Approving and removing framed paintings was items.approve, which also
judges the items and pictures players make. masterpieces.approve now
guards it, on the server (POST /mod/api/masterpiece) and in the mod
panel's buttons and its "only ones I approved" filter. Moderators and
admins have it by default; seeing the Masterpieces page is still
player.view.
roles.load, once at start (setting permissionSplitMasterpieces): a role
list the admin changed, and a staff member's own grants and denies, that
held items.approve are given masterpieces.approve too, so nobody gains or
loses anything by the split.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
In a theatre, "Browser" puts a web page on the screen for that player
alone, beside "Your Video". The desktop client (1.3.3) draws it in a
sandboxed webview of its own over the game page, which tells it where,
what the game draws over it, and where to go; nothing of it goes to the
server.
- off by default: the admin panel's Debug tab turns it on for everyone
(setting theatreBrowser). the server marks the game page with
data-theatre-browser="on" as it sends it (lib/http.js), and the page
shows the button only when the server allows it and the client says it
can draw it, so older clients never see a button that does nothing.
- the boxes over the screen share one style (.aj-box), and a clicked
button no longer keeps Chromium 87's focus ring.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
8fb5cfe's own-video player names www.youtube-nocookie.com and
player.vimeo.com in public/game.html, which the security check's
invariants refused: neither was in .github/allowed-hosts.json.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
b11ae1d made the server load discord.js at start, through lib/discordbot.js,
even with the bot off. update.sh installs no npm packages, so prod had none,
and every start failed with "Cannot find module 'discord.js'".
- lib/discordbot.js loads discord.js when the bot starts (a token and guild
id set), not with the server. without the package the bot stays off, with
a line in the log, and the panel's Start says to run npm ci. the two
message flags cards use are written as numbers, and the slash commands
are made when they are synchronized.
- deploy/update.sh runs npm ci --omit=dev when package-lock.json changed or
node_modules is missing. a failed install leaves the bot off; the game
needs no package.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
In a theatre, "Your Video" opens a box for a YouTube, Vimeo or .mp4 /
.webm / .mp3 link that plays for that player alone; nothing of it goes to
the server. A staff video for the room comes first and the player's own
waits for it.
The game now tells the page where the theatre's screen is
(AJClient.reportTheatreScreen: the original player's 512 by 288, in stage
coordinates), so both videos sit exactly on it at any window size. It
also tells which parts of it the game's windows, buttons and chat
balloons are drawn over, and the page cuts those out of the videos and
hides its controls under them: a web page is otherwise always drawn over
the game.
The box is in the game's own look. Desktop players need client 1.3.2,
which lets the game page load the video players and the one file link the
player chose. buildVersion 78.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
The admin panel's "What they did" table, in the moderator panel too: the
latest 300 entries. A new permission, staff.log, which moderators and
admins have by default, guards the page and its route.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
The account view's Lost access box gives the account a new random password
(12 characters, none that look alike), shown once with a Copy button. It
signs them out everywhere and forgets trusted devices; "Turn off their 2FA
too" is for a lost authenticator. Written to the mod log, without the
password.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
The login's Guide option made a player a guide on their own screen only:
the room's avatar packet never said so, so everyone else drew a plain
player. "ac" now sends the guide field (bit 4, after a blend colour of 0),
which gives the guide's name tag and chat bubble on every client.
Guide is now given in the admin panel (Make guide / Remove guide, logged).
Asked for at login by anyone else, it is refused, with a plain message on
arrival. A guide's custom client can still leave it off; the official
launcher asks nothing, and a guide shows as one.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
The rules were written into the client, so changing them meant a new
build. GET /rules.txt reads data/rules.txt on every ask (no restart
needed; data/ is what prod keeps between deploys and lets the server
write), making it with "Example" when there is none. The rules window
fetches it each time it opens: a line starting "# " is a heading in the
old rules' heading style, the rest is shown as it is written (escaped,
never HTML). 64 KB at most. buildVersion 75.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
- accounts under a day old cannot paint for a frame: the easel's token is
refused and a message box says how long is left
(AJ_MASTERPIECE_MIN_AGE, 86400; the tests use 0).
- 10 new pictures an account in any 24 hours (config.masterpiecesPerDay),
counted in the database (masterpiece_uploads) so a restart does not
forget them; past it HQ says when the next one may go. a picture
approved before is not a new one.
- a picture a moderator or the admin approved is approved again as it is
framed, and the same picture waiting is approved with it, its makers
told: the same file (SHA-256), or the same painting saved and painted
again, which comes back as other bytes. lib/jpegprint.js reads every
8x8 block's average from a baseline JPEG's DC coefficients (~2.6 ms for
the Art Studio's 711x434); the same size with no block more than 2 of
255 apart is the same picture (a saved .ajart painted again: 1).
- staff taking a painting back forgets its picture.
- paintings from before get their hash and fingerprint a few at a time
after start; those a person approved make their pictures approved ones.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
A switch in the pet chooser (the settings menu's own On/Off switch, at
the top left of the pet's picture) puts the pet that is out in the
avatar's place, for everyone, as at a Play-As-Your-Pet party: the pet
at the party's size where the avatar stands, turning as it walks, its
name on the name bar, chat balloons and emotes over it, the pet in the
HUD. Hidden at the party itself.
- kept as user var 9008 (9007 is the performance profile), so it holds
through rooms and logins and is kept for the next pet when the pet is
put away. the server tells the room by user communication type 13,
also to players coming in later.
- WorldPet and AvatarWorldView ask the avatar's own form instead of the
room-wide party test; a pet that cannot come into the room leaves the
avatar shown.
- the type-13 handler read a variable it never set, so every client took
every message for "off" and nobody else saw the form.
- the action menu's pet button does the pet's trick again (5c9b2e0 had
made it the switch, which only hid the avatar).
Flying pets keep to the ground's walls (the party lets them over).
buildVersion 74.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
A "Music" page in both panels: an MP3 (MPEG layer III frames, 4 KB to
15 MB) becomes a den music track at once, with no restart.
- lib/custommusic.js: a custom den item made from "Jam On" (614) with a
new `audio` column, the file's version. Its abbrName is
CustomMusic<id>_<version>, which the content handler answers from
data/custom-music/<id>-<version>.mp3, so a new upload is a new name and
no game plays an old copy from its cache.
- games get it by "xdi" with no client change; players from the item
finder, or the shop when staff tick "on sale".
- deleting it takes it from every inventory and removes the file.
- /mod/api/music and /admin/api/music: list, play, upload (name, cost,
inShop in the query), delete; 30 uploads an hour per staff member;
"music uploaded"/"music deleted" in the mod log.
- new permission music.upload, on the Admin role by default; a role list
the admin has changed needs it ticked. The panels' CSP allows
media-src 'self' for the preview players.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
"pn" (EggPetHatchedPopup) saved `account`, which that handler never
defined since aa455f5: a ReferenceError after the name was set in
memory, so no reply went out and the game's loading spiral never ended,
and the name was not saved, so the popup came back at every login.
"account is not defined" at lib/pets.js in prod's log several times an
hour since 10-17.
qol.js names the egg it buys and waits for the answer.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
A custom item change made the item and name packs again on the next
fetch, on the one thread every game shares: ~360 ms at 5000 items,
~1.6 s at 50000, after every change, players making them many times a
minute. Nearly all of it was the AMF3 writer.
- the writer fills one growing buffer instead of a Buffer per value
(byte-identical output, checked against the old one on every cached
pack): the item pack 230 -> 52 ms at 5000 items, 1524 -> 231 ms at 50000.
- a changed pack is made again at most every AJ_PACK_REMAKE_MS (15 s);
until then the one made before goes out with the custom item version
it has, and customItems.sendAll sends a game logging in what its packs
lack by that version. one remake at a time; deflated on libuv's threads.
- tests make the packs again at once (AJ_PACK_REMAKE_MS=0), and a run of
the items test checks the throttled case.
Busy evening simulated in-process (a change every 3 s, packs fetched
6 a second, 30 s): longest hold-up 329 -> 61 ms at 5000 items, 1648 ->
359 ms at 50000 (p99 240 -> 6 ms).
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Every custom item's full def row went to every game at login, though the
item and name packs it fetched minutes before already have them all: with
5000 clothing and 452 den items that was 3.3 MB, 4.2 MB with the colours,
over the send backlog limit (94b8de8 raised it).
- a fetch of the item, den item or name pack notes, per address, how far
the custom items had changed; at login a game is sent the items changed
since, and those with a picture (the packs have no pictures). an address
that fetched nothing lately is sent all, as before.
- "xdi" rows carry the fields the client reads (addItemDef,
addDenItemDef), not the whole base row, and clothing is for any animal
as in the pack.
- accounts keep a digest of the state last written, not a copy of it
(~13 KB an account, ~185 MB on prod).
Measured locally with prod-sized data (20000 colours, 5452 items, 14k
accounts): the login burst 4.2 MB -> 1.5 MB (the colours are most of what
is left), live heap after start 419 -> 297 MB.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Every custom colour and item def is written at login before the client
reads; at 20000 colours and 5000 clothing that is ~4.2 MB, over the 4 MB
backlog limit, so every login was cut off right after it succeeded.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
update.sh piped git diff --name-only straight into grep -q; grep stops at
the first match, so with a long list git hit a broken pipe and pipefail
made the test false: "no restart needed" after 33f5607 (134 music files).
The list is now taken whole, then searched.
- Discord: the account page links a player's Discord account through
Discord's sign-in (lib/discord.js); only linked names are shown on cards
(typed ones are cleared). A bot keeps the Server Booster badge on linked
accounts that boost. The game tells the client where the player is, for
the client's Discord rich presence (flashvars discordAppId).
- @username tags in chat, chat balloons and wall posts: only real players'
names (asked of the server, "xmn"), names with spaces too, drawn on a
blue box; a click opens the player's card.
- Settings: separate Music and SFX volume sliders for the old one.
- Device ids required: a launcher that sends none (before 1.3.0) is told
at the game's login "Your client is outdated. Update at
https://burrow.moe/download". AJ_REQUIRE_DEVICE=0 turns it off.
- Panels: clear a player's Jammer Wall posts; turning away masterpieces
and player items asks first.
- Item Giver: negative colour ids (the same colour written signed).
- buildVersion 71; the client rebuilt with Snipzil's sitting fix.
The 133 music files on the game's development CDN that no den item plays,
in public/music/ (78 MB) and lib/extramusic.js (items 6013-6145), each
titled with its file name; the owner's debug track (6012) with them. Files
that already are den items under another name (the same audio, or the
same track by name and length) are left out.
A "Custom pictures" row in the game's settings menu, as Blocked players:
shown by default; hidden, every custom item is drawn with its base item's
art (icons, worn, placed in dens, Jam-A-Grams). Kept in user var 9006 (1 for
hidden), which the server stores like the other settings. buildVersion 62.
The game shows a name tag's badge to buddies only, except the News Crew
camera. AvatarWorldView now shows the Owner, Moderator and Verified badges
(def ids 63, 64, 76) to everyone too. ajclient.swf rebuilt with
tools/build-client.sh; buildVersion 61, so clients fetch it (PR #5's client
changes went out under 60 and may still be cached).
A sign-in without device ids is let in unless AJ_REQUIRE_DEVICE=1. An
account seen on banned hardware is still refused, with the ban's reason,
when its client sends no ids. The privacy policy no longer says the
client cannot sign in without them.
- rooms hold 40 players. a player not starting in their den arrives in
a random room of config.spawnRooms that has space (AJ_SPAWN_ROOMS
overrides); with every one full, the emptiest, over the cap.
- two worlds, Aldan and Congo (AJ_WORLDS sets how many): each its own
copy of every land, dens and parties shared. a player arrives in a
random world with space and keeps it through dens and parties.
- the settings menu's World row is back: the server sends the worlds'
names (generic list 16) and the world list (rm), and the client asks
for the names once at login. a buddy's "go to" leads into their
world, whose name the buddy card shows. "Find Open World" (on by
default) joins a full room in a world with space.
- the panels show the world with the room. the test harness pins one
world and the township. buildVersion 60.
A land animal underwater is shown the land actions (sit, sleep, hop,
dance, play) and an ocean animal on land the ocean ones; animals of
land and ocean both get a "Swim moves" / "Land moves" button above the
actions window to swap sets. gui.ActionManager joins swf-src. The other
set's dance and play go by names of their own (:danceLand:,
:danceSwim:, :playLand:, :playSwim:), and AvatarWorldView plays each
action from the set the animal has art for.
- the client (1.3.0) sends one-way hashes of the device's ids at
sign-in; the server keys them again with a secret of its own
(data/device-key) and keeps them per account (lib/devices.js). a
sign-in without them is refused with 426 (AJ_REQUIRE_DEVICE=0 lets it
in), so 1.2 clients cannot sign in.
- hardware bans: every device an account used in the last 90 days.
any id but a network card blocks sign-in, sign-up and the game, on
any account. a network card match, ids that look altered, or a device
shared with a banned player raise hardware alerts instead.
- both panels: hardware ban and lift, the account's hardware ids,
search by hardware id, other accounts by device or address, a
timeline (bans, staff actions, reports, alerts), and hardware bans
and alerts in the bans tab.
- jam-a-grams and wall posts go into the chat log, the filtered ones
marked not sent. chat search filters by kind, by what the filter
stopped, and from a time back; each player's page lists their
jam-a-grams and wall posts, sent and received.
- account search runs on the server and ranks exact names first, then
names starting with the search; the admin panel no longer downloads
every account. hidden tabs only refresh the waiting counts in the
title. masterpieces can be searched by maker, approved ones too.
reports can show the reported player's chat at the time. links follow
the open tab and player.
- admin actions on accounts go into the moderator log.
- privacy policy covers hardware hashes and the new logs.
- lib/chatfilter.js reads its rules from lib/chat-filter.txt (reloaded
when it changes) and applies them to typed chat, jam-a-gram messages
and jammer wall posts. players cannot turn it off. a blocked message
reaches nobody, its sender sees the game's "inappropriate behavior"
warning, and blocked chat is kept in the chat log marked not sent.
- rules match words, prefixes and phrases, in order or anywhere, with
"?" for any word and "!" for exceptions, and see through stand-in
letters, drawn-out letters and spaced-out spelling. the example rules
block sexual talk aimed at someone while letting plain swearing
through; the slur section is left for the owner to fill in.
- secret valentine jam-a-grams are off: the client sends a normal card
without asking (buildVersion 56), and the server refuses a card asked
for as a secret valentine.
Ping on prod jumped to seconds because node's main thread was busy most
of every second.
- accounts.save(account, ...) names the changed accounts, which are
written within a second; the rest are looked at a few at a time
(10 ms a save for those in play, 5 ms for the others). One save under
prod-like load: 289 ms before, 16 ms after.
- an asset the CDN does not have gets a cacheable 404 and is logged once
- the proxy's own connections no longer count against the web cap, which
had node reset requests nginx had already let in
- a repeated client error is written once in ten minutes; the panel's
log buffer trims in batches
- the daily backup uses sqlite's online backup off the main thread
- stats graphs for the admin and moderator panels (lib/stats.js, public/stats-view.html)
- playtime, private unless shown on the card's bio tab; set on the account page
- search accounts by ip address, only against ban evasion; mods see no addresses and each search is logged
- privacy policy for the above (terms version 2026-10-17)
- the per-second save looks only at accounts in play, with a slow sweep of the rest
- items in several dens at once; chat filter hides slurs and threats by default
- sexual usernames refused; moderators may enter full rooms; guide login allowed
- 150-character chat box (client build 55)
- fixes: gifts, trades, dens, pets in dens, den recycling, special animals' colours,
jammer walls, settings switches; the buddy list sent at login
- the item giver, the rules screen and the art studio rework