CleanStreets

CleanStreets

No more litter. Ever.

What does this mod do?

Every night the game scatters trash across the city streets. CleanStreets intercepts every single trash spawn on the server and teleports it straight into the nearest dumpster — before it ever touches the ground. Clients automatically see the correct positions via FishNet RPCs; no client-side mod needed.

• []All daily street-trash spawns land inside dumpsters instead of on sidewalks[/]

  []One-time startup cleanup removes trash that already exists in your save[/]

  []Optional: workstation by-product trash can also be redirected (config toggle)[/]

  []No containers nearby? The spawn is skipped entirely — nothing drops on the street[/]

  []100 % server-side — works in singleplayer and multiplayer (host-only install)[/]

  []Compatible with TrashGrabberPLUS — grabber logic is never touched[/]

  ---

  Configuration

  After the first launch, UserData/CleanStreets.cfg is created automatically.

  # Set to true to also redirect workstation by-product trash into dumpsters.

  # Default: false

  RedirectStationTrash = false

  # On the next scene load, destroys every pre-existing TrashItem in the world,

  # then resets itself to false. Set back to true to re-run (e.g. on a new save).

  # Default: true

  CleanAllTrashOnce = true

  CleanAllTrashOnce is the solution for saves where trash already existed before the mod was installed. It runs once, logs how many objects were removed, and silently disables itself. Re-enable it manually any time you start a fresh save.

  ---

  How it works (technical)

  CleanStreets uses HarmonyLib Prefix patches on TrashManager. CreateTrashItem and TrashManager. CreateTrashBag. These are the server-side entry points that also drive the FishNet observer RPCs, so modifying the spawn position here is automatically replicated to all clients with zero extra networking code.

  Container positions are cached per scene load from all TrashRemovalVolume objects (the static dumpsters placed by the map). The cache is invalidated on scene change and rebuilt lazily on the next spawn.

  []Server guard: InstanceFinder. IsServer — the patch is a no-op on clients[/]

  []Items scatter randomly (±0. 25 m X/Z, −0. 2 m Y) so they pile up naturally instead of clipping[/]

  []Physics is enabled on spawn so items settle to the container floor under gravity[/]

  []If all patches fail at runtime, return true restores vanilla behaviour — the game never crashes[/]