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

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};