Fish & Bait Files

The fish and the baits each live in their own file. The plugin never rewrites them, so you can replace them whole. A fish.yml or bait.yml written for PyroFishingPro works unchanged.

fish.yml

plugins/BusyFishing/modules/fish/fish.yml. Fish are listed as Fish.<Tier>.<number>. Tiers are Bronze, Silver, Gold, Diamond, Platinum and Mythical. Numbers must be unique inside a tier; bait, bosses and tournaments refer to a fish as TIER:number (for example BRONZE:4).

yaml
Fish:
  Bronze:
    '1':
      Name: '<#cd7f32>Minnow'
      Description: "Small, quick and everywhere."
      Material: COD
      AllBiomes: true
      Biomes: ''

Every fish needs Name and either Biomes or AllBiomes. Everything else is optional; the defaults are shown:

Key Default What it does
Name MiniMessage or & colour codes
Description One line, or a list of lines
Material COD Any item, or PLAYER_HEAD:<texture>
Biomes Biome names, comma separated
AllBiomes false Can be caught in every biome
Enabled true
Glowing false
CustomModelData { Use: false, Number: 0 }
TimeCycle { Enabled: false, SpawnDuringDay: false } Day or night only
WeatherCycle { Enabled: false, SpawnDuringRain: false } Rain or clear only
Y-Level { Enabled: false, Lower: -64, Upper: 320 } Height range
Region { Enabled: false, Regions: [] } WorldGuard region ids
Worlds { Enabled: false, Worlds: [] }
Season Needs RealisticSeasons or AdvancedSeasons
CatchPermission '' A permission needed to catch it
SellPriceOverride { Enabled: false, Price: 0 } Its own price instead of the tier's
isSellable true
DisableGivingFishItem false Run the commands only, give no item
ExcludedFromDelivery false Never asked for by a delivery
EatingHunger -1 Food points added when eaten
CatchCommands [] Console; %player% %fish%; prefix <chance:25> for a 25% chance
EatingCommands [] Console; %player% %fish%
SellCommands { Enabled: false, Commands: [] } Run when sold

71 fish ship by default. Run /fish reload after editing.

bait.yml

plugins/BusyFishing/modules/bait/bait.yml. A fish listed under a bait can only be caught while that bait is on the rod.

yaml
# The last lore line of a rod with bait on it. %bait% %uses%
BaitLoreFormat: '%bait% has %uses% uses left.'

Baits:
  # The id, used in /fish giveitem bait:glow_worm
  glow_worm:
    enabled: true
    item:
      name: 'Glow Worm'
      material: GLOW_BERRIES
      model_data: 0
      glowing: false
      lore:
        - 'Cave fish can not resist it.'
        - 'Good for %uses% catches.'
    # Catches before the bait is used up.
    uses: 50
    shop:
      # Sold in /fish bait.
      isShopItem: true
      # Permission needed to buy it. Empty = none.
      permission: ''
      cost: 10000
      minimumFishingLevel: 10
      # Slot in the shop menu. -1 = the next free content slot.
      slot: -1
    # The fish this bait unlocks, as TIER:number from fish.yml.
    fish:
      - 'GOLD:10'

See Bait & Boosters for how players use them.