mirror of
https://github.com/burrow-dev/burrow-server.git
synced 2026-11-18 17:27:50 -05:00
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]>
103 lines
4.0 KiB
JavaScript
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};
|