Fishies 0.8.5

field-guide/en-GB/caring/feeding.md

@@ -10,13 +10,29 @@ A newly hatched fish needs its first meal. After that, a growing fish gets hungr
 
 Select a fish and choose Feed on its card or in its menu to drop food just for that fish: it swims to it, and no other fish takes it.
 
-## Three foods
+## Seven foods
 
-Flake is free and always will be; the other two are an upgrade you choose, never a gate. If you pick one you cannot afford, the fish is fed flake instead of being left hungry. Their price is a fraction of the fish’s own, so they stay affordable wherever you are in the game, and a grown fish’s paid meal costs half.
+Flake is free and always will be; every other food is an upgrade you choose, never a gate. If you pick one with an empty jar, the meal is bought as you feed at its usual price, and if you cannot afford it the fish is fed flake instead of being left hungry.
 
-- Flake · free, an everyday meal.
-- Pellet · keeps a fish fed twice as long, and moves its whole care clock out with it.
-- Brine shrimp · three times as long, puts health back, and always counts as a perfect meal for quality.
+- Flake · free, from a tin that never runs out.
+- Pellets · keep a fish fed twice as long, and move its whole care clock out with it.
+- Brine shrimp (frozen) · three times as long, put health back, and always count as a perfect meal for quality.
+- Mysis shrimp (frozen) · two and a half times as long, a little health, quality a touch faster.
+- Nori sheet · twice as long, quality faster. Grazers love it.
+- Krill · two and a half times as long, a little health, quality faster.
+- Red worms (live) · from your worm bin: twice as long, health, quality faster and a little faster growth. Fresh for 48 hours, then stale: still a meal, without the extras. Worms are never lost.
+
+## Food in grams
+
+Food lives in jars in your [Pantry](https://fishies.lol/wiki/mechanics/stash), in grams. Every fish has an appetite: its egg price divided by 20, in grams, and half that once it is grown. A Clownfish eats 2 g a meal, a Grouper over 200 g. So a meal from a jar costs what a meal has always cost.
+
+Buy food in packs from the shop's Food tab or from a jar's card: 100 g at the list price, 500 g at 10% off, 2 kg at 20% off. A jar holds one food; bigger jars and more shelves are upgrades in the Pantry.
+
+## Loved and disliked foods
+
+Every fish eats one of five ways: grazers, hunters, plankton eaters, sand sifters and everyday eaters. A food it loves does half as much again beyond the fed time, and a little heart rises from the fish. A food it dislikes still feeds it, but only the fed time counts, and it gives a little shrug.
+
+Grazers love nori and dislike krill and worms. Hunters love krill and worms and dislike nori. Plankton eaters love brine shrimp, mysis and krill. Sand sifters love worms and mysis and dislike nori. Everyday eaters take everything the same. Flake and pellets suit every fish.
 
 ## What feeding earns
 
@@ -24,7 +40,7 @@ Feeding a hungry fish earns 5 XP. Feeding it again straight away doesn't repeat
 
 ## While you're away
 
-An [auto-feeder](https://fishies.lol/wiki/mechanics/filters-and-feeders) feeds each fish from its hopper the moment it gets hungry, for as long as the hopper lasts: flake, or pellets or brine shrimp you paid for. Grown fish get hungry far less often, so the hopper lasts much longer for them. Feeder meals count toward quality just like the same meal by hand, but they earn no XP and no coins, so feeding by hand still pays more, and it still works with a feeder installed.
+An [auto-feeder](https://fishies.lol/wiki/mechanics/filters-and-feeders) feeds each fish from its hopper the moment it gets hungry, for as long as the hopper lasts. It loads its food from your Pantry's jars. Grown fish get hungry far less often, so the hopper lasts much longer for them. Feeder meals count toward quality just like the same meal by hand, but they earn no XP and no coins, so feeding by hand still pays more, and it still works with a feeder installed.
 
 ## Too long without food
 

field-guide/en-GB/caring/fish-card.md

@@ -10,7 +10,7 @@ Every fish is born with a name and is female or male. Neither ever changes what
 
 ## What the card shows
 
-Growth, food and health sit at the top of every card. Under them, three tabs: Overview for what it needs now, Quality for where its quality stands, what it is made of and what slows it, and Value for what it sells for. Each row is explained once, in the article it points to.
+Growth, food and health sit at the top of every card, each led by the time left or its state in words: Grows up in 1d 4h, Hungry in 18h, Healthy or Recovers in 6h. A thin line under each shows how far along it is, and its percent stands beside its name. Under them, four tabs, each an icon and a short name: Info for what it needs now, Quality for where its quality stands, what it is made of and what slows it, Value for what it sells for, and Family for its parents, brothers and sisters and fry. Each row is explained once, in the article it points to.
 
 - Growth and food: how long until it is grown, and when it gets hungry. See [Growing up](https://fishies.lol/wiki/mechanics/growth) and [Feeding & hunger](https://fishies.lol/wiki/mechanics/feeding).
 - Health: how well it is, and when it would run out without food. See [Quality, condition & breeding](https://fishies.lol/wiki/mechanics/quality).
@@ -36,6 +36,20 @@ Rather keep a grown fish than sell it? Open its card and choose Adopt. An adopte
 
 Adopting can’t be undone. If you ever need its place, choose Release to the ocean on its card: it swims off into the open sea and you get no coins for it.
 
+To you an adopted fish is priceless, so it shows no price and no quality tier. It wears Obsidian instead, a black stone that never changes, and its card tells its story: its age, the day it hatched and the day you adopted it, its age milestones and its family. It still needs food and care like any fish. It breeds as it always did, by the quality its care gives it, and its fry are ordinary fish you can keep or sell; Obsidian itself is never passed on.
+
+## Family
+
+Every fish bred in your aquariums remembers its mother and father, and their parents too. Open a fish’s card and choose Family to see its parents, grandparents, brothers and sisters (fry of the same two parents), its own fry and its generation, and where each of them is now: in this aquarium, in another one, on an expedition or still an egg.
+
+A relative that leaves stays in the family as a memory, marked sold, released to the ocean or lost, with the name and quality it had. Your aquariums remember up to 100 of them, and the oldest memory goes first.
+
+A fish bought as an egg, given as a gift or bred before 16 October 2026 has no recorded parents, and its card says so. Its own fry still name it as their parent. Only you see your fish’s families; a visitor sees none of it.
+
+## Age milestones
+
+A fish counts its age from the day it hatches. At one week, one month, three months, six months and one year, and on every birthday after that, it earns a milestone badge beside its age. The next time you look in, one notification names every fish that reached one, and the badge sparkles the first time you open its card. Its title beside its name, Mature, Seasoned or Elder, is something else: it counts only the days it was fed as a grown fish.
+
 ---
 
 In the game: https://fishies.lol/wiki/mechanics/fish-card · Fishies 0.8.5

field-guide/en-GB/caring/grade.md

@@ -13,7 +13,7 @@ Grade never changes a price. It is the same fact as the sale value, counted in p
 The bar on a fish's card splits its Grade in two. Pedigree is what the fish was born with; upbringing is what your care has earned it. Each row shows the points one part adds, and [What a fish is worth](https://fishies.lol/wiki/mechanics/quality) explains each part.
 
 - Care tier · upbringing. The quality its care and its home have earned, conditioning included.
-- Age · upbringing. A few points for a fish kept fed after it is grown, all of them once it is ripe.
+- Age · upbringing. Points for every fed day after the fish is grown, quickest in the first weeks, all of them at 45 days, and a few more for an Elder.
 - Lineage · pedigree. The tiers a bred fish was born above its care.
 - Colour · pedigree. The rarer the colour, the more it adds.
 - Generation · pedigree. Each bred generation after the first takes a little off.

field-guide/en-GB/caring/notifications.md

@@ -10,7 +10,7 @@ Turn reminders on and Fishies lets you know about the things that matter while y
 - A fish is close to starving, about 2 hours before it would be lost.
 - Eggs have hatched, or a fish is ill and needs a remedy.
 - The glass needs cleaning.
-- Your filter needs a service soon, your auto-feeder is running low or has run empty, or some fish are outside their comfortable temperature. You can also be told when a fish is lost, when someone visits your aquarium and when someone follows you.
+- Your filter needs a service soon, your auto-feeder is running low or has run empty, or some fish are outside their comfortable temperature. You can also be told when a fish is lost, when someone visits your aquarium and when someone follows you. You can also hear when a gift arrives, when someone stars your aquarium, when someone whispers to you and when someone replies to you in the Community, each with its own switch.
 
 ## Where they arrive
 

field-guide/en-GB/caring/quality.md

@@ -24,6 +24,7 @@ Where a fish lives matters too. Every species has a home, reef, rock, sand, weed
 - Gold · the highest tier care alone can reach, earned once the fish is grown and kept in a good home.
 - Diamond · sometimes born to two gold parents, then raised well.
 - Purple diamond · sometimes born to two diamond parents, then raised well.
+- Obsidian · not a tier but what an adopted fish wears: priceless, never sold and never passed on.
 
 ## Where fry come from
 
@@ -33,6 +34,10 @@ A fish rests two days after a clutch, and the same pair waits a week before spaw
 
 Each egg from two gold parents has a one-in-four chance to be born a tier above the care it receives. From two diamond parents it is one tier half the time and two tiers one time in ten. That head start is the only way into diamond and purple, and it is only a head start: a fry left hungry slides back down like any other fish. Tap a bred egg before it hatches and choose Incubate to keep it warm until thirty-six hours: from gold parents it is then one tier half the time, and from diamond parents one tier seven times in ten and two tiers one time in five. An egg from parents below gold gets a one-in-five chance to start at bronze instead, which is care, so it still stops at gold. Turn on Auto-incubate eggs in Settings to do this for every bred egg as it is laid, even while you are away.
 
+Every egg remembers its mother and father, so its card shows its family. An adopted parent breeds by its own quality, as before it was adopted, and its fry are ordinary fish. See [Your fish’s card](https://fishies.lol/wiki/mechanics/fish-card).
+
+When a pair lays an egg, hearts rise over the two parents and the egg glows as it settles. A note names the parents, with a button that opens the egg’s card; several eggs at once make one note. Eggs laid while you were away are counted when you come back.
+
 ## Conditioning
 
 Every aquarium has a Conditioning Box: a small clear box clipped inside the glass near the surface. It is free, and it arrives as a [gift](https://fishies.lol/wiki/mechanics/next-goal) when a fish in that aquarium first reaches silver. Tap it in the water, or open it from the Aquarium Studio, pick a fish and how long it rests, and it swims back out a quality tier higher.
@@ -47,7 +52,7 @@ A grown fish sells for its species' value, then its quality, then three smaller
 
 Colour: every fish has one of six colours, rolled when you buy the egg and passed from a parent to most fry. Sand and kelp sell at the plain price, bleach ×1.1, teal ×1.2, ink ×1.35 and the rare coral ×1.6.
 
-Age adds up to +0.10 for a fish kept fed after it is grown, the full amount once it is ripe. Each bred generation after the first takes 2% off, never more than 10% in all, and a parent bought from the shop starts the line again.
+Age adds to the price of a fish kept fed after it is grown, quickly at first and more slowly later: about +10% after 7 fed days, +19% after 15, +31% after 30 and the full +35% after 45. Only fed days count, by hand or from a feeder: a grown fish left hungry does not age. At 7 fed days a fish becomes Mature, at 30 Seasoned and at 90 an Elder. An Elder adds +5% more, wears silver on its fins and swims a little calmer; the other titles add nothing to the price. The price breakdown on its card always shows its fed days and what is still to come. Each bred generation after the first takes 2% off, never more than 10% in all, and a parent bought from the shop starts the line again.
 
 ---
 

field-guide/en-GB/caring/water.md

@@ -6,7 +6,7 @@ _How clear your aquarium's water is, what keeps it clear, and what cloudy water
 
 Every aquarium has a water reading from 0 to 100%: how many fish it can keep in clear water, against how many it holds. Every fish counts, eggs and lost fish included. Only the [legendary fish](https://fishies.lol/wiki/mechanics/legendary) are left out, because water never touches them.
 
-The gauge under your level and coins shows the water as Clear, Good, Cloudy or Murky. Open it to see the numbers behind it, your filter's health and how long your feeder's food will last.
+The gauge under your level and coins shows the water as Clear, Good, Cloudy or Murky, when your filter next needs a service and how long your feeder's food will last. Open it to see the numbers behind them and your filter's health.
 
 ## What keeps water clear