Repository navigation
v0.10.0
A large operability release: structured logging, rate limiting, a dedicated at-rest encryption key,
reliability work across the backup and lifecycle paths, a client-side avatar cropper, and a
project-wide copy pass. It also folds in the npm→pnpm migration and a round of dependency major
bumps. Two behaviour changes below need a note before you upgrade.
Upgrade notes
- At-rest encryption moved to a dedicated key. Stored credentials (API keys, RCON passwords,
TOTP secrets, the Discord webhook URL) are now encrypted with a random key at
$DATA_DIR/.secret-key, generated automatically on first boot, independent of
SESSION_SECRET. Values written under the oldSESSION_SECRET-derived key still open (it's
kept as a decrypt-only fallback) and are re-encrypted under the dedicated key automatically on the
next boot. Back up.secret-keywith the rest ofdata/- losing it means re-entering every
stored credential. A.secret-keyfile that exists but doesn't parse is now a hard boot error
rather than being silently regenerated. - Session cookie
SameSitedefault is nowlax(wasstrict), configurable via
COOKIE_SAMESITE. This fixes "remember me" appearing to log users out after following a link
from another site. State-changing requests are stillOrigin-checked; withCOOKIE_SAMESITE=none
the panel additionally rejects writes that carry noOrigin/Referer.
Added
- Structured logging (Pino). Every module logs through
src/logger.js; one JSON line per
request; a secret-redacting sanitizer;makeFailureThrottle()for background loops; a dormant
Sentry seam (src/instrument.js). New env:LOG_LEVEL,LOG_PRETTY,MSM_EXIT_ON_FATAL
(hard-exit on an uncaught fault, for supervised deployments), and an inertSENTRY_DSNblock. - Rate limiting.
express-rate-limiton all of/api(RATE_LIMIT_API_PER_MIN, default 1200)
and on login / 2FA / setup POSTs (RATE_LIMIT_AUTH_PER_15MIN, default 100);0disables a
limiter. Plus an account-global soft login counter alongside the existing per-IP one. - Health & monitoring endpoints.
GET /healthz(unauthenticated liveness; checks the DB;
deliberately returns no version) andGET /api/status/summary(authenticated: current problems,
recent alerts, disk free) for operators and external monitors. The containerHEALTHCHECKnow
hits/healthz. - Discord "Alerts" category. OOM, unhealthy, stalled boot, stop-failed, failed schedule, quota
stop, offline-after-restart, crash loop, crash report, and update-failed are forwarded under a new
toggleable category (on by default). See the new integrations guide. - Automatic daily backups + panel-DB snapshots. Every new server is seeded a daily backup
schedule on create (staggered 02:00–05:59). The panel's own database is snapshotted via
VACUUM INTOtodata/backups/_panel/on a daily timer (newest 14 kept), and an
integrity_checkpragma runs on boot. - Avatar cropper. Custom profile-picture uploads now pass through a client-side square-crop
step (drag / corner-resize) before upload; oversized rasters are downscaled before the crop UI so
a large photo can't OOM a mobile browser. - Explicit container healthcheck (
mc-health) sodocker inspect"healthy" means the server
accepts players, not just that the process started. - Update checking extended to Docker-image staleness and, for servers with no managed pack,
explicit Minecraft-version / loader-build pins (Paper/Forge/etc.). - esbuild client bundle.
pnpm run buildnow also producespublic/dist/js/; the app serves it
when present and raw source otherwise. - New docs:
docs/integrations.md; refreshed backups / architecture / updates / getting-started
/ users-and-roles / 2FA guides and the README env table. - Import zip on the Mods tab - one button, two zip shapes, auto-detected. A CurseForge
modpack export (manifest.json) is resolved through the CurseForge bulk endpoints (two POSTs
instead of ~170 GETs for an 87-mod pack), previewed with per-mod warnings, and installed as
custom mods with real task progress. A hand-assembled zip of jars gets each jar identified
(Modrinth sha1 lookup, then CurseForge fingerprint, then the jar's own metadata) and judged
against the server: fits / wrong loader / wrong MC version / already installed / unidentified. - Pack overrides, opt-in and reversible - a modpack export's
overrides/tree can be applied to
the server; every file that would be overwritten is backed up first to.import-backups/<timestamp>/
inside the server folder. Zip-slip-guarded, size-capped, and the backup tree itself is protected. - Create a server from a zip - the wizard's From-modpack tab takes a custom zip: the manifest
(or a majority vote across identified jars) prefills the loader and Minecraft version, then create,
bulk install, optional overrides, and start run as one task. Zips of plugins create Paper servers. - CurseForge search on the existing-server Mods tab - platform chips (Modrinth default,
CurseForge once the API key is stored), with Installed badges on results already on the server. - Blocked downloads handled up front - when a CurseForge author forbids API downloads, the
search modal swaps Install for Open CurseForge + Upload jar, and zip imports partition
those mods into a report with per-mod browser links and upload slots. - Datapack support on the Mods tab and an opt-in override for Modrinth's MC-version
compatibility filter, so a build not listed for this exact version or loader can still be
installed with a clear "not verified" warning. - Solver goes cross-platform - the Auto-detect compatibility solver accepts CurseForge mods
alongside Modrinth ones, mapping each CF project's file history into the same loader and
MC-version intersection. - Per-server OpenAI-compatible chatbot - admins can connect each Minecraft server to its own
Ollama or OpenAI-compatible endpoint and configure the model, invocation name (@wizardby
default), persona, join greeting, timed check-in, opt-in conversation window, and transcript
retention. Vanilla recipe questions use versioned game data and compact 2x2/3x3 chat grids. - Optional chatbot powers - Basic users may receive enabled self/world powers; separately named
Power controllers may affect another exact online player. Gifts, healing, feeding, spawn/time/
weather changes, and directional teleports are individually configurable and audited. Powers
start disabled and in dry-run mode; configuration and transcripts are admin-only; API keys are
encrypted at rest; LAN endpoints are accepted while link-local and metadata targets stay blocked.
The model never receives raw RCON: it can select only intent-matched structured tools whose
authorization, target, item, quantity, cooldown, and dry-run policy are validated again right
before execution; selectors are rejected, cross-player targets must be online and cannot be the
caller, and models without tool calling fall back to conversation only.
Changed
- Package manager: npm → pnpm throughout (scripts, CI, Dockerfile, docs).
- Dependency majors: express 5, zod 4, multer 2, dockerode 5 (closes a uuid buffer-bounds
advisory), plus croner / dotenv / js-yaml / express-handlebars / marked and the dev toolchain
(eslint 10, typescript 7, @types/node 26). Node ≥ 24 is now required. - Backup retention is capped per reason (scheduled 10, pre-update 10, manual 20) and restore /
world-reset safety snapshots get their ownpre-restorebucket (keep 5) so they can never evict a
manualbackup you deliberately kept. Each new archive is integrity-checked before it's recorded. - Project-wide copy pass: one house style for casing, punctuation, and error messages; a shared
friendlyError()replaces raw "Request failed (500)" / Zod jargon / leaked container ids. - Performance: prepared-statement cache in the DB layer; the per-page sidebar view models no
longer fan out per-server pack/update/crash lookups; the WebSocket console stream is brokered (one
docker logs --followper server, not per tab); static-asset caching; backup zipping moved to a
worker_threadsworker; async bcrypt on the login path; memoized analytics reports. - First-run
/setupon a non-loopback bind is PIN-gated (PIN printed to the console). - Side-effecting GETs (event export, world download,
.mrpack) are gated to admin/operator. - Windows-authored zips whose entry names use backslash separators are now rejected on
import/restore (a containment tightening in the consolidated extractor).
Fixed / Security
- Logging/secrets:
pino-prettymoved to runtime dependencies (a pruned prod install could
crash at boot); the log sanitizer now redacts webhook tokens that live in a URL path and no longer
over-redacts keys likesessionId; one throwing getter no longer discards a whole log line; the
access log records aborted requests and never 500s on a craftedX-Request-Id. - Console broker: a broker is now torn down when its upstream stream ends, so a tab that
connects afterwards starts a fresh follow instead of getting a stuck, stale stream; one slow
client is dropped rather than freezing the console for every other viewer. - Backups/lifecycle: the status-refresh overlap guard can no longer wedge permanently on a hung
Docker call; boot crash-recovery respects crash-loop backoff and no longer emits a false
"not auto-started" alert for a server it then auto-starts; the "server up" check reads only the
current boot's logs, not a reused container's previous run; the crash-loop counter only counts
crashes that actually armed a restart. - Discord bridge: a transient webhook failure retries the event instead of dropping it (bounded,
so a dead webhook can't wedge the queue). - Login lockout: the account-global counter now decays, so a slow sprayer can't hold a valid
account locked out indefinitely; the 429 lockout message and "username already taken" now reach
the user instead of a generic "check what you entered". - Analytics / storage / events: the memoized-report cache is bounded (LRU); the rescan debounce
is trailing, not leading, so it can't run mid-restore; the Activity type-filter list is
invalidated after a prune. - Pre-branch: "remember me" logout on cross-site navigation; a full-project audit pass (per-request
CSP nonces - nounsafe-inlineinscript-src; magic-byte upload sniffing; wizard search
request-ordering; a shared crash-safeescapeHtml); symlink-escape, chat-command-nesting, and
SSRF/proxy-leak fixes. - Plugin servers' mod search no longer over-filters: plugin lookups stop being narrowed by a
mod-loader facet (a spigot-only plugin used to resolve to zero builds on a Paper server), and
datapack/resourcepack version lookups are no longer filtered by the server's loader either.
/api/mods/searchand/api/mods/versionsaccept plugin servers (loader=paper, plugin kind)
instead of rejecting them at validation. - Post-merge review fixes: the teleport target dropdown on the player page now escapes player
names (a crafted name on an offline-mode server could otherwise inject markup into an admin's
page);sessions.user_idis backfilled during migration so "sign out other devices" also
revokes sessions that predate the upgrade; the friendly-validation fallback recognizes zod 4's
new message wording; the Discord event bridge got the same re-entrancy guard as its sibling
pollers (no more duplicate notifications when a webhook responds slowly); an intentional stop
no longer records a spurious "unhealthy" alert while the world saves; the central error
handlers no longer throw a second error when a download fails mid-stream; the few
side-effecting GETs (world download, .mrpack, events export) reject cross-site navigations. - Restore safety: the world displaced during a backup restore is parked next to the server
directory instead of under tmp (which boot wipes), and boot now recovers it automatically if a
restore crashed between the two swap renames. Backups also run under the per-server operation
lock so a concurrent recreate or delete can no longer produce a silently incomplete archive. - One zip extractor for the whole panel: the decompression-bomb caps moved into the shared
utils/zip.js, every consumer (backups, worlds, blueprints, pack overrides) now uses it, and
the duplicateutils/safeExtract.jsis gone. Cached mod icons are served by one mechanism (the
authenticated static mount, now with the sandbox CSP that keeps a registry-supplied SVG from
running script); the duplicate API route was removed.