服务器资源包不加载：原因与限制

限制

• 大小——最大 100 MB。 控制面板不会接受更大的压缩包：客户端在加入时无法完成下载这样的资源包。
• 仅支持 Zip。 .rar、.7z 格式的压缩包或文件夹都无法使用。
• 每个服务器只能有一个资源包。 新资源包会完全替换之前的资源包。
• 需要重启。 资源包链接保存在 server.properties 中，服务器会在启动时读取它。如果您向正在运行的服务器上传资源包，玩家将在重启后获得它。

上传方法：“设置”板块，“上传资源包”一行 → “上传 zip”。控制面板会保存压缩包、计算 SHA-1 并自动填写链接——资源包和数据包。

资源包无法上传到控制面板

资源包已上传，但玩家没有收到

1. 服务器尚未重启。 控制面板会显示“需要重启”的提示——请重启服务器。
2. 玩家拒绝了资源包。 在玩家的服务器列表中：选择服务器 → “配置” → “资源包：已启用”。
3. 格式版本不匹配。 资源包是为其他游戏版本构建的：客户端会提示资源包不兼容，或只能部分应用。请检查 pack.mcmeta 中的 pack_format。
4. 压缩包结构不正确。 pack.mcmeta 和 assets 文件夹必须位于 zip 的根目录中，而不是嵌套文件夹内。
5. 玩家使用的是手机。 通过 Geyser 加入的 Bedrock 玩家无法获得 Java 资源包——Bedrock 资源包。

通过自己的链接使用资源包

如果您手动输入链接而不是上传：

• 链接必须直接提供文件本身，而不是页面：普通的 Google Drive 和 Yandex Disk 链接无法使用；
• 请填写 SHA-1 字段：没有它，客户端会在每次加入时重新下载资源包，而且在您更新资源包后，客户端可能仍停留在旧版本；
• 在同一链接替换文件后，请更新 SHA-1。

使用按钮上传压缩包会更简单——这样控制面板会自行维护链接和哈希值。

所有人加入时都被踢出

“需要资源包”开关已开启，但资源包无法下载：没有获得资源包的玩家无法加入。请关闭该要求，修复资源包，然后重新开启——强制资源包。