FishPro — 玩家指南
欢迎!本指南将一步步向您展示如何使用 FishPro:
快速命令
- /fp menu — 打开主菜单(升级、商店、帮助)
- /fp help — 打开帮助菜单
- 入门
- 获得一根钓鱼竿。
- 输入 /fp menu。
- 您将看到:
- 升级:使用金币升级您的鱼竿。
- 商店:购买熟鱼并出售生鱼。
- 帮助:获取简要信息及本指南的链接。
- 赚取金币
- 像往常一样进行钓鱼。
- 在捕获物品时,您有机会获得金币(几率由服务器设定)。
- 某些服务器仅对真实鱼类(鳕鱼、鲑鱼、河豚、热带鱼)奖励金币。
- 金币增幅器(一项升级)会增加每次捕获获得金币的几率。
- 您当前的金币余额在主菜单中以金锭图标显示。
- 升级您的鱼竿
- 在主手持有您的钓鱼竿。
- 输入 /fp menu → 点击“升级”。
您可以升级的内容:
- 诱饵 I–III
- 海之眷顾 I–III
- 耐久 I–III
- 经验修补 I(需在拥有诱饵 III + 海之眷顾 III + 耐久 III 后解锁)
- 金币增幅器 I–III(增加每次捕获的额外金币几率)
购买流程:
- 在图形界面中点击某项升级。
- 如果您拥有足够的金币且满足要求,即可购买。
- 如果您的鱼竿已满级,主菜单会以红色显示“(已满级)”,并且无法打开升级菜单。
返回按钮:
- 在升级菜单中,右上角的槽位(箭头)将带您回到主菜单。
- 使用商店
打开方式:
您可以执行的操作:
- 购买熟鱼:
- 出售生鱼:
- 鳕鱼、鲑鱼、热带鱼、河豚
- 左键点击出售 1 个
- 右键点击出售背包中该种类的所有鱼
物品信息会显示:
- 价格
- 您拥有的数量
- 若出售所有该物品可获得的总金币数(仅限出售项)
- 您当前的金币余额
注意事项:
- 如果某物品在本服务器上未设置价格,则无法购买或出售。
- 如果背包已满,则在腾出空间前无法购买。
返回按钮:
- 帮助菜单
打开方式:
您将找到:
- 如何赚取金币。
- 升级步骤及金币增幅器的作用。
- 一个获取本指南网页链接的按钮。
- 一个重新打开主菜单的按钮。
- 附魔台与铁砧(重要)
取决于服务器的设置:
- 如果原版鱼竿附魔被禁用:
- 附魔台:
- 当您尝试附魔钓鱼竿时,槽位会显示名为“Enchanting Rods are disabled”的红色屏障。
- 请使用 /fp menu → 升级 进行替代操作。
- 铁砧:
- 尝试将附魔书应用到钓鱼竿上时,结果栏会显示红色屏障,您无法取走它。
- 仍然允许在铁砧上重命名鱼竿。
- 如果允许原版附魔,则附魔台和铁砧正常工作。
- 技巧与常见问题
- “我无法打开‘升级’菜单。” 请确保主手持有钓鱼竿。
- “红色显示的‘(已满级)’是什么意思?” 您的鱼竿已拥有此处所有可用升级——没有更多可购买的选项。
- “右键点击无效?” Shift+右键点击被视为右键点击;Shift+左键点击被视为左键点击。
- “商店中的某个物品按钮无反应。” 该物品很可能在本服务器上未设置价格。
- “我没买到我购买的熟鱼。” 请检查背包是否已满。
FishPro — 管理员指南
本节介绍如何为您的服务器设置和自定义 FishPro:配置、价格、功能及管理操作。
A) 安装与文件夹结构
- 停止服务器。
- 将 FishPro jar 文件放入 plugins/ 目录。
- 启动服务器一次。
首次运行创建的文件夹/文件:
plugins/FishPro/
Configurations/
config.yml
upgrade.yml
shop.yml
Players/
<playerName>/
coins.yml
profile.yml
Guide/
Configuration.md
Configuration.txt
注意:
- Players/<name>/… 会在玩家加入(或其金币首次保存)时创建。
- Guide/ 下的文件会在首次运行时自动复制;插件会自动扁平化意外嵌套的 “Guide/Guide” 或 “Guide/Giuide” 文件夹。
B) 命令与菜单
- /fp menu → 主菜单(金币、升级、商店、帮助)
- /fp help → 帮助菜单(包含仅限 OP 的 Reload 按钮,如果您是 OP 用户)
C) 配置功能 (Configurations/config.yml)
reward:
chance_percent: 20.0 # 每次符合条件的捕获获得金币的基础几率
amount: 1 # 成功时 awarded 的金币数量
only_fish_items: true # true = 仅真实鱼类物品计入;false = 任何捕获类型均计入
features:
coin_booster_enabled: true # 启用/禁用金币增幅器升级
disable_vanilla_rod_enchanting: true # true = 视觉上阻止附魔台/铁砧的鱼竿附魔
- disable_vanilla_rod_enchanting:当为 true 时,如果玩家尝试将书应用到鱼竿上,附魔台物品槽和铁砧结果栏会显示名为“Enchanting Rods are disabled”的红色屏障。在铁砧上重命名鱼竿仍然允许。
- coin_booster_enabled:当为 false 时,金币增幅器不会出现在升级菜单中,也不生效。
D) 升级价格 (Configurations/upgrade.yml)
设置每级的金币消耗:
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
规则:
- 根据设计,诱饵/海之眷顾/耐久在此服务器上最高升至 III 级。
- 经验修补仅在拥有诱饵 III + 海之眷顾 III + 耐久 III 后解锁。
- 金币增幅器每级增加 +10% 的金币几率(I–III)。
- 如果 coin_booster_enabled 为 false,则隐藏金币增幅器。
E) 商店价格 (Configurations/shop.yml)
定义买卖价格:
shop:
cooked_cod:
buy: 5
cooked_salmon:
buy: 6
cod:
sell: 2
salmon:
sell: 2
tropical_fish:
sell: 2
pufferfish:
sell: 2
行为说明:
- 熟鳕鱼/熟鲑鱼:左键或右键点击 = 购买 1 个(需要设置“buy”价格)。
- 生鳕鱼/生鲑鱼/生热带鱼/生河豚:左键点击 = 出售 1 个,右键点击 = 出售全部(需要设置“sell”价格)。
F) 重载更改
- 推荐做法:在做出更改后停止并重新启动服务器。
- 游戏内快速重载:输入
/fp help → 选择“Reload Configs”(仅 OP 可见且可用)。这将重新读取 config.yml、upgrade.yml 和 shop.yml。
G) 玩家数据
- 存储位置:plugins/FishPro/Players/<playerName>/
- coins.yml → 玩家的金币余额
- profile.yml → UUID、名称、最后上线时间
- 当玩家加入时创建或更新这些数据。
H) 自定义与用户体验说明
- 返回按钮:商店和升级菜单的右上角设有返回箭头。
- 帮助菜单特意未设置返回箭头(其内部包含一个“打开菜单”按钮)。
- 金币增幅器仅提升获得金币的概率;它不会改变 Minecraft 的战利品表。
- 如果您禁用了原版鱼竿附魔,玩家会看到一个清晰的视觉提示方块(避免聊天刷屏),该方块由屏障物品组成,上面显示“Enchanting Rods are disabled”(鱼竿附魔已禁用),并提示使用
/fp menu → Upgrade(升级)。
I) 故障排除
-
“商店/升级点击无反应”
- 确保玩家点击的是 GUI 物品(上方背包栏),而非他们自己的下方背包栏。
- 确认 shop.yml 和 upgrade.yml 中存在对应的价格。
- 更新后完全重启服务器(尽量避免使用 /reload 命令)。
- 检查控制台启动时的错误信息。
-
“玩家文件夹未出现”
-
“附魔台/铁砧未阻止鱼竿附魔”
- 检查 config.yml 中的 features.disable_vanilla_rod_enchanting: true 设置。
- 切换此设置后需重启服务器。
-
版本与平台兼容性
- FishPro 面向现代 Paper/Spigot 构建版本(推荐使用 1.20+)。
- 如果您使用的是分支版本或较旧版本,请在更改后进行全面测试。
J) 管理员快速检查清单
- 在 config.yml 中设置您期望的金币获取概率和数量。
- 在 upgrade.yml 中调整升级价格。
- 在 shop.yml 中设置商店的买入/卖出价格。
- 决定是否启用以下功能:
- 启用金币增幅器 (features.coin_booster_enabled)
- 禁用原版鱼竿附魔 (features.disable_vanilla_rod_enchanting)
- 重启服务器,然后使用新账号进行测试:
- 钓鱼时赚取金币。
- 在商店中进行买卖。
- 升级鱼竿(注意 Mending 解锁机制及已满级状态的限制)。
- 若已禁用,请确认附魔台/铁砧处的鱼竿附魔操作会显示屏障物品提示。
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
- 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.
- 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.
- 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.
- Using the Shop
Open:
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.
- 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.
- 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.
- 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
- Stop the server.
- Put the FishPro jar in plugins/.
- 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/<name>/… 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/<playerName>/
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧