跳转到正文
iPlugin

ZIP 项目、备份与发布

导入一个 Xerr 插件目录,导出编辑快照,再安全应用到服务器

编辑器的项目交换方式只有 ZIP 导入与 ZIP 导出。图片、字体可以在项目内上传;它们是项目资产,不是另一个项目入口。

准备 Xerr.zip

先备份服务器的 plugins/Xerr,再压缩这个插件目录。推荐的包内结构:

config.yml

config.yml 与 core 直接位于 ZIP 根目录也可以。编辑器会识别共同的项目根目录;不要混入第二个 Xerr 项目、整个 plugins 目录或其它服务端文件。

生成的 generated/resource_pack、generated/resource_pack.zip 和自托管缓存 cache/hosted_packs 不需要参与制作,压缩项目时可排除。客户端资源包通常以 pack.mcmeta 和 assets 为根,它不是本教程中的编辑项目。

当前安全限制为 压缩文件 128 MB、解压内容 128 MB、最多 5000 个条目。项目过大时先排除生成目录、日志和无关文件,不要通过拆开同一个项目的必需配置来绕过限制。

编辑中如何保留进度

编辑在当前工作台中进行。需要留存一个阶段成果时就导出 ZIP;不要把关闭页面或浏览器内缓存当作保存方式。

  • 重要步骤完成后导出一个快照。
  • 保留最初导入的包,以及准备发布的包。
  • 浏览器提示有未导出改动时,先完成导出再刷新或关闭。
  • 导入另一个 ZIP 会替换当前项目;有改动时先导出。

Cmd / Ctrl + S 执行导出 ZIP,不会把文件自动写回服务器。

工作区右上角导出 ZIP 按钮和底部未导出修改状态

右上角「导出 ZIP」留存当前项目快照,底部标记尚未导出的修改。

导出前检查

导出会应用当前输入与待同步源码,再检查配置和资产。数值错误、YAML 错误或图片/字体读取失败时,先修复相应问题。

未修改文件按原始内容保留;可视化修改尽量保留注释和未知字段。改动文件的空白格式可能规范化,不保证字节级完全相同。

应用到服务器

  1. 备份服务器当前的 plugins/Xerr,确认使用的是与编辑器配套的插件配置格式。
  2. 将导出 ZIP 解压到一个临时目录,确认其中的 config.yml 和 core。
  3. 把项目配置与资产更新回 plugins/Xerr,不要再套一层 Xerr/Xerr。
  4. 对照本次重命名、移动和删除操作,移除对应的旧文件;只复制新增文件可能保留同名定义或旧绑定。
  5. 执行 /xerr reload;涉及资源生成时执行 /xerr pack 并让客户端加载新包。
  6. 在游戏内验证,再保留本次发布包作为下一次编辑起点。

导出的 ZIP 包含配置与原始资产。给玩家加载的资源包由插件打包生成,不是直接把编辑器导出的 ZIP 发给客户端。

资源包下载地址、合并其它资源包与版本适配见资源包交付。