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]>
125 lines
4.7 KiB
JavaScript
125 lines
4.7 KiB
JavaScript
"use strict";
|
|
|
|
const {logText} = require("./logtext.js");
|
|
const crypto = require("crypto");
|
|
const fs = require("fs");
|
|
const path = require("path");
|
|
const config = require("../config.js");
|
|
const limits = require("./limits.js");
|
|
|
|
// cloudflare turnstile, with AJ_TURNSTILE_SITE_KEY and AJ_TURNSTILE_SECRET
|
|
// set: a captcha before every password tried (the client's login, the
|
|
// account page, the moderator panel) and every account made (the sign-up
|
|
// page, the client). a saved sign-in is not asked. the page shows the
|
|
// widget (public/captcha.js) and sends its answer as `captcha`; the answer
|
|
// is checked here with cloudflare, and is good for one request.
|
|
//
|
|
// a sign-in that passed the captcha and then wants a 2FA code, and a
|
|
// sign-up the client signs in with straight after, get a pass: good for
|
|
// that account from that address for a few minutes, so the second request
|
|
// is not asked again.
|
|
|
|
const ORIGIN = "https://challenges.cloudflare.com";
|
|
const VERIFY_URL = `${ORIGIN}/turnstile/v0/siteverify`;
|
|
const VERIFY_TIMEOUT_MS = 10000;
|
|
const MAX_ANSWER_LENGTH = 2048;
|
|
const PASS_MS = 600000;
|
|
const PASS_USES = 5;
|
|
const MAX_PASSES = 10000;
|
|
|
|
const on = Boolean(config.turnstile);
|
|
const passes = new Map(); // SHA-256 of a pass -> {id: account id, key: address key, expiry, uses}
|
|
const sha256 = text => crypto.createHash("sha256").update(String(text)).digest("hex");
|
|
|
|
// for the pages: what each answer means
|
|
const MESSAGES = {
|
|
captcha_required: "Complete the captcha.",
|
|
captcha_failed: "Captcha failed. Try again.",
|
|
captcha_unavailable: "Captcha unavailable. Try again later.",
|
|
};
|
|
|
|
const issuePass = (account, from) => {
|
|
if (!on || !account) {
|
|
return undefined;
|
|
}
|
|
for (const [hash, entry] of passes) {
|
|
if (entry.expiry < Date.now() || passes.size >= MAX_PASSES) {
|
|
passes.delete(hash);
|
|
}
|
|
}
|
|
const pass = crypto.randomBytes(24).toString("hex");
|
|
passes.set(sha256(pass), {id: account.id, key: from.key, expiry: Date.now() + PASS_MS, uses: 0});
|
|
return pass;
|
|
};
|
|
|
|
const passHolds = (pass, account, from) => {
|
|
if (typeof pass !== "string" || !account) {
|
|
return false;
|
|
}
|
|
const hash = sha256(pass);
|
|
const entry = passes.get(hash);
|
|
if (!entry || entry.expiry < Date.now() || entry.id !== account.id || entry.key !== from.key || ++entry.uses > PASS_USES) {
|
|
passes.delete(hash);
|
|
return false;
|
|
}
|
|
return true;
|
|
};
|
|
|
|
// asks cloudflare about one answer of the widget. null when it was a person.
|
|
const verify = async (answer, from, action) => {
|
|
if (typeof answer !== "string" || !answer || answer.length > MAX_ANSWER_LENGTH) {
|
|
return "captcha_required";
|
|
}
|
|
const form = new URLSearchParams({secret: config.turnstile.secret, response: answer});
|
|
if (!limits.isLoopback(from.address)) {
|
|
form.set("remoteip", from.address);
|
|
}
|
|
let result;
|
|
try {
|
|
const response = await fetch(VERIFY_URL, {method: "POST", body: form, signal: AbortSignal.timeout(VERIFY_TIMEOUT_MS)});
|
|
result = await response.json();
|
|
}
|
|
catch (err) {
|
|
console.log(`[captcha] cloudflare did not answer: ${logText(err.message)}`);
|
|
return "captcha_unavailable";
|
|
}
|
|
// an answer made for another form is no answer for this one. cloudflare's
|
|
// test keys give none.
|
|
if (!result || result.success !== true || (result.action && result.action !== action)) {
|
|
return "captcha_failed";
|
|
}
|
|
return null;
|
|
};
|
|
|
|
// null when the request may go on, or why not (a key of MESSAGES).
|
|
// `account`, when known, is who a pass would have to be for. requests from
|
|
// the server's own machine are not asked, as with the other limits.
|
|
const check = async (body, from, action, account) => {
|
|
if (!on || from.local) {
|
|
return null;
|
|
}
|
|
if (passHolds(body.captcha_pass, account, from)) {
|
|
return null;
|
|
}
|
|
return verify(body.captcha, from, action);
|
|
};
|
|
|
|
// a page's security policy: public/captcha.js always (the page calls it even
|
|
// when off), and the widget too when it is on.
|
|
const policy = csp => (on
|
|
? `${csp.replace("script-src ", `script-src 'self' ${ORIGIN} `)}; frame-src ${ORIGIN}`
|
|
: csp.replace("script-src ", "script-src 'self' "));
|
|
|
|
// a page with public/captcha.js asked for under a name that changes with the
|
|
// script and the key: cloudflare keeps .js files for hours, whatever the
|
|
// server says, and a browser would go on with an old one.
|
|
const withScriptVersion = html => {
|
|
const version = sha256(fs.readFileSync(path.join(config.publicDir, "captcha.js")) + (on ? config.turnstile.siteKey : "")).slice(0, 12);
|
|
return Buffer.from(String(html).replace("src=\"/captcha.js\"", `src="/captcha.js?v=${version}"`));
|
|
};
|
|
|
|
// public/captcha.js with the site key in it ("" when off).
|
|
const script = text => text.replace("\"{{siteKey}}\"", JSON.stringify(on ? config.turnstile.siteKey : ""));
|
|
|
|
module.exports = {on, check, issuePass, policy, script, withScriptVersion, MESSAGES};
|