本插件添加了一个自定义钓鱼系统,包含点击动作小游戏、基于排名的自定义鱼类、出售商店 GUI 以及自动化的钓鱼竞赛。
玩家通过快节奏的小游戏捕获自定义鱼类,将其出售换取金钱,并参与每日定时举办的钓鱼比赛。
- 捕获鱼类会启动一个点击动作小游戏——在计时器结束前,按照屏幕上显示的左/右击序列进行操作
- 鱼类被划分为自定义等级,每个等级拥有独立的物品池、重量(捕获几率)、长度范围和基础价格
- 每条捕获的鱼都会获得一个随机的长度,其出售价格随长度变化(
基础价格 + 长度 × 每单位长度价格)
- 内置出售商店 GUI——放入鱼后一次性全部出售,或按住 Shift 右键直接清空背包中的所有鱼
- 钓鱼竞赛提供两种模式:最长鱼和最多捕获数
- 竞赛可设置为在固定时间(HH:mm)每日自动运行,或由管理员强制启动
- 实时显示的Boss 条计时器向所有玩家展示剩余的竞赛时间
- 可配置的奖励(控制台命令),涵盖第 1 / 2 / 3 名及参与奖
- 支持用于总捕获数和顶级排名的排行榜占位符(PlaceholderAPI)
- 可将钓鱼活动限制在特定的允许世界中
- 所有等级、玩家统计数据和预定竞赛均自动保存
- 所有 DP-Plugins 插件都需要
DPP-Core 插件
- 如果未安装
DPP-Core,本插件将无法工作
- 您可以在此下载
DPP-Core:点击我!
- 出售鱼类和获取金钱奖励需要
EssentialsX(经济系统)
PlaceholderAPI 为可选插件——仅在使用排行榜占位符时需要
1️⃣ 将 DPP-Core 插件和本插件文件(DP-CustomFishing-*.jar)放入服务器的 plugins 文件夹
2️⃣ 重启服务器,插件将自动启用
3️⃣ 首次运行时将生成配置文件
config.yml
- 消息前缀
Settings.PricePerLength — 每增加 1cm 鱼长所添加的额外价格(默认值:10)
Settings.AllowedWorlds — 启用自定义钓鱼的世界列表
Settings.symbol.left / right — 小游戏点击符号(◀, ▶)
Contest.Duration — 竞赛持续时间,单位为分钟(默认值:30)
Contest.Rewards.<Length|MostCatch>.<1st|2nd|3rd|participation>.commands
- 由控制台执行的奖励命令;
%player% 会被替换为获胜者的名字
❗ 大多数命令需要管理员权限 (dpcf.admin)
别名:/customfishing, /커스텀낚시, /낚시
命令列表与示例
| 命令 |
权限 |
描述 |
示例 |
/dpcf opensell |
dpcf.sell |
打开鱼类售卖界面 (GUI) |
/dpcf opensell |
/dpcf create <rank> |
dpcf.admin |
创建新的鱼类等级 |
/dpcf create rare |
/dpcf items <rank> |
dpcf.admin |
编辑某个等级的物品池(通过 GUI) |
/dpcf items rare |
/dpcf price <rank> <price> |
dpcf.admin |
设置某个等级的基础价格 |
/dpcf price rare 500 |
/dpcf length <rank> <min> <max> |
dpcf.admin |
设置某个等级的长度范围 |
/dpcf length rare 30 80 |
/dpcf weight <rank> <weight> |
dpcf.admin |
设置某个等级的捕获权重(概率) |
/dpcf weight rare 20 |
/dpcf delete <rank> |
dpcf.admin |
删除一个等级 |
/dpcf delete rare |
/dpcf list |
dpcf.admin |
列出所有等级 |
/dpcf list |
/dpcf setpriceperlength <price> |
dpcf.admin |
设置全局的每单位长度价格 |
/dpcf setpriceperlength 10 |
/dpcf contestcreate <name> <length|mostcatch> <HH:mm> |
dpcf.admin |
注册一个每日重复举行的竞赛 |
/dpcf contestcreate daily length 14:30 |
/dpcf contestedit <name> <length|mostcatch> <HH:mm> |
dpcf.admin |
编辑已注册的重复举行竞赛 |
/dpcf contestedit daily mostcatch 20:00 |
/dpcf contestdelete <name> |
dpcf.admin |
删除已注册的重复举行竞赛 |
/dpcf contestdelete daily |
/dpcf contestlist |
dpcf.admin |
列出所有已注册的重复举行竞赛 |
/dpcf contestlist |
/dpcf conteststart <length|mostcatch> |
dpcf.admin |
立即强制开始一场竞赛 |
/dpcf conteststart length |
/dpcf conteststop <length|mostcatch> |
dpcf.admin |
强制停止一场竞赛(无奖励) |
/dpcf conteststop length |
/dpcf reload |
dpcf.admin |
重新加载插件配置 |
/dpcf reload |
使用命令时的注意事项
- 小游戏需要在 5 秒内点击正确 3–5 次——错误点击或超时会导致鱼逃脱
- 其资源池中没有物品的等级永远不会产出鱼——使用
/dpcf items <rank> 添加物品
- 更高的权重意味着该等级被选中的概率更高
- 同一时间只能运行每种类型的一个竞赛
- 强制停止的竞赛不会发放奖励
- 钓鱼仅在
Settings.AllowedWorlds 下列出的世界中有效
- PlaceholderAPI 占位符:
%dpcf_total_fishing% — 玩家总共钓到的鱼的数量
%dpcf_top_fishing_<rank>% — 指定排行榜名次中玩家的捕获数量(例如 %dpcf_top_fishing_1%)
%dpcf_top_name_<rank>% — 指定排行榜名次中玩家的名字(例如 %dpcf_top_name_1%)
- 开发者自定义事件:当玩家成功完成钓鱼小游戏时,会触发
FishingSuccessEvent
- 鱼类物品携带 NBT 标签:
dpcf_rank、dpcf_length、dpcf_price
- 加入我们的 Discord 以获取支持、报告错误或提出功能建议
- 我们始终欢迎您的建议和反馈!
This plugin adds a custom fishing system with a click-action minigame, rank-based custom fish, a sell shop GUI, and automated fishing contests.
Players catch custom fish through a fast-paced minigame, sell them for money, and compete in daily scheduled fishing competitions.
- Catching a fish starts a click-action minigame — follow the left/right click sequence shown on screen before the timer runs out
- Fish are organized into custom ranks, each with its own item pool, weight (catch chance), length range, and base price
- Every caught fish gets a random length, and its sell price scales with length (
base price + length × price-per-length)
- Built-in sell shop GUI — put fish in and sell them all at once, or shift-right-click to sell everything in your inventory
- Fishing contests with two modes: longest fish and most catches
- Contests can be scheduled to run daily at a fixed time (HH:mm) or force-started by an admin
- Live boss bar timer shows the remaining contest time to all players
- Configurable rewards (console commands) for 1st / 2nd / 3rd place and participation
- Leaderboard placeholders for total catches and top rankings (PlaceholderAPI)
- Fishing can be restricted to specific allowed worlds
- All ranks, player stats, and scheduled contests are saved automatically
- All DP-Plugins require the
DPP-Core plugin
- The plugin will not work if
DPP-Core is not installed
- You can download
DPP-Core here: Click me!
EssentialsX (economy) is required for selling fish and money rewards
PlaceholderAPI is optional — needed only for leaderboard placeholders
1️⃣ Place the DPP-Core plugin and this plugin file (DP-CustomFishing-*.jar) into your server’s plugins folder
2️⃣ Restart the server, and the plugin will be automatically enabled
3️⃣ Configuration files will be generated on first run
config.yml
- Message prefix
Settings.PricePerLength — extra price added per 1cm of fish length (default: 10)
Settings.AllowedWorlds — list of worlds where custom fishing is enabled
Settings.symbol.left / right — minigame click symbols (◀, ▶)
Contest.Duration — contest duration in minutes (default: 30)
Contest.Rewards.<Length|MostCatch>.<1st|2nd|3rd|participation>.commands
- Reward commands executed by console;
%player% is replaced with the winner's name
❗ Most commands require admin permission (dpcf.admin)
Aliases: /customfishing, /커스텀낚시, /낚시
Command List and Examples
| Command |
Permission |
Description |
Example |
/dpcf opensell |
dpcf.sell |
Open the fish sell GUI |
/dpcf opensell |
/dpcf create <rank> |
dpcf.admin |
Create a new fish rank |
/dpcf create rare |
/dpcf items <rank> |
dpcf.admin |
Edit the item pool of a rank (GUI) |
/dpcf items rare |
/dpcf price <rank> <price> |
dpcf.admin |
Set base price of a rank |
/dpcf price rare 500 |
/dpcf length <rank> <min> <max> |
dpcf.admin |
Set length range of a rank |
/dpcf length rare 30 80 |
/dpcf weight <rank> <weight> |
dpcf.admin |
Set catch weight (chance) of a rank |
/dpcf weight rare 20 |
/dpcf delete <rank> |
dpcf.admin |
Delete a rank |
/dpcf delete rare |
/dpcf list |
dpcf.admin |
List all ranks |
/dpcf list |
/dpcf setpriceperlength <price> |
dpcf.admin |
Set global price-per-length value |
/dpcf setpriceperlength 10 |
/dpcf contestcreate <name> <length|mostcatch> <HH:mm> |
dpcf.admin |
Register a daily repeating contest |
/dpcf contestcreate daily length 14:30 |
/dpcf contestedit <name> <length|mostcatch> <HH:mm> |
dpcf.admin |
Edit a registered repeating contest |
/dpcf contestedit daily mostcatch 20:00 |
/dpcf contestdelete <name> |
dpcf.admin |
Delete a registered repeating contest |
/dpcf contestdelete daily |
/dpcf contestlist |
dpcf.admin |
List all registered repeating contests |
/dpcf contestlist |
/dpcf conteststart <length|mostcatch> |
dpcf.admin |
Force start a contest now |
/dpcf conteststart length |
/dpcf conteststop <length|mostcatch> |
dpcf.admin |
Force stop a contest (no rewards) |
/dpcf conteststop length |
/dpcf reload |
dpcf.admin |
Reload the plugin configuration |
/dpcf reload |
❗Notes when using commands
- The minigame requires 3–5 correct clicks within 5 seconds — a wrong click or timeout means the fish escapes
- A rank with no items in its pool will never produce a fish — add items with
/dpcf items <rank>
- Higher weight means a higher chance for that rank to be selected
- Only one contest per type can run at the same time
- Force-stopped contests do not give rewards
- Fishing only works in worlds listed under
Settings.AllowedWorlds
- PlaceholderAPI placeholders:
%dpcf_total_fishing% — total number of fish the player has caught
%dpcf_top_fishing_<rank>% — catch count of the player at the given leaderboard rank (e.g. %dpcf_top_fishing_1%)
%dpcf_top_name_<rank>% — name of the player at the given leaderboard rank (e.g. %dpcf_top_name_1%)
- Custom event for developers:
FishingSuccessEvent is fired whenever a player successfully completes the fishing minigame
- Fish items carry NBT tags:
dpcf_rank, dpcf_length, dpcf_price
- Join our Discord for support, bug reports, or feature requests
- Suggestions and feedback are always welcome!
评论 0
登录后参与评分
还没有评论,来抢沙发吧