Skip to content

Leaderboard

Curren Jeandell edited this page Jun 1, 2026 · 1 revision

Leaderboard

Fishtastic tracks all fish catches persistently on the server. The leaderboard screen lets you browse records across four categories.

The leaderboard screen requires GelatinUI to be installed. The catch database is always recorded even without GelatinUI; the screen just won't open without it.


What Is Tracked

Every fish you catch through the minigame records:

  • Which species it was
  • Its size in centimeters
  • Its quality tier
  • The player who caught it

This data persists across server restarts via Minecraft's SavedData system (stored in the world's data folder as fishtastic/fish_catches).


Leaderboard Views

View Description
Personal Best Size Your largest catch per species
Global Best Size The server record holder per species (one record per fish type)
Personal Catch Count How many of each species you've caught total
Global Catch Count Total catches across all species, ranked by player

You can switch between Personal and Global, and between Size and Count, directly in the leaderboard screen.


Opening the Screen

Open the leaderboard via whatever keybind or command your modpack exposes. If GelatinUI is present, the screen animates in with a slide transition and shows a settings panel (top-right) and a sorted list of records.


Admin Notes

The catch database only records items that:

  1. Are in the #fishes item tag.
  2. Have a valid size component (size > 0).

Vanilla fish (Cod, Salmon, etc.) are included if they have a size component set — but vanilla fishing does not set one, so only fish caught via the Fishtastic minigame appear in records by default.

Use /fishtastic setitemsize and /fishtastic setfishquality to manually tag items for testing, then catch them through the minigame to populate the database.

Clone this wiki locally