ZIP 项目、备份与发布
导入一个 Xerr 插件目录,导出编辑快照,再安全应用到服务器
编辑器的项目交换方式只有 ZIP 导入与 ZIP 导出。图片、字体可以在项目内上传;它们是项目资产,不是另一个项目入口。
准备 Xerr.zip
先备份服务器的 plugins/Xerr,再压缩这个插件目录。推荐的包内结构:
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」留存当前项目快照,底部标记尚未导出的修改。
导出前检查
导出会应用当前输入与待同步源码,再检查配置和资产。数值错误、YAML 错误或图片/字体读取失败时,先修复相应问题。
未修改文件按原始内容保留;可视化修改尽量保留注释和未知字段。改动文件的空白格式可能规范化,不保证字节级完全相同。
应用到服务器
- 备份服务器当前的
plugins/Xerr,确认使用的是与编辑器配套的插件配置格式。 - 将导出 ZIP 解压到一个临时目录,确认其中的
config.yml和core。 - 把项目配置与资产更新回
plugins/Xerr,不要再套一层Xerr/Xerr。 - 对照本次重命名、移动和删除操作,移除对应的旧文件;只复制新增文件可能保留同名定义或旧绑定。
- 执行
/xerr reload;涉及资源生成时执行/xerr pack并让客户端加载新包。 - 在游戏内验证,再保留本次发布包作为下一次编辑起点。
导出的 ZIP 包含配置与原始资产。给玩家加载的资源包由插件打包生成,不是直接把编辑器导出的 ZIP 发给客户端。
资源包下载地址、合并其它资源包与版本适配见资源包交付。