牢李插件系列
搜索

安装与升级

前置依赖、首次安装、升级、重载与完整重启。

安装前要求

  • 服务端：Paper/Leaves/Lophine 1.21.1-1.21.11、26.1.x、26.2，或 Folia 1.21.8 及以上稳定构建。
  • Java：插件使用 Java 21 字节码；Minecraft 26.x 服务端若要求 Java 25，应使用 Java 25 启动服务端。
  • 强制前置：PacketEvents 2.13.0 或更高兼容版本。
  • 可选前置：PlaceholderAPI、CustomCrops、Dominion、Residence。使用 Residence 时还需安装与其版本匹配的 CMILib；这两个插件不是 LISeasons 的强制前置。

当前 plugin.yml 声明：

api-version: '1.21'
folia-supported: true
depend: [packetevents]
softdepend: [CustomCrops, PlaceholderAPI, Dominion, Residence]

PaperMC 官方没有发布 Folia 1.21.1 构建；因此 1.21.1 最低兼容验证使用 Paper stable，Folia 使用官方仍可获取的 1.21.8 stable。不要把 Paper 1.21.1 兼容误解为存在 Folia 1.21.1 服务端。

PacketEvents 缺失时，插件会被服务端依赖检查阻止加载；版本低于 2.13.0 时，客户端颜色模块会拒绝初始化。这不是可忽略的颜色模块警告。

首次安装

  1. 停止服务器。
  2. 安装 PacketEvents 2.13.0 或更高的兼容版本；无需安装 ProtocolLib。
  3. 将 LISeasons-1.0.73.jar 放入 plugins/。
  4. 启动后确认日志显示“PacketEvents 纯客户端群系伪装”；该模块不会改写或保存世界群系。
  5. 启动服务器一次，等待 plugins/LISeasons/ 生成配置。
  6. 修改 config.yml -> worlds，确认季节系统应在哪些世界运行。
  7. 完整重启服务器。
  8. 进入游戏执行 /seasons info、/seasons calendar 检查基础功能。

默认世界范围：

worlds:
  enable-all: false
  allowed:
    - world
  denied:
    - world_nether
    - world_the_end

判定顺序为：denied 优先拒绝；否则 enable-all: true 或世界名位于 allowed 时启用。

生成的文件

文件 是否建议手动编辑 用途
config.yml 是 时间、世界、作物、天气、视觉、生物、冰雪和集成
messages.yml 是 MiniMessage 文本、季节/世界名称映射
temperature.yml 是 空气温度、体温、湿度、装备、物品和温度事件
season-color.yml 是 PacketEvents 客户端季节色调和区块预算
season-events.yml 是 季节事件、流星雨和奖励
festivals.yml 是 节日日期与说明
gui.yml 按需 旧版 GUI 兜底配置
gui/*.yml 是 六个独立菜单页面
calendar-state.yml 否 每个世界的持久化服内日历进度

从旧版本升级

1.0.73 自动补齐龙卷风的事件入口与 disasters.TORNADO 中文配置。请保留原文件；不希望发生龙卷风时，关闭 season-events.yml -> summer-events.tornado.enabled。升级需停服替换 Jar，不能只重载配置。

1.0.72 首次生成 climate-survival.yml，默认启用可致死的持续高低温伤害及四种持续灾害。开放服务器前确认这些玩法符合预期；需要非致死模式可设 allow-lethal-damage: false。旧配置只补缺失节点和注释，保留服主数值与自定义文案。旧事件的自定义介绍不会被覆盖，管理员可按新的实际机制自行调整。

升级前至少备份：

plugins/LISeasons/
plugins/LISeasons.jar 或原 LISeasons Jar

推荐流程：

  1. 停止服务器并备份整个插件目录。
  2. 删除旧 Jar，但保留配置目录。
  3. 放入新 Jar。
  4. 启动后查看配置迁移日志和 PacketEvents 客户端群系伪装初始化日志。
  5. 对比新 Jar 内的默认 temperature.yml、festivals.yml 与自己的旧文件。
  6. 执行功能验收后再开放服务器。

自动迁移范围

本次新增 season-world-rules.snow-accumulation（上半台阶、倒置楼梯、树叶开关）及 visual-effects.respect-player-weather。无需删除配置文件。Residence 冰雪兼容自动通过标准事件生效，不存在需要另行打开的 residence.enable 配置。

1.0.70 会为以下已有文件补全缺失节点和中文注释，并保留已存在的自定义值与自定义注释：

  • config.yml
  • messages.yml
  • temperature.yml
  • season-color.yml
  • season-events.yml
  • gui.yml
  • 六个 gui/*.yml 页面

它还包含冬冻春融旧字段迁移、默认品牌文本迁移和流星雨旧默认值迁移。流星数值只有仍等于旧版原始默认值时才会替换，管理员改过的值不会被强制覆盖。

从 1.0.65 起，temperature.yml 也会自动补全缺失节点，因此旧服会获得 action-bar.enable HUD 总开关及其中文注释，已有数值不会被覆盖。1.0.67 会给 messages.yml 补充 season-names.none 与 season.case.none。1.0.68 会补充季节 Buff BossBar、陨石奖励散落半径和弹起速度节点；旧服自定义值与自定义注释仍不会被覆盖。festivals.yml 当前仍只在文件缺失时生成，跨大版本升级时应手动对比该文件。

重载还是重启

/seasons reload 会重读主配置、消息、体温、颜色、事件、节日和 GUI 配置，并重建相关定时任务。

以下情况建议完整重启：

  • 更新 LISeasons Jar；
  • 安装或更新 PacketEvents；
  • 更新服务端核心或切换 1.21.1-1.21.11、26.1.x、26.2；
  • 出现 PacketEvents 群系包解析或发送失败；
  • 更新 PlaceholderAPI、CustomCrops、Dominion 等依赖；
  • 怀疑热重载残留旧任务或旧类。

不要使用会强制卸载/重载插件类的第三方热重载插件替代完整重启。

安装后验收

/seasons info
/seasons calendar
/seasons event list
/seasons festival today
/seasons event trigger meteor-night

同时检查：

  • 启动日志显示 LISeasons 1.0.65 已启用；
  • PacketEvents 2.13.0 或更高兼容版本在 LISeasons 之前启用；
  • 当前世界不在 worlds.denied；
  • 玩家附近草地和树叶会按预算逐步变色；
  • TAB 等异步占位符插件不再出现异步读取区块报错；
  • 流星测试时抬头观察，客户端粒子设置不要使用“最少”。

返回首页