EcoJar: Fish Tank Simulator
Aquarium sim, aquatic plants
Free · In‑App Purchases · Designed for iPad. Not verified for macOS.
A sealed jar with no lid to open. Twelve materials, one oxygen budget. Draw a world, leave it alone, and find out on day thirty whether it holds.
A sealed glass jar. Sand, water, algae, a few daphnia. Then you leave it alone and find out whether it holds.
EcoJar is an aquarium made 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. Every change is measured against the original in a headless simulator before it ships. 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. A nano aquarium of sand and algae, a closed terrarium of grass and bacteria, an aquascape of plants and stone: all legitimate, all failing differently.
WHY MOST FIRST ATTEMPTS DIE
Three reasons, in order: too many animals for the algae; algae with too little light; a jar packed so tightly the gases have nowhere to buffer. None of it is scripted. The chart tells you well before the fish do.
WHAT IS NOT SIMULATED
No water temperature, because this simulation does not model it. No pH, no hardness, no ammonia number. 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, nothing to buy. 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 analytics. No advertising identifier. Everything runs on your device, and your jar lives in this app's own storage. Uninstalling deletes it.
EcoJar uses the orb.farm engine under the MIT License and is not affiliated with or endorsed by its author. The full license text is in the app under About.
Ratings & Reviews
- This app hasn’t received enough ratings or reviews to display an overview.
EcoJar is now free to download. The Planted Jar is an optional one-time pack that adds five species: duckweed, marimo, hornwort, snails and crayfish. No subscription, no ads.
The developer, Kunliang Wu, indicated that the app’s privacy practices may include handling of data as described below. For more information, see the developer’s privacy policy .
Data Not Collected
The developer does not collect any data from this app.
Accessibility
The developer has not yet indicated which accessibility features this app supports. Learn More
Information
- Seller
- Kunliang Wu
- Size
- 38.7 MB
- Category
- Entertainment
- Compatibility
Requires iOS 15.1 or later.
- iPhone
Requires iOS 15.1 or later. - iPad
Requires iPadOS 15.1 or later. - iPod touch
Requires iOS 15.1 or later. - Mac
Requires macOS 12.0 or later and a Mac with Apple M1 chip or later. - Apple Vision
Requires visionOS 1.0 or later.
- iPhone
- Languages
English and 5 more
- English, German, Japanese, Simplified Chinese, Spanish, Traditional Chinese
- Age Rating
4+
- 4+
- In-App Purchases
Yes
- The Planted Jar $9.99
- Copyright
- © 2026 Kunliang Wu
