indifferentketchup
3a34b71e54
Drops missing-dep warnings whose source mod's mod.info `require=` is
out of sync with its Steam Workshop Required Items sidebar. Author
edits to mod.info often lag build ports; trusting the sidebar means
B42 sorts no longer raise warnings on B41-only deps the author has
already retired (e.g. tikitown's Diederiks Tile Palooza, EN_Newburbs).
Filter is conservative: only drops a dep when (a) we have a cached
wsid for it, (b) that wsid is wrong-build for the user's pz_build,
and (c) the source mod's required_wsids list (with required_scraped_at
populated as the "we have evidence" gate, since the column itself
defaults to '{}') excludes that wsid.
Also swaps worker.fetch_required_wsids from public-page HTML scrape
to authenticated IPublishedFileService/GetDetails. Same `children`
data, no 429 cooldowns. Removes the now-unused throttle/cooldown
infrastructure (SORTOF_STEAM_MIN_INTERVAL / SORTOF_STEAM_COOLDOWN
env vars are no longer read).
See docs/specs/2026-05-06-stale-requires-filter.md.
sortof
Project Zomboid mod load-order sorter for dedicated servers. Paste workshop
IDs or a collection URL; get back the WorkshopItems=, Mods=, and Map=
lines for servertest.ini.
Stack
- FastAPI + asyncpg, Python 3.12.
- Postgres 16 (Docker).
- DepotDownloader for fetching
mod.info/map.infofrom each cached workshop item. - Vanilla JSX + index.html, no build step (Babel-standalone in-browser).
Setup
docker compose up -d sortof_db
python3.12 -m venv api/.venv
api/.venv/bin/pip install -r api/requirements.txt
python3.12 -m venv worker/.venv
worker/.venv/bin/pip install -r worker/requirements.txt
.env next to docker-compose.yml:
POSTGRES_USER=sortof
POSTGRES_PASSWORD=<random>
POSTGRES_DB=sortof
SORTOF_CORS_ORIGINS=http://127.0.0.1:8801
Set DD_PATH to the DepotDownloader binary, then:
api/.venv/bin/uvicorn app:app --host 127.0.0.1 --port 8801
worker/.venv/bin/python drain.py
Layout
api/ FastAPI service, sort engine, response adapters
worker/ drain worker (DepotDownloader + mod.info parser)
frontend/ index.html + JSX
init/ Postgres bootstrap migrations (run on first boot)
data/ checked-in JSON config (e.g., pz_versions.json)
docs/ specs, plans