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]>
54 lines
1.9 KiB
JavaScript
54 lines
1.9 KiB
JavaScript
"use strict";
|
|
|
|
const crypto = require("crypto");
|
|
const accounts = require("./accounts.js");
|
|
|
|
// moderators' notes on a player: what staff want one another to know about
|
|
// them ("talked to them about trading, seemed fine"), on the player's page
|
|
// of the moderator panel and with "!notes" in the game. the player is never
|
|
// shown them (lib/manage.js leaves them out of their data).
|
|
//
|
|
// on an account: modNotes [{id, at, by, text}], the oldest first.
|
|
|
|
const MAX_NOTES = 100;
|
|
const MAX_TEXT = 500;
|
|
|
|
const now = () => Math.floor(Date.now() / 1000);
|
|
|
|
const list = account => [...(account.modNotes || [])].reverse();
|
|
|
|
// returns {note} or {error}.
|
|
const add = (account, by, text) => {
|
|
const clean = String(text || "").replace(/\s+/g, " ").trim().slice(0, MAX_TEXT);
|
|
if (!clean) {
|
|
return {error: "Write the note first."};
|
|
}
|
|
const note = {id: crypto.randomBytes(6).toString("hex"), at: now(), by: String(by), text: clean};
|
|
account.modNotes = [...(account.modNotes || []), note].slice(-MAX_NOTES);
|
|
accounts.save();
|
|
return {note};
|
|
};
|
|
|
|
// a note taken away by whoever wrote it, or by someone who may remove anyone's
|
|
// (`anyone`). returns {note} or {error}.
|
|
const remove = (account, id, by, anyone) => {
|
|
const note = (account.modNotes || []).find(entry => entry.id === String(id));
|
|
if (!note) {
|
|
return {error: "No such note."};
|
|
}
|
|
if (!anyone && note.by.toLowerCase() !== String(by).toLowerCase()) {
|
|
return {error: "Only whoever wrote a note, or an admin, can remove it."};
|
|
}
|
|
account.modNotes = account.modNotes.filter(entry => entry !== note);
|
|
accounts.save();
|
|
return {note};
|
|
};
|
|
|
|
// the newest notes on anybody, with whom they are about.
|
|
const recent = count => accounts.all()
|
|
.flatMap(account => (account.modNotes || []).map(note => ({...note, about: account.username})))
|
|
.sort((one, other) => other.at - one.at)
|
|
.slice(0, count);
|
|
|
|
module.exports = {list, add, remove, recent, MAX_TEXT};
|