Files
burrow-server/lib/roominfo.js
T
SnipzilandClaude Opus 5.5 e05565787f feat(server): staff tools, player-made items, picture safety, chat, multiplayer games
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]>
2026-10-17 21:44:10 -04:00

103 lines
4.0 KiB
JavaScript

"use strict";
const {logText} = require("./logtext.js");
const zlib = require("zlib");
const amf3 = require("./amf3.js");
const cdn = require("./cdn.js");
const defpacks = require("./defpacks.js");
// what a room's own file says about it: its name ("Jam Mart Clothing"),
// which the client shows in the corner of the screen, and which shops stand
// in it. the room defPack has neither, and a shop's title is not in any
// defPack at all: the official server sent both along. the file is the
// same one the client loads to draw the room (roomDefs/<path>.xroom: zlib,
// then AMF3), so reading it here costs no extra download once anyone has
// been in the room.
// what the room editor left in files nobody named.
const UNNAMED = "Display Name";
// rooms whose file has no name and whose path does not spell it either.
const NAMES = new Map([
["jamaa_township.room_diamonds", "Diamond Shop"],
["jamaa_township.room_alphahq", "Alpha Headquarters"],
["oceans.deep_sea", "Deep Blue"],
["aussie.room_main", "Kimbara Outback"],
["aussie.room_aushop", "Outback Imports"],
["aussie.room_hos", "Medical Center"],
]);
const VOLUME_SHOP = 12; // ActorVolume.type: clicking it opens generic list `typeDefId`
const rooms = new Map(); // "jamaa_township.clothes_shop" -> {name, shops: Set of list ids}
const loading = new Map();
const filePath = base => cdn.hashedPath(`roomDefs/${base.replace(/\./g, "/")}.xroom`);
const parse = body => {
const room = amf3.decode(zlib.inflateSync(body));
const settings = (room.actors.ActorSettings || [])[0] || {};
const volumes = room.actors.ActorVolume || [];
return {
name: typeof settings.name === "string" && settings.name.trim() !== UNNAMED ? settings.name.trim() : "",
shops: new Set(volumes.filter(volume => Number(volume.type) === VOLUME_SHOP).map(volume => Number(volume.typeDefId))),
};
};
const remember = (base, body) => {
try {
rooms.set(base, body ? parse(body) : {name: "", shops: new Set()});
}
catch (err) {
rooms.set(base, {name: "", shops: new Set()});
}
};
// reads the room's file, downloading it if nobody has been there yet.
// nothing waits on this: the first player ever to enter a room gets the
// fallback name below, everyone after them the real one.
const ensure = base => {
if (rooms.has(base) || loading.has(base)) {
return;
}
loading.set(base, cdn.get(filePath(base))
.then(body => remember(base, body), () => {})
.finally(() => loading.delete(base)));
};
// at start: every room whose file is already in the cache.
const preload = async () => {
for (const path of defpacks.roomPaths()) {
const base = path.replace(/\//g, ".");
const body = await cdn.cached(filePath(base));
if (body) {
remember(base, body);
}
}
console.log(`[rooms] names of ${logText(rooms.size)} rooms read from the cache`);
};
// A name made from the path, for a room not read yet or left unnamed:
// "jamaa_township.room_main" -> "Jamaa Township", "oceans.crystal_reef" ->
// "Crystal Reef". the seasonal versions of a land ("room_main_summer") are
// that land.
const titleCase = text => text.split("_").filter(Boolean).map(word => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
const fallbackName = base => {
const [folder, room = ""] = base.split(".");
return NAMES.get(base) || (/^room_main|^main_room|^$/.test(room) ? titleCase(folder) : titleCase(room.replace(/^room_/, "")));
};
const name = base => (rooms.get(base) || {}).name || fallbackName(base);
// the title of a shop opened in this room, as the id of a localization
// string (Shop.gotItemListCallback), or "" to leave the shop window's own.
// A shop's title was its room's name ("Jam Mart Clothing", "Epic Wonders");
// a shop standing in a land's main room has no name of its own to be found.
const shopTitle = (base, listId) => {
const room = rooms.get(base);
if (!room || !room.shops.has(Number(listId)) || /\.room_main/.test(base)) {
return "";
}
return defpacks.stringId(name(base)) || "";
};
module.exports = {ensure, preload, name, shopTitle};