the symptom, in your words

"Keep PackageReferences clean from day one"

✓ verified on 26.07.08e
lane Getting set upposted updated

▸ 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).

▸ 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.08e: seen in a real project.
s&box moves fast; an undated fix is a liability. Spot a stale detail?
changelog
  • Removed unverified pointer about exact PackageReference authoring UI (not covered by source).

Want to know when new guides or fixes drop? Join the community to help build this out. Report gotchas, flag outdated fixes, or just lurk.

Join the Discord