FishPro — Player Guide

Welcome! This guide shows you, step by step, how to use FishPro:

Quick commands

• /fp menu — opens the main menu (Upgrade, Shop, Help)
• /fp help — opens the Help menu

1. Getting started

• Get a fishing rod.
• Type /fp menu.
• You’ll see:
  • Upgrade: upgrade your rod using coins.
  • Shop: buy cooked fish and sell raw fish.
  • Help: quick info and a link to this guide.

1. Earning coins

• Go fishing as normal.
• On catches, you have a chance to earn coins (the server sets the chance).
• Some servers only reward coins for real fish (Cod, Salmon, Pufferfish, Tropical Fish).
• Coin Booster (an upgrade) increases your chance to receive coins per catch.
• Your current coin balance is shown in menus as a gold ingot.

1. Upgrading your rod

• Hold your fishing rod in your main hand.
• Type /fp menu → click Upgrade.

What you can upgrade:

• Lure I–III
• Luck of the Sea I–III
• Unbreaking I–III
• Mending I (unlocks after Lure III + Luck III + Unbreaking III)
• Coin Booster I–III (+ extra coin chance per catch)

How buying works:

• Click an upgrade in the GUI.
• If you have enough coins and meet requirements, it’s purchased.
• If your rod is fully maxed, the main menu shows (Maxed) in red and the Upgrade menu won’t open.

Back button:

• In the Upgrade menu, the top-right slot (arrow) returns you to the main menu.

1. Using the Shop Open:

• /fp menu → Shop

What you can do:

• Buy cooked fish:
  • Cooked Cod, Cooked Salmon
  • Left-click or Right-click buys 1
• Sell raw fish:
  • Cod, Salmon, Tropical Fish, Pufferfish
  • Left-click sells 1
  • Right-click sells all of that fish in your inventory

Item info shows:

• Price
• How many you have
• Total coins if you sell all (for sell items)
• Your current coin balance

Notes:

• If an item has no price on this server, you won’t be able to buy/sell it.
• If your inventory is full you can’t buy until you free space.

Back button:

• In the Shop, the top-right slot (arrow) returns you to the main menu.

1. Help menu Open:

• /fp help, or /fp menu → Help

You’ll find:

• How coins are earned.
• Upgrade steps and what Coin Booster does.
• A button to get a web link for this guide.
• A button to reopen the main menu.

1. Enchanting table and anvil (important) Depending on this server’s settings:

• If vanilla rod enchanting is disabled:
  • Enchanting table:
    • When you try to enchant a fishing rod, the slot shows a red barrier named “Enchanting Rods are disabled.”
    • Use /fp menu → Upgrade instead.
  • Anvil:
    • Trying to apply an enchanted book to a fishing rod shows a red barrier as the result and you can’t take it.
    • Renaming your rod is still allowed.
• If vanilla enchanting is allowed, the table/anvil work as normal.

1. Tips and common questions

• “I can’t open Upgrade.” Hold a fishing rod in your main hand.
• “(Maxed) in red?” Your rod has every upgrade available here — nothing left to buy.
• “Right-click doesn’t work?” Shift-right-click counts as right-click; shift-left-click counts as left-click.
• “Shop button does nothing on an item.” That item likely has no price on this server.
• “I didn’t get the cooked fish I bought.” Check if your inventory is full.

---

FishPro — Admin Guide

This section explains how to set up and customize FishPro for your server: configuration, prices, features, and admin actions.

A) Installation and folders

1. Stop the server.
2. Put the FishPro jar in plugins/.
3. Start the server once.

Created folders/files (first run):

plugins/FishPro/
  Configurations/
    config.yml
    upgrade.yml
    shop.yml
  Players/
    <playerName>/
      coins.yml
      profile.yml
  Guide/
    Configuration.md
    Configuration.txt

Notes:

• Players//… is created when a player joins (or first time their coins are saved).
• The Guide/ files are auto-copied on first run; the plugin flattens accidental nested “Guide/Guide” or “Guide/Giuide” folders automatically.

B) Commands and menus

• /fp menu → Main menu (Coins, Upgrade, Shop, Help)
• /fp help → Help menu (includes OP-only Reload button, if you’re OP)

C) Configuring features (Configurations/config.yml)

reward:
  chance_percent: 20.0   # Base chance per eligible catch to earn coins
  amount: 1              # Coins awarded on success
  only_fish_items: true  # true = only real fish items count; false = any catch type

features:
  coin_booster_enabled: true          # Enable/disable the Coin Booster upgrade
  disable_vanilla_rod_enchanting: true # true = block table/anvil rod-enchanting visually

• disable_vanilla_rod_enchanting: when true, players see a red barrier named “Enchanting Rods are disabled” in the enchanting table item slot and as the anvil result if they try to apply books to rods. Renaming rods in anvil remains allowed.
• coin_booster_enabled: when false, Coin Booster won’t appear in the Upgrade menu and doesn’t apply.

D) Upgrade prices (Configurations/upgrade.yml) Set coin costs per level:

upgrades:
  lure:
    1: 10
    2: 25
    3: 50
  luck_of_the_sea:
    1: 10
    2: 25
    3: 50
  unbreaking:
    1: 10
    2: 25
    3: 50
  mending:
    1: 100
  coin_booster:
    1: 50
    2: 100
    3: 150

Rules:

• Lure/Luck/Unbreaking go up to III on this server by design.
• Mending unlocks only after Lure III + Luck III + Unbreaking III.
• Coin Booster adds +10% coin chance per level (I–III).
• If coin_booster_enabled is false, Coin Booster is hidden.

E) Shop prices (Configurations/shop.yml) Define buy/sell prices:

shop:
  cooked_cod:
    buy: 5
  cooked_salmon:
    buy: 6

  cod:
    sell: 2
  salmon:
    sell: 2
  tropical_fish:
    sell: 2
  pufferfish:
    sell: 2

Behavior:

• Cooked Cod/Salmon: Left or Right-click = buy 1 (needs “buy” price).
• Raw Cod/Salmon/Tropical/Pufferfish: Left-click = sell 1, Right-click = sell all (needs “sell” price).

F) Reloading changes

• Recommended: stop/start the server after changes.
• Quick in-game reload: /fp help → “Reload Configs” (visible and usable only for OP). This re-reads config.yml, upgrade.yml, and shop.yml.

G) Player data

• Location: plugins/FishPro/Players//
  • coins.yml → player’s coin balance
  • profile.yml → uuid, name, last_seen
• Created/updated when the player joins.

H) Customization and UX notes

• Back button: Shop and Upgrade menus have a back arrow in the top-right.
• The Help menu intentionally has no back arrow (it has an “Open Menu” button inside).
• Coin Booster boosts coin-chance only; it does not change Minecraft loot tables.
• If you disable vanilla rod enchanting, players get a clear, visual block (no chat spam) with a barrier item that says “Enchanting Rods are disabled” and a hint to use /fp menu → Upgrade.

I) Troubleshooting

• “Shop/Upgrade clicks do nothing”

  • Ensure players click the GUI items (top inventory), not their own inventory below.
  • Verify prices exist in shop.yml and upgrade.yml.
  • Fully restart the server after updates (avoid /reload if possible).
  • Check console for errors on startup.

• “Players folder doesn’t appear”

  • Folders are created when players join at least once.

• “Enchanting table/anvil not blocking rod enchanting”

  • Check features.disable_vanilla_rod_enchanting: true in config.yml.
  • Restart the server after toggling.

• Version and platform

  • FishPro targets modern Paper/Spigot builds (1.20+ recommended).
  • If you’re on a fork or older version, test thoroughly after changes.

J) Quick admin checklist

• Set your desired coin-chance and amount in config.yml.
• Adjust upgrade prices in upgrade.yml.
• Set shop buy/sell prices in shop.yml.
• Decide if you want to:
  • Enable Coin Booster (features.coin_booster_enabled)
  • Disable vanilla rod enchanting (features.disable_vanilla_rod_enchanting)
• Restart the server, then test with a fresh account:
  • Earn coins while fishing.
  • Buy/sell in Shop.
  • Upgrade rod (respecting Mending unlock and maxed state).
  • If disabled, confirm table/anvil rod enchanting shows the barrier item.