指南

如何制作 Minecraft 数据包

更新于 2026年10月7日

数据包不需要模组或插件就能改变游戏:配方、战利品、进度、每个 tick 运行的函数。它适用于原版服务器和单人世界。它是一个由 JSON 文件和 .mcfunction 文件组成、布局严格的文件夹(或 .zip)。

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

用 Codexe 生成这个

分步说明

  1. 1.创建 pack.mcmeta

    根目录下的文件,包含描述,以及你的 Minecraft 版本对应的 pack_format 数字。数字不对,游戏会警告或拒绝这个数据包。

  2. 2.添加 data 文件夹

    data/<namespace>/,其下有 function、recipe、loot_table 和 advancement 等文件夹。文件夹名称在 1.21 中变了(从复数改为单数)。

  3. 3.编写函数

    .mcfunction 文件里每行一条命令。通过函数标签把它们挂到 minecraft:load 和 minecraft:tick 上。

  4. 4.安装

    把文件夹或 .zip 放进 <world>/datapacks/ 并运行 /reload,或者在创建世界时添加。

  5. 5.测试

    检查 /datapack list,然后在游戏里试每个配方和函数。错误会出现在服务器日志中。

用 Codexe

描述配方、战利品或机制,以及版本。Codexe 用正确的布局和 pack_format 写出文件,把数据包加载到真实的 Minecraft 服务器上,在标记为就绪之前发现错误,并让你加入那个服务器来试玩。

常见问题

用数据包还是插件?

数据包不需要服务端软件,在单人游戏中也能用,但只能做命令和 JSON 允许的事。插件能做服务端 API 允许的任何事,但需要 Spigot 或 Paper。

为什么我的数据包加载不了?

通常是 pack_format 不对、用了其他版本的文件夹名称,或者 JSON 有错误。服务器日志会指出是哪个文件。

制作数据包

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

“一个 Minecraft 1.21.4 的数据包:“Sea Totem”的有序配方(中间是海洋之心,周围是金),产出一个带自定义名称的不死图腾,以及一个添加侧边栏死亡次数计分板的加载函数。”

用 Codexe 生成这个
如何制作 Minecraft 数据包(分步说明) | Codexe