- Remove package-lock.json: the server uses no npm packages, which the
invariants check enforces (no supply chain to attack).
- Allow the two hosts the server really calls in .github/allowed-hosts.json:
cdn.jsdelivr.net (Twemoji pictures, lib/emoji.js) and vision.googleapis.com
(the optional SafeSearch check, lib/image-moderation.js). The github.com
mention in lib/emoji.js was only a comment, now reworded.
- logText strips line feeds with .replace(/\n/g, ""), the form CodeQL's
js/log-injection recognises as a sanitiser. The old [\r\n]+ to a space was
just as safe, but not recognised, so every log line using it was flagged
(34 alerts on main, 35 on this branch).
- /authenticate: the saved sign-in is decided by what the server finds for
the refresh token, not by whether the request has one
(js/user-controlled-bypass). A token that is not good is still refused
with error_code 100.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Staff and moderation
- Invisible staff (!invisible, "xiv"): hidden from players, half see-through
to other staff, cannot chat while hidden. New permission staff.invisible.
- Summon and goto land on the player's exact spot ("xgt" before the move).
- Custom warnings (!warn PLAYER custom TEXT), shown in the warning popup.
- Mod notes (!note, !notes; lib/modnotes.js), on the player page and the
dashboard.
- Granular permissions: per-role overrides (setting rolePermissions) and
per-account grants and denies, applied live to staff who are playing
(refreshStaff re-sends "xsp").
- Item control (lib/itemcontrol.js): lock items out of the item finder
(!lock, !unlock, !locked), take an item from a player (!take), delete a
custom item from the game and every inventory.
- GET items/find: search any item by name or id, marked locked, for the
dashboards' quick lock.
Player-made items (lib/playeritems.js, "xcm")
- The Item Maker: make, rename, set the worn look, delete. 5 a day, 20 in all;
names go through the name filter.
- Admin switches: Item Maker on/off, new items wait for approval, and a
separate switch (on by default) that holds every player-uploaded picture
for a moderator. Review queue for items.approve (moderator and up).
- Pictures (lib/itemart.js): PNG, JPEG and GIF cleaned of metadata, BMP
converted to PNG; 512px and 300KB at most once cleaned.
- Worn as the maker chooses: a sticker (the picture) or a texture (the
item's shape painted with the picture).
Picture safety
- A picture waiting for approval is never served publicly: /itemart/ 404s it,
and it is only shown through /account|/mod|/admin/api/itemart to its maker
and to staff who review or make items.
- A picture turned away or taken off is remembered by SHA-256 and cannot be
uploaded again.
- Three strikes: three pictures turned away stops a player's uploads until a
moderator lets them again. Staff can stop or allow uploads by hand.
- Accounts under 24 hours old cannot upload pictures (AJ_ITEM_ART_MIN_HOURS);
uploads capped at 10 a day.
- Optional Google Cloud Vision SafeSearch (lib/image-moderation.js) for item
pictures and Art Studio paintings when AJ_GOOGLE_VISION_API_KEY is set;
fails closed when the scanner is unreachable.
Chat
- Emoji: Twemoji pictures served at /emoji/<codepoints>.png and cached in
data/emoji (lib/emoji.js).
- Smart spam filtering before the word filter (lib/chatspam.js): long runs of
one character, repeated words and lines, huge words and emoji floods are
tidied, and repeats within 20 seconds are dropped.
- Typing indicator: "xty" is passed on to everyone in the room who can see
the player, at most every 2 seconds.
Games (lib/minigames.js)
- Room games can be played together: a MULTIPLAYER table gives a game a
waiting list (Single Player / Multiplayer). Players in the same room are
matched, taken into the game together, and each one's moves are relayed to
the others. Gem Breaker is the first: two players, "pos", "shoot" and
"playerLost" relayed.
- Gem Breaker's start message now lists each player's id. Without it no
player counted as local, so even single player could not aim.
Other
- Players stay connected through the client's new 75-minute AFK limit
(idleTimeoutMs 80 minutes).
- Jam-a-Grams carry custom items and colours; Jammer Wall avatar photos are
validated (walls.js photoParam).
- Weak passwords refused (common words, or containing the username).
- Code-scanning fixes: every logged value goes through logText
(lib/logtext.js) against log injection, HSTS, path-only error logs, a
single file read in lib/names.js.
Tests: items (pictures, approval, strikes, re-upload refusal, the hidden
waiting picture, the dashboard search), staff (invisibility, goto and summon
spots, custom warnings, notes), buddygames (two-player Gem Breaker, the
typing relay), and updates for main's verified badge and spawn rooms.
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]>
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.
- 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
- searching players by address and lifting an address ban need
address.ban (moderators and above), not only the panel itself
- entering a full room goes by the staff role
Co-Authored-By: Claude Opus 5.5 <[email protected]>
- a warning given while the player is away is kept and shown with the
game's popup once they are next in a room (the latest one)
- unwarn: "Take back latest" in the moderator panel, !unwarn in game and
from the staff window ("xmd")
- config.warningSilence: the Nth warning within some days also silences
(3rd: an hour, 5th: a day, by default)
Co-Authored-By: Claude Opus 5.5 <[email protected]>
For staff, the report button of a player's card opens a window for that
player instead (AJClient.openModerate): warn with a reason, send a
message, silence for an hour or a day or lift it, bring them here, go to
them, disconnect, and their warnings. Only what the role allows is shown.
The window sends "xmd" [command, username, ...], which the server runs as
the staff command typed in chat (lib/commands.js), so the permission check
and the moderators' log are the same; the answer comes as a message box.
Only active staff, and only these commands. Staff are sent their role and
permissions at login ("xsp"); nobody else is sent anything.
test/staff.js covers xsp and xmd, and that a player's xmd does nothing.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
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