EcoJar: Fish Tank Simulator

A sealed glass jar. Sand, water, algae, a few daphnia. Then you leave it alone and find out whether it holds.

EcoJar is a fish tank simulator built out of cellular automata. Every grain of sand falls, every bubble rises, every alga photosynthesizes, one cell at a time, across forty thousand cells. Nothing is decoration and nothing runs on a timer: if the oxygen falls, it fell because something in your jar breathed it.

BUILT ON ORB.FARM
EcoJar is a fork of orb.farm, Max Bittker's open-source sandbox. We kept the engine and the feel: the cells, the light, the day and the night. We rebuilt what happens inside: how fish live and die, how oxygen swings through the night, how a jar starts, and which species can live here. Play the original at orb.farm; its source is at github.com/MaxBittker/orb.farm.

THE OXYGEN BUDGET IS THE WHOLE THING
Oxygen and carbon dioxide are tracked as real quantities, produced and consumed cell by cell. Aquatic plants and algae only make oxygen where light reaches them, so the curve climbs through the day and turns over at dusk. Every animal spends it all night, whether you watch or not. A jar with too many fish and too little light does not fail dramatically. It fails quietly at four in the morning, and you find out from the chart.

THE LOOP THAT KEEPS A SEALED JAR ALIVE
Waste sinks. Bacteria break it down, and what they leave behind is nitrogen. Nitrogen drifts down until it reaches sand or a plant, feeds it, and releases a bubble on the way. Nitrogen that finds nothing returns to plain water. That is the loop a real closed ecosystem runs on, and it decides whether you get a planted tank that feeds itself or cloudy water.

WHAT YOU CAN DRAW WITH
Twelve materials, each with its own behaviour, plus Clear and Cut.
- Sand, stone, wood and glass build the jar. Sand piles into slopes and anchors anything rooted.
- Water finds its level and carries what is dissolved in it.
- Algae is the engine room: it photosynthesizes, spreads, and blooms first when there is more light and nitrogen than anything can use.
- Grass and plants are the slower producers, and what nitrogen feeds directly.
- Bacteria are the recyclers. Without them, waste accumulates.
- Daphnia and zooplankton are the food web's middle, and the difference between a clean jar and a green one.
- Fish and goldfish sit on top, and go first when the water cannot keep up.

HOW TO BUILD A JAR THAT SURVIVES
Start smaller than you want to. A nano aquarium of sand, water and algae runs a long time alone. Add one daphnia population and watch a single grazer flatten an algae bloom. Only then add a fish. Most people add the fish first, and lose that jar.

WHY MOST FIRST ATTEMPTS DIE
Three reasons, in order: too many animals for the algae; algae with too little light; a jar packed so tight the gases cannot buffer. The chart tells you well before the fish do.

FOR FISH KEEPERS AND JAR KEEPERS
If you keep a jarrarium on a windowsill, you know the wait: weeks before you learn whether the balance was right. This is the same question at a hundred times the speed.

WHAT IS NOT SIMULATED
No water temperature, no pH, no hardness, no ammonia number: the simulation does not model them, and we would rather say so than print a number that means nothing.

WHAT IT ASKS OF YOU
Nothing. No score, no level, no daily reward, no timer. The base game is free; one optional pack adds extra species. It is a cozy aquarium you can put down for a week. Build a jar, watch the oxygen curve, and decide for yourself whether it is a good one.

PRIVACY
No account. No advertising identifier. Anonymous usage stats only. Everything runs on your device, and your jar is stored on it. Uninstalling deletes it.

If you want an ecosystem simulator you can leave running, an aquarium sim, a pixel fish tank that behaves like a real one, or a fish bowl that runs itself, that is what this is.

EcoJar uses the orb.farm engine under the MIT License and is not affiliated with or endorsed by its author.

Recent changes:
Small fixes: the Panel button's label no longer gets cut off in some languages, and if the store couldn't be reached at launch, Buy on the Pack page now tries again. On Android, the anonymous statistics now also note where the app was installed from (for example Google Play), to tell test devices apart from players. Nothing that identifies you.