for Minecraft 1.21.x · 鲜活四季

SeasonalPlugin

🌸 春华 · ☀️ 夏茂 · 🍂 秋实 · ❄️ 冬藏 — 为世界注入生命的律动。
树叶变色 | 作物季节限制 | 春季开花 | 冬季冻伤 | 钓鱼加成

从 Modrinth 下载探索四季功能

四季更替

春 → 夏 → 秋 → 冬循环，支持现实时间或游戏天数切换，进度实时可见。

天气影响

春季多雨，夏季晴朗，冬季通过切换群系实现唯美降雪，雷暴概率独立调节。

树叶 & 草地变色

春翠绿、夏原色、秋橙黄、冬银白，动态切换生物群系，沉浸感倍增。

作物季节限制

每种作物只能在特定季节生长，不适宜的季节无法种植/成熟，增加真实策略。

冬季冻伤系统

户外未穿戴靴子和护腿的玩家缓慢掉血并获得缓慢效果，提升生存挑战。

春/夏钓鱼加成

鱼类掉落翻倍，咬钩速度加快，秋季收获翻倍，完美配合季节特性。

季节循环机制

现实时间或游戏天数 — 全自动循环，管理员可随时手动调整。

查看详细机制 & 配置选项

换季方式：在 config.yml 中设置 season-cycle.use-real-time。
✔️ true — 基于现实天数（默认每个季节持续3天）
✔️ false — 基于游戏内天数，每个季节持续指定 Minecraft 日。

季节影响一览：

🌱 春季：开花系统开启，橡树变樱花树；作物生长加速，多雨。
☀️ 夏季：钓鱼速度加快，鱼类掉落翻倍，雷暴概率降低。
🍂 秋季：农作物收获翻倍，树叶转为橙黄色，凉爽宜人。
❄️ 冬季：生物群系转为雪地类，户外冻伤，西瓜/南瓜唯一生长季。

# config.yml 换季相关示例
season-cycle:
  use-real-time: false       # 使用游戏天数
  game-days-per-season: 7    # 每季节持续7个游戏日
  real-time-days-per-season: 3

春季开花 · 唯美特效

春季中期橡树变为樱花树，花瓣纷飞，可强制花期延长。

展开开花机制与命令

春季的第34%~66%阶段，世界中所有橡树会自动转变为樱花树，破坏后掉落橡树树叶，保持原版生存平衡。管理员可使用命令手动控制花期：

/seasonadmin blossom      # 立即进入开花状态（仅春季可用）
/seasonadmin blossom off   # 强制结束花期，樱花树变回橡树

🌸 开花期间樱花树会飘落粉色粒子，营造梦幻氛围，夏季将自动恢复原状。

作物季节适配表

每个作物拥有独立的四季适配规则，不适宜的季节无法生长。

查看默认作物季节表 (可配置)

作物	春	夏	秋	冬
小麦	✅	✅	✅	❌
胡萝卜	✅	✅	✅	❌
土豆	✅	❌	❌	✅
甜菜根	✅	❌	❌	✅
可可豆	✅	✅	❌	❌
浆果	✅	✅	✅	❌
西瓜/南瓜	❌	❌	❌	✅
火把花	✅	❌	❌	❌
瓶子草	✅	✅	❌	❌
下界疣/蘑菇	✅	✅	✅	✅

使用 /season crops 命令可随时查看当前季节适宜的作物列表，种子/作物物品Lore上也会显示四季适配表，当前季节高亮显示。

⚡ 生长速度倍率：春季所有作物加速生长（默认1.5倍），冬季几乎停滞（0.2倍），其他季节正常。所有数值可在配置中调整。

命令与权限

玩家指令、管理员指令，完全自定义季节控制。

展开完整命令列表

命令	权限	说明
/season 或 /s	seasonalplugin.use	查看当前季节详细报告（进度、推荐作物、小贴士）
/season crops	seasonalplugin.use	查看所有作物的四季生长适配表
/seasonadmin set <季节>	seasonalplugin.admin	手动设置季节 (spring/summer/autumn/winter)
/seasonadmin reload	seasonalplugin.admin	重载配置文件
/seasonadmin leafrefresh	seasonalplugin.admin	强制刷新树叶颜色与生物群系
/seasonadmin blossom	seasonalplugin.admin	强制进入花期（仅春季可用）橡树→樱花
/seasonadmin blossom off	seasonalplugin.admin	强制结束花期，樱花→橡树

管理员还可通过 /seasonadmin set 任意跳转季节，方便测试与活动。

核心配置 & 机制微调

所有数值均可自定义，从天气概率到冻伤伤害，完全掌控。

展开主要配置项说明

weather.spring-rain-chance — 春季下雨概率 (默认0.6)
weather.summer-thunder-chance — 夏季雷暴概率 (默认0.05)
crop-growth.spring-multiplier — 春季作物生长速度倍率
harvest-boost.multiplier — 秋季收获掉落倍率 (默认2.0)
fishing-boost.spring-summer-multiplier — 春/夏钓鱼掉落倍数 (1.5)
freeze.damage-interval-ticks — 冬季冻伤伤害间隔
leaf-particles.enabled — 树叶季节颜色开关

完整配置文件位于 plugins/SeasonalPlugin/config.yml，修改后执行 /seasonadmin reload 即时生效。

# 示例：调整冬季冻伤强度
freeze:
  enabled: true
  damage-amount: 1.0
  damage-interval-ticks: 80
  slow-amplifier: 1

每日提示 & 沉浸辅助

玩家上线或天亮时自动推送季节情报与种植建议。

展开提示机制介绍

每日清晨或玩家首次进入服务器时，会收到一条精美的季节报告，包含：

🌿 当前季节与剩余天数进度条
🌾 最适合种植的三种作物
💡 季节特性小贴士（如“春季橡树会开花”、“冬天记得穿靴子” ）

该功能完全可配置，支持关闭或调整提示频率。同时，所有作物种子/物品上均会显示适配表格，鼠标悬浮即可查看各季节生长状态，当前季节高亮突出。

使用方式 & 编译

基于 ScriptIrc 运行，快速部署。

查看详细部署步骤

1️⃣ 将项目导出为 .sirc 文件。
2️⃣ 放入服务端目录 plugins/ScriptIrc/scripts/src/。
3️⃣ 执行命令 /scriptirc compiler SeasonalPlugin 编译。
4️⃣ 编译成功后重启服务器或执行 /reload confirm 载入插件。

✅ 无需任何外部依赖，兼容 Paper 1.21.x 及后续版本，插件会在启动时自动注册季节监听器。

# 管理员命令示例
/seasonadmin set autumn
/seasonadmin leafrefresh