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
- The tier is rolled from
catch-chance. Whatever the tiers don't cover is a plain vanilla catch. - Skills, augments, bait, boosters, totems and events can raise tier chances before the roll.
- 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.
- 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.