【1.13-1.14】数据包(原版模组)入门教程

ruhuasiyu

注意：由于论坛原因，本帖中的代码直接复制可能会有特殊的字符导致无法使用！
§1 简介
原版模组(vanilla mod)一般指在不修改Minecraft游戏本体的前提下，通过命令方块、一键命令(OOC)、数据包(datapack)、资源包(resourcepack)等方式对游戏的可玩性做出修改。而自Minecraft Java版1.13起的数据包概念问世之后，原版模组的制作已变得十分便捷。然而纵观论坛，原版模组仍然不够繁荣。因此我将为首次接触此概念的玩家做一个简单的入门，以期抛砖引玉。

部分段落常为部分读者所熟知，若如此可直接跳至自己所需段落。对于首次接触者，请耐心阅读。

§1.1 新人指引
本文中不会对命令部分做过多的详解。若你对命令尚不了解，可先依次通过如下链接学习并了解：

• 命令手册
  
  • 命令 - Minecraft Wiki，最详细的官方我的世界百科
  • 新人手册-MC命令方块资源
  • 命令进阶
    
• 记分板和nbt手册
  
  • 记分板 - Minecraft Wiki，最详细的官方我的世界百科
  • 区块格式 - Minecraft Wiki，最详细的官方我的世界百科
  • Player.dat格式 - Minecraft Wiki，最详细的官方我的世界百科
    

可先熟悉各项指令后，再学习记分板和nbt相关命令。实体和方块nbt亦可通过在游戏中使用data get entity/block指令来获取，以避免记忆大量的nbt。

若你已对1.12或以下的命令较为熟悉，可直接查看1.13页面和1.14页面查看命令改动之处。

§1.2 工具准备
文本编辑器 注意函数文件(.mcfunction)、JSON文件(.json)均需使用UTF-8编码格式，以下列出的文本编辑器默认均为UTF-8编码，可以在编辑页面的右下角状态栏看到。

• 记事本(Windows系统自带) Windows10最新版本的记事本已经默认是UTF-8编码了，点击查看->状态栏可以在右下角状态栏看到，因此可以正常使用。旧版本的记事本仍然不是，请勿使用。
• VS Code 下载安装后，可以安装如下插件：
  
  • Chinese (Simplified) Language Pack for Visual Studio Code 支持中文语言
  • datapack helper plus (JSON) 支持JSON语法补全，高亮等
  • language-mcfunction 支持mcfunction语法和高亮
  • mcfunction 支持mcfunction语法和高亮
    
• Notepad++ 可从mcfunction的语言样式和自动补全帖中下载相关文件并导入，另外请将Notepad++中"设置->首选项->其它->自动检测字符编码"选项关闭。
  

压缩工具 主流的压缩工具有winrar(付费软件)和7-zip(免费软件)，Windows10系统下可以直接打开zip格式文件。Minecraft可以识别文件夹格式或zip格式的资源包和数据包。

nbt工具 推荐使用nbtexplorer来打开.dat和其它nbt格式文件。

§1.3 文件类型
我们简要介绍下将接触的文件类型，本段中不做详解，仅做眼熟用。为便于查看文件后缀，请将文件->文件夹选项->查看->隐藏已知文件类型的扩展名选项去掉勾选。其中前三者为纯文本文件，可通过新建文本文件然后修改后缀来创建，使用文本编辑器打开和编辑。

• .json 进度、战利品表、标签、模型、语言文件均为该格式。
• .mcmeta 格式与json相同，仅用于记录资源包和数据包的信息(版本和描述)。
• .mcfunction 即函数文件，每一行都是一条单独的可执行的指令。
• .nbt和.mca 使用nbt查看器打开，打开后为树状结构。世界生成、玩家、结构、地图等信息均为nbt格式，区块为mca格式。
• .zip 右键选择使用压缩工具打开，通常是资源包和数据包。
• .jar 右键选择使用压缩工具打开，通常是minecraft或mod本体。下面是快照18w31a的游戏本体jar文件的文件内容。
  

                               
登录/注册后可看大图

§1.4 文件结构
打开.minecraft所在的文件夹，这通常位于你的启动器目录下。如果启动器中设置为各版本独立，则类似的文件结构位于versions/版本号下。

• assets minecraft的资源文件。可在此找到所有游戏内文本的key和翻译，之后便可通过加载资源包来修改。打开 indexes中对应的JSON文件，查找zh_cn对应的hash值，然后在objects中找到相应文件，用文本编辑软件打开即可看到相应的文本。
• versions/resourcepacks 资源包文件夹，每个子文件夹或zip对应一个资源包。
• versions/screenshots 游戏截图。
• versions/logs 日志信息。可打开latest.log来查看加载资源包和数据包时的错误信息，包括错误的文件名称、位置、错误的行列数等，这对于我们开发原版模组是十分重要的。
• versions/options.txt 游戏设置，诸如音量、视距等。
  
  
                                 
  登录/注册后可看大图
• versions/saves 地图存档，我们从展示共享版下载的地图一般就是放入该文件夹。
• versions/saves/advancements 玩家的进度和完成时间。
• versions/saves/playerdata 玩家的属性等内容，可修改玩家的位置、复活点、飞行速度等内容。
• versions/saves/stats 玩家的统计信息。
• versions/saves/data 地图、记分板、村庄等内容。idcounts.dat记录了当前已使用的地图数量，修改后新打开的空地图会以此开始计数，这可以避免模组自定义的地图被玩家无意修改。map_数字.dat即相应的地图信息。scoreboard.dat记录了记分板、记分板的值、组。其它的文件记录了相应结构(村庄、要塞、废弃矿井)的信息。
• versions/saves/datapacks 数据包文件夹，每个子文件夹或zip对应一个资源包。
• versions/saves/DIM1、DIM-1、region 末地、下界和主世界的区块信息。.mca文件可用nbtexplorer打开并修改相应的区块内容，但是极为不便。建议使用mcedit等工具来编辑。
• versions/saves/level.dat 世界信息，包含了种子、生成类型、难度、出生点、世界边界、游戏规则等内容。
• versions/saves/generated 手动保存的结构，保存后将其移动至数据包内方可使用。
  
  
                                 
  登录/注册后可看大图
  
  

362487237

66666666666666666

ruhuasiyu

SolidBlock 发表于 2019-8-25 14:09
JSON文件包括一对根括号{}，包含类似 "abc":"def" (键:值)的对。相同的键后者会覆盖前者。键总是为字符串， ...

有的，战利品表中就会用到等我有空修改下

SolidBlock

JSON文件包括一对根括号{}，包含类似 "abc":"def" (键:值)的对。相同的键后者会覆盖前者。键总是为字符串，值可以为
字节数据(byte) 例如 OnGround:0b，NoGravity:1b 等。虽然范围为-128~127，但通常仅表示真假，即只有1b和0b。
你这里是不是错了，我记得你说的这是nbt的，json没有那么多种数字，字符串的引号也不可以省

SolidBlock

作者辛苦了，我已经收藏。另外如果可以的话你也可以将此内容投到mcwiki或者B站

亿岁

厉害厉害，不服不行

fengmc

五体不懂，告辞

lizhiawa

貌似从中学到了什么

POPchannel

6666666666

miaomiaom

ghutgututui

玖尾狐

厉害大佬大佬

木瓜mugua

感谢大佬  

1478700172

召唤阵v手机为难我你忘记

良心不会停

非常感谢楼主！！！！

天宇_qwq

表示一脸懵逼

3079686894

哇哇哇学到了~~~