资源包配置

包含哪些外观

Java 与基岩资源包包含激光方块和立体旅行背包。其他功能使用原版外观；背包储物功能不依赖资源包。彩虹拉杆使用原版粒子，Java 与基岩显示形状可能略有差异。

JAR、Java ZIP、基岩 MCPACK 与 Geyser JSON 必须使用同一 LuckyGame 版本。客户端无需安装模组。

Java 版

Java 26.2 使用资源包格式 88。在 Compose 的 environment 中加入当前版本的固定 URL 与 SHA1：

RESOURCE_PACK: "https://luckygame.saxontech01.com/releases/2.2.0/LuckyGame-Java-2.2.0.zip"
RESOURCE_PACK_SHA1: "f33aa514b376473e13358bbedda331fd3e3ecaab"
RESOURCE_PACK_ENFORCE: "TRUE"
RESOURCE_PACK_PROMPT: '{"text":"LuckyGame：激光器与旅行背包外观"}'

RESOURCE_PACK_PROMPT 必须是 JSON 文本组件。修改 Compose 后重建容器，再让客户端接受资源包并验证下载。不要只改容器内 server.properties。

基岩版与 Geyser

1. 把 LuckyGame-Bedrock-2.2.0.mcpack 放入 data/plugins/Geyser-Spigot/packs/。
2. 把 LuckyGame-Geyser-2.2.0.json 放入 data/plugins/Geyser-Spigot/custom_mappings/。
3. 在 Geyser 的 config.yml 启用 enable-custom-content: true。
4. 先备份，移出旧 LuckyGame / WearableBackpacks / LaserGuard 资源包及旧背包映射，保留无关包和映射，再完整重启。

基岩包 UUID 保持兼容，通过版本号识别升级。最低引擎声明为 1.21.60，实际接入版本以安装的 Geyser 支持范围为准。

背包的第一视角

Java 背包表面离镜头小于 1.5 格时隐藏；正常 F5 和其他玩家可见，贴墙 F5 或贴近他人也可能隐藏附近背包。快速移动或延迟可能使模型超出隐藏范围。

基岩第一视角使用原生条件隐藏。普通皮革胸甲不受影响。更换资源包后分别连接两端检查效果。

外观异常时检查

• 下载 URL 是否指向当前固定版本，Java SHA1 是否与文件对应。
• 是否仍同时启用了旧资源包或重复 Geyser 映射。
• Geyser 是否启用自定义内容并已完整重启，客户端是否接受新资源包。
• 彩虹光点是否在 24 格内可见，客户端是否关闭了粒子。