Files
burrow-server/lib/support.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

158 lines
6.4 KiB
JavaScript

"use strict";
const {logText} = require("./logtext.js");
const accounts = require("./accounts.js");
// what players send from the account page (/account, lib/manage.js) for
// whoever runs the server to answer in the admin panel: requests for a new
// username, and feedback and bug reports.
const SCHEMA = `
CREATE TABLE IF NOT EXISTS name_requests (
id INTEGER PRIMARY KEY AUTOINCREMENT,
created_at INTEGER NOT NULL,
account_id INTEGER NOT NULL,
old_name TEXT NOT NULL,
new_name TEXT NOT NULL,
reason TEXT NOT NULL,
status TEXT NOT NULL DEFAULT 'waiting',
handled_at INTEGER
);
CREATE TABLE IF NOT EXISTS feedback (
id INTEGER PRIMARY KEY AUTOINCREMENT,
created_at INTEGER NOT NULL,
account_id INTEGER NOT NULL,
username TEXT NOT NULL,
kind TEXT NOT NULL,
text TEXT NOT NULL,
handled_at INTEGER
);
`;
const WAITING = "waiting";
const APPROVED = "approved";
const DENIED = "denied";
const WITHDRAWN = "withdrawn";
const KINDS = ["feedback", "bug"];
const MAX_REASON = 300;
const MAX_TEXT = 4000;
const MAX_OPEN_FEEDBACK = 5000; // waiting to be read; further ones are refused
const FEEDBACK_PER_DAY = 10; // per account
const DAY_SECONDS = 86400;
const now = () => Math.floor(Date.now() / 1000);
const db = () => accounts.database();
const clean = (text, max) => String(text === undefined ? "" : text).replace(/[\u0000-\u0008\u000b-\u001f\u007f]/g, " ").trim().slice(0, max);
const load = () => db().exec(SCHEMA);
const nameRow = row => ({
id: row.id,
createdAt: row.created_at,
accountId: row.account_id,
oldName: row.old_name,
newName: row.new_name,
reason: row.reason,
status: row.status,
handledAt: row.handled_at,
});
const waitingNameRequest = account => {
const row = db().prepare("SELECT * FROM name_requests WHERE account_id = ? AND status = ? ORDER BY id DESC LIMIT 1").get(account.id, WAITING);
return row ? nameRow(row) : null;
};
const nameRequestsOf = account =>
db().prepare("SELECT * FROM name_requests WHERE account_id = ? ORDER BY id DESC LIMIT 10").all(account.id).map(nameRow);
// asks for a new username. one request waits at a time: a new one replaces
// it. returns {request} or {error: "invalid_username" | "username_taken" | "same_name"}.
const requestName = (account, newName, reason) => {
newName = typeof newName === "string" ? newName.trim() : "";
if (newName === account.username) {
return {error: "same_name"};
}
// changing only the capitals of one's own name is not "taken".
const problem = newName.toLowerCase() === account.username.toLowerCase() ? null : accounts.usernameProblem(newName);
if (problem) {
return {error: problem};
}
db().prepare("UPDATE name_requests SET status = ?, handled_at = ? WHERE account_id = ? AND status = ?").run(WITHDRAWN, now(), account.id, WAITING);
db().prepare("INSERT INTO name_requests (created_at, account_id, old_name, new_name, reason) VALUES (?, ?, ?, ?, ?)")
.run(now(), account.id, account.username, newName, clean(reason, MAX_REASON));
console.log(`[support] "${logText(account.username)}" asked to be called "${logText(newName)}"`);
return {request: waitingNameRequest(account)};
};
const withdrawNameRequest = account =>
db().prepare("UPDATE name_requests SET status = ?, handled_at = ? WHERE account_id = ? AND status = ?").run(WITHDRAWN, now(), account.id, WAITING).changes > 0;
// requests waiting, oldest first; or with `handled`, the latest answered.
const nameRequests = (handled = false) => db()
.prepare(handled
? "SELECT * FROM name_requests WHERE status IN (?, ?) ORDER BY handled_at DESC LIMIT 200"
: "SELECT * FROM name_requests WHERE status = ? ORDER BY id LIMIT 500")
.all(...(handled ? [APPROVED, DENIED] : [WAITING])).map(nameRow);
const nameRequestById = id => {
const row = db().prepare("SELECT * FROM name_requests WHERE id = ? AND status = ?").get(Number(id), WAITING);
return row ? nameRow(row) : null;
};
const answerNameRequest = (id, approved) =>
db().prepare("UPDATE name_requests SET status = ?, handled_at = ? WHERE id = ? AND status = ?")
.run(approved ? APPROVED : DENIED, now(), Number(id), WAITING).changes > 0;
const feedbackRow = row => ({
id: row.id,
createdAt: row.created_at,
username: row.username,
kind: row.kind,
text: row.text,
handledAt: row.handled_at,
});
const openFeedbackCount = () => db().prepare("SELECT COUNT(*) AS count FROM feedback WHERE handled_at IS NULL").get().count;
// returns {ok: true} or {error: "empty" | "unknown_kind" | "too_many"}.
const sendFeedback = (account, kind, text) => {
const body = clean(text, MAX_TEXT);
if (!KINDS.includes(kind)) {
return {error: "unknown_kind"};
}
if (!body) {
return {error: "empty"};
}
const today = db().prepare("SELECT COUNT(*) AS count FROM feedback WHERE account_id = ? AND created_at > ?").get(account.id, now() - DAY_SECONDS).count;
if (today >= FEEDBACK_PER_DAY || openFeedbackCount() >= MAX_OPEN_FEEDBACK) {
return {error: "too_many"};
}
db().prepare("INSERT INTO feedback (created_at, account_id, username, kind, text) VALUES (?, ?, ?, ?, ?)").run(now(), account.id, account.username, kind, body);
console.log(`[support] ${logText(kind === "bug" ? "bug report" : "feedback")} from "${logText(account.username)}"`);
return {ok: true};
};
const feedbackOf = account =>
db().prepare("SELECT * FROM feedback WHERE account_id = ? ORDER BY id DESC LIMIT 20").all(account.id).map(feedbackRow);
const feedback = (handled = false) => db()
.prepare(handled
? "SELECT * FROM feedback WHERE handled_at IS NOT NULL ORDER BY handled_at DESC LIMIT 200"
: "SELECT * FROM feedback WHERE handled_at IS NULL ORDER BY id LIMIT 500")
.all().map(feedbackRow);
const markFeedbackRead = id => db().prepare("UPDATE feedback SET handled_at = ? WHERE id = ? AND handled_at IS NULL").run(now(), Number(id)).changes > 0;
// an account being deleted: what it sent goes with it.
const forget = account => {
db().prepare("DELETE FROM feedback WHERE account_id = ?").run(account.id);
db().prepare("DELETE FROM name_requests WHERE account_id = ?").run(account.id);
};
const openCount = () => openFeedbackCount() + db().prepare("SELECT COUNT(*) AS count FROM name_requests WHERE status = ?").get(WAITING).count;
module.exports = {
load, requestName, withdrawNameRequest, waitingNameRequest, nameRequestsOf, nameRequests, nameRequestById, answerNameRequest,
forget, sendFeedback, feedbackOf, feedback, markFeedbackRead, openCount, MAX_REASON, MAX_TEXT, KINDS,
};