- The status card is the players' card now: a title, "Online" and the
admin's message, players and rooms, uptime and memory, an optional banner
image and a "Play Burrow" button. The open report count is staff data and
is no longer on it.
- The admin page's Discord tab takes a banner image URL (http(s), at most 500
characters, blank for none), saved as discordBotStatusBanner and named in
the mod log. GET /burrow-status-banner.png serves a banner of our own.
- The game activity, moderation, bot audit and security logs are one card
shape (logCard): a summary line, a list of fields and when it was logged.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
With a trusted local proxy the address was the last X-Forwarded-For hop,
which behind Cloudflare is Cloudflare's own edge: every visitor shared a
handful of addresses for the rate limits, and the Turnstile check was sent
an edge as remoteip. When that last hop is in Cloudflare's published
ranges (https://www.cloudflare.com/ips/), CF-Connecting-IP is used, if it
is an address. From anywhere else the header is ignored: someone who
reaches the server directly could otherwise name any address, past the
rate limits, address bans and AJ_ADMIN_ALLOW. Neither header is read
unless config.trustedProxy is on and the request came from loopback.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
- server: at most config.maxConcurrentCaptchaChecks (AJ_CAPTCHA_MAX_CONCURRENT,
24 by default, 1 to 100) Turnstile checks wait on Cloudflare at once; past
that the answer is captcha_unavailable at once, so a slow Cloudflare cannot
hold thousands of sockets open. The page's policy lets it connect to
challenges.cloudflare.com too.
- page: public/captcha.js gives up on a widget that has not loaded in 15 s,
or that loaded without turnstile.render, instead of waiting for ever, and a
render that throws counts as a failed answer. The game's captcha window says
to check the connection or a content blocker, with a "Try again" button.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
POST /api/register used accounts.register, whose scryptSync froze every
player for as long as each password took, so a burst of sign-ups was felt
in the game. accounts.registerAsync checks the same things, derives the
hash on libuv's pool (hashPasswordAsync), checks the name again after it
(another request may have taken it meanwhile) and inserts the account as
before. The game's own Create Account keeps the sync path.
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]>
Include instructions on verifying route signatures for signed push
webhooks and precautions against exposing webhook secrets in logs,
commits, or pull requests.
Add OpenRC service and configuration files to support automated server
updates on systems without systemd timers.
- Add `deploy/update-loop.sh` to handle periodic updates for OpenRC.
- Add `deploy/burrow-update.openrc` and `deploy/burrow-update.conf`.
- Update `deploy/update.sh` to support both systemd and OpenRC service
restarts.
- Add `deploy/README.md` with installation instructions.
- Update `.gitignore` to allow the deployment documentation.
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]>
Prevent slow or periodic account/player lookup responses from replacing a newer search, make both dashboard layouts usable on narrow screens, and use the unified dashboard masterpiece routes for staff and owner review images. Propagate approved username changes through moderation-facing history and cover report-name propagation with an end-to-end regression test.
Remember a standing avatar's valid action and mirror marker, replay it after avatar creation for players entering or reloading a room, and clear it on movement or exit. Add an end-to-end regression test for late join animation sync.
Deliver the in-game moderation and event overlays, theatre playback bridge, room-effect controls, staff shortcuts, friend-game prompts, and Windows emoji handling fixes.
Improve den editing with explicit front, behind, and natural stacking choices that persist without changing item position. Correct item display layers and custom artwork behavior, and make popup controls reliably closable.
Include performance-mode settings, animation and input safeguards, and rebuild ajclient.swf from the patched sources so the served client exactly matches the feature set.
Add owner/developer room-effect controls and chat shortcuts, staff movement that bypasses full or locked destinations, in-game moderation entry points, theatre video synchronization, and shared room effects.
Restore game and trade popups, reliably award refreshments and game rewards, support pet play outside parties, correct den placement categories, improve den item persistence, and refresh custom-item and masterpiece behavior.
Harden room, party, pet, minigame, and item state handling with matching feature and restored-system regression coverage.
Provide a single /dashboard entry point for owner and staff tools, with Discord OAuth sign-in for approved owner accounts and active staff. Add owner-managed dashboard access grants, staff server health and update visibility, filtering, moderation improvements, item controls, and per-animal clothing restrictions.
Replace staff-triggered password and 2FA resets with email-verified account recovery. Persist validated recovery addresses, use short-lived hashed recovery tokens, expose recovery flows in registration and account pages, and keep mail delivery disabled until its webhook configuration is present.
Cover dashboard aliases, recovery restrictions, Discord access, monitoring, item locks, wear rules, and staff behavior with regression tests.
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]>
the dates under the graphs of 7 days and more were formatted with weekday
and dateStyle together, which browsers refuse (a TypeError), so render()
stopped after the tiles and none of those graphs was drawn on the admin or
the moderator panel; only the last 24 hours were. the date is now spelled
out instead ("Sun, Oct 18, 2026").
Co-Authored-By: Claude Opus 5.5 <[email protected]>
From the 18 October security audit (S-9, S-10).
- the moderator panel only refused a role the actions in its permission
map. hardware bans and lifting them were missing from it, and answering
ban appeals (which lifts the ban, the address's too), name requests,
paintings and reports were checked for player.view alone, so a Helper
could do all of them. each now needs its own permission (address.ban,
player.ban, player.names, items.approve, player.warn), with the rank
check the other actions have, and an action missing from the map is
refused. the page hides what the role cannot do.
- a new password, "Sign out everywhere", locking the account, turning 2FA
off or deleting the account now also ends its moderator panel sessions,
as the admin panel's reset already did, so a stolen panel session does
not outlive them.
- test/staff.js covers both, and fails without either fix.
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.
Introduce a bubble system that allows players to signal availability for
specific buddy games. Other players in the same room can click the
bubble to initiate a game. The implementation handles bubble visibility
for new arrivals and ensures bubbles are cleared when players leave
rooms or start other activities.
Replace AvatarManager.checkIfAnimatingOnTopOf with P-code to fix an
issue where players were pushed off others within 100 pixels. This
also bypasses decompilation errors in the original class loops.
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).