RptStardew —— 星露谷式种田 · 46 种作物 · 锄头水壶镰刀洒水器 · 季节轮替 [1.21 ~ 26.2]

R***

关于这个插件​RptStardew 是一个星露谷风格的种植插件：把"种田"这件事做成了一套完整循环——开垦、播种、浇水、生长、收获、枯萎。
作物、工具、洒水器全部由 CraftEngine 以展示实体渲染，不占原版方块状态、不需要客户端装模组，进服就能玩。生长节奏完全照星露谷 Wiki 的 Stages 表填的：每个作物每个阶段要几天都不一样，不是"一夜升一级"糊弄过去。


功能说明​1. 46 种作物，阶段生长​

• 防风草、蓝爵、大黄、花椰菜、杨桃、上古水果、霜瓜……共 46 种，涵盖春 / 夏 / 秋 / 冬四个季节。
• 每种作物的**每个生长阶段需要几个"夜晚"**都按 wiki 逐作物填好（如蓝莓 1+3+3+4+2）。
• 走展示实体渲染，不占方块、不占方块状态；服务器上多打几片田也不会撑爆状态池。
• 作物头顶可选浮动文字标签（名称 / 阶段 / 水分），一眼看到长到哪了。
  

2. 一整套农具​

工具	档位	说明
锄头	木 / 铜 / 钢 / 金 / 铱制（5 档）	右键草地/泥地开垦成耕地
水壶	木 / 铜 / 钢 / 金 / 铱制（5 档）	有水量、可右键水源补水；潜行右键 = 满蓄力，一次浇一片；浇水带水粒子
镰刀	普通 / 金 / 铱（3 档）	左键挥出剑气，一片一片收割

3. 浇水与生长​

• 不浇水就不长（进度保留、不枯萎），想长就得浇水。
• 每次浇水给作物 +33% 水分，跨夜归零（一天耗尽）；水分低于 50% 停止生长（都可配置）。
• 水壶和水壶的蓄力范围、洒水器的覆盖范围都会把耕地本身浇湿（土色变深），不是只改内部计数。
• 下雨 / 雷雨天所有作物自动浇满，不用管。
  

4. 洒水器​

档位​	覆盖范围
洒水器	上下左右 4 格
优质洒水器	周围一圈 8 格（3×3 去中心）
铱制洒水器	周围 24 格（5×5 去中心）

• 每天清晨自动浇一次；浇的时候洒水器会喷一圈水环（8 帧动态贴图）。
• 覆盖范围内的作物一定会被浇到，不受"下方是不是耕地"影响。
• 打掉即可回收。
  

5. 季节轮替​

• 春 → 夏 → 秋 → 冬，每季 28 天（可在配置里改），一年四季循环，世界第 1 天为「春 1」。
• 每种作物只能在自己的季节种下去；不在当季会直接被拒绝并提示。
• 跨季枯萎：季节一变，不属于新季节的作物会枯死；已经成熟等着收的也一起枯（星露谷原版规则，可配置关闭）。
• 枯死不毁地：只换外观，耕地原样保留；枯株用的是星露谷那套枯死贴图（4 张随机）。
• 跨季作物照 Wiki 连续生长：玉米 / 向日葵 / 小麦（夏+秋）、咖啡豆（春+夏）、上古水果 / 茶叶（春+夏+秋）。
• 冬天户外只能种霜瓜。
• 管理员可 /rptsd season next 直接跳季。
  

6. 品质系统​收获时按概率 roll 银 / 金 / 铱三种品质（概率在配置里，默认金 1% / 银 2%），品质只作用于当次收获的第一份产物，与 wiki 口径一致。
7. 对接 PlaceholderAPI​季节信息可以直接塞进记分板 / TAB / 计分板插件：

变量	内容
%rptstardew_season%	春 / 夏 / 秋 / 冬
%rptstardew_season_en%	Spring / Summer / Fall / Winter
%rptstardew_day%	本季第几天
%rptstardew_days_perseason%	每季天数
%rptstardew_days_left%	本季还剩几天（含今天）
%rptstardew_year%	第几年
%rptstardew_season_line%	夏 · 第 3/28 天 · 第 2 年
%rptstardew_crops%	进行中的作物株数
%rptstardew_sprinklers%	洒水器个数
%rptstardew_season_enabled%	季节系统是否开启

变量里带玩家时会按玩家所在世界算季节。
支持版本与环境​

项目	说明
Minecraft 版本	1.21 ~ 26.2（插件 api-version 1.21，字节码目标 Java 21，同一个 jar 通吃）
服务端核心	Paper、Folia（已声明 folia-supported: true）
Java 运行环境	Java 21 及以上
不支持	1.20.x 及以下
前置插件	CraftEngine（必需，作物/工具/洒水器的渲染全走它）
可选前置	PlaceholderAPI（要用上方变量才需要）
数据库	内嵌 SQLite（plugins/RptStardew/stardew.db），驱动已打进 jar，不需要 MySQL、不需要服主准备任何东西

目标用户​

• 想让服务器多点"生活感"的生存服 / 长期服服主 —— 种田不是点两下收菜，而是一天一天等的。
• 正在使用 Folia 核心的服主 —— 插件从设计之初就双端兼容，全部方块/实体操作都走区域线程。
• 不想给玩家装客户端模组的服主 —— 全部内容走服务端 + 资源包，进服即用。
• 在意"不能把服务器卡死"的服主 —— 作物不占方块状态，生长用轮询而不是随机刻。
  

是否付费​完全免费。 不需要授权、不需要联网校验。
获取作者帮助​

途径	内容
交流群	QQ 群 1124248111
作者 QQ	2221899680
游戏内	输入 /rptsd help 查看全部指令与说明

使用教程​安装​

• 确认服务端已装好 CraftEngine。
• 将 RptStardew-1.0.0.jar 放入服务端 plugins/ 目录。
• 把内容包 stardew/ 放进 CraftEngine/resources/（内容包不随 jar 分发，必须单独放）。
• 重启服务端；或先 /ce reload all 再 /rptsd reload。
  

首次启动会生成 plugins/RptStardew/config.yml 与 crops.yml。

指令列表​

指令	权限	说明
/rptsd help	rptsd.admin	指令帮助
/rptsd info	rptsd.admin	当前季节 / 作物数 / 洒水器数 / 参数
/rptsd list	rptsd.admin	列出全部 46 种作物
/rptsd season	rptsd.admin	查看当前季节
/rptsd give <作物> [数量] [玩家]	rptsd.admin	发放种子
/rptsd plant <作物>	rptsd.admin	在自己脚下耕地种一株
/rptsd spray	rptsd.admin	让最近的洒水器立刻浇一次水（浇水 + 水环）
/rptsd speed	rptsd.admin	让附近 8 格作物各长一个阶段
/rptsd clear	rptsd.admin	清除附近 8 格作物（只清作物）
/rptsd season next	rptsd.admin	跳到下一季并结算枯萎
/rptsd reload	rptsd.admin	重载配置并通知 CraftEngine 重载内容包

主指令 /rptsd，别名 /rptstardew。
/rptsd 全部子命令都是管理指令，默认只给 OP，不对玩家开放 —— 玩家的玩法全是交互，不需要指令：
锄头右键草地开垦 · 手持种子右键耕地播种 · 水壶右键浇水 · 右键成熟作物收获 · 镰刀左键挥剑气收割。

权限	默认值	说明
rptsd.admin	仅 OP	使用 /rptsd 的全部子命令

没有 rptsd.use 之类的玩家权限节点 —— 种植、浇水、收获都是物品交互，不需要权限，拿着工具就能用。

主要配置项（config.yml）​

配置项	默认值	说明
growth.check-interval-seconds	3	生长与环境检查间隔（秒）
growth.levels-per-day	1	生长速度全局倍率（2 = 天数减半）
growth.water-per-use	33	每次浇水给作物加多少水分（%）
growth.min-water-percent	50	水分低于多少就停止生长
growth.require-water	true	是否需要浇水才会生长
harvest.right-click-harvest	true	右键成熟作物是否立即收获
harvest.quality.enabled	true	品质系统总开关
harvest.quality.gold-chance	0.01	金星概率
harvest.quality.silver-chance	0.02	银星概率
display.show-label	true	作物头顶是否显示浮动文字
persistence.save-interval-seconds	60	数据落盘间隔（秒）
season.enabled	true	季节系统总开关
season.days-per-season	28	每季多少天（星露谷原版 28）
season.anchor-day	1	世界第几天算「春 1」
season.wither-ripe	true	成熟作物跨季是否也一起枯萎（原版：会）

改完执行 /rptsd reload 生效，不需要重启服务端。
常见问题​

• 作物种不下去 / 提示"只能在 X 种"？ 当前是别的季节。用 /rptsd season 看当前季节，或把 season.enabled 关掉。
• 作物不长了？ 大概率是没浇水。水壶右键作物浇水（每浇一次 +33%，要浇够才行）；下雨天会自动浇满。
• 洒水器为什么不动？ 它每天只在过一个夜晚的时候浇一次，不是随时浇。想立刻看效果用 /rptsd spray。
• 跨季之后一片作物都枯了？ 这是季节规则：不属于新季节的会枯，成熟等着收的也会枯。不想要这个行为就把 season.wither-ripe 关掉，或直接关掉整个 season.enabled。
• 枯死的作物怎么清？ 直接打掉即可。
• 内容包要去哪拿？ 单独下载，放进 CraftEngine/resources/stardew/。
• 想自己调生长速度？ 改 growth.levels-per-day（普通玩家也能用 /rptsd speed 让附近作物立刻长一阶段）。
  

声明​

• 本插件为个人作品，保留所有权利。
• 插件本体未使用任何混淆手段，欢迎安全审查；不含任何后门、病毒或远程控制代码，所有数据仅保存在服务器本地 plugins/RptStardew/ 目录中。