Mods / Compost Bin

Tags:
Addon
Author:
Wizard476
Side:
Both
Created:
Mar 6th at 4:25 AM
Last modified:
Mar 7th at 12:09 AM
Downloads:
754
Follow Unfollow 58
Recommended download (for Vintage Story 1.20.0-pre.0 - 1.21.6):
compostbin-v1.2.0.zip  1-click install

Yes! It is, indeed, another compost mod! My wife and I were trying to find a mod to make composting better, and did not really like any of the offerings we were seeing, so I strongarmed claude code into helping me make this. Please accept my offering of a modded barrel which works as a compost bin. The bin has 8 slots, accepts perishable items, as well as rot, dry grass, cattail tops, thatch and papyrus. Perishable items placed in the bin will spoil at a rate of 150% their normal rate, dry plant matter spoils in 4 days at baseline speed. If the bin contains at least 64 rot, and nothing but rot, you can seal the bin and the vanilla compost reaction occurs. To build the bin, place the normal items for the barrel recipe, with 2 dry grass in the empty side slots:

SBS

GBG

SBS

 

v1.2.0
------

- The GUI now has a graphical thermometer bar that fills left-to-right with heat, so you can actually see what your pile is doing at a glance. Temperature shows on the left side of the bar, and OVERHEATING warnings show on the right.
- Fixed the fire mechanic so the bin actually catches fire instead of just vanishing into the void. Fire spawns above the bin and uses it as fuel, so it spreads naturally like any other fire.
- Miscellaneous cleanup and localization fixes.


v1.1.0
------

This is the big one. I went down the rabbit hole of trying to make the bin behave more like an actual compost pile, and this is what came out the other end.

Temperature & Heat:
- The bin now has a temperature model! Decomposition speed scales with the ratio of perishable items ("greens") to dry plant matter ("browns"). A balanced 1:1 ratio gets you baseline speed, a 2:1 ratio gets you double, and anything beyond that caps out. The season matters too — winter slows things down, summer speeds them up. The full range goes from 0.375x in frozen winter to 9.0x at peak summer with a hot, freshly turned pile.

Turning:
- Sneak + right-click the bin with a shovel to turn the pile. This gives you a 2x speed boost that decays over 12 game hours. Costs 1 shovel durability. You will see a burst of steam when you do it, which is a nice touch.

Watering:
- Right-click with a watering can to cool an overheating pile. Halves the seasonal modifier for 6 game hours and resets the fire timer. Costs 2 seconds of water.

Fire Risk:
- If you stuff way too many greens in without enough browns (above 2:1 ratio, with browns present), the bin starts overheating. You get a 24 game-hour countdown before it actually catches fire. The good news is that the elevated rot speed means your food scraps are rotting away faster, so moderate overloads tend to self-correct. You really have to be shoveling food in there to actually start a fire. Pure greens with no browns is slimy but safe — no fire risk. Watering buys you time to fix the ratio.

Dry Offering Changes:
- Dry plant matter now decomposes on an accumulated progress system instead of a flat timer. The speed scales with all the same factors as everything else (heat, season, turning). At baseline it is still about 4 days, but a hot well-maintained pile can get it done in under a day.
- Browns get consumed as greens rot — roughly 1 brown consumed for every 4 rot produced. The consumed browns also yield a bit of rot back.
- Below a 1:1 green-to-brown ratio, decomposition stalls. You need enough food scraps to get the microbial party started. This was the "future release" item from v1.0.0.

Particles:
- Steam rises from hot bins, smoke pours from overheating ones. Intensity scales with temperature. Freshly turned bins vent a burst of trapped heat.

GUI & Hover Text:
- Temperature, decomposition speed, turning boost, stalled warnings, and overheating countdowns all show in the GUI and hover text now.

Mod Version Mod IdentifierFor Game version Downloads Released Changelog Download 1-click mod install*
1.2.0 compostbin
1.20.0-pre.0 - 1.21.6
703 Mar 7th at 12:09 AM compostbin-v1.2.0.zip 1-click install

Compost Bin — Changelog
=======================

v1.2.0
------

GUI
- Added graphical thermometer bar below the inventory slots, filling left-to-right
with an amber-to-red gradient proportional to pile temperature.
- Temperature reading (°C or "Cold") overlaid on the left side of the thermometer.
- "OVERHEATING" warning overlaid on the right side of the thermometer when applicable.
- Condensed all status information to a single compact line below the thermometer.

Fire Mechanics
- Fixed thermal runaway ignition: the bin now actually catches fire instead of
silently disappearing. Fire is placed above the bin and uses the bin as fuel,
allowing it to spread naturally through the game's fire propagation system.
- Combustible properties (800°C, 30s burn) moved to blocktype JSON as the single
source of truth.

Localization
- Added dedicated lang key for the GUI ignition countdown (previously hardcoded).
- Removed unused lang key.


v1.1.0
------

Temperature & Heat Model
- Decomposition speed now scales with four factors:
effective_speed = 1.5x * heatFactor * seasonalModifier * turningBoost
Range: 0.375x (frozen winter, cold pile) to 9.0x (peak summer, max heat, freshly turned).
- Heat factor derived from the perishable-to-dry-offering ratio:
No browns: 1.0x | Below 1:1: 1.0x | 1:1 to 2:1: linear 1.0-2.0x | Above 2:1: capped 2.0x
- Seasonal modifier based on ambient temperature:
Below 0°C: 0.5x | 0-20°C: 0.5-1.0x | 20-40°C: 1.0-1.5x | Above 40°C: 1.5x
- Display temperature in °C (20-93°C range) shown in hover text and GUI,
grounded in real-world composting temperature ranges.

Turning (Aeration)
- Sneak + right-click with a shovel to turn the pile.
- Grants a 2.0x speed boost that decays linearly to 1.0x over 12 game hours.
- Consumes 1 shovel durability per turn.
- Visual feedback: burst of steam particles when recently turned.

Watering (Cooling)
- Right-click with a watering can to cool an overheating pile.
- Halves the seasonal modifier for 6 game hours.
- Resets the thermal runaway timer, buying time to correct the ratio.
- Consumes 2 seconds of water from the can.

Thermal Runaway (Fire Risk)
- When perishable items exceed 2x the dry offering count (and dry offerings are
present), the bin begins overheating.
- 24 game-hour countdown to ignition, displayed in the GUI and hover text.
- Self-correcting: elevated 3.0x rot speed means food rots away faster, naturally
cooling the bin. Only extreme overload or continuous feeding causes fire.
- Timer resets if the ratio drops back into the safe range.
- Pure greens with no browns: slimy but safe — no fire risk.
- Safe operating band: 1:1 to 2:1 perishable-to-dry ratio.

Dry Offering Improvements
- Replaced timestamp-based decomposition with accumulated progress model.
Progress scales with the full speed formula, accounting for changing conditions.
- Target: 144 effective hours (96 wall-hours at baseline, 16 at maximum speed).
- Carbon consumption: for every 4 rot produced from perishables, 1 dry offering
is consumed. Consumption cycles across slots in round-robin order.
- Consumed dry offerings yield rot (4 consumed = 1 rot), with remainder tracked
across ticks to prevent integer division loss.
- Below 1:1 perishable-to-dry ratio: decomposition progress is frozen (stalled).
- Migration: saves from v1.0.0 are automatically converted to the new format.

Particles
- Steam particles rise from hot bins (above 40°C), intensity scaling with temperature.
- Dense smoke particles pour from overheating bins (above 70°C).
- Brief steam burst when the pile is freshly turned.

GUI & Hover Text
- Hover text now shows: temperature, decomposition speed, turning boost,
stalled warning, and overheating countdown.
- GUI displays the same information with a seal button that appears when
sealing prerequisites are met.

1.0.0 compostbin
1.20.0-pre.0 - 1.21.6
51 Mar 6th at 4:27 AM compostbin-v1.0.0.zip 1-click install

Initial release... 


6 Comments (oldest first | newest first) (threaded | flat)

Wizard476 , Mar 21st at 7:48 PM

ITheLegend28I: I will look into this as time allows...

ITheLegend28I, Mar 18th at 11:04 AM

Any plans on adding config file? I would like to tweak rot to compost time.

Wizard476 , Mar 8th at 7:46 PM

@KiriRae Thatch should work, I double checked it and it works in my game?  If the chest accepts something, it should turn it into rot.  I am not familiar with the string sense mod, but I may look into that further, if I have the time.

KiriRae, Mar 8th at 4:06 AM

What items are considered 'brown'? I tried thatch but didn't work. It may be because I have string sense mod loaded and it's not standard thatch (compatibility requested 😋) Or maybe I put in too much? Just dumped a stack in with just a few foods.

Foxtrot88, Mar 8th at 12:38 AM

I've been waiting for this mod for such a long time oh my god. Besides getting quicker access to compost (compost still takes an ungodly amount of time, it shouldn't take this long), some other mods like Rustbound magic require steady access to rot, and this solves the issue so nicely, thank you so much!!! 🤩

ITheLegend28I, Mar 7th at 9:03 PM

nice mod!