v1.1.0 · 智能配置迁移核心

ReloadConfig v1.1.0

自动检测插件配置版本,智能迁移数据,备份旧文件,告别手动重配的烦恼。
适用于 Spigot / Paper 所有版本。

全自动扫描 & 版本对比

服务器启动时自动扫描所有 config.yml,对比磁盘版本与 jar 版本,仅当磁盘版本 < jar 版本时触发迁移,杜绝重复迁移。

内容对比模式

即使插件未定义 config-version,也会逐键对比 jar 默认配置与磁盘配置,有差异即自动迁移。

智能数据迁移

同名键自动匹配值;支持自定义映射规则;未匹配旧键记录到报告中,绝不丢失。

中英双语支持

控制台、日志、报告及配置文件注释全部支持中英文切换,适配全球服主。

跳过规则 & 黑名单

支持运算符 (>= > = <= <) 配置跳过特定插件版本,默认跳过 Gost >=2.2.2,避免不兼容热重载的插件出问题。

Reload 建议

迁移完成后自动输出 /reload <插件名> 命令,支持黑名单标注不支持热重载的插件。

工作原理

版本对比 + 内容对比,双重保障,只升级真正需要迁移的配置。
点击查看完整工作流程

ReloadConfig 在服务器加载完毕后介入,完成配置升级流程:

1
扫描所有插件 config.yml
2
读取 config-version / 内容对比
3
符合条件则备份 (.bak)
4
生成新配置 + 合并数据
5
保存配置 + 输出 reload 建议 + 报告

✅ 修复了旧版本的重复迁移 bug:现在严格比较磁盘版本与 jar 版本,版本相同或更低不会重复执行。内容对比模式确保没有 config-version 的插件也能获得最佳体验。

使用方法

三步集成:放入插件 → 启动服务器 → 自动工作,支持中英文及跳过规则。
查看详细步骤 & 新特性配置

1. 安装插件 — 将 ReloadConfig.jar 放入 plugins/ 目录,重启服务器。

2. 自动工作 — 默认启用自动扫描、备份和内容对比模式。

3. 进阶配置 — 编辑 plugins/ReloadConfig/config.yml 可设置语言、跳过规则、自定义映射等。

# plugins/ReloadConfig/config.yml (v1.1.0 新配置)
language: zh-CN               # 或 en
auto-scan: true
backup-old-config: true

skip-plugins:                 # 支持 >= > = <= <
  - "Gost >=2.2.2"           # 默认跳过 Gost 2.2.2 及以上版本
  - "AnotherPlugin >1.0"

migration-rules:
  "OldPlugin.old-key": "NewPlugin.new-key"

reload-blacklist:             # 不支持热重载的插件
  - "Gost"
  - "HeavyPlugin"

插件升级后,迁移成功会输出 /reload <插件名> 建议;如果插件在黑名单中,会提示需要重启服务器。

为插件开发者设计

只需在 config.yml 中添加 config-version 字段(不再限定 ScriptIrc),即可享受完美迁移。
查看接入示例 & 版本升级说明

从 v1.1.0 开始,版本键名统一为 config-version(之前为 ScriptIrc-config-version),任何 Bukkit/Spigot/Paper 插件均可兼容:

config-version: 1
# 其他配置内容...
database:
  host: localhost
  port: 3306

即使插件没有定义 config-version,ReloadConfig 也会通过内容对比模式智能检测配置差异,进行迁移。建议开发者逐步加入版本号以获得最佳体验。

提示:旧配置中未匹配的键会被记录到日志报告中,不会丢失;迁移完成后控制台会输出热重载建议,方便插件生效。

配置参数详解

全面控制迁移行为:语言、跳过规则、备份、自定义映射等。
查看完整配置项 & 新版特性

ReloadConfig 自身的配置文件位于 plugins/ReloadConfig/config.yml

配置键类型默认值说明
languageStringzh-CN界面语言 (zh-CN / en)
config-versionint1本插件自身的配置版本
auto-scanbooleantrue是否启动时自动扫描
backup-old-configbooleantrue迁移前是否备份为 .bak
skip-pluginsList["Gost >=2.2.2"]跳过指定插件版本,支持运算符
reload-blacklistList[]不支持热重载的插件列表
migration-rulesMap{}旧键→新键映射
# skip-plugins 示例
skip-plugins:
  - "Gost >=2.2.2"   # 跳过 Gost 2.2.2 及以上版本
  - "OldPlugin =1.0" # 精确匹配 1.0
  - "TestPlugin <=0.5"

备份机制:旧配置重命名为 .bak,新配置包含合并后的数据,版本号自动更新。

注意事项 & 更新亮点

v1.1.0 修复重复迁移 bug,新增内容对比、跳过规则、中英双语等。
查看详细更新说明与重要提示
  • 🐛 修复重复迁移 bug — 版本相同不再重复迁移,避免生成大量 .bak 文件。
  • 🔧 版本键名统一 — 从 ScriptIrc-config-version 改为 config-version,任何插件通用。
  • 📊 内容对比模式 — 无需版本号也可检测配置差异并迁移。
  • 🔄 Reload 建议 + 黑名单 — 自动输出 /reload 命令,黑名单插件提示重启。
  • ⏭️ 跳过规则 — 支持运算符匹配插件版本,避免误操作。
  • 🌐 中英双语 — 控制台、日志、注释全双语支持。
  • 👤 作者信息 — 配置、启动提示、日志、报告均添加作者及主页链接。

日志位置:plugins/ReloadConfig/logs/ - 每次迁移生成独立报告文件。
控制台实时摘要:清晰展示哪些插件已迁移、是否备份、成功/警告条目。

为什么选择 ReloadConfig?

无痛更新、通用性强、数据永不丢失,新版更智能。
展开了解更多核心优势

✔️ 告别插件更新后的配置灾难管理员无需手动复制大量配置。

✔️ 通用性极强不限制插件来源,支持 config-version 或自动内容对比。

✔️ 映射规则 + 同名匹配双保险配置结构大改也能平稳过渡。

✔️ 完全透明备份和详细日志,一键回滚。

非常适合服务器维护者、整合包作者,让配置管理从繁琐中解放。