FishPro

插件

· 作者 OlliBix

FishPro 通过金币、升级和商店来奖励钓鱼行为;提供直观的菜单,可选择禁用原版鱼竿附魔,并支持快速设置与重载。

0 本站下载 0 关注 更新于 1 年前

最新 25.1 · 1.21.10 · Bukkit / Paper

一键开服(送7天)

FishPro — 玩家指南

欢迎!本指南将一步步向您展示如何使用 FishPro:

快速命令

  • /fp menu — 打开主菜单(升级、商店、帮助)
  • /fp help — 打开帮助菜单
  1. 入门
  • 获得一根钓鱼竿。
  • 输入 /fp menu。
  • 您将看到:
    • 升级:使用金币升级您的鱼竿。
    • 商店:购买熟鱼并出售生鱼。
    • 帮助:获取简要信息及本指南的链接。
  1. 赚取金币
  • 像往常一样进行钓鱼。
  • 在捕获物品时,您有机会获得金币(几率由服务器设定)。
  • 某些服务器仅对真实鱼类(鳕鱼、鲑鱼、河豚、热带鱼)奖励金币。
  • 金币增幅器(一项升级)会增加每次捕获获得金币的几率。
  • 您当前的金币余额在主菜单中以金锭图标显示。
  1. 升级您的鱼竿
  • 在主手持有您的钓鱼竿。
  • 输入 /fp menu → 点击“升级”。

您可以升级的内容:

  • 诱饵 I–III
  • 海之眷顾 I–III
  • 耐久 I–III
  • 经验修补 I(需在拥有诱饵 III + 海之眷顾 III + 耐久 III 后解锁)
  • 金币增幅器 I–III(增加每次捕获的额外金币几率)

购买流程:

  • 在图形界面中点击某项升级。
  • 如果您拥有足够的金币且满足要求,即可购买。
  • 如果您的鱼竿已满级,主菜单会以红色显示“(已满级)”,并且无法打开升级菜单。

返回按钮:

  • 在升级菜单中,右上角的槽位(箭头)将带您回到主菜单。
  1. 使用商店 打开方式:
  • /fp menu → 商店

您可以执行的操作:

  • 购买熟鱼:
    • 熟鳕鱼、熟鲑鱼
    • 左键或右键点击可购买 1 个
  • 出售生鱼:
    • 鳕鱼、鲑鱼、热带鱼、河豚
    • 左键点击出售 1 个
    • 右键点击出售背包中该种类的所有鱼

物品信息会显示:

  • 价格
  • 您拥有的数量
  • 若出售所有该物品可获得的总金币数(仅限出售项)
  • 您当前的金币余额

注意事项:

  • 如果某物品在本服务器上未设置价格,则无法购买或出售。
  • 如果背包已满,则在腾出空间前无法购买。

返回按钮:

  • 在商店中,右上角的槽位(箭头)将带您回到主菜单。
  1. 帮助菜单 打开方式:
  • /fp help,或 /fp menu → 帮助

您将找到:

  • 如何赚取金币。
  • 升级步骤及金币增幅器的作用。
  • 一个获取本指南网页链接的按钮。
  • 一个重新打开主菜单的按钮。
  1. 附魔台与铁砧(重要) 取决于服务器的设置:
  • 如果原版鱼竿附魔被禁用:
    • 附魔台:
      • 当您尝试附魔钓鱼竿时,槽位会显示名为“Enchanting Rods are disabled”的红色屏障。
      • 请使用 /fp menu → 升级 进行替代操作。
    • 铁砧:
      • 尝试将附魔书应用到钓鱼竿上时,结果栏会显示红色屏障,您无法取走它。
      • 仍然允许在铁砧上重命名鱼竿。
  • 如果允许原版附魔,则附魔台和铁砧正常工作。
  1. 技巧与常见问题
  • “我无法打开‘升级’菜单。” 请确保主手持有钓鱼竿。
  • “红色显示的‘(已满级)’是什么意思?” 您的鱼竿已拥有此处所有可用升级——没有更多可购买的选项。
  • “右键点击无效?” Shift+右键点击被视为右键点击;Shift+左键点击被视为左键点击。
  • “商店中的某个物品按钮无反应。” 该物品很可能在本服务器上未设置价格。
  • “我没买到我购买的熟鱼。” 请检查背包是否已满。

FishPro — 管理员指南

本节介绍如何为您的服务器设置和自定义 FishPro:配置、价格、功能及管理操作。

A) 安装与文件夹结构

  1. 停止服务器。
  2. 将 FishPro jar 文件放入 plugins/ 目录。
  3. 启动服务器一次。

首次运行创建的文件夹/文件:

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 解锁机制及已满级状态的限制)。
    • 若已禁用,请确认附魔台/铁砧处的鱼竿附魔操作会显示屏障物品提示。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源