Fishing 钓鱼系统

付费模块

本模块为付费模块。授权由云端平台统一管理：在 cloud.021209.xyz 购买/领取授权后，于「装备模块」页面勾选到对应服务器即可，无需填写 password 或 license.yml。

Fishing 模块为服务器提供一套完整的 星露谷风格钓鱼小游戏，通过 ArcartX UI HUD 实时渲染钓鱼过程。玩家抛竿后进入钓鱼小游戏，操控绿条追逐游动的鱼，填满进度条即可捕获。支持多水域生态、鱼种季节/天气/时间分布、宝藏奖励、饵料加成和钓鱼图鉴收集。

功能概览

功能	说明
星露谷钓鱼小游戏	服务端物理引擎驱动，实时同步到客户端 HUD
多水域系统	圆形/矩形指定地点 + 默认兜底，不同水域独立鱼池/难度/宝藏
鱼种生态	季节、天气、水域类型、时间段四维过滤
宝藏系统	不同水域拥有独立宝藏池，捕获时概率获得；支持外部物品库物品
饵料加成	PDC 标签识别装载饵料，提升特定鱼种吸引率和宝藏概率，并提供鱼竿耐久加成
自定义钓竿	通过 `rods/` 配置钓竿属性，影响绿条高度、宝藏概率、经验倍率等
钓鱼图鉴	`/fishing` 打开图鉴 UI，记录捕获数量和最大尺寸
等级系统	捕获获取经验，升级提升绿条高度
售卖系统	`/fishing sell` 直接出售手中鱼，`/fishing sell all` 批量出售背包中所有鱼
跨模块联动	捕获成功自动发射 EventBus 事件与 EventPacket Signal，联动 BattlePass / Title / Mail / Market

依赖

依赖	是否必须	用途
ArcartX	✅ 必须	UI 渲染 + 数据包通信
PlaceholderAPI	✅ 必须	钓鱼统计占位符输出

命令

玩家命令

命令	权限	说明
`/fishing`	`axs.fishing.use`	打开钓鱼图鉴界面
`/fishing sell`	`axs.fishing.use`	出售主手中的钓鱼产物
`/fishing sell all`	`axs.fishing.use`	出售背包中所有钓鱼产物

管理员命令

命令	权限	说明
`/axs fishing stats [玩家]`	`axs.fishing.admin`	查看钓鱼统计
`/axs fishing givexp <玩家> <经验>`	`axs.fishing.admin`	给予钓鱼经验
`/axs fishing reset <玩家>`	`axs.fishing.admin`	重置钓鱼数据
`/axs fishing reload`	`axs.fishing.admin`	重载钓鱼模块配置

权限

权限节点	默认	说明
`axs.fishing.use`	true	使用钓鱼功能
`axs.fishing.admin`	op	管理员命令

PlaceholderAPI 占位符

占位符	说明
`%axsfishing_level%`	钓鱼等级
`%axsfishing_total_xp%`	当前经验值
`%axsfishing_xp%`	当前经验值（`total_xp` 别名）
`%axsfishing_total_caught%`	总捕获数
`%axsfishing_perfect_catches%`	完美捕获数
`%axsfishing_collection_count%`	已收集鱼种数
`%axsfishing_collection_percent%`	图鉴收集百分比
`%axsfishing_collection%`	图鉴收集进度（已收集/鱼种总数）
`%axsfishing_favorite_fish%`	捕获最多的鱼种显示名称

配置结构

ArcartXFishing.yml

yaml

config-version: 2

storage:
  mode: sqlite              # sqlite / mysql
  sqlite-file-name: fishing.db
  pool-size: 1
  mysql-host: localhost
  mysql-port: 3306
  mysql-database: axs_fishing
  mysql-username: root
  mysql-password: ""

fishing:
  replace-vanilla: true
  minigame-tick-interval: 1
  bar-gravity: 0.3
  bar-bounce-damping: 0.7
  bar-click-force: -0.6
  catch-duration-ticks: 600
  progress-drain-rate: 0.5
  progress-gain-rate: 1.0
  base-green-bar-height: 96
  height-per-level: 4
  treasure-chance: 0.15       # 宝藏触发基础概率
  perfect-bonus-multiplier: 1.5
  base-xp-per-level: 100

ui:
  register-on-enable: true
  minigame-id: "fishing_minigame"   # 钓鱼小游戏 UI ID
  collection-id: "fishing_collection" # 图鉴 UI ID

commands:
  enabled: true
  base-permission: "axs.fishing.use"  # 玩家命令基础权限

# ─── 水域定义 ────────────────────────────────────────
# waters.specified 为列表：每个元素含 name 字段作为水域 ID
waters:
  specified:
    - name: "dragon_lake"
      display-name: "&b龙泉湖"
      type: circle              # circle / rectangle
      world: "world"
      center: [100, 64, 200]    # 圆心 [x, y, z]
      radius: 50                # 半径
      fish-pool: "lake"         # 引用 fish-pools
      treasure-pool: "common"   # 引用 treasure-pools
      difficulty-modifier: 1.2  # 难度倍率
      bait-multipliers:         # 饵料在此水域加成
        worm: 1.5
        corn: 2.0
      require-permission: ""    # 可选进入权限

    - name: "jade_river"
      display-name: "&a翡翠河"
      type: rectangle
      world: "world"
      min: [500, 60, 300]       # 矩形最小角 [x, y, z]
      max: [700, 80, 400]       # 矩形最大角 [x, y, z]
      fish-pool: "river"
      treasure-pool: "common"
      difficulty-modifier: 0.9
      bait-multipliers:
        worm: 1.0
        bread: 1.3
      require-permission: ""

  default:
    name: "default"
    display-name: "&7普通水域"
    fish-pool: "default"
    treasure-pool: "default"
    difficulty-modifier: 1.0
    bait-multipliers:
      worm: 1.0
      bread: 1.0
      corn: 1.0

# ─── 鱼类池 ────────────────────────────────────────
# 引用 fishes/ 目录下的鱼种 ID
fish-pools:
  default: ["sea_bass", "salmon"]
  lake: ["sea_bass", "catfish", "legendary_carp"]
  river: ["salmon", "catfish"]
  ocean: ["tuna", "pufferfish", "sea_bass"]

# ─── 宝藏池 ────────────────────────────────────────
# 引用 treasures/ 目录下的宝藏 ID
treasure-pools:
  default: ["old_boot", "lost_ring"]
  common: ["old_boot", "lost_ring", "ancient_coin"]
  rare: ["ancient_coin", "lost_ring"]

fishes/ 鱼种文件

每鱼种一个独立 YAML 文件，存放在 fishes/ 目录下：

yaml

id: "sea_bass"
display-name: "海鲈鱼"
rarity: common              # common / uncommon / rare / legendary
min-size: 10
max-size: 50
base-price: 80
base-xp: 15
seasons: [spring, summer, fall, winter]
weathers: [clear, rain]
water-types: [ocean, river]  # ocean / river / lake

# time-ranges 为 map：根键任意，内部含 start / end
time-ranges:
  day:
    start: "06:00"
    end: "20:00"

item:
  source: "minecraft"
  item-id: "cod"
  amount: 1
  # texture: "item"                  # 可选：ArcartX 自定义贴图
  # texture-url: "fishing/sea_bass.png" # 可选：ArcartX GUI 贴图
  # json: '{"id":"minecraft:cod"}'  # 可选：完整 JSON 物品定义
  # mmo-type: "ARMOR"               # MMOItems 类型
  # mmo-id: "FISH_ARMOR"            # MMOItems ID
difficulty: 30              # 1~100，影响鱼 AI 游动速度

# behaviors 为 map：根键任意，内部含 type / weight
behaviors:
  smooth:
    type: smooth
    weight: 0.6
  dart:
    type: dart
    weight: 0.4

# 捕获后自动发放的货币奖励（可选）
currency-reward:
  currency-id: "coin"       # 货币 ID
  amount: 15                  # 基础数量（完美捕获会自动乘以 perfect-bonus-multiplier）

item 物品引用说明：

字段	必填	说明
`source`	否	物品来源：`minecraft` / `mythic` / `neige` / `overture` / `mmo` / `json`，默认 `minecraft`
`item-id`	否	外部物品 ID 或原版 Material 名称
`amount`	否	数量，默认 `1`
`mmo-type`	否	MMOItems 物品类型，仅在 `source: mmo` 时有效
`mmo-id`	否	MMOItems 物品 ID，仅在 `source: mmo` 时有效
`json`	否	完整 JSON 物品定义，优先级最高
`texture`	否	ArcartX 自定义贴图 `icon` 字段
`texture-url`	否	ArcartX GUI 贴图 `url` 字段

行为类型：smooth（平滑游动）、dart（快速冲刺）、sinker（下沉型）、floater（上浮型）

treasures/ 宝藏文件

每宝藏一个独立 YAML 文件，存放在 treasures/ 目录下：

yaml

id: "old_boot"
display-name: "旧靴子"
item:
  source: "minecraft"
  item-id: "leather_boots"
  amount: 1
chance: 0.3        # 在宝藏池中的出现概率

baits/ 饵料文件

每饵料一个独立 YAML 文件，存放在 baits/ 目录下：

yaml

id: "worm"
display-name: "蚯蚓"
item:
  source: "minecraft"
  item-id: "string"
  amount: 1
default: true               # 是否为默认饵料
fish-attract-modifiers:     # 针对特定鱼种的吸引倍率
  catfish: 2.0
  sea_bass: 1.5
treasure-chance-boost: 0.02  # 宝藏概率加成
max-durability-bonus: 0     # 鱼竿耐久消耗减免值

使用饵料

装载机制

Fishing 通过 PersistentDataContainer（PDC） 标签识别鱼竿上装载的饵料。玩家需要手持鱼竿并拥有饵料物品，通过调用 FishingService.attachBait()（通常由其他系统/命令触发）将饵料装载到鱼竿上。

装载成功后：

背包中的饵料物品会被消耗 1 个
鱼竿的 PDC 中写入 axs_fishing_bait_id 标签
后续抛竿时系统读取该标签并应用对应饵料属性

未装载饵料时，使用 baits/ 目录中第一个 default: true 的饵料作为默认饵料。

饵料属性

属性	说明
`fish-attract-modifiers`	针对特定鱼种的吸引倍率，影响选鱼权重
`treasure-chance-boost`	宝藏触发概率加成，与钓竿加成叠加
`max-durability-bonus`	鱼竿耐久消耗减免值，通过 `PlayerItemDamageEvent` 生效

自定义钓竿

rods/ 钓竿文件

每钓竿一个独立 YAML 文件，存放在 rods/ 目录下：

yaml

id: "wooden_rod"
display-name: "木制钓竿"
item:
  source: "minecraft"
  item-id: "fishing_rod"
  amount: 1
# 宝藏概率加成（加到基础概率上）
treasure-chance-bonus: 0.05
# 绿条高度加成（像素）
green-bar-height-bonus: 8
# 小游戏持续时间加成（ticks）
catch-duration-bonus: 60
# 经验倍率
exp-multiplier: 1.1
# 所需最低玩家钓鱼等级
min-player-level: 0

钓竿识别

钓竿通过 PDC 标签 axs_fishing_rod_id 识别。普通鱼竿（无标签）使用 RodDefinition.DEFAULT 默认属性。

钓竿属性效果

属性	说明
`treasure-chance-bonus`	增加宝藏触发概率
`green-bar-height-bonus`	增加小游戏绿条高度（像素）
`catch-duration-bonus`	增加小游戏最大持续时间（ticks）
`exp-multiplier`	捕获获得经验的倍率
`min-player-level`	使用该钓竿所需的最低钓鱼等级（可由外部系统校验）

快速开始教程

以下是一个从零搭建完整钓鱼系统的步骤，按顺序操作即可让钓鱼功能正常运行。

第一步：安装与激活

将 ArcartXSuite-Fishing-*.jar 放入服务器的 plugins/ArcartX-Suite/modules/ 目录
确保 ArcartX 本体已安装并正常启动
首次启动后，在 plugins/ArcartX-Suite/data/fishing/ 目录下会生成默认配置

第二步：创建鱼种（fishes/）

在 plugins/ArcartX-Suite/data/fishing/fishes/ 目录下创建鱼种文件：

yaml

# sea_bass.yml
id: "sea_bass"
display-name: "海鲈鱼"
rarity: common
min-size: 20
max-size: 60
base-price: 50
base-xp: 10
seasons: [spring, summer, fall]
weathers: [clear, rain]
water-types: [ocean, river]
time-ranges:
  day:
    start: "06:00"
    end: "22:00"
item:
  source: "minecraft"
  item-id: "cod"
difficulty: 25
behaviors:
  smooth:
    type: smooth
    weight: 0.8
  dart:
    type: dart
    weight: 0.2

currency-reward:
  currency-id: "coin"
  amount: 8

yaml

# legendary_carp.yml
id: "legendary_carp"
display-name: "传说锦鲤"
rarity: legendary
min-size: 80
max-size: 150
base-price: 5000
base-xp: 500
seasons: [spring]
weathers: [clear]
water-types: [lake]
time-ranges:
  dawn:
    start: "05:00"
    end: "07:00"
item:
  source: "minecraft"
  item-id: "tropical_fish"
difficulty: 85
behaviors:
  dart:
    type: dart
    weight: 0.5
  sinker:
    type: sinker
    weight: 0.5

稀有度说明：common（普通）→ uncommon（稀有）→ rare（罕见）→ legendary（传说）。稀有度越高，基础被选中的权重越低，但可通过饵料倍率提升。

第三步：创建宝藏（treasures/）

在 plugins/ArcartX-Suite/data/fishing/treasures/ 目录下创建：

yaml

# old_boot.yml
id: "old_boot"
display-name: "旧靴子"
item:
  source: "minecraft"
  item-id: "leather_boots"
chance: 0.5

第四步：创建饵料（baits/）

在 plugins/ArcartX-Suite/data/fishing/baits/ 目录下创建：

yaml

# worm.yml
id: "worm"
display-name: "蚯蚓"
item:
  source: "minecraft"
  item-id: "string"
default: true
fish-attract-modifiers:
  catfish: 2.0
  sea_bass: 1.5
treasure-chance-boost: 0.05
max-durability-bonus: 0

第五步：创建钓竿（rods/）（可选）

在 plugins/ArcartX-Suite/data/fishing/rods/ 目录下创建：

yaml

# wooden_rod.yml
id: "wooden_rod"
display-name: "木制钓竿"
item:
  source: "minecraft"
  item-id: "fishing_rod"
treasure-chance-bonus: 0.05
green-bar-height-bonus: 8
catch-duration-bonus: 60
exp-multiplier: 1.1
min-player-level: 0

钓竿需要通过外部系统或命令将 axs_fishing_rod_id PDC 标签写入鱼竿物品。

第六步：配置水域与池（ArcartXFishing.yml）

编辑主配置，将鱼种和宝藏绑定到水域：

yaml

waters:
  specified:
    - name: "dragon_lake"
      display-name: "&b龙泉湖"
      type: circle
      world: "world"
      center: [100, 64, 200]
      radius: 50
      fish-pool: "lake"
      treasure-pool: "common"
      difficulty-modifier: 1.2
      bait-multipliers:
        worm: 1.5

  default:
    name: "default"
    display-name: "&7普通水域"
    fish-pool: "default"
    treasure-pool: "default"
    difficulty-modifier: 1.0
    bait-multipliers:
      worm: 1.0

fish-pools:
  default: ["sea_bass"]
  lake: ["sea_bass", "legendary_carp"]

treasure-pools:
  default: ["old_boot"]
  common: ["old_boot"]

第七步：配置 Market 回收（与 Market 模块联动）

如果使用 Market 模块，在 plugins/ArcartX-Suite/data/market/recycle/ 目录下添加：

yaml

fishing_recycle:
  display-name: "&a鱼市回收"
  entries:
    sea_bass:
      source: "fishing"
      item-id: "sea_bass"
      price: 50
      currency: "coin"
    legendary_carp:
      source: "fishing"
      item-id: "legendary_carp"
      price: 5000
      currency: "coin"

第八步：装载饵料（可选）

通过支持 PDC 写入的系统或命令调用 FishingService.attachBait()，将背包中的饵料装载到鱼竿上。装载后鱼竿会写入 axs_fishing_bait_id 标签。

第九步：使用

玩家手持钓鱼竿，抛竿到指定水域或任意水面
鱼上钩后进入 HUD 小游戏，按住空格控制绿条
捕获成功后鱼物品自动进入背包
使用 /fishing sell 出售手中鱼，或 /fishing sell all 批量出售
使用 /fishing 打开图鉴查看收集进度

水域匹配规则

玩家抛竿时，按 waters.specified 列表顺序匹配
圆形水域检测玩家是否在圆心 radius 范围内
矩形水域检测玩家是否在 min ~ max 坐标范围内
未匹配任何指定地点时回退到 waters.default
匹配成功后使用该水域的 fish-pool 和 treasure-pool

小游戏玩法

玩家使用钓鱼竿抛竿（触发 PlayerFishEvent）
模块拦截事件，取消原版钓鱼，打开钓鱼 HUD
玩家按住空格或 鼠标左键 控制绿条上升
松开按键绿条受重力下落
鱼在轨道内游动，绿条覆盖鱼时进度条上涨
进度条满则捕获成功，超时或进度归零则失败
全程鱼未离开绿条可获得 完美捕获 加成

售卖系统

钓鱼产物在生成时会通过 PersistentDataContainer 标记鱼种 ID、尺寸和完美捕获状态，物品 lore 也会自动显示售价信息。

/fishing sell — 出售主手中的鱼，自动根据尺寸计算价格并发放货币
/fishing sell all — 扫描背包中所有钓鱼产物，按鱼种尺寸统一出售并发放货币

Market 回收联动

Market 模块的回收系统已兼容 Fishing 产物。在 recycle/*.yml 中配置 source: "fishing" 即可：

yaml

sea_bass:
  source: "fishing"
  item-id: "sea_bass"        # 对应 fishes/*.yml 中的 id
  price: 80
  currency: "coin"

Market 回收界面会自动识别带 PDC 标记的鱼物品，按回收表价格结算。

跨模块联动

EventBus 事件主题

Fishing 在捕获成功时自动向 EventBus 发布以下事件，其他模块可订阅：

事件主题	触发条件	Payload 字段
`axs.fishing.success`	每次捕获成功	`fish_id`, `fish_rarity`, `fish_size`, `water_area`, `bait_id`, `is_perfect`, `player_level`
`axs.fishing.perfect`	完美捕获	同上
`axs.fishing.collection_unlock`	首次捕获某鱼种	同上 + `total_collection_count`
`axs.fishing.treasure`	获得宝藏	`water_area`

EventPacket Signal

EventPacket 模块可通过以下 Signal ID 配置规则：

Signal ID	变量
`fishing_success`	`{fish_id}`, `{fish_name}`, `{fish_rarity}`, `{fish_size}`, `{water_area}`, `{is_perfect}`
`fishing_legendary_catch`	同上
`fishing_first_catch`	同上
`fishing_treasure`	同上

Title / Mail 里程碑

Fishing 内置里程碑检测，达成条件时自动调用 Title 和 Mail 模块（需已安装并启用）：

里程碑	条件	奖励
首次传说鱼	首次捕获 `rarity: legendary` 的鱼	称号 `legendary_hunter`（7天）+ 邮件 `legendary_first_catch`
学徒渔夫	累计捕获 10 条	称号 `fisher_apprentice`（永久）
大师渔夫	累计捕获 100 条	称号 `fisher_master`（永久）
传说渔夫	累计捕获 500 条	称号 `fisher_legend`（永久）
完美大师	完美捕获 50 次	称号 `perfect_master`（永久）

进阶联动配置示例

EventPacket 联动（发送奖励）

在 data/eventpacket/rules/ 下创建规则，当玩家钓起传说鱼时给予额外奖励：

yaml

legendary_catch_reward:
  enabled: true
  trigger: command-signal
  signal: "fishing_legendary_catch"
  repeatable: true
  cooldown: "5s"
  actions:
    - type: command.dispatch
      executor: console
      command: "eco give {player_name} 1000"
    - type: subtitle.play
      group-id: "legendary_celebrate"

BattlePass 任务联动

在 plugins/ArcartX-Suite/data/battlepass/ 中配置钓鱼相关任务：

yaml

weekly_fish_master:
  name: "周常：钓鱼大师"
  description: "本周捕获 20 条鱼"
  event-topic: "axs.fishing.success"
  conditions:
    - key: "fish_rarity"
      operator: "ANY"
  increment: "+1"
  target: 20
  reward-xp: 200

yaml

legendary_hunter:
  name: "传说猎人"
  description: "钓起一条传说鱼"
  event-topic: "axs.fishing.success"
  conditions:
    - key: "fish_rarity"
      operator: "EQ"
      value: "LEGENDARY"
  increment: "+1"
  target: 1
  reward-xp: 500

称号与邮件预设配置

Fishing 里程碑调用的称号和邮件需要在对应模块中预先配置：

Title 模块：在 plugins/ArcartX-Suite/data/title/ 中添加

yaml

fisher_apprentice:
  display-name: "&7[学徒渔夫]"
  # ... 其他称号属性

fisher_master:
  display-name: "&a[大师渔夫]"

fisher_legend:
  display-name: "&6[传说渔夫]"

perfect_master:
  display-name: "&b[完美大师]"

legendary_hunter:
  display-name: "&c[传说猎人]"

Mail 模块：在 plugins/ArcartX-Suite/data/mail/presets/ 中添加 legendary_first_catch.yml

yaml

preset:
  subject: "传说捕获嘉奖"
  body: "恭喜你首次捕获传说级鱼类！这是你的奖励。"
  item-attachments:
    - material: "DIAMOND"
      amount: 5

常见问题排查

问题	原因	解决方法
抛竿后没有进入小游戏	`replace-vanilla: false` 或 ArcartX UI 未正常加载	检查主配置 `replace-vanilla` 是否为 `true`，确认 ArcartX 客户端正常连接
鱼种不刷新	季节/天气/时间/水域类型不匹配	检查当前服务器季节、天气和时间段是否符合鱼种配置条件
饵料不生效	鱼竿未装载饵料或 PDC 标签写入失败	确认已调用 `FishingService.attachBait()` 消耗饵料并写入 `axs_fishing_bait_id` 标签
钓竿属性不生效	鱼竿缺少 `axs_fishing_rod_id` PDC 标签	通过外部系统或命令写入正确的 PDC 标签
Market 无法回收鱼	recycle 表中未配置 `source: "fishing"` 条目	参考上方 Market 回收联动配置
`/fishing sell` 提示"不是钓鱼产物"	鱼物品缺少 PDC 标记	重新钓鱼即可获得带标记的新物品
EventPacket 收不到 Signal	EventPacket 模块未安装或未启用 fishing 相关规则	确认模块已安装，并在规则中配置正确的 `signal`

数据库表

表名	说明
`axs_fishing_player`	玩家等级、经验、总捕获数、完美捕获数
`axs_fishing_collection`	图鉴条目：鱼种 ID、捕获次数、最大尺寸、首次捕获时间

Fishing 钓鱼系统 ​

功能概览 ​

依赖 ​

命令 ​

玩家命令 ​

管理员命令 ​

权限 ​

PlaceholderAPI 占位符 ​

配置结构 ​

ArcartXFishing.yml ​

fishes/ 鱼种文件 ​

treasures/ 宝藏文件 ​

baits/ 饵料文件 ​

使用饵料 ​

装载机制 ​

饵料属性 ​

自定义钓竿 ​

rods/ 钓竿文件 ​

钓竿识别 ​

钓竿属性效果 ​

快速开始教程 ​

第一步：安装与激活 ​

第二步：创建鱼种（fishes/） ​

第三步：创建宝藏（treasures/） ​

第四步：创建饵料（baits/） ​

第五步：创建钓竿（rods/）（可选） ​

第六步：配置水域与池（ArcartXFishing.yml） ​

第七步：配置 Market 回收（与 Market 模块联动） ​

第八步：装载饵料（可选） ​

第九步：使用 ​

水域匹配规则 ​

小游戏玩法 ​

售卖系统 ​

Market 回收联动 ​

跨模块联动 ​

EventBus 事件主题 ​

EventPacket Signal ​

Title / Mail 里程碑 ​

进阶联动配置示例 ​

EventPacket 联动（发送奖励） ​

BattlePass 任务联动 ​

称号与邮件预设配置 ​

常见问题排查 ​

数据库表 ​

Fishing 钓鱼系统

功能概览

依赖

命令

玩家命令

管理员命令

权限

PlaceholderAPI 占位符

配置结构

ArcartXFishing.yml

fishes/ 鱼种文件

treasures/ 宝藏文件

baits/ 饵料文件

使用饵料

装载机制

饵料属性

自定义钓竿

rods/ 钓竿文件

钓竿识别

钓竿属性效果

快速开始教程

第一步：安装与激活

第二步：创建鱼种（fishes/）

第三步：创建宝藏（treasures/）

第四步：创建饵料（baits/）

第五步：创建钓竿（rods/）（可选）

第六步：配置水域与池（ArcartXFishing.yml）

第七步：配置 Market 回收（与 Market 模块联动）

第八步：装载饵料（可选）

第九步：使用

水域匹配规则

小游戏玩法

售卖系统

Market 回收联动

跨模块联动

EventBus 事件主题

EventPacket Signal

Title / Mail 里程碑

进阶联动配置示例

EventPacket 联动（发送奖励）

BattlePass 任务联动

称号与邮件预设配置

常见问题排查

数据库表