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.1 KiB
JavaScript
103 lines
4.1 KiB
JavaScript
"use strict";
|
|
|
|
const {logText} = require("./logtext.js");
|
|
const accounts = require("./accounts.js");
|
|
const limits = require("./limits.js");
|
|
|
|
// player reports (client side: ReportAPlayer, FacilitatorXtCommManager). A
|
|
// report is who, about whom, one of the game's fixed reasons, and what the
|
|
// reporter typed about it (the patched report window has a text box; the
|
|
// game's own had none). they wait in the admin panel's Reports page.
|
|
|
|
const SCHEMA = `
|
|
CREATE TABLE IF NOT EXISTS reports (
|
|
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
created_at INTEGER NOT NULL,
|
|
reporter TEXT NOT NULL,
|
|
target TEXT NOT NULL,
|
|
reason INTEGER NOT NULL,
|
|
detail TEXT NOT NULL,
|
|
context TEXT NOT NULL,
|
|
room TEXT NOT NULL,
|
|
handled_at INTEGER
|
|
);
|
|
`;
|
|
|
|
// ReportAPlayer.reasonIdForReason, in the game's own words.
|
|
const REASONS = {
|
|
1: "Being a bully",
|
|
2: "Bad words",
|
|
3: "Personal info",
|
|
4: "Safety",
|
|
5: "Inappropriate den",
|
|
6: "Scamming",
|
|
7: "Inappropriate behavior",
|
|
13: "Inappropriate username",
|
|
14: "Inappropriate Jam-A-Gram",
|
|
15: "Inappropriate Jammer Wall post",
|
|
16: "Inappropriate Masterpiece",
|
|
};
|
|
const MAX_DETAIL = 200;
|
|
const MAX_CONTEXT = 4000;
|
|
const MAX_OPEN = 5000; // reports waiting; further ones are dropped
|
|
const MERGE_SECONDS = 10;
|
|
|
|
const perTenMinutes = limits.limiter(10, 600000);
|
|
const now = () => Math.floor(Date.now() / 1000);
|
|
const clean = (text, max) => String(text === undefined ? "" : text).replace(/[\u0000-\u0008\u000b-\u001f\u007f]/g, " ").trim().slice(0, max);
|
|
|
|
const load = () => accounts.database().exec(SCHEMA);
|
|
|
|
const openCount = () => accounts.database().prepare("SELECT COUNT(*) AS count FROM reports WHERE handled_at IS NULL").get().count;
|
|
|
|
// files a report. the patched client sends what was typed in a message of
|
|
// its own just before the game's usual report message, so a second report
|
|
// by the same player about the same player within a few seconds is the
|
|
// same one: its typed text is kept and nothing new is filed.
|
|
// returns false when the reporter has sent too many.
|
|
const file = ({reporter, target, reason, detail = "", context = "", room = ""}) => {
|
|
const db = accounts.database();
|
|
const recent = db.prepare("SELECT id, detail FROM reports WHERE reporter = ? AND target = ? AND created_at >= ? ORDER BY id DESC LIMIT 1")
|
|
.get(reporter, target, now() - MERGE_SECONDS);
|
|
if (recent) {
|
|
if (!recent.detail && detail) {
|
|
db.prepare("UPDATE reports SET detail = ? WHERE id = ?").run(clean(detail, MAX_DETAIL), recent.id);
|
|
}
|
|
return true;
|
|
}
|
|
if (!perTenMinutes.allow(reporter.toLowerCase()) || openCount() >= MAX_OPEN) {
|
|
return false;
|
|
}
|
|
db.prepare("INSERT INTO reports (created_at, reporter, target, reason, detail, context, room) VALUES (?, ?, ?, ?, ?, ?, ?)")
|
|
.run(now(), reporter, target, Number.isInteger(reason) ? reason : 0, clean(detail, MAX_DETAIL), clean(context, MAX_CONTEXT), clean(room, 100));
|
|
console.log(`[world] ${logText(reporter)} reported "${logText(target)}" (${logText(REASONS[reason] || `reason ${reason}`)})`);
|
|
return true;
|
|
};
|
|
|
|
const row = report => ({
|
|
id: report.id,
|
|
createdAt: report.created_at,
|
|
reporter: report.reporter,
|
|
target: report.target,
|
|
reason: REASONS[report.reason] || `Reason ${report.reason}`,
|
|
detail: report.detail,
|
|
context: report.context,
|
|
room: report.room,
|
|
handledAt: report.handled_at,
|
|
});
|
|
|
|
// reports waiting, oldest first; or with `handled`, the latest dealt with.
|
|
const list = (handled = false) => accounts.database()
|
|
.prepare(handled
|
|
? "SELECT * FROM reports WHERE handled_at IS NOT NULL ORDER BY handled_at DESC LIMIT 200"
|
|
: "SELECT * FROM reports WHERE handled_at IS NULL ORDER BY id LIMIT 500")
|
|
.all().map(row);
|
|
|
|
const markHandled = id => accounts.database().prepare("UPDATE reports SET handled_at = ? WHERE id = ? AND handled_at IS NULL").run(now(), id).changes > 0;
|
|
|
|
// the reports about one player, newest first, for their timeline.
|
|
const about = username => accounts.database().prepare("SELECT * FROM reports WHERE target = ? COLLATE NOCASE ORDER BY id DESC LIMIT 100")
|
|
.all(String(username)).map(row);
|
|
|
|
module.exports = {load, file, list, about, markHandled, openCount, MAX_DETAIL};
|