安装与迁移

准备环境

适用于 Paper 26.2、Java 25。当前部署基于 Ubuntu 与 Docker Compose。先从下载页取得完整安装包，核对 SHA256 后解压。

基岩玩家接入需要另装 Geyser 与 Floodgate。其他第三方插件继续独立管理。

安装到服务器

1. 正常停服，备份 Compose 文件、整个 data 目录与已有插件文件。
2. 如果从六个旧独立插件迁移，移除旧自制 JAR、旧 Compose 挂载和旧下载项，保留旧数据目录。也检查 plugins/update，避免下次启动装回旧 JAR。
3. 将 LuckyGame-2.2.0.jar 放入宿主机 local-plugins/，在已有数据挂载旁加入下方挂载。
4. 按资源包配置文档设置 Java 下载地址、SHA1，以及基岩资源包和映射，然后完整启动服务器。

volumes:
  - ./data:/data
  - ./local-plugins/LuckyGame-2.2.0.jar:/data/plugins/LuckyGame.jar:ro

通过 Compose 管理的配置应写在 compose.yaml，容器重建时会重新应用。不要用热重载代替重启。

旧数据如何迁移

首次启动会把六个旧插件目录复制到 data/plugins/LuckyGame/ 对应功能目录，暂存后原子移入。旧目录保留，已有目标目录不覆盖。

装置位置、密码门的门主与摘要、背包 UUID 与内容、拉杆状态和液体恢复队列均须保留。不要同时加载旧自制插件与 LuckyGame，否则 LuckyGame 会拒绝启用。

如果目标目录已存在而旧数据未导入，请先停服检查和备份。不要用空目录替换旧背包数据。迁移后新数据写入 LuckyGame，回滚必须恢复匹配的整套数据。

确认安装完成

在启动日志中确认 LuckyGame 2.2.0 已启用，六项功能统一加载，然后在游戏内检查 /lg、/im info、/laser info、/bp info 与 /wl info。

检查 Java 与基岩的资源包下载和外观，分别试用背包、合成配方和已有装置。管理命令需要对应权限。