原创 工具 娱乐 QZFishing——一款高度自定义的钓鱼插件|替换原版|不同世界不同奖励|指令奖励 1.2

插件简介​

QZFishing 是一个功能强大的 Minecraft 钓鱼奖励系统插件，支持自定义钓鱼奖励、多世界分组管理、权限控制和权重随机抽取等功能。适用于Minecraft 1.16 及以上版本。理论上你可以用这个插件实现钓鱼刷MM怪物等之类，简单上手，无限可能。
作者: 青栀
作者QQ：2643703759
交流群: 1085042728

---

核心功能​

---

安装与配置​

安装步骤​

配置文件说明​

插件包含三个主要配置文件：

代码：

settings:
是否启用原版钓鱼（如果为false，将完全替换原版钓鱼）
enable-vanilla-fishing: false
是否取消原版钓鱼提示消息
cancel-fishing-message: true
世界分组配置
格式: 世界名: 奖励组名
world-groups: default: default world_nether: nether world_the_end: end festival_world: festival

配置项说明：
[MD] **配置项说明：** | 配置项 | 类型 | 默认值 | 说明 | |--------|------|--------|------| | `enable-vanilla-fishing` | boolean | false | 是否保留原版钓鱼物品掉落 | | `cancel-fishing-message` | boolean | true | 是否取消原版钓鱼聊天消息 | | `world-groups` | Map | - | 世界与奖励组的映射关系 | [/MD]

2. rewards.yml - 奖励配置文件​

[MD] **奖励项配置说明：** | 字段 | 类型 | 必填 | 说明 | |------|------|------|------| | `command` | String | ✅ | 钓到后执行的命令，支持 `%player%` 占位符 | | `weight` | Integer | ✅ | 权重值，数值越大抽中概率越高 | | `permission` | String | ❌ | 所需权限，留空表示所有人可获得 | | `display-name` | String | ❌ | 显示名称，支持颜色代码（&a, &b 等） | **概率计算示例：** 假设某奖励组总权重为 205（100+50+20+5+30），则： - `common_fish`: 100/205 ≈ 48.8% - `rare_fish`: 50/205 ≈ 24.4% - `treasure`: 20/205 ≈ 9.8% - `legendary`: 5/205 ≈ 2.4% - `money_reward`: 30/205 ≈ 14.6% [/MD]

3. messages.yml - 消息配置文件​

代码：

messages:
#Title 提示配置
title-settings: fade-in: 10 # 淡入时间（ticks） stay: 40 # 停留时间（ticks） fade-out: 10 # 淡出时间（ticks）
#获得奖励时的标题
reward-title: "&a&l恭喜获得奖励！" reward-subtitle: "&f你钓到了 %reward%"
#没有可用奖励时的标题
no-reward-title: "&c未获得奖励" no-reward-subtitle: "&f请检查你的权限"

消息配置说明：
[MD] **消息配置说明：** | 配置项 | 说明 | 占位符 | |--------|------|--------| | `reward-title` | 获得奖励时的大标题 | `%reward%` | | `reward-subtitle` | 获得奖励时的副标题 | `%reward%` | | `no-reward-title` | 无奖励时的大标题 | - | | `no-reward-subtitle` | 无奖励时的副标题 | - | | `title-settings.fade-in` | Title 淡入时间（ticks） | - | | `title-settings.stay` | Title 停留时间（ticks） | - | | `title-settings.fade-out` | Title 淡出时间（ticks） | - | **颜色代码参考：** [/MD]

​

[MD] --- ## 🎮 使用指南 ### 玩家使用 1. 在任何世界中手持钓鱼竿进行钓鱼 2. 钓到物品后会自动执行对应命令 3. 屏幕上方会显示获得的奖励名称 4. 某些奖励可能需要特定权限才能获得 ### 管理员操作 #### 命令列表 | 命令 | 权限 | 说明 | |------|------|------| | `/qzfishing help` | qzfishing.use | 显示帮助信息 | | `/qzfishing info` | qzfishing.admin | 查看插件信息和奖励组统计 | | `/qzfishing reload` | qzfishing.admin | 重新加载所有配置文件 | **快捷别名：** - `/qzfish` - `/qzf` #### 权限节点 | 权限节点 | 默认 | 说明 | |----------|------|------| | `qzfishing.use` | true | 使用插件的基本权限 | | `qzfishing.admin` | OP | 管理员权限（reload/info） | | `qzfishing.rare` | false | 获得稀有奖励的权限 | | `qzfishing.treasure` | false | 获得宝藏奖励的权限 | | `qzfishing.legendary` | false | 获得传说奖励的权限 | | `qzfishing.nether.*` | false | 下界奖励组权限 | | `qzfishing.end.*` | false | 末地奖励组权限 | #### 权限设置示例（使用 LuckPerms） [/MD]


使用效果

---

更新日志​

v1.1-SNAPSHOT（当前版本）​

新增功能：

• Tab指令补全
• 修复热重载

v1.0-SNAPSHOT（当前版本）​

新增功能：

• 基础钓鱼奖励系统
• 多世界分组支持
• 权重随机算法
• 权限系统集成
• Title 提示系统
• 防刷冷却机制
• 配置热重载

已知问题：

• 暂无

---

​

联系方式​

• 作者: 青栀
• QQ: 2643703759
• 交流群: 1085042728

提交问题​

遇到问题时，请提供以下信息：

1. 服务器版本和核心类型
2. 插件版本号
3. 相关配置文件内容（脱敏后）
4. 控制台错误日志
5. 问题复现步骤

功能建议​

欢迎提出新功能建议，我们会根据需求评估是否加入后续版本。

---

​

感谢所有使用和支持 QZFishing 的玩家和管理员！

如果你觉得这个插件有用，欢迎：

• 在发布页面点赞
• 推荐给其他服主
• 加入交流群分享经验