Height: 0.4 Blocks
See § Spawning
See § Data values
|— Tom Stone|
In Java Edition, tropical fish spawn in lukewarm, warm, deep lukewarm and deep warm oceans in groups of 8, with random patterns (see below).
In Bedrock Edition, fish spawn underwater at 12-32 blocks away from the player. Tropical fish spawn only in warm and deep warm ocean biomes, in groups of 3-5 for the same preset pattern, and in groups of 1-3 for random pattern. In addition, tropical fish only spawn on the surface (i.e., there must not be a spawnable block above the spawn location with a non-solid block on top).
- 1 tropical fish.
- 1 bone meal (5% chance) [Java Edition only]
- 1–2 bones (25% chance) [Bedrock Edition only]
- 1 - 3 when killed by a player or tamed wolf.
Tropical fish tend to swim in schools of fish (a maximum of nine tropical fish per school).
The player may collect a fish by using a water bucket on it, which gives the player a bucket of fish. Fish placed with buckets do not despawn naturally. When that fish bucket is used against a block, it empties the bucket, placing water with that fish swimming in it. An empty bucket may be used as well.[Bedrock Edition only]
Tropical fish cannot survive out of water. Outside of water, they flop around like guardians for a while until eventually they suffocate and die like squid. In Bedrock Edition and Legacy Console Edition, they rotate when flipping. Fish cannot swim or breathe in cauldron water.
When tropical fish spawn in the wild, 90% of the time they appear as one of the 22 varieties seen on the right, and the other 10% of the time their patterns, size and colors are completely random, drawn from any of 2 shapes, 15 colors, 6 patterns, and 15 colors for the pattern. These result in 2,700 naturally-occurring combinations.
With commands, the player can summon tropical fish with black as one or both of their colors, and/or without any visible pattern, though even without the pattern they can still have a pattern color, causing a further 884 possible combinations, 480 of which look the same due to the missing pattern.[Java Edition only]
Tropical fish also have assigned names which can be seen after capture, so that the buckets are given names like "Bucket of Plum Blockfish", "Bucket of Sky-Orange Snooper" or "Bucket of Orange-Lime Dasher" in Bedrock Edition, while the types and colors are seen as tooltips in Java Edition. Their colors are mostly named according to the colored block names, though with a few exceptions (the number in brackets is the color id; see § Entity data):
- White (0)
- Orange (1)
- Magenta (2)
- Sky (3)
- Yellow (4)
- Lime (5)
- Rose (6)
- Gray (7)
- Silver (8)
- Teal (9)
- Plum (10)
- Blue (11)
- Brown (12)
- Green (13)
- Red (14)
- Black (15)
Black color is unused, it can only be spawned using commands.
The base color is first, and the pattern color is next if it is different.
The fish bucket is given a name according to the shape and pattern of the fish:
Some varieties (mostly the common varieties) of tropical fish don't follow the normal naming system, and instead reference real-life fish species. Apart from these names, these types of fish aren't different from regular tropical fish in terms of design or behavior.
These varieties are:
|Black Tang||Gray Flopper|
|Blue Dory [Bedrock Edition only]||Gray-Sky SunStreak|
|Blue Tang [Java Edition only]||Gray-Blue Flopper|
|Butterfly Fish [Bedrock Edition only]/Butterflyfish [Java Edition only]||White-Gray Brinely|
|Cotton Candy Betta||Rose-Sky Spotty|
|Emperor Red Snapper[note 1]||White-Red Clayfish|
|Moorish Idol||White-Gray Glitter|
|Ornate Butterfly [Bedrock Edition only]/Ornate Butterflyfish [Java Edition only]||White-Orange Clayfish|
|Queen Angel Fish [Bedrock Edition only]/Queen Angelfish [Java Edition only]||Lime-Sky Brinely|
|Red Cichlid||Red-White Betty|
|Red Lipped Blenny||Gray-Red Snooper|
|Red Snapper||Red-White Blockfish|
|Tomato Clown [Bedrock Edition only]||Red-White SunStreak|
|Tomato Clownfish [Java Edition only]||Red-White Kob|
|Yellowtail Parrot [Bedrock Edition only]/Yellowtail Parrotfish [Java Edition only]||Teal-Yellow Dasher|
|Yellow Tang||Yellow Flopper|
- The Emperor Red Snapper, is the only specially named fish that has a separate name between, UK and US translations, that being 'Red Emperor' for the UK.
|This section needs more information.|
Information requested: verify if there truly are no subtitles
|Sound||Subtitle||Namespaced ID||Subtitle ID||Source||Pitch||Volume||Attenuation distance|
||(Empty sound event)||N/A||N/A||N/A||16|
||(Plays when it dies)||?||0.8||?||16|
||(Plays when on land)||?||?||0.3||16|
||(Plays when damaged)||?||?||?||16|
|Entity||Namespaced ID||Numeric ID|
Pufferfish and tropical fish have additional entity data, beyond what other fish have.
- Entity data
- Tags common to all entities see Template:Nbt inherit/entity/template
- Tags common to all mobs see Template:Nbt inherit/mob/template
- FromBucket: 1 or 0 (true/false) - Whether the fish had ever been released from a bucket.
- Variant: A 4-byte integer.
- The least significant byte has a value of either 0 for a small fish, or 1 for a large fish. Values above 1 result in an invisible fish.
- The next byte has a value from 0–5, representing the pattern on the fish. Values above 5 result in a fish with no pattern.
- The next byte has a value from 0–14, representing the color of the fish's body.
- The most significant byte has a value from 0–14, representing the color of the fish's pattern.
The fish sizes and patterns are depicted in the following table, with white body color and dark gray pattern color.
The 22 varieties of tropical fish most commonly found throughout the world have
Variant tag values from the following table, which also lists what color/shape/patterns come from that value.
|Shape||Pattern||Base color||Pattern color||Variant||Name|
|0||1||7||3||50790656||Gray-Sky SunStreak [Bedrock Edition only]|
|1||0||7||11||185008129||Gray-Blue Flopper [Java Edition only]|
The variant number is the sum of the most significant byte × 224 + second most significant byte × 216 + second least significant byte × 28 + least significant byte.
|Icon||Achievement||In-game description||Actual requirements (if different)||Availability||Xbox points earned||Trophy type (PS)|
|Bedrock||Legacy Console editions|
|I'm a Marine Biologist||Collect a fish in a bucket||Use a water bucket (or an empty bucket in Bedrock Edition) on any fish mob to collect it.||Yes||No||Alt||No||20G||—|
|Icon||Advancement||In-game description||Parent||Actual requirements (if different)||Namespaced ID|
||Tactical Fishing||Catch a fish... without a fishing rod!||Fishy Business||Use a water bucket on a fish mob to get a bucket of fish.|
|This section needs more information.|
Information requested: when "a handful" of tropical fish were implied by a bedrock dev
|Java Edition Alpha|
|June 28, 2010||Notch mentioned that fish might be a feature of coral, if he were able to add coral: "... I do know that the corals will have tiny fish particles around them."|
|October 4, 2010||Fish were a passive mob that Notch showed interest in adding. In the promotional graphic for the Halloween Update, Notch indicated he would add fish. However, they were only added as an item; there was no code for a fish mob.|
|October 5, 2012||Fish were jokingly teased in the fake snapshot 12marc40awesome, along with coral and "fish blocks".|
|April 13, 2013||When Jon Kågström was asked in his AMA on Reddit, "What mob would you like to implement into the game?" He responded, "I would like to add birds, fish and tree animals to make it more alive. However this will take some time before it can be done."|
|July 31, 2013||During Notch's AMA on Reddit, when asked about what happened to his plans of adding fish as a mob, he responded, "Oh yeah, the fish!"|
|1.13||November 18, 2017||Two fish mobs, presumably early tropical fish, were shown off in a clip presented at MineCon Earth.|
|18w10a||Added tropical fish.|
|18w10b||Tropical fish now make sounds and no longer use the player damage sound.|
|1.13.1||18w31a||Fish now have a 5% chance of dropping bone meal when killed.|
|1.4.0||beta 22.214.171.124||Added all 4 variants of fish mobs.|
|1.8.0||beta 126.96.36.199||Tropical fish are now slightly bigger.|
|1.13.0||beta 188.8.131.52||Tropical fish now drop experience when killed.|
|Legacy Console Edition|
|TU69||1.76||Patch 38||Added fish mobs.|
|1.4.0||Added all 4 variants of fish mobs.|
- "How We Ruin-ed Minecraft" – Minecraft.net, March 5, 2018
- – "fish bouncing and suffocating on top of the cauldron which fill with water" resolved as "Won't Fix"