English Description

Tropical Fish Collection

Track and collect every single tropical fish variant in the game!
Minecraft has 3072 possible tropical fish patterns — now you can document them all. Catch fish with a bucket, browse your collection in a sleek grid, and never lose track of your progress.

✨ How It Works

1. Press K (configurable in Controls → Tropical Fish Collection) to open the collection screen.
2. Catch a tropical fish with a water bucket — the variant is automatically recorded.
3. A toast notification appears, showing the fish's pattern and colours.
4. Browse, sort, search, and export your growing collection.

🖥️ Collection Screen Features

Feature	Description
3072-variant grid	Every possible tropical fish displayed as a coloured cell with bucket icon
Sorting	Sort by body colour or by pattern type
Filtering	Show only collected / all variants
Search bar	Quickly find patterns or colours (e.g. "red", "stripey")
Detailed tooltips	Hover to see pattern name, body colour, and pattern colour
Progress counter	e.g. "Found: 42 / 3072"
Visual editor	Drag & drop the grid, stats panel, and buttons; resize icons
Free camera	Pan and zoom the entire view with mouse
One‑click export	Save your collection to config/tropicalfishcollection/exported_fish.txt

⚙️ Per‑World & Multi‑IP Support

Your collection is saved separately for each singleplayer world and for each server.

If a server has multiple IP addresses (e.g. lobby and game proxies), you can merge them into one collection by editing the context_mapping.json file:
config/tropicalfishcollection/context_mapping.json

Example:

{
  "server_mc.hypixel.net": "server_hypixel",
  "server_lobby.hypixel.net": "server_hypixel"
}

🎨 Customisation (ModMenu + YACL)

All settings are stored in config/tropicalfishcollection/settings.json and can be changed in‑game via ModMenu:

Category Options
Grid Columns (2–32), rows (2–32), icon scale (10–40px), offsets
Colours Background (HEX + alpha), checkmark, uncollected cells
Borders Cell border width (0–5px) and colour
Text Stats text colour (HEX + alpha)
Notifications Toast duration (1–15s), achievement sound toggle
Performance Max bucket icons per page (0 = unlimited; prevents crashes)
Display Show/hide bucket icons, sort buttons, tooltip mode

🌍 Fully Client‑Side

No server installation required — works on vanilla and modded servers. Your collection stays with you wherever you play.

❤️ Credits

Developed by Dok_Si

Русское описание

Tropical Fish Collection

Следите за своей коллекцией тропических рыб и соберите их всех!
В игре существует 3072 уникальных варианта тропических рыб — теперь вы можете задокументировать каждый из них. Ловите рыбу ведром, просматривайте найденные экземпляры в удобной сетке и никогда не теряйте свой прогресс.

✨ Как это работает

1. Нажмите K (можно изменить в настройках управления → Коллекция тропических рыб), чтобы открыть экран коллекции.
2. Поймайте тропическую рыбу ведром воды — вариант автоматически запишется.
3. Появится уведомление с названием узора и цветами рыбы.
4. Просматривайте, сортируйте, ищите и экспортируйте свою коллекцию.

🖥️ Возможности экрана коллекции

Возможность	Описание
Сетка из 3072 ячеек	Все возможные варианты рыб в виде цветных ячеек с иконкой ведра
Сортировка	По цвету тела или по типу узора
Фильтрация	Показать только собранные / все варианты
Поиск	Быстрый поиск по узору или цвету (например, «красный», «полосатый»)
Подсказки	При наведении: название узора, цвет тела и цвет узора
Счётчик прогресса	Например «Найдено: 42 / 3072»
Визуальный редактор	Перетаскивание сетки, панели статистики и кнопок; изменение размера иконок
Свободная камера	Панорамирование и масштабирование мышью
Экспорт в один клик	Сохранение коллекции в config/tropicalfishcollection/exported_fish.txt

⚙️ Разделение по мирам и объединение серверов

Коллекция сохраняется отдельно для каждого одиночного мира и для каждого сервера.

Если у сервера несколько IP-адресов (например, лобби и игровые прокси), их можно объединить в одну коллекцию, отредактировав файл context_mapping.json:
config/tropicalfishcollection/context_mapping.json
Пример:

{
  "server_mc.hypixel.net": "server_hypixel",
  "server_lobby.hypixel.net": "server_hypixel"
}

🎨 Настройка (ModMenu + YACL)

Все параметры хранятся в config/tropicalfishcollection/settings.json и меняются через ModMenu:

Категория Настройки
Сетка Столбцы (2–32), строки (2–32), размер иконок (10–40px), отступы
Цвета Фон (HEX + прозрачность), галочка, несобранные ячейки
Рамки Толщина рамки (0–5px) и цвет
Текст Цвет текста статистики (HEX + прозрачность)
Уведомления Длительность тоста (1–15с), звук достижения (вкл/выкл)
Производительность Макс. иконок на странице (0 = без лимита; предотвращает вылеты)
Отображение Показ иконок вёдер, кнопок сортировки, режим подсказок

🌍 Полностью клиентский мод

Установка на сервер не требуется — работает на ванильных и модифицированных серверах. Ваша коллекция всегда с вами.

❤️ Авторы

Разработка: Dok_Si