Mods / Floating Fish

Tags: #Creatures #Food #QoL
Author: Reverhaus
Side: Both
Created: Feb 20th at 3:10 AM
Last modified: Oct 27th at 12:11 PM
Downloads: 10899
Follow Unfollow 276

Recommended download (for Vintage Story 1.21.2 - 1.21.5):
floatingfish_1.1.3.zip  1-click install


Floating Fish (After Kill)


This mod makes fish float to the surface after being killed, instead of sinking to the bottom. You can easily grab the fish and carry it in your inventory.

To prepare the fish, simply use a knife in the crafting grid to turn it into a fillet for cooking. This makes fish easier to collect and process without altering the game's basic mechanics.

Inspired by RogueHouse Additions
Inspired by a similar feature from the RogueHouse Additions modpack, this version keeps things simple and stays true to the core gameplay.

 

Mod integration

Primitive Survival

 

  • No more duplicated fish when running both mods.

  • All fish caught with Floating Fish are now processed using Primitive Survival recipes, standardizing your crafting and cooking.

 

Incompatibilites

Some users have reported fish spawn issues in their worlds. It appears this is due to certain biome mods that alter the vanilla fish spawn rates. It's possible that these mods have not yet been updated to accommodate the fish changes introduced in Vintage Story version 1.21.

 

 

This is my first mod, and I'm VibeCoding, so please be understanding if there are any errors or redundancies.

Please be patient I do vibe coding

 

Changelog

 

v1.1.3

  • Fixed code for freshwater salmon (Simplified the code for possible compatibility with mods that make salmon recipes.)
  • Adjusted recipes for freshwater salmon (2 fishmeats instead 5 fishmeat) and adjusted reef fish recipes (now only drop 1 tiny bone instead 1 fishmeat)

 

v1.1.2

  • NEW: Added full compatibility with the Primitive Survival mod.

    • Resolves fish duplication between the two mods.

    • Floating Fish now utilizes Primitive Survival recipes for processing fish, ensuring a unified experience.

 

v1.1.1

  • FIXED: Incorrect formatting in the English language file.

  • UPDATED: Corrected fish names in DE, EN, FR, and PL to match official game translations.

  • ADDED: Temporary placeholder fish names (via Google Translate) for ES, PT, RU, and UK until official translations are available in-game.

 

v1.1.0 - ⚠ NOT COMPATIBLE WITH VERSIONS PRIOR TO 1.21

  • OVERHAUL: Updated for Vintage Story 1.21's new fish system.

  • REPLACED: The old salmon-pink entity with the new saltwater salmon, which now spawns in lakes.

  • ADDED: Variable quantities of fish fillets depending on the species.

  • EXPANDED: Added 29 new vanilla fish species.

Fish List

Reef Fish

 

  • Bicolor Angelfish

  • Copperband Butterflyfish

  • Blackwedged Butterflyfish

  • Black Clownfish

  • Common Clownfish

  • Yellowstripe Maroon Clownfish

  • Longspine Porcupinefish

  • Banded Surgeonfish

  • Powderblue Tang

  • Titan Triggerfish

  • Creole Wrasse

Saltwater Fish

 

  • Sea Bream

  • Cape Gurnard

  • Common Haddock

  • Silver Hake

  • Atlantic Herring

  • Atlantic Mackerel

  • Alaska Pollock

  • Pacific Perch

  • Great Barracuda

  • Black Grouper

  • Red Snapper

  • Skipjack Tuna

  • Bering Wolf

  • Yellowtail Amberjack

  • Common Mahi-Mahi

  • Atlantic Wreckfish

  • Common Coelacanth

  • Atlantic Sturgeon

  • Pink Salmon

  • UPDATED: BreedableFish mod compatibility (note: BreedableFish may not yet reflect the new fillet quantities).

 

v1.0.3

  • ADDED: Compatibility with the BreedableFish mod.

  • ADDED: Multi-language translations (German, Spanish, French, Polish, Portuguese, Russian, Ukrainian).


Incompatibilities & Known Issues

  • Biome Mods: Some users report issues with fish spawning when using mods that alter vanilla biome or fish spawn rates. This is likely because those mods have not been updated for the fish changes in Vintage Story version 1.21.

  • Version Warning: v1.1.0 and above are not compatible with game versions prior to 1.21 or with saves from previous versions of this mod.

Mod Version Mod IdentifierFor Game version Downloads Released Changelog Download 1-click mod install*
1.1.3 floatingfish
1.21.2 - 1.21.5
1746 Oct 27th at 12:11 PM floatingfish_1.1.3.zip 1-click install

Fixed code and adjusted fish drop

1.1.2 floatingfish
1.21.2 - 1.21.4
1241 Oct 8th at 9:59 PM floatingfish_1.1.2.zip 1-click install

Added compatibility with the Primitive Survival mod

1.1.1 floatingfish 612 Oct 3rd at 5:19 PM floatingfish_1.1.1.zip 1-click install

Corrected translation into multiple languages ​​(English is no longer broken)

1.1.0 floatingfish 1087 Aug 4th at 1:04 AM floatingfish_1.1.0.zip 1-click install

rewrite of the complete mod for the version 1.21.0-rc.2 (incompatible with previous versions)

1.0.3 floatingfish 2069 Jul 29th at 12:48 AM floatingfish_1.0.3.zip 1-click install

Added compatibility with the BreedableFish mod

Added translations to other languages (Ukrainian added too)

1.0.1 floatingfish 3810 Feb 21st at 2:13 AM floatingfish.zip 1-click install

Adjusted parameters and purged code

1.0.0 floatingfish 309 Feb 20th at 3:13 AM Empty floatingfish.zip 1-click install

55 Comments (oldest first | newest first)

💬 Reverhaus , Nov 24th at 11:30 AM

Mr_J_Soda I'm sorry, but I don't know how to create functions for Config lib. When I learn, I'll work on some of these ideas.

💬 Mr_J_Soda, Nov 11th at 9:20 PM

I know you added full compatibility with the Primitive Survival mod, which is wonderful, but would it be possible to get some kind of config setting so we can pick if we want floating fish or Primitive Survival fish?

💬 Reverhaus , Nov 11th at 2:43 AM

Hydromancerx I'm trying to learn how to mod animals and do something interesting with them; I don't know if I can do it yet. 🥵🙏

💬 Hydromancerx, Oct 29th at 6:25 PM

Please make more types of fish! Espeically freshwater fish!

💬 Reverhaus , Oct 28th at 10:36 AM

General_JOE I'd love to do it! But I need to learn how to create entities (and make some simple 3D models) before I can make anything interesting :(

💬 General_JOE, Oct 22nd at 9:58 PM

Any chance for new freshwater species in the future? It's so barren with just salmon swimming around the lakes and rivers :)

💬 RiverTheSheep, Oct 8th at 11:19 PM

Nice!

💬 Reverhaus , Oct 8th at 10:10 PM

RiverTheSheep After collaborating with the author of Primitive Survival, we've successfully resolved the item duplication between our mods. Primitive Survival and Floating Fish are now fully compatible and work together correctly :)

💬 RiverTheSheep, Oct 5th at 9:14 PM

Ahhh, I see. Appreciate the answer! 

💬 Reverhaus , Oct 5th at 11:18 AM (modified Oct 5th at 11:54 AM)

RiverTheSheep Yes, the mod works correctly alongside Primitive Survival. The issue is that when you use a fishing spear or catch fish in a trap, it generates a different type of 'dead fish' than the one found in FloatingFish, with different characteristics. (The Primitive Survival fish can be cooked, yields different amounts of meat when butchered, etc.). Using them together doesn't cause incompatibilities, but there are duplicate items (fish) with different values/properties.

I'm not sure if I can patch this to combine the fish items.

The problem is the Primitive Survival fish disappears when it hits the water, so I can't make it float like the FloatingFish item.

The PS fish has many more functions than mine, and I don't know how to change its 'disappearing' behavior to let it float.

💬 RiverTheSheep, Oct 3rd at 11:35 PM

Does this mod work with Primitive Survival? Or would it cause issues

💬 Reverhaus , Oct 3rd at 5:23 PM

I'm very sorry for the delay.

 

I have corrected the English translation so that it is no longer broken, and I have corrected some translations into other languages to match the official translations (others are just Google translations because I don't know the languages, but I will correct them as the official translations are updated).

💬 Reverhaus , Sep 26th at 10:44 AM

Sindanarmo This mod modifies freshwater salmon (the legacy salmon) and replaces it with the new salmon. Perhaps that's why you only see that fish, because the rest of the fish are vanilla, and the biomes are altering their spawn rate.

💬 Sindanarmo, Sep 23rd at 4:00 PM

I have exactly same bug, which was already mentioned before - after installing mod there was only one fish - salmon. It is even worse because after removing mod there is still only salmon. Installed it on 1.21.1 version of game. What I'm supposed to do to have all of the fish in my world?

💬 Gumbyohson, Sep 20th at 11:40 AM (modified Sep 20th at 12:10 PM)

Razgriz Actually it looks like the issue is caused by both the missing end comma and the '//' comments in each new section line. I checked a few other JSON files and they dont have them. Chucked the EN.JSON into https://jsonlint.com/ and it says the comments invalidate the JSON and the missing commas cause runover of the record.

Removing all //comments should resolve the issue and adding the missing commas and make the file valid again.

💬 DrgnDspchr, Sep 12th at 3:48 AM (modified Sep 16th at 2:52 AM)

edited...

Yep.. it was definately user error on my part... i had the wrong version of the mod installed... all better now.. thanks 

 

 

Greetings... 
I am fairly certain that this is user error on my part... but the fish never actually float for me... 1.21 or 1.21.1 ... it doesnt crash anything, but the fish sink and stay down... ??????? 

Thanks in advance

 

💬 Tasshroom33, Sep 6th at 12:48 AM

Razgriz Ha I came here to say exactly what you did, you beat me to it! Easy fix in the .zip but yeah should be updated.

💬 Razgriz, Sep 4th at 2:14 PM

Found another minor issue with the en.lang json (it probably exists in the other lang files as well)

It's missing the entity name entry so the fish in game show up as "item-creature-fish-freshwater-salmon-pink-adult-male"

Adding these lines will fix it:

I put them just below the current Pink Salmon entries in your -modded entities section.

"fish-freshwater-salmon-pink-adult-male": "Pink Salmon (Male)",

"fish-freshwater-salmon-pink-adult-female": "Pink Salmon (Female)",

💬 Razgriz, Aug 27th at 6:39 PM

Not sure if you've been made aware or not, but you have errors with regards to your en.json lang file, which is causing some errors.

Specifically lines:

35

48

108

129

135


(the end of each fish grouping it seems)


You're just missing end line commas is all, so its a super simple fix!

💬 AzuliBluespots, Aug 25th at 7:40 PM

I'm... not using this mod (you can guess why, someone already mentioned the reason) but I'm getting fish errors in my 1.21 stable logs. This is the only place I see mentioning them.

 

25.8.2025 16:22:53 [Warning] An entity fish-saltwater-amberjack-yellowtail-adult-female failed to complete initialisation, will not be physics ticked.
25.8.2025 16:23:31 [Warning] An entity fish-saltwater-haddock-common-adult-female failed to complete initialisation, will not be physics ticked.
25.8.2025 16:24:20 [Warning] An entity fish-saltwater-mackerel-atlantic-adult-female failed to complete initialisation, will not be physics ticked.


Are these fish supposed to be vanilla?

💬 Reverhaus , Aug 25th at 1:26 AM

Jhoulana This is something I've thought about so many times!

But unfortunately, I don't understand ANYTHING about the 'Butchering' mod's code to add fish or other shark mods to the butchering mechanic... I'm afraid it's just way over my head :(

💬 Reverhaus , Aug 25th at 1:22 AM

Mrozak bro, this isn't Twitter, idc about your personal perspective on AI stuff 🤷‍♂️

I'm not trying to do anything more than offer something to the community. I added the whole 'vibecoding' thing precisely so I wouldn't be judged too harshly for code errors and so people understand that I'm not an experienced modder.

 

Sorry if you hate that. I'm doing my best, if you don't like how I do it. Bye.

💬 Pervy_Sage, Aug 21st at 1:41 AM

Thanks this should make an island play through easier.

💬 Jhoulana, Aug 19th at 12:19 PM (modified Aug 19th at 12:20 PM)

@Reverhaus

could i request making them bucherable? i mean able to place the dead fish on the ground and harvest them ?

CaptainOats is not intersted in including fish is his Butchering mod and the thing with the fishes irks my immersive needs >.<

 

 

💬 Sianks, Aug 16th at 6:17 PM

I dont understand why I couldnt see any fishes besides basic Salmon in lakes nor in Creative Mode Inventory itself. 

💬 Mrozak, Aug 13th at 9:06 AM

Reverhaus No need to be upset.
Yes, i HATE "vibe coding", and i strongly believe that people would get better results if they'd learned how to do stuff themselves.
Fact is, "vibe coding" is just another term for "no idea what am i doing, but proud of it" :)
This is not personal, i don't hate you, you are great, i just hate "vibecoding" - and you should too :)

💬 Reverhaus , Aug 8th at 5:37 PM

Mrozak Wow! I appreciate the report, but you could be more polite and respectful next time. If you don't like a mod, you don't have to download it.

I'll get to work on it, but I hope I don't read you here again.

💬 Mrozak, Aug 8th at 3:11 PM

en.json contains multiple errors - missing commas.
i recommend you stop wasting time with "vibe coding" and do it properly.

💬 Verlia, Aug 5th at 9:12 PM

That's amazing, thanks so much for this <3

💬 Reverhaus , Aug 5th at 12:16 AM

Hydromancerx I though the fish names were on the new patch notes but they don't appear in it 🥴

This is the list of all fish (I will put in the Mod description too):

Spoiler

Reef Fish

 

  • Bicolor Angelfish

  • Copperband Butterflyfish

  • Blackwedged Butterflyfish

  • Black Clownfish

  • Common Clownfish

  • Yellowstripe Maroon Clownfish

  • Longspine Porcupinefish

  • Banded Surgeonfish

  • Powderblue Tang

  • Titan Triggerfish

  • Creole Wrasse

Saltwater Fish

 

  • Sea Bream

  • Cape Gurnard

  • Common Haddock

  • Silver Hake

  • Atlantic Herring

  • Atlantic Mackerel

  • Alaska Pollock

  • Pacific Perch

  • Great Barracuda

  • Black Grouper

  • Red Snapper

  • Skipjack Tuna

  • Bering Wolf

  • Yellowtail Amberjack

  • Common Mahi-Mahi

  • Atlantic Wreckfish

  • Common Coelacanth

  • Atlantic Sturgeon

  • Pink Salmon

💬 Reverhaus , Aug 5th at 12:10 AM

Verlia Yes! When you kill a fish, you can put it in your inventory just like any other item.

💬 Verlia, Aug 4th at 10:21 PM

Thank you for this, I was glad to see something like it. Is there a way to pick up fish bodies/put them into inventory by chance?

 

💬 Hydromancerx, Aug 4th at 3:34 PM

What are the 29 new fish species?

💬 B0YAR, Aug 4th at 3:08 PM

Reverhaus
That would be cool! As well as support up to version 1.20.12 thank you!

💬 Reverhaus , Aug 4th at 11:15 AM

Mrozak fixed! Thanks for the log 🤠

💬 Mrozak, Aug 4th at 9:28 AM

Using the mod version 1.1.0 in game version 1.21.0-rc.2 i get the following error when generating a new world:

Log
4.8.2025 10:49:21 [Error] Failed loading patches file game:patches/disable-vanilla-salmon-pink.json:
4.8.2025 10:49:21 [Error] Exception: Failed deserializing disable-vanilla-salmon-pink.json: Cannot deserialize the current JSON object (e.g. {"name":"value"}) into type 'Vintagestory.ServerMods.NoObf.JsonPatch[]' because the type requires a JSON array (e.g. [1,2,3]) to deserialize correctly.
To fix this error either change the JSON to a JSON array (e.g. [1,2,3]) or change the deserialized type so that it is a normal .NET type (e.g. not a primitive type like integer, not a collection type like an array or List<T>) that can be deserialized from a JSON object. JsonObjectAttribute can also be added to the type to force it to deserialize from a JSON object.
Path 'op', line 2, position 9.
at Vintagestory.Common.Asset.ToObject[T](JsonSerializerSettings settings) in VintagestoryLib\Common\Model\Asset.cs:line 69
at Vintagestory.ServerMods.NoObf.ModJsonPatchLoader.ApplyPatches(String forPartialPath) in VSEssentials\Loading\JsonPatchLoader.cs:line 229

Can be fixed by editing the disable-vanilla-salmon-pink.json as the error message suggests.

💬 Reverhaus , Aug 4th at 2:58 AM

B0YAR Damn! It could be cool! Now I know a lot more about patch moar entities! I try it with those mods soon 🤠👌

💬 B0YAR, Aug 4th at 2:21 AM (modified Aug 4th at 7:37 PM)

Cool mod! 
Please add support for this mods
1. NA Catfish
2. NA Darters
3. NA Salamanders
4. FOTW Reqiuem Sharks
5. Something in the Water

 

Thank you!

💬 Reverhaus , Jul 30th at 4:16 PM

ManChrzan I really like that idea! Especially with the new version 1.21.0-rc.2 which greatly improves fish and the randomized fish drops! But I'm not sure I know how to get the necessary resources to "extrapolate" that basket trap functionality and turn it into a feature to drop a fish corpse. If anyone knows how to do it, I'm completely open to it.

💬 ManChrzan, Jul 30th at 8:37 AM (modified Jul 30th at 8:42 AM)

I really love this mod, fish sinking into the bottom of the waters was so annoyng that I couldn't bother killing them unless I was starving.
I have a suggestion though, could you make it so you can place the fish from your inventory onto the ground and then be able to harvest it like normal as an alternative to the crafting grid?

PS. I haven't tried modding VS yet, but I did other games. If I was to do it I'd look into the basket traps as a reference, since they can spawn dead animals. Hope, this helps. :D

💬 AgentOfChaos, Jul 30th at 5:05 AM

aw. ok thanks

 

💬 Reverhaus , Jul 29th at 3:21 AM

AgentOfChaos Wilderlands Ethology does this function already

💬 AgentOfChaos, Jul 29th at 2:48 AM

wilderlands euthology patch?

 

💬 Reverhaus , Jul 29th at 1:28 AM

Tasshroom33 From what I understand, Claude Opus has very limited free tokens (for everything I need to contextualize about VS modding and corrections...)

💬 Tasshroom33, Jul 29th at 12:55 AM

If your going to vibe code Claude 4 Opus is pretty good.

💬 Reverhaus , Jul 29th at 12:51 AM

Narg Thanks for the suggestion! I have been arguing with ChatGPT for a while to help me make a patch and now the mod is compatible with BREEDABLEFISH 🤠

💬 Narg, Jul 25th at 5:53 PM

Reverhaus

I know you said you dont know how to patch in fish mobs, but any chance of taking a look at Breedable Fish?

💬 Yskar, Mar 6th at 10:39 AM

Gizo
i meant this: ModsUpdate

💬 RangeCreed, Mar 2nd at 6:16 AM

@Gizo VS Launcher can tell you if your mods are out dated etc and other featuresl like multiple game version and installs.

💬 Gizo, Feb 26th at 1:20 AM

automatic mod updater?!?!

💬 Reverhaus , Feb 23rd at 10:44 PM

Yskar - I take note of this, I had no idea! ^^U

💬 Yskar, Feb 23rd at 2:30 PM

In the next version could you add the mod version in the filename? It would make better to use the automatic mod updater.

💬 Wumbologist, Feb 22nd at 6:11 PM

👍 good mod

💬 Reverhaus , Feb 22nd at 12:24 PM

thanks! I think the vanilla fishing system is annoying and unrealistic, which makes nobody want to fish anymore once they have some food. BavarianViking

💬 BavarianViking, Feb 20th at 12:21 PM

yes, more realism. thx

 (edit comment delete)
Основной веб-сайт | Почтовый сервер | FTP сервер | Административная панель | API интерфейс | Content Delivery Network | Статические файлы | Ресурсы сайта | Изображения | Файловое хранилище | Блог | Интернет-магазин | Техническая поддержка | Справочная система | Документация | Форум | Новости | Загрузки | Демонстрация | Тестовая среда | Приложение | Медиа контент | Разработка | Промежуточная среда | Бета версия | Безопасная зона | Вход в систему | Панель управления | Портал | Система управления контентом