指南
如何安装数据包
更新于 2026年10月18日
数据包不需要模组,也不需要服务端软件:在原版、单人游戏和任何服务器上都能用。数据包属于某一个世界:把它放进那个世界的 datapacks 文件夹,然后重新加载。唯一要注意的是,数据包要适用于你的 Minecraft 版本。
一个可以作为起点的例子。
用 Codexe 生成这个分步说明
1.检查版本
数据包页面会写明它支持哪些 Minecraft 版本。数据包格式在不同版本之间会变化,所以 1.20 的数据包可能在 1.21 上用不了。
2.找到世界的 datapacks 文件夹
单人游戏:
.minecraft/saves/<World>/datapacks/。服务器:world/datapacks/(即server.properties中level-name指定的文件夹)。3.复制数据包
直接把 .zip 放进去,或者放解压后的文件夹。无论哪种方式,
pack.mcmeta都必须位于 zip 或文件夹的最顶层。4.重新加载
在游戏中运行
/reload(需要管理员权限或开启作弊),或者重启服务器。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 生成这个