Fish & Catching

The fish module is the base everything else builds on: it decides whether a catch is a custom fish, which tier it is, and which fish of that tier the player gets. Config: modules/fish/config.yml. The fish themselves live in modules/fish/fish.yml, see Fish & Bait Files.

How a catch is rolled

  1. The tier is rolled from catch-chance. Whatever the tiers don't cover is a plain vanilla catch.
  2. Skills, augments, bait, boosters, totems and events can raise tier chances before the roll.
  3. A fish of that tier is picked at random from the ones this player can catch here: right biome, weather, time, height, world, region, season, permission and bait.
  4. The player gets the fish item, fishing XP, entropy, and progress towards deliveries, tournaments and the codex.
yaml
# Chance, in percent, that a catch is a custom fish of this tier. Whatever is
# left over (19% with these values) is a plain vanilla catch.
catch-chance:
  bronze: 60
  silver: 15
  gold: 5
  diamond: 1
  platinum: 0.2
  mythical: 0.04

Prices

yaml
prices:
  raw-fish: 50.0      # vanilla cod, salmon, pufferfish and tropical fish
  bronze: 100.0
  silver: 550.0
  gold: 1500.0
  diamond: 5000.0
  platinum: 10000.0
  mythical: 25000.0

A single fish can override its tier's price with SellPriceOverride in fish.yml. Prices are paid out by the shop.

Options

Key Default What it does
broadcast.<tier> platinum, mythical on Tell the whole server when someone lands this tier
disabled-worlds [example_world] Worlds where no custom fish are caught
custom-lure-timing true Bite timing set per Lure level by the plugin, so Lure IV and up keep getting faster. Some skills and augments need it
allow-auto-fishers false AFK fish farms (bobber held by a fence, pressure plate or tripwire) are blocked unless true
off-hand-fishing true Fishing with the rod in the off hand
force-inventory false Put fish straight into the inventory (still dropped when it's full)
replace-vanilla-catch false A custom catch replaces the vanilla fish instead of coming with it
disable-treasure false Vanilla treasure and junk become plain cod
raw-fish-tag false Tag vanilla fish caught with a rod; the shop then only buys tagged raw fish
bronze-only false Every custom catch is Bronze, for testing
disable-all-fishing false Emergency switch: nothing can be caught at all
creative.blocked false Stop fishing in creative mode (bypass: busyfishing.admin)
catch-permission.enabled false Require catch-permission.node (busyfishing.fish) to catch custom fish

Testing catch chances

/fish simulate [catches] rolls that many catches where you stand, with everything that applies to you (rod, bait, skills, totem), and prints how many of each tier came up. The catches are real, so the fish, XP and entropy are given.

Fish from killing fish

With the mobs module, killing a cod, salmon, pufferfish or tropical fish can drop a Bronze custom fish.