🎣 Koishi 回合制钓鱼大师 (turnbase-fishing-game)

一款为 Koishi 打造的深度回合制钓鱼 RPG 插件。拥有超过 600 种可收集生物、动态世界事件、完整的技能树与等级系统、波动的市场经济以及策略性的装备管理。这不仅是钓鱼，更是一场冒险。

核心特色

• ⚔️ 互动式钓鱼战斗: 与鱼儿展开一场体力与策略的较量！通过【坚持】、【放线】、【收线】等操作，在消耗鱼的斗志和控制鱼线张力之间找到平衡，最终将其捕获。

• 📖 超过 600 种可收集物: 内置超过 600 种设计各异的生物和物品，从普通的"鲫鱼"到神话中的"东方青龙"，每一次上钩都充满惊喜。

• 🗺️ 广阔的探索地图: 包含【柳溪河】、【镜之湖】、【黄金海岸】、【风暴深海】、【无光之渊】以及神秘的【传说之泉】等多个钓场。每个地图都有其独特的鱼类分布，高级地图需要购买【准钓证】才能进入。

• 🌪️ 动态世界事件: 天气、节日、生物迁徙等随机事件会实时影响钓鱼难度、稀有度乃至市场价格，让每次出航都充满变数。

• 🧠 深度 RPG 成长: 独特的等级和技能树系统！通过升级获得技能点，自由构筑"战斗技巧"、"幸运"、"洞察力"和"装备保养"等不同流派的钓鱼大师。

• 📈 动态经济系统: 真正的玩家驱动市场！鱼类的价格会根据全服玩家的捕获量动态波动，抓住商机，低买高卖，成为渔业大亨。

• 🛠️ 策略性装备管理: 鱼竿不仅有等级之分，更有耐久度设定！挑战超出负荷的巨物可能导致装备损坏甚至永久报废，修理和选择合适的装备是成功的关键。

• 🏆 成就与社交: 解锁数十种称号，从【钓鱼菜鸟】到【神话创造者】，并通过排行榜与好友一较高下，争夺服务器的最高荣誉。

指令一览

核心指令

• 钓鱼 / fish: 开始一场钓鱼，进入回合制战斗。
• 钓鱼.签到: 每日签到以获取金币奖励。
• 钓鱼.天气 / 钓鱼.季节: 查看当前天气和季节加成。
• 钓鱼.切换地图 [地图名]: 查看或切换钓鱼地点。
• 钓鱼.传说之泉: 查询传说之泉每日开放时间。

信息查询

• 钓鱼.状态: 查看你的个人统计、等级、体力、装备信息。
• 钓鱼.背包: 查看你的鱼、鱼竿、药水、道具等物品。
• 钓鱼.图鉴 [页码]: 分页查看你已解锁的鱼类。
• 钓鱼.称号 [称号名]: 查看称号列表或佩戴指定称号。
• 钓鱼.排行榜 [类型]: 查看各类排行榜（巨物/富豪/累计/传奇/等级/虔诚/大赛）。
• 钓鱼.百科 [分类]: 查看战斗/经济/妈祖/鱼竿/技能等机制说明。

任务与成就

• 钓鱼.任务 [序号]: 查看今日任务或领取指定任务奖励。
• 钓鱼.成就 [页码]: 查看成就列表和解锁进度。

商店装备

• 钓鱼.商店 [分类]: 打开商店（1鱼饵/2药水/3道具/4鱼竿/5鱼线/6准钓证/7组合包/8行情）。
• 钓鱼.购买 <商品名> [数量]: 购买指定商品。
• 钓鱼.装备 <类型> <名称>: 装备鱼竿/鱼线/鱼饵。
• 钓鱼.出售 [-r稀有度/-b低于重量/-o高于重量/-a全部]: 出售鱼。
• 钓鱼.修理 <鱼竿名>: 修理损坏的鱼竿。
• 钓鱼.修理.重铸 <鱼竿名>: 重铸鱼竿（需要海洋之泪）。
• 钓鱼.使用 <物品名>: 使用药水/道具/凭证。
• 钓鱼.丢弃 <物品名> [数量]: 丢弃物品。

成长系统

• 钓鱼.技能 [技能名] / 钓鱼.技能树: 查看技能树或直接学习技能。
• 钓鱼.神器 [神器名]: 查看神器等级和属性。
• 钓鱼.妈祖: 神龛供奉与祈愿（提升运气）。
• 钓鱼.设置: 设置昵称/自动喝药/自动续费鱼线。

料理系统

• 钓鱼.料理: 查看配方和已制作料理。
• 钓鱼.烹饪 <配方名>: 用鱼制作 Buff 料理。
• 钓鱼.食用 <料理名>: 享用料理获得 Buff。

玩家交易

• 钓鱼.转账 @用户 <金额>: 向其他玩家转账（5%手续费）。
• 钓鱼.寄卖行: 查看全服交易市场。
• 钓鱼.寄卖行.挂单 <鱼名> <数量> <单价>: 挂单出售。
• 钓鱼.寄卖行.搜索/购买/撤单/我的挂单: 交易操作。

AI 助手（需配置 aiConfig.enabled）

• 钓鱼.助手 [问题]: 咨询钓鱼建议或询问鱼类知识。

帮助

• 钓鱼.帮助 / fishing-help: 显示本插件的详细帮助信息。

配置项

| 配置项 | 类型 | 默认值 | 说明 | | :--- | :--- | :--- | :--- | | cooldown | number | 30000 | 玩家每次钓鱼后的冷却时间（毫秒）。 | | normalBaitPrice | number | 5 | 商店中单个普通鱼饵的购买价格。 | | advancedBaitPrice | number | 100 | 商店中单个高级鱼饵的购买价格。 | | baitCost | number | 1 | 每次钓鱼消耗的普通鱼饵数量。 | | advancedBaitCost | number | 1 | 每次钓鱼消耗的高级鱼饵数量。 | | signInBonus | number | 200 | 玩家每日签到时获得的金币数量。 | | fishingStaminaCost | number | 10 | 每次抛出鱼竿开始钓鱼时，基础消耗的体力值。 | | defaultMaxStamina | number | 100 | 新玩家或重置时，初始的最大体力值。 | | staminaPerLevel | number | 5 | 玩家每提升一个等级，最大体力值增加的点数。 | | staminaOverflowMultiplier | number | 2.0 | 使用体力药水时，允许体力溢出基础最大体力的倍数。 | | rodMaxDurability | number | 100 | 所有普通鱼竿的初始和修理后的最大耐久度。 | | rodDurabilityPenaltyThreshold | number | 0.3 | 鱼竿耐久度低于此比例时，性能将开始下降。 | | rodOverloadDamageThreshold | number | 1.0 | 鱼竿承重超过此阈值倍数时，鱼竿开始承受过载损伤。 | | rodRepairCostMultiplier | number | 0.15 | 计算鱼竿修理费用时的基础费率。 | | quickFish | object | {...} | 控制快速钓鱼功能的行为。 | | dmMode | boolean | false | 钓鱼战斗是否在私聊中进行。 | | junkChance | number | 0.05 | 每次抛竿钓到垃圾的基础概率。 | | staminaCostsPerAction | object | {...} | 配置【坚持】、【放线】、【收线】的体力消耗。 | | advancedBaitEffects | object | {...} | 配置高级鱼饵的重量加成、难度降低等效果。 | | eventUpdateInterval | number | 1 | 全局事件系统每隔多少小时更新一次。 | | specialEncounter | object | {...} | 控制特殊生物的出现概率及其 Pity 保底机制。 | | reforgeSystem | object | {...} | 配置鱼竿"重铸"操作的条件和花费。 | | combatMechanics | object | {...} | 调整钓鱼战斗核心平衡性的数值。 | | mapData | array | [...] | 所有可用的钓鱼地图及其配置。 | | rodData | array | [...] | 所有可购买的鱼竿及其属性。 | | rarityConfig | object | {...} | 鱼类稀有度的全局配置。 | | potionPrices | array | [...] | 商店中可购买的体力药水列表。 | | titles | array | [...] | 所有可获得的称号及其解锁条件。 | | weatherCity | string | "" | 天气查询城市名，留空则自动检测 IP 位置。 | | aiConfig | object | {...} | 本地 LLM (Ollama) 智能助手配置。 |

钓鱼战斗机制

钓鱼战斗采用回合制：

1. 【坚持】: 消耗鱼的斗志，积累连击数（每连击+6%收线成功率，上限+50%）。
2. 【放线】: 降低鱼线张力，防止断线，但鱼会恢复斗志，同时清零连击。
3. 【收线】: 尝试捕获，成功率 = (1-斗志)×(1-张力)+连击加成。
4. 【剪线】: 主动放弃，保护鱼竿免受损坏。

最佳策略: 先【坚持】积累 5+ 连击 → 再【收线】，成功率大幅提升！

力竭捕获: 鱼斗志≤3%时，继续【坚持】会自动触发力竭捕获，无需收线。

示例

> 钓鱼

你在【柳溪河】熟练地抛出了【新手竹竿】,并使用了【普通鱼饵】...
...
鱼线突然绷紧,水面下传来一股巨大的力量!

--- 🎣 钓鱼回合 1/20 ---
鱼竿上传来一股强烈的拉扯感!手感约莫 5.2kg!
鱼竿【新手竹竿】(耐久: 100/100, 承重: 5kg)

🟢鱼线状态良好。 (鱼线张力: 18%)
💪你体力充沛。 (体力: 90/100)
💢鱼还在疯狂挣扎! (鱼的斗志: 85%)

请选择你的操作:
1. 【坚持 (消耗 9 体力): 全力对抗,消耗鱼的斗志。】
2. 【放线 (消耗 3 体力): 缓解张力,鱼的斗志可能恢复。】
3. 【收线 (消耗 13 体力): 尝试捕获,风险较高。】
4. 【剪线 (消耗 0 体力): 放弃本次捕获。】

> 1

你紧握鱼竿,全力对抗!鱼的挣扎略有减弱,但鱼线更紧了。

--- 🎣 钓鱼回合 2/20 ---
... (经过数回合的搏斗) ...
鱼的斗志被你完全消耗,已经无力反抗!成功捕获!

🎉 恭喜!你成功钓到了【巨型乌鳢】!
✨ 巨型乌鳢 (稀有) ✨
📏 重量: 6.80 kg
💰 估价: 163 金币
🌟 获得经验: 45 XP
📝 体型巨大的乌鳢,攻击性极强,是淡水中的霸主。

更新记录

v3.0.1 (2026-04-20)

• 修复版本号与文档同步问题
• 优化 README 文档结构，与实际代码指令保持一致

v3.0.0

• 回合制钓鱼战斗系统
• 600+ 种鱼类和物品
• 技能树与等级系统
• 动态市场经济
• 装备耐久度管理
• 成就与排行榜系统

问题及 Bug 提交

请在 GitHub Issues 中提交问题，或联系插件作者。

许可证: MIT