- 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"
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]>
Since 7dee290 a Discord account linked to a staff member opened the
moderator panel for 12 hours on Discord's word alone, with no password and
no 2FA code, though the normal sign-in asks for both every time; and since
b11ae1d the bot took /moderate and /burrow commands from that Discord
account alone. The link outlives a new password and "sign out
everywhere", so a taken-over Discord account was enough to act as the
staff member. The admin dashboard's Discord sign-in (adminDashboardAccess)
skipped its password the same way.
- /mod/discord/callback and /admin/discord/callback no longer sign in:
they keep a pending sign-in for 5 minutes (a Strict cookie) and the page
asks for the linked account's 2FA code (POST .../api/discord/code). Five
wrong codes and it must start again at Discord. The admin one also needs
the account to have 2FA on and not be locked.
- the bot's commands and buttons count only for a staff member with a
panel session that took a code (modpanel.discordBot.commandActor): the
password sign-in, or Discord and a code; not the game's token sign-in. A
new password, signing out everywhere or 2FA turned off end those
sessions (forget), and so the bot's use. Whose Discord it is still keeps
linked staff out of /discord moderation, and lets them close tickets.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
- 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]>
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]>
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]>
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]>
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.
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.
- 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.
Both panels keep the black and white theme and the game's font, with a new
sidebar layout.
Moderator panel (public/mod.html)
- Dashboard: tiles for players online, open reports, requests and paintings;
find a player; recent mod notes; a Restrict Items card for roles that may
lock items.
- Player page: mod notes, the items the player made with their pictures,
"Take picture off" (counts as a strike), and stop/allow picture uploads.
- Items tab: make items, change their look, lock and unlock, take from a
player, delete.
- Review tab (items.approve): approve or turn away new items and pictures.
Pictures are blurred until clicked, and each card shows how many of the
maker's pictures were turned away before. Lists whose uploads are stopped.
- Emoji shown as pictures in chat logs.
Admin panel (public/admin.html)
- Overview: a Restrict Items card that searches any item by name or id and
locks or unlocks it in place, with the count of locked items.
- Items page: the same tools as the moderator panel, plus the Item Maker
switches (players can make items; new items wait; every picture waits).
- Role permission matrix on the Moderators page, and per-account permission
grants and denies.
- Main's Chat tab added to the sidebar.
Account page (public/account.html)
- My Items: rename, add or change a picture (converted and shrunk in the
browser when needed), sticker or texture, delete. Shows when a picture is
waiting for a moderator and when uploads are stopped.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Hardware bans, panel search and logs, two worlds and the verified badge,
with the branch's staff roles kept: full rooms let in active staff, and
address search stays with the roles that may ban addresses.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
- 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.
Staff with the new items.create permission (admins, and the new Developer
role) make clothing and den items from the game's own art: an existing
item under a new id (50000 on), name, price, members-only flag and choice
of its colours. No restart of the server or of anyone's game:
- lib/customitems.js keeps them (custom_items table) and puts them into
the server's tables and the packs new games fetch (defpacks.setCustomItem)
- games already playing get the def rows in "xdi"; so does every game at
login. The client adds them (ItemXtCommManager.addItemDefs,
DenXtCommManager.addDenItemDefs, both now in swf-src; rebuild with
tools/build-client.sh)
- they are sold first in the two shops of oddities and found by the item
finder; an item can be renamed, repriced, recoloured and taken off sale,
never deleted (players may own it)
- the moderator panel has an Items page; in game, "!item clothing|den ID
NAME" and "!item list"
- the Developer role holds only staff.list and items.create. The panel's
pages that show players (players, chat, reports, requests, bans,
paintings) now need player.view, which helpers and up have
test/items.js covers it end to end, including a restart (withServer can
keep its database for that).
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Moderators were one flag on the account. Now an account can hold a staff
role (lib/roles.js): helper, moderator or admin, each a list of named
permissions, with a higher role holding everything below it. An account
only marked `moderator` still counts as a moderator.
Every staff action checks the permission it needs, and staff never act
on staff of their own rank or above:
- warnings: kept on the account (who, when, the reason, a note for
staff), and shown to the player with the game's own warning popup for
the reason ("fw": inappropriate behavior, bullying, personal
information, scamming), which this server's strings already word as the
Burrow Rules.
- moderator panel: each action is checked against the role; new actions
"warn" (with a reason and note), "summon" (bring a player to the room you
are in) and "goto"; the player's page shows their warnings; GET
/mod/api/me returns your role and permissions, and the page hides the
buttons yours does not allow.
- in the game: !staff, !summon, !goto, !kick, !silence (HOURS, 0, or
off), !warn PLAYER [reason] [note], !warnings PLAYER and !message, for
staff whose role allows each, written to the moderators' log like the
panel's actions, marked "(in game)". To anyone else they are plain chat.
Usernames with spaces work.
- the login reply carries the player's own staffRole and
staffPermissions (empty for everyone else), so a client can show staff
tools only to staff.
- admin panel: a role picker on the account, "role" on POST
/admin/api/account, and GET /admin/api/roles listing what each allows.
The old moderator switch still works.
Also: the moderators' message box showed "--Message From Moderator--\n\n"
with the "\n" as written (strings 11134 and 11135 keep it as two
characters); they get real line breaks.
Staff powers need 2FA turned on, as the moderator panel already did. In
the game they come with the game session, which a trusted device opens
without a code; requiring a recent code there is left for later.
test/staff.js covers all of the above end to end.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
- 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