Subscribe to download
Item Stories [beta]

This mod makes buildings more "lived in" by spawning items inside them. It is picking what to spawn randomly from a 'story' system.

If you've tried my "'immersive barricaded start" mod , this will spawn items in a similar way, but for every building, and at a much lower chance.

I've made it into a framework, so different item stories can easily be added.

I've tested this thoughout a 20-days-long savefile, so I'm still figuring out the balance for this, but it looks good so far. I'm open to feedback. You can tweak easily the values with the sandbox settings anyway.
Start and Peak sandbox settings use the same principle as my "Time Decreases Loot" or "Time Decreases Car Condition" mods : start settings are applied before the start day, peak settings applied after the peak day, and proportionally scaled settings are applied between start day and peak day.

Other stories can easily be added, to spawn specific items in specific rooms and/or on specific furniture sprites for example.

---

• "Room Loot" (DONE): Included in this mod. Spawns an item picked from the loot table of the room the item will spawn in. Kitchen items in kitchens, bedroom items in bedrooms, etc. Chance are low and customizable through sandbox settings, and it can trigger in ALL rooms and on ALL furniture sprites.
  
• Pillows on Beds (DONE): Triggers in all rooms, but only on bed sprites, and spawns only pillows.
  
• Propane Tanks in Garages (DONE) :Triggers only in garages and sheds, spawns only propane tanks
  
• ZuperCart's Supermarket Carts in Stores (DONE): Triggers in a variety of stores. Low chance. Spawns Zupercart's supermarket carts.
  
• ZuperCart's Trolleys in Warehouses & Factories (DONE)
  
• Pool cues and balls on billiard tables (DONE)
  
• Pallet crates in warehouses (DONE)
  
• Tire Racks in Mechanics and Garages (DONE)

I will make an all-in-one mod with all item stories eventually.

---

If you have an idea for an item story, you want an item to have a chance to spawn in some rooms or furnitures, leave it in the comments.
Or better yet, simply make a mod yourself that uses the framework. You only need to know how set up a lua table, how building rooms are named (Click here for a list of PZ's rooms[pzwiki.net]), and how to check furniture sprite names using the Brush Tool of PZ's debug mode.
Though keep in mind that stories can only spawn inside a building. 'Forest' stories aren't possible, for example.

---

Randomized Houses:
Item stories are only generated in rooms that have not generated a vanilla randomized house story event. So if you absolutely want Item Stories to trigger on every room, you'll need set the Sandbox Setting "Meta" -> "Randomized House Chance" to "Never".

Tilesets with no surface offsets :
Some mods use tilesets that haven't properly mapped their tiles' furniture surface offsets, which means some of their furniture tiles will be considered as floor instead of furniture. Which generally means much lower chances of item story spawns.
Even some furniture in vanilla don't have their surface offset mapped. I can't really do anything about it. The devs have said they're going to implement a sudo-3d map for each sprite, but it'll be a while before they release it in a build.
These sprites can be recognized easily by simply trying to "Place Item" on one of these tiles to see that it's not working.

The mod will still work though, it's not like these tiles break anything.

---

Note : Playing with this means obviously you're going to find more loot. So I recommend either turning down the vanilla loot, or turning down the Sandbox Settings of this mod.

---

It is recommended to use Loot Tables Fixed [41.78] alongside this mod, but it's not strictly a must-have.

---

Yes. Specifically, the 'Room Loot' story can spawn them, since it picks items from the same loot tables as containers. And then there's also Zupercarts carts, for which I specifed the item Ids of the carts.
However, I am NOT responsible if another modder hasn't properly inserted their custom items in the loot tables.

---

It worked when I tested it on my own local dedicated server with only me on the server.
The framework is basically client side only, though, so I'm expecting some things to go wrong.

---

I made sure that when the player explores, the item stories spawner triggers on one unexplored room at a time, every tick, instead of all unexplored rooms at once. Because of this, even when I teleported into the middle of Louisville's biggest buildings, I didn't notice any lag.

---

Workshop ID: 3037988451
Mod ID: ItemStories_RoomLoot
Mod ID: ItemStories_Framework

Workshop ID: 3037988451
Mod ID: ItemStories_RoomLoot
Mod ID: ItemStories_Framework