Fish Species Breeding

Fish Species Breeding

Turn regular aquariums into a renewable source of specific fish species.

When an aquarium contains at least **two fish of the exact same species**, this mod can automatically add one new fish of that same species during its scheduled breeding cycle. Breeding continues during later cycles until the aquarium inventory can no longer accept another fish.

This is especially useful for saves where Sims need a steady supply of particular fish for collections, cooking, bait, potions or other gameplay—but still have to obtain the first breeding pair themselves.

## Choose one breeding schedule

The project includes two separate versions:

- **Daily** — runs once every Sim day at approximately **4:00 AM**.
- **Every 3 Days** — runs once every third Sim day at approximately **4:00 AM**.

Install **only one version at a time**. Do not keep both script files in your Mods folder.

If the lot has not finished loading at 4:00 AM, the mod does not discard the breeding cycle. It retries every five Sim minutes until a usable aquarium becomes available.

## Features

- Produces offspring only from **two or more fish of the same species**.
- Creates a new fish using the exact object definition of its parent species.
- Adds one offspring per qualifying aquarium during each scheduled cycle.
- Continues breeding during future cycles until the aquarium is full.
- Supports fish stored in stacks and counts the complete stack quantity.
- Supports multiple aquariums on the currently loaded lot.
- If one aquarium contains breeding pairs of several species, one eligible species is selected per cycle and the selection rotates over time.
- Does not affect fish bowls.

## Important gameplay notes

- Breeding affects regular aquariums on the **currently loaded lot**.
- Fish bowls are intentionally excluded.
- Each aquarium can produce a maximum of one offspring per scheduled cycle.
- The game’s aquarium inventory determines when the tank is full.

## Installation

1. Remove every older version of Fish Species Breeding.
2. Choose either the **Daily** or **Every 3 Days** download.
3. Extract the included folder into:

   `Documents > Electronic Arts > The Sims 4 > Mods`

4. Keep the script no more than one folder deep inside `Mods`.
5. Enable **Custom Content and Mods** and **Script Mods Allowed** in the game options.
6. Delete `localthumbcache.package` before starting the game after installation or replacement.

Fish Species Breeding

Zmień zwykłe akwaria w odnawialne źródło konkretnych gatunków ryb.

Jeśli w akwarium znajdują się co najmniej **dwie ryby dokładnie tego samego gatunku**, mod podczas zaplanowanego cyklu automatycznie doda jedną nową rybę tego gatunku. Rozmnażanie będzie powtarzane w kolejnych cyklach, dopóki inventory akwarium może przyjmować następne ryby.

To szczególnie przydatne w rozgrywkach, w których Simowie potrzebują stałego zapasu konkretnych ryb do kolekcji, gotowania, używania jako przynęty, przygotowywania eliksirów lub innych celów — ale pierwszą parę hodowlaną nadal muszą zdobyć samodzielnie.

## Wybierz jeden harmonogram rozmnażania

Projekt zawiera dwie oddzielne wersje:

- **Daily** — uruchamia cykl raz na każdy simowy dzień, około **4:00 rano**.
- **Every 3 Days** — uruchamia cykl raz na każde trzy simowe dni, około **4:00 rano**.

Zainstaluj **tylko jedną wersję naraz**. Nie zostawiaj obu plików skryptowych w folderze Mods.

Jeśli o 4:00 parcela nie zdążyła się jeszcze w pełni załadować, mod nie pomija całego cyklu. Ponawia sprawdzenie co pięć simowych minut, dopóki prawidłowo załadowane akwarium nie stanie się dostępne.

## Funkcje

- Potomstwo może powstać wyłącznie z **dwóch lub większej liczby ryb identycznego gatunku**.
- Nowa ryba korzysta dokładnie z tej samej definicji obiektu co gatunek rodziców.
- Każde kwalifikujące się akwarium otrzymuje jedną nową rybę podczas zaplanowanego cyklu.
- Rozmnażanie powtarza się w kolejnych cyklach aż do zapełnienia akwarium.
- Mod poprawnie zlicza również ryby znajdujące się w stosach.
- Obsługuje wiele akwariów na aktualnie wczytanej parceli.
- Jeśli w jednym akwarium znajdują się pary kilku gatunków, podczas cyklu wybierany jest jeden z nich, a wybór zmienia się w kolejnych cyklach.
- Nie obejmuje fishbowli.
- Zawiera opcjonalne komendy diagnostyczne.

## Ważne informacje o działaniu

- Rozmnażanie obejmuje zwykłe akwaria znajdujące się na **aktualnie wczytanej parceli**.
- Fishbowle są celowo pomijane.
- Jedno akwarium może stworzyć maksymalnie jedną rybę podczas danego cyklu.
- To inventory gry decyduje, kiedy akwarium jest pełne.

## Instalacja

1. Usuń wszystkie starsze wersje Fish Species Breeding.
2. Wybierz plik **Daily** albo **Every 3 Days**.
3. Wypakuj zawarty w archiwum folder do:

   `Dokumenty > Electronic Arts > The Sims 4 > Mods`

4. Plik skryptowy może znajdować się najwyżej jeden folder poniżej `Mods`.
5. W opcjach gry włącz **Modyfikacje i zawartość zmodyfikowana** oraz **Modyfikacje ze skryptami**.
6. Po instalacji lub wymianie wersji usuń `localthumbcache.package` przed uruchomieniem gry.