指南

如何安装数据包

更新于 2026年10月18日

数据包不需要模组,也不需要服务端软件:在原版、单人游戏和任何服务器上都能用。数据包属于某一个世界:把它放进那个世界的 datapacks 文件夹,然后重新加载。唯一要注意的是,数据包要适用于你的 Minecraft 版本。

一个可以作为起点的例子。

用 Codexe 生成这个

分步说明

  1. 1.检查版本

    数据包页面会写明它支持哪些 Minecraft 版本。数据包格式在不同版本之间会变化,所以 1.20 的数据包可能在 1.21 上用不了。

  2. 2.找到世界的 datapacks 文件夹

    单人游戏:.minecraft/saves/<World>/datapacks/。服务器:world/datapacks/(即 server.properties 中 level-name 指定的文件夹)。

  3. 3.复制数据包

    直接把 .zip 放进去,或者放解压后的文件夹。无论哪种方式,pack.mcmeta 都必须位于 zip 或文件夹的最顶层。

  4. 4.重新加载

    在游戏中运行 /reload(需要管理员权限或开启作弊),或者重启服务器。

  5. 5.确认它已启用

    /datapack list 会显示已启用和可用的数据包。如果你的数据包是可用但未启用,运行 /datapack enable "file/<name>"。

创建世界时添加数据包

在单人游戏中点击创建新的世界,然后点更多和数据包:把 .zip 拖进窗口,再把它移到已启用的一侧。对于改变世界生成(生物群系、地形、结构)的数据包,这是正确的方式,因为这些改动只作用于数据包启用之后生成的区块。

在服务器上,要在首次启动之前把世界生成数据包放进 world/datapacks/,否则旧地形保持原样,只有新区块会改变。

常见问题

  • 数据包不在 /datapack list 中:它放错了文件夹,或者 zip 里多了一层文件夹,导致 pack.mcmeta 不在最顶层。
  • “为旧版本/新版本制作”警告:pack_format 与你的游戏不匹配。数据包可能仍能加载,但为其他版本编写的配方或函数可能会失败。
  • 已加载但没有任何效果:某个函数或配方有错误。服务器日志(单人游戏中是游戏日志)会写明出错的文件。
  • 你下载的是资源包:材质和音效放在 resourcepacks/ 中,而不是 datapacks/。有些内容会同时提供两种包。

在托管面板上

在托管面板上,打开文件管理器,进入世界文件夹,把 zip 上传到 datapacks/,然后重启。有些托管服务提供数据包安装器,效果相同。世界文件夹是 server.properties 中指定的那个,而不是服务器根目录。

用 Codexe 制作的数据包

在 Codexe 上制作的数据包,在标记为就绪之前会被加载到真实的 Minecraft 服务器上,并检查服务器日志中配方、函数、进度或 JSON 的错误。你下载到的是一个 zip,pack.mcmeta 和 data/ 位于顶层,可以直接放进 world/datapacks/;你也可以先在私人测试服务器上试玩。

常见问题

客户端需要安装什么吗?

不需要。数据包在服务器上运行(单人游戏中是内置服务器)。只有数据包附带了材质资源包时,玩家才需要资源包。

数据包对所有世界都生效吗?

不,只对它所在文件夹的那个世界生效。需要使用它的每个世界都要复制一份。

能移除数据包吗?

运行 /datapack disable "file/<name>",然后把它从文件夹中删除。它已经创建的东西(物品、计分板、生成的地形)可能会留在世界中。

为你的世界制作数据包

这条提示词打开后即可直接发送:

“一个 Minecraft 1.21.4 数据包,命名空间为“camp”:一个“铺盖卷”的无序配方(3 个白色羊毛和 2 根线),产出一张带名称的白色床;一个把 4 个腐肉变成 1 个皮革的配方;以及一个在侧边栏显示“deaths”计分板的 load 函数。”

用 Codexe 生成这个
如何安装 Minecraft 数据包(世界或服务器) | Codexe