Release history
Changelog
Every new feature, fix and speed-up on s&box Explorer, newest first.
- Last 30 days
- 90
- Features shipped
- 233
- Fixes
- 218
- Days with changes
- 66
812 changes Clear filters
September 2026
11
-
Fix
10:31 PM
Apply the cache-key and shell-escape fixes to the cron that actually runs
Details
2e945aa fixed backend/api/auto-refresh.php, but the caller in production is tools/scheduled-refresh.php, run from cron every 30 minutes. Minutes after the deploy it started a refresh for a "user" named player_all_packages_76561198162354937 - a cache key the player pages write, read back as a username by the same str_replace bug. It now requires the expected prefix and skips anything else, and the name reaches the shell through escapeshellarg rather than bare double quotes.
The same pattern is in tools/cron-refresh.php, tools/refresh-endpoint.php, tools/cleanup-invalid-cache.php and admin/refresh-status.php. None of them run: they are not in the crontab, nothing references them, and the admin page only displays. Left alone.
f600468 -
Fix
10:19 PM
Read the prune list from a file, since the host has no /dev/fd
Details
The first deploy to run tools/deploy-prune.sh printed
tools/deploy-prune.sh: line 29: /dev/fd/62: No such file or directory prune: moved 0 file(s) deleted since 09cea795
The host's bash has no /dev/fd, so the process substitution feeding the loop failed and the loop read nothing. "moved 0 file(s)" was true only because this deploy deleted nothing; a deploy that removed files would have reported the same and left them live. The list now goes through a temp file. Redirecting a pipeline also exposes its exit status to set -e, and git check-ignore exits 1 when no path is ignored, so the pipeline is guarded.
Verified on the server: process substitution fails there, the temp-file pipeline lists all 14 files deleted in 09cea79. The test now also rejects process substitution, which no local shell would have caught.
5d19018 -
Fix
9:21 PM
End the refresh worker's retry loop, and make deploys remove deleted files
Details
The background refresh failed 204 of its last 218 runs and retried the same handful of orgs every few seconds, attempt 309 and counting. Three bugs:
- BackoffStrategy cast 30 * 2^(n-1) to int before capping it. Past ~58 failures the float no longer fits and PHP casts it to 0, so the wait collapsed to nothing. It now caps first; a long streak waits 30 minutes.
- The worker treated an org with no packages as a failed fetch. codira, shadowstudio and lore are real orgs with zero packages, so they could never succeed. Only a failed request is a failure now; an empty list is cached.
- auto-refresh read every TYPE_USER_PACKAGES cache key as a username, including the player_all_packages_{steamid} keys the player pages write, and started workers for a user of that name. Keys without the expected prefix are skipped, and the name now reaches the shell through escapeshellarg.
The worker also re-queried eleven types for every org, one of them "texture", which Facepunch ignores and answers with the whole catalogue. The per-type sweep now runs only when the first pass hit its 2,000 cap, over the types that exist, including clothing, sound, vsnd and tmat, which it never asked for.
Deploys never removed anything: rsync has no --delete, so all 14 files removed in 09cea79 stayed live, and the dropped 2027 theme stayed in the theme picker. tools/deploy-prune.sh moves files deleted in git since the recorded build into ~/sbox-backups, skipping whatever .deployignore excludes, so server-owned paths are never touched. It does not use .gitignore, which ignores /tools/* and would have left deleted cron scripts executable. A failure only reports; the deploy carries on.
Also: browse chips for Addons, Collections, Entities and Terrain Materials (each larger than the Prefab or Shader lists), German "Prefabs" and "Sounds" in place of "Fertighäuser" and "Klingt", a successful webhook no longer written to error_log, and the comments removed from code deployed earlier.
2e945aa -
Feature
6:47 PM
Bring the search page onto the current design, and make it tell the truth
Details
The page had not changed since May, and several things on it were wrong:
- It advertised AND, OR, NOT, phrases and parentheses. Facepunch's search has none of these, so the syntax panel and the script that validated it (advanced-search.js, loaded on every browse page and used by nothing else) are gone.
- "101 results found" for car was a count of what had been grouped; the real total is 3,704. It read a total key the fetch never returned.
- It asked Facepunch for 500 packages per search, which takes ~10.7s upstream, to show 10 per type. It now asks for 200 (~1.7s).
The page now uses the browse layout: the same header, search box and type chips, the organization matches as a row (with an exact organization match first when the query is one), then one row of the standard package cards per type, each with "See all" into /t/{type}/?tags={query}. The number of cards follows the grid so every breakpoint shows full rows. ?type= goes straight to that listing.
That listing now says what it is: "Models matching "car"" instead of "Browse Models", and type names come from the translations, so /t/vsnd/ reads "Browse Sound Files" rather than "Browse Vsnds". Addons, collections, decals, entities, terrain materials and tutorials get English names.
search-results.css and advanced-search.css keep only the rules other pages still use.
09cea79 -
Refactor
6:30 PM
One version of each page, no switches
Details
Removes the old package page and org page that ?v2=0 still served, and the Explorer 2027 beta theme with its ?beta=1 override, beta homepage and cookies. Everyone gets the current package page (package-detail-v2) and org page (org-v2); anyone who had picked Explorer 2027 falls back to Default, which the theme manager already does for a theme that no longer exists.
Deleted: views/package-detail.php, package-detail-sections.php, package-detail-sidebar.php, the sections only they used (media-stage, media-gallery, loading-screen, reviews-teaser, rail-reception), frontend/org-page.php, views/beta-home.php, includes/explorer-2027.php, css/ee/sbox-explorer-2027.css and css/features/beta-home.css. The hooks in index.php, bootstrap.php, head.php, package-list.php and theme-manager.js go with them.
test_package_tabs.php now checks the current package page, keeps every check on the shared tab and stage scripts, and pins that neither switch comes back. Shared stylesheets and scripts stay: each is still in use by the current pages.
640d45e -
Fix
6:19 PM
What the pages told visitors that had stopped being true
Details
- Org links: org pages and the classic package sidebar read website, X and Discord off the Org object inside package results, which Facepunch now fills with Ident, Title and Thumb only. No org page showed its links or summary. They now come from the organization record (fetchOrganization, already cached 5 minutes), through orgSocialLinks(), which also stops owner-typed non-http(s) values becoming links and points handles at x.com rather than twitter.com.
- Sound Files filter: it asked for type:soundfile, which does not exist, and Facepunch ignores an unknown type - so it listed all 33,000 packages. It now asks for vsnd (8,876 sound files); /t/soundfile/ redirects there, and the label key is renamed in all 30 languages.
- Empty search: the advice to "try different boolean operators" was wrong - Facepunch search matches AND, OR and NOT as words ("car AND boat" finds more than "car"). A search with no results now says so, instead of suggesting the server might be down.
- Error state: the heading rendered as the raw key "common.errorLoadingPackages", and "contact support" pointed nowhere.
- Translations: a key missing from a language rendered raw, because the English fallback applied only when a whole file was missing. Every one of the 29 languages lacked the same 66 keys. Languages are now layered over English key by key.
chore(views): drop the comments added with the stale-copy fixes
f5c992b -
Fix
5:23 PM
Clear what the production logs were full of, and a few real bugs
Details
Found by reading error_log, the app log and ~/error_log on the server:
- Client errors: ~90% of the app log was unactionable. One crawler's bare "Script error." (154 in ten days), Applebot and Mediapartners-Google running tippy before Popper had loaded (107), and ResizeObserver loop notices. client-errors.php now drops those three before logging.
- form-validation.js called matches() on window/document, which Firefox hands a captured blur listener: 51 TypeErrors in ten days.
- The Facepunch circuit breaker counted only in Redis, so it did nothing in exactly the outage it exists for. It now falls back to APCu, verified on the production host with Redis absent.
- Bots asking for ?page=913198702 became skip=22829967525 and a 400 from Facepunch. getCurrentPage() caps at 10,000 (Facepunch lists ~33,000 packages, ~1,300 pages), and hidden gems uses it.
- 404s on org news posts join the suppression list; their links outlive the posts.
- fetchPackagesBatch remembers a failed ident for five minutes instead of refetching and relogging it on every view, and a 404 is not an error.
- Webhook "cooldown active" skips were ~2,000 error_log lines a month of the cooldown working; they go to debugLog.
- newspost.css used --text-color, which nothing defines. It resolved to the inherited --text-secondary, so that is now named explicitly and the CSS integrity check passes again.
- CSP (report-only): AdSense's googlesyndication, doubleclick and adtrafficquality hosts, and a frame-src, whose absence sent every ad iframe to default-src 'self'. The live .htaccess is patched by hand as before.
4ab05fa -
Fix
2:22 PM
Stop the gc_divisor startup warning and the Steam key in error_log
Details
The "PHP Startup: session.gc_divisor must be greater than 0" lines were not the site. getCliPhpBinary() started background jobs with the host's /usr/local/bin/ea-php84, whose php.ini sets the divisor to 0; the site itself serves from alt-php84, which is fine. Each spawn inherited the docroot as its working directory, so the warning landed in our error_log roughly every half hour. The CLI next to the serving PHP (PHP_BINDIR/php) now comes first: same version, same ini, no warning.
Steam outages also logged full request URLs, and every Steam Web API URL carries the account key. HttpService and SteamHttpClient now replace the key= value before a URL reaches a log line or exception message.
a31eb90 -
Fix
9:08 AM
Serve the last good catalogue, and keep the address that works
Details
"Unable to load skins data right now" was showing most of the time, and it was mostly this site rather than sboxskins.gg, which answers every page in about 0.2s. Two faults, each enough on its own.
The fallback never worked. Production caches in SQLite, and there a plain CacheManager::get() of an expired entry deletes it. fetchSkinsCatalogue() did that read first, then - once the fetch had failed - asked for a stale copy of the entry it had just destroyed. So any failure upstream reached visitors as an empty market for the ten minutes the failure was remembered. The last catalogue that loaded is now kept as its own entry for a week and served whenever a fetch fails; tests/test_skins_fallback.php reproduces the old behaviour against those SQLite semantics and fails on master.
The address pinning discarded the one address that works. sboxskins.gg's DNS rotates through a pool, and from this host part of it is unreachable: 216.150.16.1 and .16.129 time out every time, .16.65 and .1.129 answer in 0.2s. The remembered good address was only used when the current DNS answer happened to contain it, and it expired after ten minutes - shorter than the fifteen between catalogue refreshes - so each refresh gambled on the rotation again, and an answer of two dead addresses failed outright. It is now tried first regardless and kept for a day; it is re-proven on every use, and TLS still checks the certificate against the hostname.
fetchCachedEndpoint(), added for the jam and platform-stats pages, had the same stale-read pattern and so the same hole. It keeps a last-good copy too, so an outage at Facepunch shows slightly old jam data rather than none.
9f8a9b1 -
Feature
8:05 AM
Platform counts from Facepunch, and the last 90 days
Details
Global Stats worked out "Playing Now" by paging through every game - four requests, about 2.5 seconds - and adding up UsersNow. Checked against stats/platform that missed about 8% of players, everyone in a game with no public listing, and it had no way to see the editor at all.
Worse, the live counter that polls /api.php/stats every 30 seconds summed only the top 200 trending games, so two seconds after the page loaded its all-games figure was swapped for a smaller one. Both now read stats/platform, the platform's own count, with the old sums kept as the fallback and is_estimated saying which one a caller got.
The page gains "In the Editor" - 122 against 108 playing when checked, more people building than playing - and a 24h peak that is there on load rather than waiting for the chart script to fill it.
The new "Last 90 days" section is from stats/platform/history, which gives daily unique, new and returning players, peak concurrency and playtime. It shows the trend the old page could not: daily players down from about 5,500 in June to about 2,000, new players from ~450 a day to ~40.
- Two single-series charts rather than one stacked. New players are 2-8% of daily players and would be an invisible sliver on the same bars; a second y-axis would invent a relationship between two scales.
- Plain HTML columns, not a stretched SVG, so the rounded ends and axis text stay crisp. The whole column is the tooltip target, and every value is also in the table behind "Every day as a table".
- The range ends at midnight so the last bar is a finished day, not a partial one reading as a collapse. Week and month comparisons only ever compare complete windows of the same length, and say nothing otherwise.
- Phones get the last 30 days; 90 columns at that width are hairlines.
db1379a -
Feature
7:57 AM
Game jam pages, with the live vote and every past winner
Details
Facepunch's public API has carried jam data all along - timelines, prize ladders, winners by category and a live community vote tally - and nothing on the site read it. Game Jam III is running now (building until 25 Sep, results 3 Oct), so this is the moment the page is worth most.
/game-jams lists every jam and features the live one. /game-jams/{ident} shows the phase timeline with how far through the current phase it is, what each place pays or who won it, the community vote ranked, and every entry through the existing package cards.
Not /jam or /jams: sbox has organisations with both idents, and a route here would have shadowed their pages. /game-jams is free.
Some decisions the data forced:
- One upstream call serves both pages. The jam list is byte-for-byte what jam/{ident} returns for each jam, so the detail page reads from the list, and a real jam cannot 404 because a second call failed during an outage.
- Timeline state comes from dates, not the Phase number. The numbers have gaps (1, 2, 4, 5, 6, 7) and the older jams skip steps, but every step has a date.
- Seven of Tech Jam's ten winners were never tagged as entries, so they showed as bare idents. The missing winners, and only those, are fetched through the existing package batch.
- Entries are filtered by the jam's own Query rather than a string built here, so a change to how Facepunch tag entries is followed automatically.
- Vote ranks are competition ranks with ties ordered by ident, so the list does not reshuffle on every cache refresh.
- The public list can be shorter than EntryCount (44 of 64 for Jam III), and the page says so rather than implying the grid is everything.
fetchCachedEndpoint() is the fetch-fresh-else-serve-stale shape that fetchPackageStats already used, pulled out because every new endpoint wants it. The platform stats fetchers beside it are used by the next commit.
tests/test_jams.php covers the timeline, relative dates, ranking, ties, unlisted entries and prize shapes: 42 checks.
7cea2ea
15
-
Feature
10:52 PM
Actually load tippy, which the site has been styling for nothing
Details
tippy-init.js warned "Library not loaded" on every page. It was the one entry in theme-manager's vendor list with a real consumer, and emptying that list left the initialiser, frontend/css/vendor/tippy.css and 55 title attributes on a package page all shipping with nothing to drive them.
Loaded in the footer above tippy-init.js rather than through the vendor loader, because that one injects asynchronously and would race it; defer keeps document order. The plain UMD build, not -bundle, because -bundle only adds tippy's own stylesheet, which would land after ours and undo the skin. Popper is a separate global either way. Both pinned with integrity - they are third-party and executable.
tippy.css only ever held the skin, which nobody noticed because it was never exercised: with arrow: true the arrow needs the geometry from the core stylesheet or it does not render at all. That structure now sits above the skin in the same file, so the colours still win.
The .gitignore change is why that file was awkward to commit: `vendor/` matches at any depth, so it swallowed frontend/css/vendor along with Composer's directory - the explicit fontawesome line below it was a workaround for the same thing. Anchored to the root it actually meant.
Verified in Chrome against a package page: tippy and Popper both defined, 65 elements initialised, the native title removed so tooltips do not double up, and the box measured 97x36 with a 4px radius and a drawn arrow.
7791f18 -
Fix
8:03 PM
Cover cdnjs, the loading-screen videos and GA's region host
Details
Second pass over the report-only log, from a package detail page rather than the listings.
cdnjs is a real dependency, not stray markup: Font Awesome loads on the profile and package pages and highlight.js on /mcp-knowledge, so it needs script, style and font rather than removing.
media-src was never declared at all, so the loading-screen videos fell back to default-src 'self' and every package page with one logged a violation.
The analytics host is the subtle one. connect-src already listed region1.google-analytics.com, but GA4 collects on region1.analytics.google.com
- a different domain - and picks the region by visitor location, so the
wildcard covers the other numbered hosts rather than waiting to learn each one from a fresh console.
1842d79 -
Fix
7:54 PM
Allow the hosts the service worker and Cloudflare actually use
Details
The report-only policy has been logging two violations on every page load.
Both are false alarms in the sense that nothing is blocked, but they bury anything real. service-worker.js caches thumbnails through fetch(), and a service worker fetch is governed by connect-src even when the response is an image - img-src already permits these hosts, which is why the pictures render while the console fills up. Cloudflare injects its own beacon script, so static.cloudflareinsights.com was never going to be in a policy we wrote.
The docroot .htaccess is excluded from the rsync, so this file documents the policy rather than shipping it; the live header needs the same edit by hand.
e5f605e -
Fix
5:34 PM
Shim requestIdleCallback, which Safari was throwing on
Details
The app log is 285 reports a day of "Can't find variable: requestIdleCallback", by an order of magnitude the largest entry in it. That is Safari's wording: Safari only shipped the API in 16.4 and older iOS has none, and three call sites used it bare.
The costly one is in theme-manager's UI init, which throws partway through, so date pickers, sliders, tags, the lightbox, charts, drag and drop, gridstack and masonry never initialise for those visitors. Nothing is visible in Chrome, which is why a full front-end audit went straight past it - it only showed up in the errors real browsers were reporting back.
Shimmed once at the top of main.js: it loads first in the shared runtime and everything after it is deferred, so it is defined before any caller, and a native implementation is left alone.
Reproduced against production with the API deleted before page scripts run - "ReferenceError: requestIdleCallback is not defined" - and confirmed gone against the same page with the shim.
bf85998 -
Fix
5:30 PM
Send expected skins-host timeouts to the app log
Details
sboxskins.gg is a small community server that is often slow, and its connect timeouts were the bulk of what was left in error_log - crowding out the faults that actually need someone to look.
They are not faults. Everything downstream already handles them: the failure is remembered for ten minutes and callers fall back to stale data, which is the whole point of the cache added earlier. So httpCode 0 from that host now goes through Logger::warning into logs/app-<date>.log, where it keeps more context than error_log ever had - endpoint, request id, IP, the cURL error - and stops sitting next to real problems.
A real status code still goes to error_log, because a 403 or a 500 means something changed upstream. So does a malformed body.
With the per-attempt suppression already in HttpService, an unreachable skins host now writes nothing to error_log at all.
fab45db -
Fix
5:17 PM
Stop a Redis outage writing a log line per cache lookup
Details
RedisCache::init() guarded on $redis being null, but a failed connect sets $redis back to null in the catch - so the guard never tripped. Every isAvailable() call reconnected from scratch and logged again, which is why a 70-second outage on 4 September put roughly 140 identical "Connection refused" lines in error_log: one per cache lookup rather than one per request. Each of those also paid a connect attempt before failing.
Tracked with an explicit attempted flag now, set before anything that can throw, so one attempt is made per request whatever the outcome.
Also suppresses 404s for organization/ lookups, which the list beside it already does for player/, package/get/, package/versions/, news/package/ and package/stats/. A miss there means the ident does not exist upstream - a stale link or a bot walking the URL space - and because any unknown top-level path is resolved as an org ident, every probe for /env, /weapon or /crashes wrote a line. Non-404s from the same endpoints still log.
tests/test_log_noise.php pins both, including the exact state the storm ran in: no handle, but already attempted.
f57d3a2 -
Fix
6:34 AM
/claim-org 404s in production
Details
The route was registered only in router.php, which serves the dev server. Production goes through .htaccess into index.php and reaches routing_logic's list instead, so the page worked locally and returned 404 on the live site - found by sweeping production after the deploy rather than localhost.
Every other route in router.php's $frontendRoutes is already in routing_logic. claim-org was the one gap.
Verified by serving the site through a router that mimics .htaccess - straight to index.php, no dev-only route table - where it now redirects to login like its siblings instead of 404ing.
3b5c1a6 -
Fix
6:05 AM
Keep the cPanel .htaccess out of the rsync
Details
The docroot .htaccess is tracked here but is cPanel's file, not ours. It carries the MultiPHP handler block, which cPanel regenerates and marks do-not-edit, and which the repo copy has never contained - so a deploy overwrote it, AddHandler went away, .php stopped executing and the site served an Apache directory listing until the original was restored from backup.
That is recorded in the changelog but nothing stopped it happening again: the file was still tracked and still absent from .deployignore, so the next deploy would have repeated it exactly.
The rewrite rules the repo copy adds were checked after that incident and are redundant against the server copy, and the server copy's protections are confirmed live - config.php, logs/, data/, .git/ and .env all answer 403 while index.php renders. So the server keeps ownership of this one file.
config/.htaccess and mcp/.htaccess are ours and still deploy.
e0bad46 -
Fix
5:52 AM
Build a sitemap for this site, and let the deploy carry it
Details
robots.txt advertises https://sbox.grimtech.co.uk/sitemap.xml. The file on the server listed thirteen URLs and every <loc> pointed at https://sbox.game/ - the upstream platform, not this site - so every URL handed to a crawler was the wrong domain. It also named /stats and /org/<name>, which are not routes here.
Nothing in the repo generated it, and .deployignore listed /sitemap.xml alongside .env and the server-owned config, so no deploy could ever correct it. tools/generate-sitemap.php builds it from this site's real routes and runs as part of npm run build, the same hook the changelog uses.
Package types come from the platform, filtered. Anyone can coin a type by publishing with it, so the raw list is mostly single-package noise - "exe", "jpg", and one obscenity that would have gone straight into a file submitted to Google. ShowOnIndex plus a count threshold leaves seventeen real ones. --verify checks every URL against a running server before writing, so a sitemap of 404s cannot ship; all 38 currently answer 200.
The same exclusion was hiding a second problem. meta/ holds dev tooling next to meta/changelog.json, which frontend/changelog.php reads at runtime, and the whole directory was excluded - so the build regenerated the file and rsync then dropped it. The live changelog stops at April 2, 2026 and shows ten commits. The tooling is excluded by name now and the data ships.
SITE_URL is defined rather than assumed: admin/warmup-redis.php already referenced it with a hardcoded fallback that was always the one being used.
756c326 -
Refactor
5:41 AM
One shared runtime, and the defects a full-site audit found
Details
A global script layer already existed, but most of the runtime had drifted into a partial that exactly one page includes, so 23 standalone pages ran without theming, modals, lazy loading or keyboard shortcuts - and 20 of them had pasted theme-manager.js back in to compensate. One shared partial now carries what every page type needs. Modal runtime went from 9 of 32 routes to 32, the announcement banner from 4 to 32, and vendor 404s from 21 a page load to none: 20 of those 21 libraries had no consumer at all.
Removed 15 files and 4 API endpoints that nothing referenced. Three of the endpoints had returned 500 for nine months; deleting the fourth repaired /api/display/preferences, which the published spec documents and which a dead file had been shadowing.
sboxskins.gg was flooding error_log and hanging page loads. Failures are remembered for ten minutes rather than one, single items are negative-cached like the catalogue already was, and the per-attempt connect noise is dropped while the caller's line is kept. Cold failure 4.0s, warm 0.00s, two log lines where there were nine.
A crawl of every public route then found: disabled pagination arrows were anchors carrying href="#", and the CSS that should dim them was written as :disabled, which never matches an anchor; /t/<type> pages rendered "Browse Games" as their h1 but fell through to the bare site name in the tab; org news author links opened internal profiles in a new tab.
And the changelog page was invisible. One .date-group wraps all 15,331px of it and a scroll-reveal asked for threshold 0.1 - 1,533px visible at once, which no ordinary viewport satisfies - so it set opacity 0 and never fired. Its commit bodies also double-broke every newline and inherited the accent colour.
12b9a78 -
Feature
5:41 AM
Leaderboard and profiles on the v2 surfaces, and what the sweep found
Details
The leaderboard is reworked and profiles move onto the shared surfaces, finishing the v2 pass over the public pages.
Fixes found while sweeping the result: the news list claimed the feed had ended while posts were still unreachable, and its layout is now one wide post over rows of three as the live site has it; one page width throughout; a brand blue that actually passes AA; the no-radius-over-4px rule enforced rather than just stated; media named as upstream sends it, so a 404 upstream stops being reported as ours; the award index unstuck; and every page given a real title.
ca5cdc8 -
Feature
5:41 AM
Make v2 the default, and bring charts, home and global stats onto it
Details
v2 stops being opt-in. The package rail gets one inset rather than several competing ones, and its changelog link goes somewhere real.
The chart pages, the homepage below the hero, and global stats are rebuilt on the same card language, so the four highest-traffic pages now read as one site.
65e9fe4 -
Feature
5:41 AM
The same header and the same width on every page
Details
Pages disagreed about where content starts. Every page now shares one header and one measure, and the tops line up rather than each page beginning at its own offset.
The news article pages are rebuilt on the v2 language and the news list is paged instead of loading everything at once.
Releases 2.0.0.
e02774a -
Feature
5:41 AM
One type scale, one radius scale, and a shared component kit
Details
The site had grown several competing sets of sizes, weights and corner radii, so two pages built a month apart did not look related. This introduces the kit every later page is built from: a single type scale, a single radius scale, and shared surface tokens.
The package and organisation pages are rebuilt on it as the first v2 view, and every public page is then measured and corrected against it rather than adjusted by eye.
b2f033f -
Refactor
5:41 AM
Clear the stylesheet debt and stop routing to pages that do not exist
Details
The slow, low-contrast pages were carrying stylesheet debt behind them - rules that had been added over the top of each other rather than replaced. Cleared so the design work that follows has a level surface to build on.
Routing was resolving URLs to pages that were never there: a request for a name the site does not serve rendered a shell rather than a 404.
Also corrects claims the site made about itself that were no longer true, and removes the running commentary from the sources.
7542065
33
-
Fix
4:14 PM
Deny the dev tooling still sitting in the docroot
Details
composer.lock, package-lock.json, phpstan.neon, phpunit.xml, router.php and three JS configs were uploaded by hand before the deploy system existed and were serving 200 to anyone. .deployignore keeps them out of new deploys but the rsync has no --delete, so it cannot remove them. The lockfiles are the part that matters: they hand out exact dependency versions to check against known CVEs.
Named individually rather than by extension, because manifest.json and locales/*.json are fetched by the site itself.
743ec9d -
Fix
9:58 AM
Repair org search, package paging and the MCP org field
Details
Three faults surfaced by the production error log.
org/list has returned 404 since at least June and Facepunch has no bulk replacement (organization/<ident> serves one org at a time). Both callers caught the failure and returned an empty array, so organisation search quietly found nothing rather than reporting a problem, then cached that empty result for an hour. Orgs are now recovered from package search: q=org:<ident> is an exact lookup and a plain term surfaces the orgs owning matching packages. Verified live: "face" finds facepunch, "rat" finds rats and ratman, "studio" finds six, where all three returned nothing before. Both call sites now share one implementation.
package/find silently ignores page and count; only skip and take work. Four call sites sent page/count, so /player/packages returned the same first results on every page and handed back 200 items where the caller asked for 20, while the response advertised correct pagination. Now skip/take, with the offset from Pagination::offset so the existing int32 clamp applies.
mcp/tools/package.php read Org as a string in five places. It is an object everywhere else in the codebase, which is why the log carried a steady drip of "Array to string conversion" and the tool printed Array where the organisation name belongs.
Also stops the settings API writing two INFO lines to the error log on every request, which was most of that file's volume.
tests/test_api_params.php locks all of it in.
42dbb8c -
Maintenance
9:36 AM
Keep the stylelint config out of the webroot
Details
.stylelintignore was already excluded; the rc file it pairs with was not, and .json is not covered by the .htaccess FilesMatch deny list, so it would have been publicly fetchable dev clutter.
dc7ca62 -
Fix
9:34 AM
Confirm dialog swallowed the click on form-level data-confirm
Details
A submit button inside a form carrying data-confirm resolves through closest() to the form, not the button. The click handler then called .click() on the form, which has no activation behaviour, so nothing happened: the dialog appeared, you pressed Confirm, and the delete never ran. Fourteen actions across eight pages were affected (announcements, cleanup-invalid-users, donations, manifest-removals x3, mcp-api-keys x5, mcp-knowledge, moderation-logs, webhook-settings). The nine that put data-confirm on the button itself worked, which is why the dashboard and player-history tested fine.
The click handler now defers to the submit handler for forms.
tests/admin-confirm.test.js covers both entry points in jsdom, including cancel and Escape. Verified it fails without the fix.
91505cc -
Accessibility
4:54 AM
Give every form control a name, wrap wide tables
Details
21 selects, inputs and textareas had no accessible name at all: a screen reader announced 'combo box' with nothing more, and several had no visible caption either. Added aria-label to each, matching the visible caption where there was one.
MCP API Keys' five tables and System Info's four had no scroll container, so they pushed the page sideways on a narrow viewport instead of scrolling inside their own box.
The three pages using material-symbols-outlined now use the rounded set the rest of the admin uses and head.php preloads.
43c63dd -
Tests
4:50 AM
Lock in the invariants this refactor established
Details
22 checks over the admin tree: every nav link resolves, every page is reachable from the nav, the shell opens and closes exactly once per page, no page hand-rolls a head or footer, every POST handler validates CSRF through the shared helper, no native confirm(), no bare button variant, no inline <style>, no bare setInterval, and everything parses.
Writing it caught three more: mcp-knowledge's five row actions and the manifest review modal's close button were still missing the base .btn class, and analytics.php had a second <style> block buried in the body that the first extraction pass missed.
4655cac -
Maintenance
4:48 AM
Stop ignoring tracked tests and drop the dead footer.version string
Details
tests/ was in .gitignore while twenty of its files were committed, so every new test needed git add -f. Nothing on disk there is untracked, so removing the entry changes no file, only the friction.
footer.version ('Perpetual betaa' and its 29 translations) is referenced nowhere: the badge renders APP_VERSION and the deploy's commit hash, and takes its aria-label from footer.versionLabel. Removed one line per locale; all 30 files still parse.
8c8c183 -
Maintenance
4:46 AM
Restore the stylelint config and clear 3,148 ESLint errors
Details
npm run lint:css could not run at all: .stylelintrc.json lives on the server but was gitignored, so it was never in the repo. Pulled the server copy verbatim (it is the authoritative one) and un-ignored it; the lint scripts now cover admin/assets too, and the admin CSS is clean.
eslint --fix takes frontend/js from 3,163 errors to 15, all of it quote and indent formatting. Verified by node --check on all 57 changed files plus the vitest suite. Of the rest, 57 were no-undef against vendor globals (Swal, Chart, tippy and friends load as plain script tags) which the config now declares, and admin/assets/*.js is linted for the first time.
What is left is real, not formatting: 7 empty catch blocks, 2 useless assignments and 1 rethrow without a cause. frontend/css still reports 2,601 style-guide errors; those are auto-fixable but rewriting every site stylesheet is well outside an admin audit.
0e545c9 -
Performance
4:42 AM
Stop background polling and collapse two N+1 queries
Details
Four pages polled on a bare setInterval, so a left-open background tab kept hitting the database indefinitely; Advanced Analytics did it every five seconds. adminPoll() skips the work while document.hidden and refreshes immediately when the tab comes back.
MCP API Keys resolved a username with its own query for every banned user rendered; one DISTINCT ON lookup now covers the whole list. Cleanup Invalid Users opened a transaction and issued three deletes per account; it is three set-based deletes in one transaction.
191f35b -
Fix
4:39 AM
Close CSRF and XSS holes in the admin panel
Details
CSRF: player-history, steam-friends-cache and warmup-redis handled POST with no token check at all. player-history's actions include TRUNCATE of all three player_history tables and exec() of the collector scripts, so a logged-in admin visiting a hostile page could be made to wipe that data. All three now validate and carry a token field, and badge-management drops its local 16-byte, !== comparison in favour of the shared 32-byte hash_equals helpers (its version also left csrf_token_time unset, disabling token expiry for every other page sharing the session).
XSS: Advanced Analytics rendered Steam usernames and avatar URLs into innerHTML unescaped, and Org Claims did the same for usernames, org idents and review notes, including an org ident spliced into an inline onclick="revokeOrg('...')". Steam personas and org idents are user controlled, so both were stored XSS into an authenticated admin session. The revoke button now passes its ident through a data attribute.
The activity heatmap's two third-party scripts get SRI hashes and crossorigin, so a compromised unpkg or d3js.org fails closed.
7491ab8 -
Fix
4:35 AM
Repair buttons, tables and icons that had no styles behind them
Details
- api-test.css was written against --card-bg, --border-color, --hover-bg and --text-color, none of which exist. Every rule fell through to a hardcoded dark value, so API Test ignored the theme and was unreadable on the light ones. Rewritten against the real tokens.
- 11 buttons across five pages used class="btn-primary" and friends without the base .btn, which only supplies colour: no padding, radius or alignment.
- .btn-action on Refresh Status was defined nowhere at all.
- table-responsive (also undefined) becomes admin-table-container, so those tables scroll instead of overflowing on narrow screens.
- 32 <i class="material-symbols-rounded"> become <span>, matching the rest of the codebase.
- Adds the .admin-badge-info, .badge-sm, .org-cell, .org-link, .timestamp and .pending-card-* rules that markup referenced but nothing defined.
bd35f08 -
Fix
4:31 AM
Drop the dead Migrate Schema control and route
Details
The Reputation page offered a 'Migrate Schema' button that POSTed to backend/api/migrate-reputation-schema.php, a file that does not exist and is not in git history; router.php carried a matching dead route. Removed both rather than inventing a schema migration.
Both reputation recalculation buttons now report through adminToast instead of alert(). Their endpoints are left alone: recalculate-reputation.php covers users with claimed orgs, recalculate-all-users-reputation.php covers everyone in batches, and they are not interchangeable.
198038e -
Feature
4:29 AM
Replace every native confirm() with a styled dialog
Details
35 destructive actions were guarded by window.confirm(), which cannot show what is about to be deleted, looks different in every browser, and can be suppressed after a few dialogs, quietly turning a guarded action into an unguarded one. 23 inline handlers become data-confirm attributes and 12 JS call sites await adminConfirm().
The dashboard tool grid now renders from the nav registry, so all 29 tools appear grouped by section instead of a hand-picked 17.
d75a8ce -
Refactor
4:27 AM
Move all 31 pages onto the shared page shell
Details
Each page rendered its own <head>, stylesheet list and footer by hand. Five of them (analytics-advanced, manifest-removals, org-claims-full, reputation-management, webhook-settings) never closed .admin-content, <main> or .admin-layout at all, and another five called renderAdminFooter() in the middle of the page with content after it.
Page CSS (1,673 lines that were inlined into PHP and re-sent on every request) now lives in admin/assets/pages/*.css and is cached and lintable. Titles are normalised to '<Page> - Admin - s&box Explorer'; the two pages that pulled theme-manager.js, and with it a dynamic load of 21 vendor scripts none of them used, no longer do.
deeea32 -
Feature
4:23 AM
Add shared page shell, nav registry, command palette and confirm dialog
Details
The admin area had 31 pages each hand-rolling their own <head>, stylesheet list and footer, which is how the CSS list drifted, how five pages ended up never closing .admin-layout, and how the sidebar (29 tools), the dashboard grid (17) and reality (30) all disagreed about what exists.
- admin/includes/admin-nav.php is now the one list of tools
- admin/includes/admin-page.php renders the page shell
- Ctrl+K palette and a sidebar filter, for jumping between 30 tools
- adminConfirm() replaces native confirm() for destructive actions
- admin pages no longer pull the 8-script front-end vendor bundle
4cbf325 -
Style
4:00 AM
Drop the last package section heading icon
Details
config-details carried a tune icon and leaderboards a military_tech one; the other nine sections have none. All eleven headings are plain text now.
29b64b5 -
Fix
3:59 AM
Resolve /api/* by pattern so production matches the dev server
Details
/api/package-leaderboard had no rewrite rule, so it fell through the catch-all to backend/api/package-leaderboard, missed, and landed on the front controller. The browser asked for JSON and got the homepage back, at HTTP 200, so the In-Game Leaderboards panel showed zero entries with no error anywhere. It worked on localhost the whole time, because router.php has the route.
That is the real problem: router.php and .htaccess are two hand-kept lists of the same thing and they drifted, 13 routes against 5. Missing alongside package-leaderboard were manifest-removal-request, steam-friends, kofi-webhook and four reputation endpoints.
.htaccess now resolves by pattern, trying <name>-api.php then <name>.php, each guarded by an -f check so a name only resolves when the file exists. The character class allows no dot or slash, so neither rule can be walked out of the directory, and everything reachable this way was already reachable through the catch-all, so nothing is newly exposed.
Also drops the military_tech icon from the leaderboards heading: nine of the eleven package sections have no heading icon.
And wires ?refresh=1 into fetchSpecificPackage, admin-gated, matching the switch that already works on player profiles and org package lists. Package pages were the one place it silently did nothing, leaving no way to bypass the hour-long cache except waiting.
5aa42db -
Feature
3:40 AM
Show the deployed commit in the version badge
Details
The footer now reads "1.0.0 [acc26c6]", so what is live is identifiable at a glance instead of having to be inferred from a git log.
The deploy already computed the hash for its own log line. It now also writes it to config/build.php, after the rsync and into the document root only. That file is generated and never committed, so rsync has nothing to overwrite it with and no install that was not deployed by the hook gets a stale value.
A generated PHP file rather than a text file read at runtime, so opcache holds it and no request pays for the I/O.
Degrades to the bare version when the stamp is absent, which is the case locally and on any manual install. The bracket is only rendered for a non-empty APP_BUILD, so it never shows an empty [].
26f4b22 -
Fix
3:38 AM
Cap pagination offset so crafted page numbers cannot 500
Details
A crawler walking synthetic pagination reached
package/find/2/?skip=7202577550&take=25&q=849152367+type:model
and every hit logged an upstream 500.
Probed the endpoint: Facepunch holds skip in a signed 32-bit int. skip=2147483647 returns 200, skip=2147483648 returns 500. Anything past TotalCount returns 200 with zero packages, so deep offsets are useless long before they are harmful.
Pagination::parse floored the page at 1 but had no ceiling, so any integer a visitor put in the URL became an offset. Every controller reads its page from there, so the cap goes in the one place rather than in each of them. Page is clamped rather than the offset, so the page number a caller gets back still matches the results it is given.
browse-api.php and code-search-api.php read skip straight from the query string and bypass the parser; code-search-api did not even floor it at zero. Both now go through Pagination::clampOffset.
MAX_OFFSET is 100000: far below the overflow, and more than ten times the largest package type (model, under 10000 entries), so it can only clip requests that would have returned nothing.
The test caught a bug in the first version of this fix: at PHP_INT_MAX the offset multiplication overflows to a float and the int-typed clamp threw a TypeError, which would have been a 500 of our own making.
9a2fd78 -
Fix
3:34 AM
Ignore build output so the clone stays deployable
Details
cPanel will not deploy a repository whose working tree is dirty, and .cpanel.yml runs npm run build inside that clone. frontend/css/dist was untracked rather than ignored, so the build left the tree dirty and cPanel reported deployable: 0 with no error anywhere: the push was accepted, the checkout advanced, and the tasks silently never ran.
Ignoring both dist directories keeps the tree clean across builds. The old negation lines were inert anyway, since nothing ignored those paths in the first place.
acc26c6 -
Refactor
3:28 AM
Move APP_VERSION into constants.php
Details
It was defined in config/config.php, which holds the database credentials and CRON_KEY, is gitignored, and is excluded from deployment. So the one string on the site that changes most often was the one string git could never touch: bumping it meant a hand edit on the live server, which is how 1.0.0 got there.
constants.php is tracked and deploys normally, so a version bump is now an ordinary commit.
Guarded with its own defined() check rather than folding it into the block below, because bootstrap loads constants.php before config.php: an install whose config.php still defines APP_VERSION would otherwise hit a redefinition warning instead of quietly keeping its own value.
The live server was patched by hand to the identical content, verified byte-for-byte against this commit, so the next deploy is a no-op for both files and the footer never lost the version.
90e8177 -
Revert
3:24 AM
Keep .htaccess in the deployed set
Details
Excluding it was based on two wrong readings of the outage.
The cPanel-generated handler block is not required. The site is serving now, PHP executing normally, with an .htaccess that does not contain it, so the AddHandler is configured at server level and that block is belt-and-braces cPanel writes in. The outage was entirely the document root dropping to mode 700 under rsync -p; restoring .htaccess from the backup was chasing the wrong cause and did not fix anything.
The five /api/* rewrites are also not redundant. I tested those routes after the repo version of .htaccess had been put back on the server, so they passed because those very rules were live, and I credited an upstream fallback that does not exist.
.htaccess is a normal tracked file and deploys like any other.
c87be7a -
Fix
3:22 AM
Stop shipping .htaccess, cPanel owns it
Details
The repo copy lacks the cPanel-generated PHP handler block, which is marked 'do not edit' because cPanel regenerates it on any MultiPHP change. Deploying the repo version therefore removed the AddHandler directive, .php stopped executing, and the site served an Apache directory listing until the original was restored from backup.
Verified afterwards that the five /api/* rewrite rules the repo copy adds are redundant: /api/code-search, /api/package-changelists, /api/organization-details and /api/player-extended all return 200 on the restored file. The only other difference was a .dump deny, which belongs on the server copy.
84d191c -
Maintenance
3:20 AM
Ship 1.0.0
Details
The footer badge had read 'beta 0.0.3' for about a year. The site has a full feature set, a public API, an MCP server and 30 locales; the beta label stopped being accurate a long time ago.
APP_VERSION lives in config/config.php, which is gitignored and excluded from deployment, so the live value was changed on the server directly. This updates the template so a fresh install does not start at 0.0.1 again.
950b1cb -
Feature
3:16 AM
Add the cPanel deployment config
Details
Builds in the server-side clone, then rsyncs into the document root with .deployignore holding back everything the live site owns.
No -p on the rsync. With it, rsync stamps the source tree's permissions onto the destination including the document root itself. The repository cPanel creates is mode 700, so a -p deploy left the docroot at 700, the web server's group lost traverse, index.php stopped executing and Apache served a directory listing instead. Without -p, existing files keep their own permissions and --chmod applies only to files rsync creates. The explicit chmod 750 afterwards is belt and braces on the one permission that takes the site down.
Lives on dev. master is production: the deploy hook fires on a push to the checked-out branch there, so master is only ever reached by a deliberate merge.
524be0f -
Fix
3:05 AM
Stop calling the Facepunch storage endpoints that always 401
Details
The error log was filling with lines like
HttpService Error (401): - URL: .../storage/query?steamid=...&package=...
one per visit to the storage tab of the data explorer.
Probed the endpoint directly. storage/query and storage/get return 401 for every package and every steamid, including pcjr.oreworks, whose package/stats/2 data is public and returns 200 from the same host. They answer only to a Bearer token minted by a live in-game client session, and Steam OpenID sign-in cannot produce one. storage-explorer.php has said as much in its own UI copy since it was written; the code just never acted on it.
So the request could never succeed. Both service methods now return the failure locally without leaving the process, keeping the exact shapes their three callers already switch on: the 401 array for query, null for get. The explorer page renders identically, because it gates on the httpCode key either way.
storage-api.php was separately answering 200 with "success": true wrapped around the failure payload, which told callers nothing. It now returns 501 with the reason.
Test asserts the shapes hold and that neither method makes a network call, using elapsed time as the proof: a real round trip measured about 200ms, these return in microseconds.
b3ee80a -
Maintenance
2:59 AM
Add the rsync exclusion list for cPanel deployment
Details
Names every path the live site owns and git must never write over: the SQLite databases and their write-ahead logs, everything under data/ (chart_history is appended to on ordinary page views), the caches, the logs, .env, config/config.php, and the config files the site rewrites at runtime. Also drops development-only files that have no business being publicly readable.
Committed ahead of .cpanel.yml on purpose. cPanel deploys on push as soon as it sees .cpanel.yml, so the exclusion list goes up first and gets verified with a dry run before anything is armed.
b80ff07 -
Maintenance
2:35 AM
Clean up the repository root and unbreak the lint tooling
Details
Audit of the 27 root-level files. Most were fine; these were not.
Dead ignore files ----------------- .eslintignore has been unsupported since ESLint 9, and package.json pins eslint ^10 with a flat config. Its four patterns move into an ignores block in eslint.config.js, which is what actually keeps frontend/js/dist out of the lint run: lint:js globs frontend/js/**/*.js, so dist was in scope.
.prettierignore had nothing to ignore for. There is no prettier dependency, script or config anywhere in the repo; formatting is php-cs-fixer, eslint and stylelint.
composer.lock ------------- The blanket *.lock rule was excluding it, so PHP dependency versions were not reproducible. This is an application, not a library, so the lockfile belongs in git. Narrowed the rule and generated the lock.
Database dumps -------------- A 38MB pg_dump of the production database was sitting in the webroot with no reference to it anywhere, kept out of git only by .git/info/exclude, which is per-clone and not shared. Moved out of the tree, and now ignored by name so the next one cannot be committed by someone whose clone lacks that local exclude.
Apache was not denying it either: the block list covered env, ini, log, sh, sql, bak and config, but not dump. Added.
Docs ---- facepunch.md and MCP_TOOLS_AUDIT.md move into docs/, which already exists and held one file.
facepunch.md also documented three things that are not true, which is what sent global-stats looking for live games in the wrong place. Verified against the live API and corrected: sort only works as a token inside q, not as a query parameter; downloads and rating come back in exactly the same order as an invented token, so they are not honoured; an unrecognised token silently falls back to popular rather than erroring; and take caps at 500, with 501 returning HTTP 400.
Also removed: SCMM.json, a 420KB OpenAPI spec for a service that shut down. Its consumer went with the skins rebuild and skins-retired.php now says as much on the page. It was never tracked.
d063b01 -
Fix
2:19 AM
Sweep leaked scratch files, and guard the tool scripts
Details
Rate limit counters and refresh locks were only ever cleaned up lazily, by the next request for the same identifier. An IP that visits once, or an org refreshed once and never again, left its file on disk permanently. That had grown to roughly 8000 files, which had to be deleted by hand. Redis is disabled in production, so the file fallback is the live path, not a contingency.
RateLimiter::gc() removes counters whose window has long closed, and runs on roughly 1 in 500 fallback writes so the directory maintains itself. It reads mtime rather than opening files, so clearing a backlog does not parse thousands of JSON blobs. mt_rand rather than random_int for the sampling: it needs no entropy guarantee and sits in a path that must never throw.
Refresh locks leak the same way but are written from five places into three directories, so cache-sweeper.php covers all of them in one place. It sweeps at 300s against a 120s lock timeout, leaving a wide margin so it can never pull a lock out from under a refresh that is still running. The test plants a 5-second-old lock and asserts it survives.
The sweep piggybacks on the existing scheduled-refresh cron rather than needing an entry of its own, and runs before the refresh work so a lock left by a killed run does not block the current one.
Also closes two holes found while making cleanup-cache.php reachable over HTTP, since nothing in .htaccess blocks backend/tools/:
- notify-package-update.php checked only that the X-Cron-Key header was present, never its value, so any value at all got in
- check-package-updates.php had no guard whatsoever
Both send push notifications to every follower. tool-auth.php is now the single check all four scripts route through: CLI, a signed-in admin, or CRON_KEY compared with hash_equals. It fails closed when the key is unset or still the placeholder, so the window between deploying and configuring is shut rather than open.
cleanup-cache.php preflights its own dependencies by name, because production runs with display_errors off and this deploys over FTP, where a half-finished upload otherwise surfaces as an unexplained blank 500.
4298dff -
Fix
2:19 AM
Show every live game, and make the cards visible
Details
Two separate bugs made the page look mostly empty.
The trending grid rendered every card at opacity 0. The CSS gates card opacity on a .visible class that nothing in the codebase ever added, so the cards were in the DOM, taking up layout space, and invisible. Only readers with prefers-reduced-motion saw them, because that media query forces opacity back to 1, which is presumably how it shipped. filter() already knows which cards should show, so it toggles the class there rather than adding an IntersectionObserver; that covers first paint, tag filtering, search and Show More in one place.
The counts were also wrong. The API has no sort that surfaces live games: every sort: token it does not recognise (players, active, online, usersnow, hot) falls back to the same default order, and live games are scattered right through all 1600+ results. One take=100 page saw about a third of them. It now sweeps every page concurrently, with take=500 because that is the hard cap, deduplicating by FullIdent since pages are fetched in parallel and the result set shifts underneath them.
Playing Now 68 -> 148, Active Games 21 -> 63.
The grid slice was also a flat 50, which would cut live games off the bottom the moment more than 50 had players in them.
8fc4311 -
Feature
2:19 AM
Add the s&box Explorer 2027 opt-in
Details
Borrows the shape of the in-game menu (icon rail, filter pills, content rows with a lead tile, activity sidebar) but keeps this site's own visual language: our tokens, our type scale, our spacing. Deliberately not a reproduction of it.
The colours are a normal entry in frontend/css/ee/, so Settings > Appearance picks the theme up automatically like any other. The layout is server-rendered though, so the server has to know the choice before it renders; it learns it from a cookie theme-manager.js mirrors alongside localStorage. Resolution runs in bootstrap, before any output, because setcookie() silently fails once headers are sent.
The picker writes both cookies, which makes it authoritative. Without that, anyone who had ever opted out with ?beta=0 would pick the theme in Settings and keep getting the classic layout forever, with no way to fix it from the UI. ?beta=1 and ?beta=0 still work as shareable links and still win for the request they are on; they just no longer outlive the next theme change.
The homepage rows de-duplicate across each other, since the same package otherwise turns up in several of them and the page looks like it is repeating itself.
677a4bf -
Fix
2:18 AM
Correct the Facepunch endpoint contract
Details
Four things were wrong about how we call public.facepunch.com:
The leaderboard endpoint was still on its pre-versioning shape and returned nothing. It now takes a stat name, defaulting to kills. The stat is validated against a character whitelist and, separately, rejected if it is made only of dots: curl normalises dot-segments in a path, so a stat of ".." would silently rewrite which endpoint the request actually hits.
The TTL map keyed leaderboard responses on "package/leaderboard", which stopped substring-matching once the stat moved into the path, quietly downgrading those entries from 600s to the 300s default. Keyed on "/leaderboard/" now.
package/find/2/ takes skip and take, not page and count, and caps take at 500 (take=1000 returns a 400). count=100 was being ignored, so the caller silently got the 200-item default.
Code search exposes the kind and year facets the API already supported. kind is matched against a whitelist because the API compares it case-sensitively and silently returns nothing for a near miss.
tests/test_facepunch_endpoints.php covers all of it, including that the kind buckets partition the total and the year buckets sum to it.
545ac53 -
Feature
2:18 AM
Rebuild the skins market on sboxskins.gg
Details
sbox.scmm.app stopped resolving (NXDOMAIN, not a transient outage), which left every /skins route rendering an empty page. sboxskins.gg exposes an equivalent JSON API, so the section is rebuilt on that instead of dropped.
Their robots.txt carries "Disallow: /api". The endpoints are public and unauthenticated, but that is a stated preference against automated use, so the cache TTLs are long, the User-Agent is identifiable, and the catalogue is paged through /api/items rather than making 221 detail calls.
Notes on their data, learned the hard way:
- priceHistory comes back newest-first, so it is reversed once on fetch rather than in each consumer. Left alone, the charts ran backwards and a "last N days" window returned the oldest N.
- sharePercent does not match the holdings it describes (92 units reported as 41.3%, 500 units as 0.9%), so shares are computed from quantity/totalSupply instead.
- ratingGrade is only returned by the list endpoint, never the detail one, so it is borrowed from the already-cached catalogue.
- priceChange24h is a percentage while priceChange6h is an absolute dollar delta, which is easy to render as the wrong unit.
SKINS_ENABLED gates the whole section for the next time a source dies. With it off, /skins used to fall through to the org handler and fuzzy-match an unrelated org page with a 200; it now returns a real 404 page.
Also fixes the homepage carousels, which all showed near-identical packages. The API ignores a &sort= parameter entirely: sorting is a token inside the query ("type:game sort:trending"). Sending it as a parameter meant every carousel got the same default ordering.
807922a
August 2026
1
-
Feature
4:07 AM
Complete Facepunch API suite, dynamic in-game leaderboards, manifest withholding system, and UI Material icon standardization
72c427b
July 2026
6
-
Feature
10:58 PM
Render detailed Facepunch API changelists with Added/Improved/Fixed categories in version history
1e4e028 -
Fix
10:55 PM
Render changelog on package page and add .htaccess API rewrite rules
69c34b7 -
Fix
10:53 PM
Format package links in code search as canonical /org/ident/ URLs
427751f -
Feature
10:52 PM
Update sbox_package tool with package_stats, steamid, and validated actions
b29a4cb -
Feature
10:46 PM
Add Package Data & Tools section to package detail sidebar
5b535a1 -
Feature
10:46 PM
Integrate Facepunch public APIs (Code Search, Package & Player Stats, Storage, Changelists, MCP actions)
25c8261
3
-
Fix
4:49 AM
10/10 MCP cleanup — tool mappings, dead code, naming
Details
- Added migrate, refactor, test, tool_search to explain.php toolMappings
- Removed unused KnowledgeDB::deleteEntry() (just called delete())
- Renamed changelog.php → updates.php (matches registered tool name)
- Updated all references in index.php and MCP_TOOLS_AUDIT.md
25eb187 -
Fix
4:39 AM
Remove mock api_diff tool, fix silent error swallowing
Details
- Removed sbox_api_diff (returned hardcoded mock data, not useful)
- Added error logging to mcpResolveAuthor empty catch block
- Updated tool counts: 17 → 16 tools, 123 → 120 parameters
- Updated MCP_TOOLS_AUDIT.md and index.php references
e89b069 -
Feature
1:17 AM
Schema auto-discovery — 5-strategy chain with parallel CDN probing
Details
- Multi-strategy URL resolution: env var → cached → scraping → CDN → fallback
- Fixed CDN probing: HEAD returns 200 for any URL, switched to GET+Range with JSON check
- Fixed 206 Partial Content acceptance (CDN returns 206 for Range requests)
- Parallelized probing with curl_multi (20 concurrent connections)
- Added refresh_schema admin action for manual refresh
- Persisted URL cache with 1-year TTL
50f5cd7
3
-
Feature
9:05 PM
Best-in-class MCP tooling — 17 tools, 11 improvements
Details
Major improvements:
- Add MCP tool annotations (readOnlyHint, destructiveHint, etc.) to Registry
- Add isError flagging on tool execution errors in index.php and StreamResponse
- Add negative guidance (Do NOT use for...) to all 16 tool descriptions
- Add additionalProperties: false to all tool inputSchemas
- Add pagination metadata (has_more, total_count) to list endpoints
- Add dry-run pattern for admin delete_all operation
- Add outputSchema to 5 structured tools (stats, package, kb, search, docs)
- Add cache metadata to cached responses in stats and package tools
- Add _context parameter to search, refactor, and contribute tools
- Add full audit trail logging to all admin operations
- Add sbox_tool_search meta-tool for progressive tool discovery
- Trim all tool descriptions to 100-150 chars optimal for AI agents
- Update MCP_TOOLS_AUDIT.md with all changes (17 tools documented)
f544a64 -
Docs
8:37 PM
Add MCP tools audit — 16 tools, 122 parameters documented
95ca858 -
Fix
8:25 PM
MCP toolset overhaul — bug fixes, security hardening, new tools
Details
- Fix duplicate sbox_search_docs alias in Registry
- Fix kb.php slug key bug (slug→url in update mapping)
- Fix admin.php single-quote string interpolation
- Fix contribute.php silent exception swallowing
- Fix package.php operator precedence in FullIdent
- Fix migrate.php false positive regex with word boundaries
- Add try/catch wrappers to 6 tool callbacks (search, stats, scaffold, refactor, diagnose, explain)
- Fix &\ reference leak in search.php
- Replace define() constants with static auth context in Auth.php
- Add timing-safe hash_equals for API key comparison
- Add DNS rebinding protection (safeFetch) in KBService
- Fix trending sort by engagement in KnowledgeDB
- Fix PDO type binding in SemanticSearch
- Hide internal errors in VotingService
- Fix dry_run and sortBy in AdminService
- Add sbox_test tool (NUnit test scaffold generator)
- Add sbox_api_diff tool (API version comparison)
- Wire new tools into index.php with Claude Code tab
64e655c
1
-
Fix
10:07 PM
CSP policy, MCP key generation, presence settings, and service worker resilience
Details
- SecurityMiddleware.php: add missing CSP domains (Google Analytics regional, AdSense, Steam avatars, Google Fonts, Facepunch services) to connect-src and script-src; add data: to font-src
- .htaccess: sync report-only CSP with enforced policy
- mcp.php: fix apiSuccess envelope mismatch (data.key -> data.data.key) that caused 'Cannot read properties of undefined (reading substring)'
- legacy-compat.php: auto-create user_presence_settings table on first access; log actual DB errors instead of generic message
- profile-api.php: change requireAuth() to requireAuthApi() on all API endpoints so unauthenticated fetch() calls get JSON 401 instead of HTML 302 redirect
- settings.js: make presence save non-blocking so a presence failure doesn't kill the entire settings save
- service-worker.js: null-check request/url before accessing properties, wrap new URL() in try/catch, bump cache version to v2
fb94470
Generated from the project's commit history whenever the site is deployed. Times are server time.