插件介绍

这不是“展示型图鉴插件”

源码实际实现的是一整套可运营玩法:玩家先获得云养动物,再通过喂养提升等级、通过繁殖扩张数量、通过击杀拿掉落与经验、通过出售换冒险币,最后接入每日任务和排行榜奖励。

MythicDongWuFangKuai,插件内标题名为“星露谷养殖”,是一款基于 MySQL 的跨服云养动物/怪物插件,面向 Paper 1.20.1 与 Java 17 环境开发。玩家通过 /dongwu 打开主界面后,可以统一管理自己拥有的各种云养生物,并在 GUI 中完成出售、击杀、喂养、繁殖、存入刷怪蛋、提取仓库奖励等操作。

插件把 Minecraft 生物做成了可配置的“云养资产”。每一种动物都有自己的基础价格区间、饱食度衰减、繁殖时间、喂养经验、等级价格加成和品质倍率。每日价格会刷新,出售收益由“当日基础价 × 品质倍率 × 等级加成”计算,因此它天然适合做长期养成服、经济服、收集服或休闲副玩法。

从代码和配置来看,插件已经内置完整数据库表、任务系统、排行奖励、云仓库、掉落表、GUI 布局配置、怪物精华道具、手动/自动繁殖逻辑,以及击杀实体概率获得云养动物的获取入口。不是一个半成品页面插件,而是完整可上线的玩法模块。

一句话总结:玩家在服里打怪拿到云养生物或精华,回到 GUI 里继续养、继续繁殖、继续回收赚钱,所有过程都能跨服同步到同一个 MySQL。

核心功能

  • 跨服云养数据同步:所有子服连接同一个 MySQL,动物数据、每日回收额度、当日价格、排行榜、任务进度都能共用。
  • 73 种可云养生物:默认覆盖 1.20.1 常见动物与怪物,注释中明确排除了末影龙和凋灵。
  • 品质系统:普通、非凡、稀有、史诗、传说五档品质,影响出售价值,繁殖时还有 5% 概率品质进阶。
  • 喂养成长:消耗“生物精华”提升饱食度和经验,等级最高 10 级,等级越高出售越值钱。
  • 手动繁殖 + 自动繁殖:手动繁殖吃冷却、饱食度和成功率判定;同种生物达到数量阈值后还会按定时任务自动增殖。
  • 动态每日价格:每种生物每天自动生成一个新的基础回收价,并写入数据库,避免经济一成不变。
  • 击杀产出进云仓库:击杀云养生物会按 drops.yml 掉物和经验,统一进入云仓库而不是直接爆在地上。
  • 每日出售额度:回收总额有每日上限,支持部分出售与额度回退,避免刷经济过快。
  • 每日任务系统:内置击杀、喂养、繁殖、出售、收集精华五类任务,完成后执行控制台奖励命令。
  • 排行榜奖励:每日定时刷新排名,支持单名次与名次区间奖励,玩家可自行领取未领取的排行奖励。
  • 完整 GUI 配置化:主界面、管理界面、繁殖界面、图鉴、仓库、排行榜、每日任务都有独立布局配置。
  • 实体击杀概率获取云养生物:玩家击杀原版实体时,有概率直接获得对应类型的云养动物。

命令列表

主命令为:/dongwu

命令说明权限
/dongwu打开星露谷养殖主界面dongwu.use
/dongwu rank打开排行榜界面dongwu.use
/dongwu task打开每日任务界面dongwu.use
/dongwu reward领取未领取的排行奖励dongwu.use
/dongwu reload重载配置、GUI 布局和任务缓存dongwu.admin
/dongwu give <玩家> <类型> <数量> [品质]后台给予指定玩家云养动物dongwu.admin
/dongwu rankrefresh手动异步刷新排行榜dongwu.admin

普通玩家的主要操作都在 GUI 中完成,命令入口非常克制。这个插件偏“图形操作玩法”,不是靠长命令堆功能。

权限节点

权限说明默认
dongwu.use基础使用权限,允许打开 GUI 与使用普通命令所有玩家
dongwu.admin管理员权限,允许重载、发放动物、手动刷新排行OP

玩法闭环

1. 获取动物

管理员可用 /dongwu give 发放。玩家击杀原版实体时也有概率直接获得对应类型的云养动物,品质随机生成。

2. 喂养升级

击杀实体会掉落“生物精华”,在 GUI 中消耗精华喂养,提高饱食度和经验,等级越高后续出售收益越高。

3. 繁殖扩张

至少 2 只、饱食度至少 20 才能手动繁殖;默认冷却 300 秒,成功率受饱食度和等级影响,最高封顶 95%。

4. 击杀取货

击杀云养生物会按掉落表产出物品和经验,统一进入云仓库;每击杀一定数量还会额外给玩家精华作为二次循环燃料。

5. 动态回收

每日基础价自动变化,最终售价由基础价、品质倍率、等级加成共同决定,并受每日出售额度限制。

6. 排行与任务

日常养成会同步推进排行榜和每日任务,让养殖玩法不只是“攒数量”,而是有目标、有奖励、有长期竞争。

几个关键公式

出售价格

最终单价 = 当日基础价 × 品质倍率 × (1 + 等级 × 等级加成系数)

繁殖成功率

成功率 = 60 + 饱食度 × 0.2 + 等级 × 3,最高不超过 95%

GUI 界面

  • 主界面 Main:分页展示玩家拥有的所有云养生物,左键进入管理,右键进入繁殖。
  • 管理界面 Manage:单个生物的核心操作台,集中放置出售、击杀、喂养、放入刷怪蛋、繁殖、仓库等操作按钮。
  • 云仓库 Storage:查看击杀所得的所有掉落物与累计经验,支持按数量提取物品,也支持聊天输入提取经验值。
  • 繁殖界面 Breed:展示当前繁殖状态、繁殖冷却和成功率,点击即可执行一次繁殖判定。
  • 怪物图鉴 Collection:用于展示收集进度,适合做长期收集目标。
  • 排行榜 Leaderboard:查看前列玩家、自己的排名、动物总数和总估值。
  • 每日任务 DailyTask:展示每日任务进度与奖励,完成后点击领取。

GUI 布局不是写死的

页面布局来自 gui.yml 的 shape 和 items 配置,按钮材质、名称、Lore、CustomModelData 都可以直接改。

配置文件

插件默认会生成 config.ymlanimals.ymldrops.ymlgui.ymlmessages.ymlitems_CN.yml。绝大多数玩法都能从这些文件直接调。

数据库与核心机制

YAMLconfig.yml
database:
  host: 120.26.54.101
  port: 3306
  database: dongwu888
  username: dongwu888
  password: "dongwu888"
  pool-size: 10

settings:
  manual-breed-cooldown: 300
  auto-breed-interval: 3600
  auto-breed-per-count: 10
  auto-breed-max-offspring: 10
  hunger-decay-interval: 3600
  hunger-decay-amount: 5
  daily-sell-limit: 100000
  animal-drop-chance: 0.005
  kill-essence-per: 5

喂养道具

YAMLconfig.yml
feed-item:
  material: PAPER
  custom-model-data: 11832
  name: "&a&l生物精华"
  lore:
    - "&7| &f云养动物的特殊饲料"
    - "&7| &f击杀生物有概率获得"
  drop-chance: 0.01
  base-cost: 10
  cost-step: 100

每日任务

YAMLconfig.yml
daily-tasks:
  1:
    name: "&c击杀怪物"
    type: KILL
    target: 10
  2:
    name: "&a喂养动物"
    type: FEED
    target: 5
  3:
    name: "&d繁殖后代"
    type: BREED
    target: 3
  4:
    name: "&6出售怪物"
    type: SELL
    target: 20
  5:
    name: "&b收集精华"
    type: ESSENCE
    target: 3

排行榜奖励

YAMLconfig.yml
leaderboard:
  refresh-time: "00:05"
  rewards:
    1:
      commands:
        - "eco give {player} 15000"
    4-10:
      commands:
        - "eco give {player} 3000"

除数据库连接外,大多数配置都能通过 /dongwu reload 热重载,源码里还会同步刷新 GUI 布局缓存和每日任务缓存。

动物与品质

animals.yml 定义了每一种可云养生物的核心属性。默认配置标注为“共计 73 种生物”,覆盖大量被动生物、中立生物与敌对生物。

字段说明
name显示名称,例如猪、狼、恶魂、监守者
egg-material该生物对应的刷怪蛋材质,用于 GUI 显示与存入背包蛋
min-price / max-price每日基础价格的随机区间
hunger-decay该生物的饱食成长/消耗节奏参数
breed-time繁殖冷却展示配置
exp-per-feed每次喂养能提供的经验
level-multiplier等级带来的价格收益加成
rarity-multiplier品质倍率,直接影响出售价格

品质倍率

默认品质为 COMMONUNCOMMONRAREEPICLEGENDARY。从配置值来看,传说品质普遍是普通品质的 12 倍售价权重,因此品质系统不是装饰,而是核心价值来源之一。

经济服的调价重点

如果你服里有强刷怪来源,建议优先调整高价值怪物的 max-pricebreed-time 和日出售额度,不然产出容易抬穿经济。

掉落与仓库

drops.yml 为每一种生物定义击杀后可获得的经验和物品。源码逻辑是:每击杀一只,循环该生物的掉落表,物品直接写入玩家的云仓库,经验也写入独立仓库表。

YAMLdrops.yml
PIG:
  exp: "1-3"
  items:
    - material: PORKCHOP
      amount: "1-3"
      chance: 100
    - material: SADDLE
      amount: "1"
      chance: 3
功能点说明
物品仓库按材质累计存储,玩家可在 GUI 中按 1 / 10 / 64 / 全部提取。
经验仓库支持右键一键提取全部经验,也支持左键关闭界面后聊天输入数值精确提取。
额外精华奖励每击杀一定数量的云养动物,额外给玩家“生物精华”,形成击杀 → 喂养的循环。
任务联动击杀和精华获取都会同步推进每日任务进度。

任务与排行

每日任务

任务系统以当天日期为维度记录进度,任务完成后标记完成状态,玩家在 GUI 中点击领取奖励时,会由控制台依次执行奖励命令。这种做法非常适合和你服里已有的经济、点券、礼包命令联动。

排行榜

排行榜每天定时刷新,数据来自数据库统计。源码里会先刷新排行榜数据、再更新名次、最后根据配置生成名次奖励。奖励支持单名次和区间名次写法,例如 14-1011-50

任务适合做日活

KILL、FEED、BREED、SELL、ESSENCE 五个任务类型已经够支撑每日活跃。

排行适合做竞争

玩家可以在主界面直接查看自己排名,并领取未领取的排行榜奖励。

依赖与版本

项目是否必须说明
Paper 1.20.1必须插件基于 Paper API 1.20.1 开发
Java 17必须Maven 与源码配置均指定 17
Vault必须冒险币发放与经济系统依赖,未找到会直接禁用插件
MySQL 5.7+必须用于跨服同步与所有核心数据存储
ItemsAdder可选作为软依赖存在,便于 GUI 标题或贴图扩展

技术信息

项目信息
插件名称MythicDongWuFangKuai / 星露谷养殖
版本1.0
主命令/dongwu
数据库连接池HikariCP 5.0.1
MySQL 驱动mysql-connector-j 8.0.33
数据表玩家、动物、每日出售、每日价格、仓库物品、仓库经验、排行榜、排行奖励、任务等
价格刷新跨天自动清空缓存并生成新的当日价格
定时任务饱食衰减、自动繁殖、排行榜每日刷新

常见问题

因为源码所有核心数据都写入 MySQL,而且配置注释明确写了“所有子服务器连接同一个数据库即可实现跨服同步”。不是本地 yaml 存档式的单服玩具。
可以。监听器里实现了“击杀原版实体后,按概率获得对应类型云养动物”的逻辑,品质还会随机生成。
这个插件选择写入云仓库,优点是不会因为背包满或挂机点环境复杂而丢产出,玩家可以之后再批量提取物品和经验。
不是。成功率受饱食度和等级影响,且上限 95%。你可以通过喂养和养成提升稳定性,而不是纯赌。
优先看三个点:daily-sell-limit、高价值怪的价格区间、以及自动繁殖参数。别先怪玩家太能刷,通常是服主参数放得太大。

如果你想做一个“能让玩家天天上线收菜”的副玩法,这个插件的玩法密度已经够了,剩下的关键在于你怎么配价格、奖励和获取节奏。