mirror of
https://github.com/burrow-dev/burrow-server.git
synced 2026-11-19 01:27:51 -05:00
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]>
This commit is contained in:
1 parent
da7eb9af58
commit
e05565787f
50 files changed
+2904
-277
No files matched your search
+137
-2
@@ -3,6 +3,8 @@
|
||||
const accounts = require("./accounts.js");
|
||||
const chatlog = require("./chatlog.js");
|
||||
const customItems = require("./customitems.js");
|
||||
const itemControl = require("./itemcontrol.js");
|
||||
const modNotes = require("./modnotes.js");
|
||||
const defpacks = require("./defpacks.js");
|
||||
const disguises = require("./disguises.js");
|
||||
const dens = require("./dens.js");
|
||||
@@ -50,7 +52,7 @@ const MAX_AGAIN = 100;
|
||||
// A hosted party's own name is three string ids, no use outside the game.
|
||||
const roomTitle = room => (room.partyHost ? `${room.partyHost.username}'s party` : room.displayName);
|
||||
|
||||
module.exports = ({findOnline, players, watchers, sendItemList, blocks, setHideBlocked, refreshForOthers, travel, reloadRoom, buyAgain, ask, staffMove, staffModeration}) => {
|
||||
module.exports = ({findOnline, players, watchers, sendItemList, blocks, setHideBlocked, refreshForOthers, travel, reloadRoom, buyAgain, ask, staffMove, setInvisible, staffModeration}) => {
|
||||
// A plain message box with an OK button.
|
||||
const tell = (session, text) => session.sendXt("xtl", -1, String(text).replace(/%/g, " percent"));
|
||||
|
||||
@@ -511,6 +513,7 @@ module.exports = ({findOnline, players, watchers, sendItemList, blocks, setHideB
|
||||
const MAX_WARNING = 200;
|
||||
const MAX_WARNINGS_SHOWN = 5;
|
||||
const MAX_ITEMS_LISTED = 8;
|
||||
const MAX_NOTES_SHOWN = 5; // "!notes": the latest, in one message box
|
||||
|
||||
const staffMay = (session, permission) => {
|
||||
const moderation = staffModeration();
|
||||
@@ -564,6 +567,34 @@ module.exports = ({findOnline, players, watchers, sendItemList, blocks, setHideB
|
||||
const logged = (session, action, target, detail = "") =>
|
||||
modlog.record(session.account.username, `${action} (in game)`, target.account.username, detail);
|
||||
|
||||
// what lib/itemcontrol.js tells about items taken.
|
||||
const worldForItems = {itemsTaken: (...args) => require("./world.js").itemsTaken(...args)};
|
||||
|
||||
const lockCommand = (session, words, locked) => {
|
||||
const [kind, id] = [(words[0] || "").toLowerCase(), words[1]];
|
||||
if (words.length !== 2) {
|
||||
tell(session, `Use: !${locked ? "lock" : "unlock"} clothing|den ID`);
|
||||
return;
|
||||
}
|
||||
const result = itemControl.setLocked(kind, id, locked);
|
||||
tell(session, result.error || result.ok);
|
||||
if (result.ok) {
|
||||
modlog.record(session.account.username, locked ? "item locked (in game)" : "item unlocked (in game)", "", `${kind} ${id}`);
|
||||
}
|
||||
};
|
||||
|
||||
// an account named by the first words (a name may have spaces: the longest
|
||||
// that is one), and the words after it.
|
||||
const accountAndRest = words => {
|
||||
for (let count = words.length; count > 0; count--) {
|
||||
const account = accounts.byName(words.slice(0, count).join(" "));
|
||||
if (account) {
|
||||
return {account, rest: words.slice(count)};
|
||||
}
|
||||
}
|
||||
return {account: null, rest: words};
|
||||
};
|
||||
|
||||
const staffCommands = {
|
||||
// "!item clothing|den ID NAME": a new item made from the game's item ID
|
||||
// (lib/customitems.js), free, every colour of the one it is made from;
|
||||
@@ -602,6 +633,104 @@ module.exports = ({findOnline, players, watchers, sendItemList, blocks, setHideB
|
||||
tell(session, on.length ? `Staff online: ${on.join(", ")}` : "No staff online.");
|
||||
},
|
||||
},
|
||||
// "!note PLAYER text": a note for the other staff (lib/modnotes.js),
|
||||
// never shown to the player. "!notes PLAYER": the latest few.
|
||||
note: {
|
||||
permission: "player.view",
|
||||
run(session, words) {
|
||||
const {account, rest} = accountAndRest(words);
|
||||
if (!account || !rest.length) {
|
||||
tell(session, account || !words.length ? "Use: !note PLAYER text" : `No player called ${words[0]}.`);
|
||||
return;
|
||||
}
|
||||
if (account === session.account) {
|
||||
tell(session, "That is you.");
|
||||
return;
|
||||
}
|
||||
if (roles.roleOf(account) && !roles.outranks(session.account, account)) {
|
||||
tell(session, "Staff of your rank or above are for someone higher up to deal with.");
|
||||
return;
|
||||
}
|
||||
const result = modNotes.add(account, session.account.username, rest.join(" "));
|
||||
if (result.error) {
|
||||
tell(session, result.error);
|
||||
return;
|
||||
}
|
||||
tell(session, `Note on ${account.username} added.`);
|
||||
modlog.record(session.account.username, "note (in game)", account.username, result.note.text);
|
||||
},
|
||||
},
|
||||
notes: {
|
||||
permission: "player.view",
|
||||
run(session, words) {
|
||||
const account = words.length ? accounts.byName(words.join(" ")) : null;
|
||||
if (!account) {
|
||||
tell(session, words.length ? `No player called ${words.join(" ")}.` : "Use: !notes PLAYER");
|
||||
return;
|
||||
}
|
||||
const latest = modNotes.list(account).slice(0, MAX_NOTES_SHOWN)
|
||||
.map(note => `${new Date(note.at * 1000).toISOString().slice(0, 10)} ${note.by}: ${note.text}`);
|
||||
tell(session, latest.length ? `Notes on ${account.username}: ${latest.join(" | ")}` : `No notes on ${account.username}.`);
|
||||
},
|
||||
},
|
||||
// "!invisible": unseen by players in every room until said again (staff
|
||||
// still see them), as the game's own moderators could be.
|
||||
invisible: {
|
||||
permission: "staff.invisible",
|
||||
run(session) {
|
||||
setInvisible(session, !session.invisible);
|
||||
},
|
||||
},
|
||||
// "!lock clothing|den ID", "!unlock clothing|den ID", "!locked": items
|
||||
// kept out of the item finder for players (lib/itemcontrol.js).
|
||||
lock: {
|
||||
permission: "items.create",
|
||||
run(session, words) {
|
||||
lockCommand(session, words, true);
|
||||
},
|
||||
},
|
||||
unlock: {
|
||||
permission: "items.create",
|
||||
run(session, words) {
|
||||
lockCommand(session, words, false);
|
||||
},
|
||||
},
|
||||
locked: {
|
||||
permission: "items.create",
|
||||
run(session) {
|
||||
const list = itemControl.lockedList().slice(0, MAX_ITEMS_LISTED)
|
||||
.map(entry => `${entry.kind} ${entry.id} ${entry.name || "(no name)"}`);
|
||||
tell(session, list.length ? `Locked out of the item finder: ${list.join("; ")}` : "Nothing is locked out of the item finder.");
|
||||
},
|
||||
},
|
||||
// "!take PLAYER clothing|den ID": every one of that item, out of their
|
||||
// inventory, online or not.
|
||||
take: {
|
||||
permission: "items.create",
|
||||
run(session, words) {
|
||||
const usage = "Use: !take PLAYER clothing|den ID";
|
||||
// the name may have spaces: the kind and the id are the last two words.
|
||||
const [kind, id] = words.slice(-2).map(word => word.toLowerCase());
|
||||
const account = words.length >= 3 ? accounts.byName(words.slice(0, -2).join(" ")) : null;
|
||||
if (words.length < 3 || !/^\d+$/.test(id)) {
|
||||
tell(session, usage);
|
||||
return;
|
||||
}
|
||||
if (!account) {
|
||||
tell(session, `No player called ${words.slice(0, -2).join(" ")}.`);
|
||||
return;
|
||||
}
|
||||
if (account !== session.account && !roles.outranks(session.account, account) && roles.roleOf(account)) {
|
||||
tell(session, "Staff of your rank or above are for someone higher up to deal with.");
|
||||
return;
|
||||
}
|
||||
const result = itemControl.take(account.username, kind, id, worldForItems);
|
||||
tell(session, result.error || result.ok);
|
||||
if (result.ok) {
|
||||
modlog.record(session.account.username, "item taken (in game)", account.username, `${kind} ${id} x${result.count}`);
|
||||
}
|
||||
},
|
||||
},
|
||||
summon: {
|
||||
permission: "player.summon",
|
||||
run(session, words) {
|
||||
@@ -672,15 +801,21 @@ module.exports = ({findOnline, players, watchers, sendItemList, blocks, setHideB
|
||||
// "!warn PLAYER [REASON] [note]": a warning, kept on the account and
|
||||
// shown with the game's own warning popup. REASON is behavior (the
|
||||
// default), bullying, personal or scamming; the note is for staff.
|
||||
// "!warn PLAYER custom TEXT": a warning in the staff member's own
|
||||
// words, which is what the player is shown.
|
||||
warn: {
|
||||
permission: "player.warn",
|
||||
run(session, words) {
|
||||
const usage = `Use: !warn PLAYER [${staffModeration().WARNINGS.join("|")}] [note]`;
|
||||
const usage = `Use: !warn PLAYER [${staffModeration().WARNINGS.join("|")}] [note], or !warn PLAYER custom TEXT`;
|
||||
withTarget(session, words, usage, true, (target, rest) => {
|
||||
const {WARNINGS, actions} = staffModeration();
|
||||
const asked = (rest[0] || "").toLowerCase();
|
||||
const reason = WARNINGS.includes(asked) ? asked : "behavior";
|
||||
const note = (WARNINGS.includes(asked) ? rest.slice(1) : rest).join(" ").trim().slice(0, MAX_WARNING);
|
||||
if (reason === "custom" && !note) {
|
||||
tell(session, "Use: !warn PLAYER custom TEXT (the text is what they are shown)");
|
||||
return;
|
||||
}
|
||||
const result = actions.warn(target.account, reason, session.account.username, note);
|
||||
tell(session, `${target.account.username} warned (${reason}): warning ${result.count}.`
|
||||
+ (result.silencedMinutes ? ` Silenced for ${result.silencedMinutes} minutes, for that many warnings.` : ""));
|
||||
|
||||
Reference in new issue
Block a user