Fishies 0.8.5

field-guide/en-GB/README.md

@@ -53,7 +53,7 @@ Plants, ornaments, the stash and how much your aquarium can hold.
 - [Decorating your aquarium](aquarium/decorating.md) · Placing and moving plants and ornaments, and choosing a floor.
 - [Aquarium Studio](aquarium/aquarium-studio.md) · Dress your aquarium: try themes, rooms, floors and equipment on your own aquarium, then buy everything you like at once.
 - [Rooms and themes](aquarium/rooms-and-themes.md) · Choose the room your aquarium stands in and the water inside it. Just for looks.
-- [The stash](aquarium/stash.md) · Where bought and gifted things wait until you place them.
+- [The Pantry](aquarium/stash.md) · The room of your house where food, decorations, eggs and the worm bin are kept.
 - [Room in your aquarium](aquarium/capacity.md) · How many fish and decorations fit, and how that grows.
 - [More aquariums](aquarium/aquariums.md) · The Aquarium Studio: buying a second and a third aquarium, and moving fish between them.
 - [Filters & auto-feeders](aquarium/filters-and-feeders.md) · Equipment that keeps the water clear and the fish fed, and what it costs to keep running.

field-guide/en-GB/aquarium/filters-and-feeders.md

@@ -20,11 +20,11 @@ An auto-feeder hangs on the rim and feeds each fish from its hopper the moment i
 
 Feeder meals count toward quality just like the same meal by hand, but they earn no XP and no coins, so [feeding by hand](https://fishies.lol/wiki/mechanics/feeding) still pays more. A feeder never feeds your tutorial fish or a legendary fish, and when the hopper runs dry it simply stops. Refilling it with flake is free. Grown fish get hungry far less often than growing ones, so a hopper lasts much longer in an aquarium of grown fish.
 
-## Pellets and brine shrimp in the hopper
+## Food in the hopper
 
-When you refill a feeder you choose what goes in: flake, free as always, or pellets or brine shrimp at their usual price. You pay when you refill, for the meals that go in. A meal costs what that food costs for the fish in the aquarium, averaged by how often each one eats, and a grown fish's meal costs half. If your coins run short, the feeder takes as many meals as they buy. Flake is never refused.
+When you refill a feeder you choose what goes in: flake, free as always, or any food from your Pantry's jars. The hopper takes its meals from the jar in grams, the fish's appetite averaged over the aquarium. If the jar runs short, the missing meals are bought at their usual price in the same refill, unless you say no; worms only ever come from their jar. Flake is never refused.
 
-A hopper holds one food at a time. Switching food empties it first: pellets or brine shrimp left in it come back as the coins they cost, and leftover flake is let go. A pellet or brine shrimp meal from the feeder does what it does by hand: pellets keep a fish fed twice as long, brine shrimp three times as long, put health back and count as a perfect meal toward quality, and the gauge counts that in. It still earns no XP and no coins.
+A hopper holds one food at a time. Switching food empties it first: what is left goes back into its jar as grams, never lost, and leftover flake is let go. A meal from the feeder does exactly what it does by hand, loved and disliked foods and stale worms included. It still earns no XP and no coins.
 
 ## Feeding early
 

field-guide/en-GB/aquarium/stash.md

@@ -1,22 +1,30 @@
-# The stash
+# The Pantry
 
-_Where bought and gifted things wait until you place them._
+_The room of your house where food, decorations, eggs and the worm bin are kept._
 
-## What goes in
+## What is in it
 
-The stash holds things you own but haven't put in the water yet:
+The Pantry is a big cupboard in a small room of your house. Open it with 8, the Owned button in the shop, or the aquarium's menu. Its doors stand open:
 
-- Plants and decorations you bought for later.
-- Everything you check out from the [cart](https://fishies.lol/wiki/mechanics/shop).
-- [Gifts](https://fishies.lol/wiki/mechanics/gifts) from other keepers, eggs included.
+- The top shelves hold jars of food, each filled to how much is left. The flake tin and the medicine box sit on a shelf on the wall.
+- The worm bin stands on the floor beside the cupboard, from level 5, with the scrap sieve under its tap.
+- The middle shelves hold decorations and plants, copies stacked. Everything you check out from the [cart](https://fishies.lol/wiki/mechanics/shop) lands here.
+- [Gifts](https://fishies.lol/wiki/mechanics/gifts) from other keepers land here too; eggs sit in the tray on the shallow shelf. The drawers below hold your floors, your Rooms and big decorations, and open to show what is inside.
+- The delivery crate by the door, with a tag while something new is in it.
 
-## Placing from the stash
+## Taking things out
 
-Open the shop and choose Owned, or press 8, then pick something. Placing it is free, because it's already paid for. A gifted egg only starts its hatching clock once you place it. Holding more than one of the same thing? The next one stays in your hand, so you can place them one after another.
+Point at something to see its name; click or tap it to pick it up and go back to the aquarium with it in hand. A jar gets the Feed tool ready with that food, a decoration or an egg is ready to place, a floor or a Room goes on. Hold or right-click for its card. Placing is free, because it's already paid for. Drag, use the wheel or the arrow keys to look up and down the shelves and across to a second cupboard, and the magnifier finds anything by name, in the drawers too.
 
 ## How much it holds
 
-The stash has no size limit: keep as much in it as you like. Selling something straight from the stash gives you half its price back.
+Decorations, eggs, floors and Rooms have no limit: what the shelves have no room for waits in a drawer. Only food has room: four jar slots of 1 kg to start, more shelves from level 8 (from level 20 they bring a second cupboard) and bigger jars from level 12. Selling something from the Pantry gives you half its price back.
+
+## The worm bin
+
+From level 5 a worm bin stands in the corner. Cleaning green glass leaves a scoop of algae scrapings in the sieve; rinse them under the tap, then drag a scoop onto the bin (or tip in worm chow from the shop). The tub makes 60 g of worms in 12 hours, a quarter more if you mist the bedding once it starts to dry. Ripe worms wait, fresh, until you scoop them into their jar.
+
+Each batch can come out rarer: the better the bin and the higher your level, the better the odds. Rarer worms do more for a fish beyond the fed time. A bigger bin, the crate (level 15) and the tower (level 30), makes more and faster.
 
 ---
 

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
 

field-guide/en-GB/getting-started/keeper-os.md

@@ -21,10 +21,12 @@ The apps sit in four groups. Someone visiting another aquarium, or looking at th
 
 ## One notification centre
 
-Everything the game tells you lands in one list: care reports from your aquarium, visits and new followers, gifts to open, finished quests and achievements, a level reward waiting, and news from the team. New rows are marked, and opening the centre reads them.
+Everything the game tells you lands in one list: care reports from your aquarium, visits and new followers, gifts to open, finished quests and achievements, a level reward waiting, and news from the team. New rows are marked, and opening the centre reads them. Replies, mentions and answers from the team in the Community land here too.
 
 Each row does what it says: Feed takes you to the hungry fish, Open opens the gift. Filter the list by care, gifts, social, shop or news, dismiss what you are done with, and turn this device’s notifications on or off at the foot.
 
+When the Fishies team gives you a badge, you are told as soon as you are in the game, and the badge keeps its row in the list.
+
 ## Settings
 
 Settings has six sections, and every option the game has lives in exactly one of them.

field-guide/en-GB/getting-started/time.md

@@ -8,7 +8,7 @@ Every aquarium runs on the server's time, not on an open browser tab. Eggs hatch
 
 ## Coming back
 
-When you return after a while, a While you were away summary tells you what happened: eggs that hatched, fish that grew up, fish waiting for food, fish that fell ill, fish that were lost, whether the glass needs a clean, and anyone who visited or followed you.
+When you return after a while, a While you were away summary tells you what happened: eggs that hatched, fish that grew up, fish waiting for food, fish that fell ill, fish that were lost, whether the glass needs a clean, and anyone who visited or followed you. It also tells you when your fish laid eggs, when a fish finished the Conditioning Box, when gifts are waiting to be opened, and when the auto-feeder ran low or empty, the filter needs a service or the water left a fish's comfortable temperature.
 
 ## Before a long break
 

field-guide/en-GB/getting-started/tools.md

@@ -21,7 +21,7 @@ Out in Open Water the Map stands in the same corner: pick another place to swim
 
 ## The right-click menu
 
-Right-click (a long press on touch) with no tool picked opens a menu for what is under your finger. On a fish: open its card ([Your fish's card](https://fishies.lol/wiki/mechanics/fish-card)), feed it while it is growing, sell it (or every adult of its species), collect it, or add its species to your favourites. On a decoration: move it or sell it. On the water: feed here, drop an egg of a favourite fish (see [Shop & cart](https://fishies.lol/wiki/mechanics/shop)), clean the glass, or decorate.
+Right-click (a long press on touch) with no tool picked opens a menu for what is under your finger. On a fish: open its card ([Your fish's card](https://fishies.lol/wiki/mechanics/fish-card)), feed it while it is growing, sell it (or every adult of its species), collect it, or add its species to your favourites. On a decoration: move it or sell it. On the water: feed here, drop an egg of a favourite fish (see [Shop & cart](https://fishies.lol/wiki/mechanics/shop)), clean the glass, or decorate. At the bottom, Menu opens any app from the Keeper OS.
 
 ## Keys
 

field-guide/en-GB/social/community.md

@@ -38,6 +38,8 @@ The editor writes Markdown and shows a live preview of exactly how the post will
 
 A reply to your topic or to your reply, a reply in a thread you follow, an @mention and an answer from staff all land in your notification centre.
 
+Turn on Community replies in your reminder settings and a reply reaches your phone or computer while you are away; tapping it opens the thread at that reply.
+
 ## Keeping it friendly
 
 The board is moderated by a real person. Report a post that breaks the rules instead of replying to it. You can [block](https://fishies.lol/wiki/mechanics/explore) a keeper, and the block covers the Community, chat and Open Water at once.

field-guide/en-GB/social/explore.md

@@ -8,9 +8,9 @@ Everything worth a visit is on the Map. Pick the Coral Neighbourhood on the ocea
 
 ## The Coral Neighbourhood
 
-On the ocean map, the Coral Neighbourhood shows keepers' aquariums as homes on its plots: yours, your friends' and the most starred. Pick a home to visit it.
+On the ocean map, the Coral Neighbourhood shows keepers' aquariums as homes on its plots: yours, your friends' and the most starred. Pick a home to visit it. Guests still on the name the game gave them and keepers who haven't been around for a month are listed under the reef as Other keepers, one press from a visit.
 
-Every home wears its keeper's name, a dot for whether they're home, out swimming or away, and their stars; friends' homes are marked in teal and yours in gold. Point at a home, or tap it once, to open its card with level, fish, followers and stars, then Visit, or tap the home again, to go there.
+Your home and your friends' homes always wear their keeper's name, a dot for whether they're home, out swimming or away, and their stars; friends' homes are marked in teal and yours in gold. Every other home shows its name when you point at it, reach it with the keyboard or hold a finger on it, so the names never hide the homes. Point at a home, or tap it once, to open its card with level, fish, followers and stars, then Visit, or tap the home again, to go there.
 
 ## Following
 
@@ -20,7 +20,7 @@ You can also follow straight from a home's card in the Coral Neighbourhood or fr
 
 ## Stars
 
-Signed-in keepers can give each aquarium one star, and take it back whenever they like.
+Signed-in keepers can give each aquarium one star, and take it back whenever they like. When someone stars your aquarium, you see who in your notifications and in your While you were away summary.
 
 Only saved accounts can give stars, so new guest accounts can't lift an aquarium up the field. A guest can still look, follow and chat, and can give stars once they [save their progress](https://fishies.lol/wiki/mechanics/signin).