MiragEdge 文档中心

外观

氛围动效

钓鱼系统工作流 · 模块工作流 ​

钓鱼内容分为鱼类、钓竿、鱼饵、比赛、维度钓鱼联动五类。这页给出每类的配置格式与验证方式。

模块 1：鱼类配置 ​

鱼是钓鱼的核心产出。每条鱼属于一个稀有度，可带环境条件。鱼类绑定在稀有度文件内。

设计要素 ​

  • 鱼的 ID，使用英文字母加下划线。
  • 归属稀有度。
  • 环境条件，包括生物群系、天气、时间、世界。
  • 自定义材质，可用原版物品、玩家头颅或自定义模型。
  • 尺寸范围。

基础格式 ​

yaml
# rarities/common.yml 内
fish:
  Cod: []                          # 使用默认材质生鳕鱼
  MyFish:                          # 带自定义物品的鱼
    item:
      material: SALMON             # 或 head-64 或 head-uuid 或 materials 列表
      displayname: <gold>自定义名称
      glowing: true
      lore:
        - '<gray>一条描述'

带条件的鱼 ​

yaml
fish:
  Atlantic_Cod:
    requirements:
      biome:                       # 限定生物群系
        - COLD_OCEAN
        - OCEAN
      weather: DOWNFALL            # 下雨或下雪时
      ingame-time: 6000-18000      # 限定游戏时间，单位为 tick
      world: world_nether          # 限定世界
      fishing-type: Lava           # 限定钓鱼类型，需 DimensionFishing
      permission: emf.fish.vip     # 需要权限
    effect: POISON:1:2             # 钓到时给效果，格式为 名称:等级:秒
    message: <yellow>*特殊消息*
    health: -1                     # 钓到时扣血
    size:
      minSize: 10                  # 覆盖稀有度尺寸范围
      maxSize: 50

物品类型速查 ​

字段说明示例
material单个原版物品SALMON
materials随机多选一[TUBE_CORAL, BRAIN_CORAL]
head-64Base64 编码的玩家头颅完整 180 字符以上
head-uuid玩家 UUID 头颅916b1144-...
multiple-head-64多头颅随机列表
不写默认生鳕鱼—

校验与部署 ​

bash
/emf admin reload
/emf admin fish

使用对应钓竿测试钓鱼，检查是否钓到新增的鱼。yml 放入 rarities/ 后执行 /emf admin reload。

模块 2：钓竿配置 ​

钓竿控制玩家能钓到哪些稀有度与鱼种。钓竿的 custom-model-data 同时被 DimensionFishing 用于检测维度钓鱼类型。

设计要素 ​

  • 钓竿 ID，使用英文蛇形命名。
  • 允许的稀有度列表，用于权限控制。
  • 合成配方，可选。
  • CMD 值，如需维度钓鱼联动。
  • 物品外观，包含材质、名称、描述、发光。

配置格式 ​

yaml
# rods/my_rod.yml
id: my_rod                       # 唯一 ID，英文
disabled: false
allowed-rarities:                # 允许的稀有度
  - Common
  - Rare
# allowed-fish:                  # 可选：进一步限定具体鱼种
#   Common:
#     - Cod
item:
  material: FISHING_ROD           # 必须是 FISHING_ROD
  custom-model-data: 206          # 自定义模型数据，可选
  displayname: <gold>我的钓竿
  glowing: true
  lore:
    - '<gray>可钓：普通 / 稀有'
recipe:                           # 合成配方，可选，不用则删除整段
  type: shaped                    # shaped 为固定排列，shapeless 为无序
  shape:
    - 'aaa'
    - 'dfd'
    - 'aaa'
  ingredients:
    a: air
    d: diamond
    f: fishing_rod

维度钓鱼 CMD 表 ​

CMD 值虚空钓鱼岩浆钓鱼
203支持不支持
204不支持支持
205支持支持
其他不支持不支持

校验与部署 ​

bash
/emf admin rod give @p my_rod

手持钓竿测试钓鱼，观察是否能钓到对应稀有度的鱼。yml 放入 rods/ 后执行 /emf admin reload。

模块 3：鱼饵配置 ​

鱼饵修改鱼类的出现权重。附加到钓竿后，影响特定稀有度或鱼种的上钩概率。

设计要素 ​

  • 鱼饵 ID。
  • 目标稀有度或鱼种。
  • 权重运算类型，取 +N、-N、*N、/N。
  • 是否可购买，含价格、数量、经济插件。
  • 附加限制，含最大数量、无限使用。

配置格式 ​

yaml
# baits/my_bait.yml
id: my_bait                       # 唯一 ID，英文
disabled: false
item:
  material: NAUTILUS_SHELL        # 材质
  displayname: <gold>我的鱼饵
  glowing: true
  lore:
    - '<gray>提升史诗鱼的出现率'

rarity-modifiers:                 # 修改整稀有度权重
  Epic: "+50"                     # 史诗鱼权重加 50
  Legendary: "*2"                 # 传说鱼翻倍

# fish-modifiers:                 # 或只修改特定鱼
#   Common:
#     Carp: "*2"
#     Bluefish: "*2"

catch-weight: 50                  # 钓到该鱼饵的概率
application-weight: 100           # 多饵时被消耗的概率
max-baits: 64                     # 一根竿最多附多少个此饵
infinite: false                   # 无限使用

purchase:                         # 商店出售，删除整段则不可购买
  price: 500
  quantity: 8
  economy-types:
    - Vault

权重运算说明 ​

运算效果示例
*2权重翻倍史诗鱼出现率翻倍
+50权重加 50传说鱼明显更容易出
*1.5提升 50%适中加成
/2减半压低某种鱼的概率

校验与部署 ​

bash
/emf admin bait give @p my_bait

使用带鱼饵的钓竿测试，观察鱼种分布变化。yml 放入 baits/ 后执行 /emf admin reload。

模块 4：比赛配置 ​

比赛按配置的时间表自动触发，支持多种类型和排名奖励。

设计要素 ​

  • 比赛类型，8 种之一。
  • 时间方案，每天固定时间或指定星期几。
  • 最少在线人数。
  • 排名奖励，支持金钱、经验、物品、效果、消息、音效、血量。
  • BossBar 显示。

价格公式 ​

鱼价等于鱼的长度乘以稀有度的 worth-multiplier。

稀有度倍率尺寸范围均价
垃圾0—0
普通2.01~50cm约 51
稀有1.520~100cm约 90
史诗2.0100~300cm约 400
传说2.5500~1500cm约 2500

比赛类型 ​

类型说明
LARGEST_FISH比最大单条鱼
MOST_FISH比钓鱼数量
LARGEST_TOTAL比累计尺寸
SHORTEST_FISH比最短单条鱼
SHORTEST_TOTAL比累计最短
SPECIFIC_FISH随机指定一种鱼
SPECIFIC_RARITY随机指定一种稀有度
RANDOM从 random-selection 中随机选

配置格式 ​

yaml
# competitions/my_comp.yml
id: my_competition                # 唯一 ID，英文
disabled: false
type: LARGEST_FISH                # 比赛类型
duration: 15                      # 持续时间，单位为分钟
minimum-players: 3                # 最少在线人数

# 时间方案 A：每天固定时间
times:
  - 08:00
  - 20:00
# 时间方案 B：指定星期几的时间，与 times 二选一
# days:
#   Saturday:
#     - 09:00
#     - 15:00
# blacklisted-days:               # 排除的日期，与 days 二选一
#   - Sunday

bossbar-colour: GREEN             # BossBar 颜色
bossbar-prefix: '<bold>钓鱼大赛:'

alerts:                           # 剩余时间提醒
  - 10:00                         # 10 分钟前
  - 5:00                          # 5 分钟前
  - 1:00                          # 1 分钟前

rewards:
  '1':                            # 第一名
    - MONEY:5000
    - EXP:5000
    - ITEM:DIAMOND,3
    - MESSAGE:<green>恭喜第一名！
  '2':                            # 第二名
    - MONEY:2500
    - EXP:2500
  '3':                            # 第三名
    - MONEY:1000
  '4':                            # 支持任意多名
    - MONEY:500
  participation:                  # 参与奖
    - MONEY:50

奖励类型速查 ​

奖励格式示例
金钱MONEY:数量MONEY:5000
经验EXP:数量EXP:5000
物品ITEM:材质,数量ITEM:DIAMOND,3
效果EFFECT:名称,等级,秒EFFECT:SPEED,2,30
消息MESSAGE:<颜色>文本MESSAGE:<green>恭喜！
音效SOUND:名称,音量,音高SOUND:ENTITY_FIREWORK_ROCKET_BLAST,1,1
血量HEALTH:数值HEALTH:10

校验与部署 ​

bash
/emf admin competition start my_competition

参与钓鱼，观察比赛排行榜和奖励发放。yml 放入 competitions/ 后执行 /emf admin reload。

模块 5：维度钓鱼联动 ​

通过 DimensionFishing 插件，EvenMoreFish 支持末地的虚空钓鱼和下界的岩浆钓鱼。钓鱼权限由钓竿的 custom-model-data 值决定。

DimensionFishing 是独立插件，运行在服务端。它检测玩家手持钓竿的 CMD 值，据此判断该玩家在特定维度是否有权限。

CMD 值虚空钓鱼岩浆钓鱼
203支持不支持
204不支持支持
205支持支持
其他不支持不支持

设计要素 ​

  • 每个世界需要什么钓鱼类型。主世界为普通，下界为岩浆，末地为虚空。
  • 分配给对应钓竿的 CMD 值。
  • 维度与钓鱼类型的映射关系。

维度映射配置 ​

yaml
# DimensionFishing 插件配置
dimensions:
  world: NORMAL                    # 主世界：普通钓鱼
  world_nether: LAVA               # 下界：岩浆钓鱼
  world_the_end: VOID              # 末地：虚空钓鱼

钓竿端配置 ​

在钓竿 yml 中分配对应的 CMD 值：

yaml
# rods/void_rod.yml：虚空钓鱼竿
id: void_rod
allowed-rarities:
  - Epic
  - Legendary
item:
  material: FISHING_ROD
  custom-model-data: 203          # DimensionFishing 识别为虚空钓鱼
  displayname: <dark_purple>虚空钓竿

# rods/lava_rod.yml：岩浆钓鱼竿
id: lava_rod
allowed-rarities:
  - Epic
  - Legendary
item:
  material: FISHING_ROD
  custom-model-data: 204          # DimensionFishing 识别为岩浆钓鱼
  displayname: <red>熔岩钓竿

# rods/omni_rod.yml：全维度钓竿
id: omni_rod
allowed-rarities:
  - Common
  - Rare
  - Epic
  - Legendary
item:
  material: FISHING_ROD
  custom-model-data: 205          # 虚空与岩浆通用
  displayname: <gold>万象钓竿

校验 ​

bash
# 1. 确认 DimensionFishing 插件已加载
/plugins

# 2. 给予测试钓竿
/emf admin rod give @p void_rod
/emf admin rod give @p lava_rod
/emf admin rod give @p omni_rod

维度验证：

  • 末地手持 void_rod，CMD 203，可虚空钓鱼。
  • 下界手持 lava_rod，CMD 204，可岩浆钓鱼。
  • 任意维度手持 omni_rod，CMD 205，两种都可。
  • 主世界任何钓竿，仅普通钓鱼。

确认岩浆钓鱼只在下界工作，虚空钓鱼只在末地工作。

部署 ​

  1. DimensionFishing JAR 放入 plugins/ 目录，重启服务器。
  2. 钓竿 yml 放入 plugins/EvenMoreFish/rods/，执行 /emf admin reload。
  3. 确认两个插件均正常加载且无报错。

DimensionFishing 与 EvenMoreFish 没有直接依赖

DimensionFishing 是独立插件。它与 EvenMoreFish 仅通过 CMD 值联动识别。

使用流程 ​

处理钓鱼开发请求时，按以下流程执行：

text
第 1 步：阅读前置知识
  → 确认数据模型、目录结构、CMD 值

第 2 步：定位需求类型
  → 新增鱼 → 模块 1
  → 新增钓竿 → 模块 2
  → 新增鱼饵 → 模块 3
  → 新增比赛 → 模块 4
  → 新增维度钓鱼 → 模块 5

第 3 步：按五步闭环执行
  → 概念理解 → 设计方案 → 编写配置 → 验证命令 → 部署说明

第 4 步：交付输出
  → 提供可直接复制的 yml 内容
  → 附带完整验证命令
  → 标注文件路径，例如 # rods/my_rod.yml

命名与路径规范 ​

项目规范示例
稀有度 yml全小写common.yml、epic.yml
鱼类 ID英文蛇形atlantic_cod、lava_eel
钓竿 ID英文蛇形beginner_rod、lava_rod
鱼饵 ID英文蛇形spicy_bait、magic_bait
比赛 ID英文蛇形daily_fishing、weekend_special
fish 子键首字母大写Cod、Atlantic_Cod
重载命令/emf admin reload—
配置文件路径plugins/EvenMoreFish/<type>/<id>.ymlplugins/EvenMoreFish/rods/my_rod.yml
© 2020-2026 锐界幻境与贡献者|SOUL
苏ICP备2024133820号-1
Build #690 · bdb9301