See Data values
|“||You're not the only new explorer of the updated oceans, mind. We've filled the seas with new types of fish! Above is the delightful pufferfish, which filled me with delightful poison because I was too busy taking that screenshot to swim away in time :(||„|
|— Tom Stone|
Fish are common passive mobs found in oceans and rivers. They come in 4 main variants: cod, salmon, pufferfish, and tropical fish. Tropical fish have 3,584 variants, so the total amount of fish adds up to 3,587 fish.
Cod spawn in normal, cold, and lukewarm oceans, and their deep variants.
Pufferfish and tropical fish spawn in lukewarm, warm, and deep lukewarm oceans.
Salmon spawn in cold and frozen oceans, and their deep variants. Unlike the other types of fish, they also spawn in normal and frozen rivers. Salmon can spawn in 3 sizes which are small, normal and large.[Bedrock and Legacy Console editions only]
Fish drop 1 of their item form when killed:
raw cod (1
cooked cod if killed while on fire[Java Edition only]),
raw salmon (1
cooked salmon if killed while on fire[Java Edition only]),
- A tropical fish will drop the clownfish-textured tropical fish item no matter what its type, pattern or colors are since the tropical fish item only has one variant.
bone meal (5% chance) [Java Edition only]
bone (25% chance) [Bedrock and Legacy Console editions only]
Cod, salmon and tropical fish tend to swim in schools of fish (a maximum of nine cod, six salmon, and nine of the same tropical per school). Salmon are able to swim up approximately 4-5 blocks in waterfalls. Pufferfish will try to hide in a coral or a coral fan and will spin until it leaves; they will also puff up when approached by dolphins and armor stands. They will also swim up waterfalls, like salmon. In Bedrock Edition, however, pufferfish will also puff up when near most hostile mobs.
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 will 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.[Legacy Console and Bedrock editions only]
None of the fish are able to survive out of water. Outside of water, they flop around like guardians for a while until eventually they start to suffocate and die like squids. Cod, salmon and tropical fish will flip around on their sides. They will rotate when flipping.[Bedrock and Legacy Console editions only] Fish cannot swim or breathe in cauldron water.
Guardians will use their laser attack on fish in Bedrock Edition.
Pufferfish will puff up when approached by a player in Survival or Adventure mode, drowned, or any non-water mob in a 5x5x5 cube around the fish, going from unpuffed, then semi-puffed, to fully puffed[Java Edition only], or instantly to the fully-puffed state[Legacy Console and Bedrock editions only]. Pufferfish are technically passive mobs but going near one when fully puffed will inflict the player/mob with seven seconds of
Poison, and touching them in their puffed form will deal damage separate from the poison. Pufferfish also instantly puff up to their fullest form after taking any kind of damage.[Bedrock Edition only]
Tropical fish varieties
When tropical fish spawn in the wild, 90% of the time they will come in one of the 22 varieties seen on the right, and the other 10% of the time their patterns, size and colors will be 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 base color will come first, and if the pattern color is different, it will come after that. Lastly, the fish bucket will be given a name according to the shape and pattern of the fish:
Some 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||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 Stripey|
|Entity||ID Name||Numeral ID|
- See also: Chunk format
Cod and salmon have entity data associated with them that contain various properties of the mob.
Pufferfish and tropical fish have additional entity data, beyond what other fish have.
- 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.
PuffState: A value from 0–2, Only used for
minecraft:pufferfish. 0 means the fish is deflated, 1 means it is halfway puffed-up, and 2 means it is fully puffed-up.
Variant: A 4-byte integer. Only used for
- The least significant byte has a value of either 0 for a small fish, or 1 for a large fish. Values above 1 will result in an invisible fish.
- The next byte has a value from 0–5, representing the pattern on the fish. Values above 5 will result in a fish with no pattern.
- The next byte has a value from 0–14,[note 1] representing the color of the fish's body.
- The most significant byte has a value from 0–14,[note 1] representing the color of the fish's pattern.
- The ID numbers for the colors match the data values of colored blocks. If this value is 15, the color will be black, and if the value is above 15, the color will be white. However, fish with values 15 and up do not spawn naturally.
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)|
||I'm a Marine Biologist||Collect a fish in a bucket||Use a water bucket (or an empty bucket[Bedrock Edition only]) on any fish mob to collect it.||No||No||Yes||No||20G||—|
|Icon||Advancement||In-game description||Parent||Actual requirements (if different)||Internal ID|
|Tactical Fishing||Catch a fish... without a fishing rod!||Fishy Business||Use a water bucket on a fish mob to create a bucket of fish.|
|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.|
|18w08b||Added fish mobs, at this time only cod, salmon, and "puffer fish".|
|Fish mobs have 20 () health.|
|18w10a||Added tropical fish.|
|The health of fish has now been changed to 3 ().|
|18w10b||Tropical fish will now make sounds and will now no longer use the player damage sound.|
|18w15a||Cod and salmon will now drop the cooked version of their item drops, if killed while on fire.|
|18w19a||Corrected "Puffer Fish" to Pufferfish.|
|1.13.1||18w31a||Fish will now have a 5% chance of dropping bone meal when killed.|
|1.4||beta 184.108.40.206||Added all 4 variants of fish mobs.|
|Upcoming Bedrock Edition|
|1.8||beta 220.127.116.11||Tropical fish are now slightly bigger.|
|Legacy Console Edition|
|TU69||1.76||Patch 38||Added fish mobs.|
|1.4.0||Added all 4 variants of fish mobs.|
A school of 6 cod swimming in an ocean.
Dying pufferfish mob in Bedrock Edition.
Dying pufferfish mob in Java Edition.
A cod and pufferfish taking damage because they are not in water.
A school of 4 salmon swimming in a frozen river.
In other media
- "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"
- – "Fish mobs have 20 health", resolved
- – "Some display names don't follow the id", resolved