Litterally

Litterally more trash, zero lag - routes Schedule I's litter into a cheap instanced field so the map holds far more of it, with no feature loss.

By DooDesch

https://github.com/DooDesch-Mods/ScheduleOne-Litterally

Last updated	a day ago
Total downloads	23
Total rating	1
Categories	Mods
Dependency string	DooDesch-Litterally-1.1.0
Dependants	0 other packages depend on this package

This mod requires the following mods to function

LavaGang-MelonLoader

The World's First Universal Mod Loader for Unity Games compatible with both Il2Cpp and Mono

Preferred version: 0.7.3

S1API is an open source collaboration project to help standardize Schedule One modding processes. The goal is to provide a standard place for common functionalities so you can focus on making content versus reverse engineering the game.

Preferred version: 3.1.1

README

Litterally - Trash Without the Lag

🛟 Need help or found a bug? Get support at support.doodesch.de/litterally.

Schedule I's litter is a known performance sink - every scrap is a real object with a rigidbody, colliders and its own save entry. Litterally routes all of it into a cheap instanced field and only makes the trash near you real. You get the vanilla amount of litter and better frames; turn one setting up and the map holds litterally tens of thousands of pieces, still at a playable frame rate.

What it does

The game's trash generators are expensive: every piece of litter is a real GameObject with a rigidbody, colliders, a per-item tick and its own save file. Litterally routes that generated trash into a cheap GPU-instanced field (a few draw calls, compact arrays) and materializes real, interactable items only in the small working set around the player and cleaners. Everything else stays virtual until you (or a cleaner) actually get near it.

Turn the multiplier up and the map holds tens of thousands of trash items at a playable frame rate, with everything still working exactly like vanilla.

Features

Pick up / throw trash near you - the items in front of you are real TrashItems.
Cleaners roam, collect the litter, empty their bins and dispose the bags as usual.
Sleeping-dynamic physics - nearby trash settles into natural poses, collides realistically and can be shoved or thrown, then auto-sleeps so it stops costing.
Persistence - the field is saved as one compact blob and restored on load, written outside the game's save folder so it can never bloat or corrupt your save.
Good citizen - only the game generator's own trash is absorbed; trash another mod creates directly is left untouched.
More trash if you want it - TrashMultiplier defaults to 1, the vanilla amount. Raise it to pile up far more litter; the same layer keeps that cheap.

Requirements

Schedule I 0.4.6f11 (IL2CPP) with MelonLoader 0.7.3+.
S1API (pulled in as a dependency).

The performance layer turns on automatically - there is nothing to configure to get the benefit.

Settings

Editable in UserData/MelonPreferences.cfg (category Litterally_01_Main):

Setting	Default	Meaning
`EnablePerformanceLayer`	on	Master switch. Off = fully vanilla trash.
`EnableInMultiplayer`	off	Force the layer on in multiplayer (experimental).
`MaxRealItems`	200	How many trash items are real/interactable around you at once.
`MaterializeDistance`	32	How far ahead (m) trash becomes interactable.
`RenderDistance`	150	How far (m) the instanced field draws.
`TrashMultiplier`	1	Multiply the game's own trash output (1 = vanilla, up to 1000).
`ActivePhysics`	off	Materialized trash uses active (sleeping-dynamic) physics.

Optional on-screen overlays (all off by default): ShowFpsCounter, ShowActiveItems, ShowStatsPanel, ShowRanges.

Multiplayer

The instanced field is local-only - it is not replicated over the network - so by default the performance layer auto-disables in multiplayer and the game runs vanilla. Set EnableInMultiplayer = on to try it anyway. Proper host-authoritative multiplayer support is a planned follow-up.

License

MIT. See the included LICENSE.md.

Get the Thunderstore App