the symptom, in your words
"Keep PackageReferences clean from day one"
✓ verified on engine 26.07lane: Getting set upposted
▸ SYMPTOM
- Standalone Steam export hangs on startup.
- Or you're early in a project and casually adding package dependencies without a plan for publish/export.
▸ CAUSE
A standalone build that still has PackageReferences can hang on startup — it can't reach sbox.game to resolve them. Platform publish and editor play may hide this until you export.
This is a setup discipline issue: dependencies you add in week one become export blockers in month three.
▸ FIX
- Prefer project-local code and assets for core gameplay.
- Treat every PackageReference as a publish/export liability — know why it's there.
- Before any standalone export experiment: clean the dependency list (standalone-steam-export).
- Don't disable the whitelist to pull in banned APIs — that blocks platform publish and is a one-way door toward standalone-only (dotnet-build-vs-whitelist).
Exact PackageReference authoring UI / csproj shape: follow current editor docs (needs verification) for your build — the verified gotcha is the startup hang when unresolved refs remain at export.
▸ WHY IT WORKS
Editor and sbox.game can resolve package graphs online; a self-contained executable cannot. Keeping references minimal from day one means export is a checklist item, not an archaeology dig.
✓
Verified on engine 26.07 — seen in a real project.
s&box moves fast; an undated fix is a liability. Spot a stale detail?
related gotchas
Standalone Steam export
Preview as of 2026-07: Valve approval + Facepunch license; full .NET, lose platform services; clean PackageReferences or startup hangs.
Getting set up: new project skeleton
.sbproj + Assets/Code/ProjectSettings/tools layout, 4-object scene + Bootstrap, dotnet build before anything else.
A pre-publish checklist for sbox.game
Org/ident rules, every store-page field is launch-blocking, AI thumbnails demoted — verify as a player after publish.
dotnet build verifies compile but NOT the whitelist
Headless dotnet build is green while the in-editor compiler emits SB1000 — Environment/IO/Process/reflection are banned in game code.