Minecraft(我的世界)中文论坛

标题: [1.14-1.6] Block2Json —— 化块为模 | 快速制作Json模型
作者: ⭐✔️    时间: 2018-2-13 11:08
标题: [1.14-1.6] Block2Json —— 化块为模 | 快速制作Json模型
本帖最后由 贰逼 于 2019-7-24 16:58 编辑


Block2Json是一款能将方块文件(包括.schematic和.nbt)转化为Json模型文件(.json)的转化工具。
  • 目前版本：R0.1.6 (2019-7-24)
  • 支持版本：1.6~1.14.4

原项目是Schematic2Json。
本项目是其完全重制版，优化了过程、使资源文件外置为json且可自定义、增加了压缩等转化、并且开始支持.nbt文件、最大的更新是将版本升级至了1.13。项目已开源：https://github.com/tremblestarman/Block2Json/wiki

你有没有想过将建筑结构转化为Json模型呢？Block2Json给了你这个机会.

图片欣赏
填补方块与Json模型的代沟？
Schematic2Json是Block2Json的前身，开发目的是鉴于国内外圈子中对像.schematic一类的方块文件（区块文件、结构文件）处理的软件非常多，相且当成熟，但对于Json模型这个被应用于模组和材质包的模型处理软件或者插件相对来说少的不利情况。
少的原因，有以下三点：
  • 第一是Json模型结构，对于外行人来讲呢可能Json模型的结构就是一道坎了。（如果你非常希望入Json模型制作的坑，推荐[Wiki-模型]，然后再就是论坛内的关于Json模型的教程。这个和学任何东西一样，需要时间慢慢，就熟练了）
  • 其二作为模型文件，和主流模型关联少。而Json模型不同于传统模型，不是以点、线、三角面构成的，而是以长方体元素组成的，因此和传统模型基本上没有任何联系了，所以现在没有能直接将传统模型转化为Json模型的捷径。
  • 第三是有模型，就有处理模型的工具。但目前功能完善的开发工具也比较少，也少有人在此领域开发，促成了目前比较尴尬的局面。
   
将方块像素和Json模型结合起来，才能弥补以上短板。首先是想借对于方块、像素之间的沟通，以及目前对方块已经十分完备的开发处理，弥补对Json模型开发的缺憾。当然还重要的是简化Json模型的制作过程，这也是Block2Json的最根本的开发目的。
说了这么多，一句话概括就是想蹭方块像素的热度，"解放"建模的双手。

当然有了Block2Json并不是一劳永逸的，毕竟Json模型与方块还是两个概念，Json有很多特性仅靠方块的排列堆砌也无法展现。因此Block2Json也仅仅只是残次的替代品，不是偷天换日，也并不能称得上完全替代建模的双手。

更多的信息见上方目录，点击目录文字进行跳转
下载地址
更新记录


Block2Json不只是作为一款“一键式”的转化器，其中也内置了许多非常有用的功能。

在【详解】的子目录中，我将以处理流程顺序展开，详细介绍像“命令行”、“资源文件”这些可设定的部分，其中难免涉及到一些原理。
处理流程，可分为以下几个子过程：

这些过程中的可设定环节，参见上方目录。

名词释义
在接下来的详解中，可能会涉及到一些有歧义，有多义，或者新定义的名词。
在这里列举，以免混淆。如果在后面的内容中遇到了这些名词，你可以在此处随时查找释义。
(有关于Json模型的名词遵照【Wiki-模型 - 方块模型】的官方翻译)

表达式
有许多地方需要用到不同的表达式，包括指令、引用、设参等。
在这里详解所有可能用到的表达式的格式及其解释。



读取资源
每次运行程序后，首先进行的是读取资源。这个过程在输入命令之前。
资源文件存在于外部文件夹中，包括./BlockInfos、./ModelInfos、./BlockTags、./BiomeList。

你可以在程序运行前，对资源文件增加、修改、删除。
资源文件使用的是Json格式，[Block2Json-Wiki]中对其中的Json标签有详解。

资源文件是高度可自定义的，在本项的子目录中，我将详细介绍如何自定义这些资源文件。
ModelInfo - 元素模型信息
首先介绍元素模型信息，是因为它是最基本的信息，而且也是目前结构、内容最复杂的信息文件。
在Block2Json的架构中，联通方块文件与Json模型的桥梁就是每个方块元素的模型，因此方块信息文件(BlockInfo.json)需要对元素模型信息进行引用以定义一个方块元素的模型。
在经过识别、匹配等过程后，通过元素模型信息最终能够生成方块元素模型。

[Block2Json-Wiki-ModelInfos]中详解了标签结构和意义。当然本篇不止于此，还将用例子的形式进一步解释，教你玩转元素模型信息。
详解
这是Half.json，也是自带的最基本的模型。
  1. {
  2.         "Enums": [{
  3.                 "Conditions": [{
  4.                         "Params": "Default"
  5.                 }],
  6.                 "Elements": [{
  7.                         "from": [
  8.                                 "-$sx",
  9.                                 "-0.5",
  10.                                 "-$sz"
  11.                         ],
  12.                         "to": [
  13.                                 "$sx",
  14.                                 "-0.5+$sy",
  15.                                 "$sz"
  16.                         ],
  17.                         "Texture": "A"
  18.                 }]
  19.         }, {
  20.                 "Conditions": [{
  21.                         "Params": "Bottom"
  22.                 }],
  23.                 "Elements": [{
  24.                         "from": [
  25.                                 "-$sx",
  26.                                 "-0.5",
  27.                                 "-$sz"
  28.                         ],
  29.                         "to": [
  30.                                 "$sx",
  31.                                 "-0.5+$sy",
  32.                                 "$sz"
  33.                         ],
  34.                         "Texture": "A"
  35.                 }]
  36.         }, {
  37.                 "Conditions": [{
  38.                         "Params": "Top"
  39.                 }],
  40.                 "Elements": [{
  41.                         "from": [
  42.                                 "-$sx",
  43.                                 "0.5-$sy",
  44.                                 "-$sz"
  45.                         ],
  46.                         "to": [
  47.                                 "$sx",
  48.                                 "0.5",
  49.                                 "$sz"
  50.                         ],
  51.                         "Texture": "A"
  52.                 }]
  53.         }]
  54. }
复制代码
对于这个文件，结合Wiki，我们首先来理解一下其中的结构。
  • Enums
    是一个列表，储存了所有模型枚举(An Enum)。

    之所以被称为模型枚举，是因为匹配它还是需要条件的，这便是Conditions。
    模型枚举可以拥有一系列模型枚举元素(An Element)，储存在了Elements。
    一个例子(通用结构)：
    1. {
    2.     "Enums": [{
    3.             "Conditions": [{...}],
    4.             "Elements": [{...}]
    5.         },{
    6.             "Conditions": [{...}],
    7.             "Elements": [{...}]
    8.         },{
    9.             "Conditions": [{...}],
    10.             "Elements": [{...}]
    11.         }....
    12.     ]
    13. }
    复制代码
  • Conditions
    是一个列表，储存了所有条件(A Condition)。
    这些条件对应的是方块信息中"Model"下的内容。
    这些条件包括
    • Params：是一个字符串。用于匹配的参数。
    • A RelativeBlock：是复合标签。用于匹配相对(模型所在的方块元素)位置的方块。使用的是方块集合表达式
    一个例子(ModelInfos/Connect-Fence.json中的部分)：
    1. "Conditions": [{
    2.     "Params": "Bottom",
    3.     "RelativeBlocks": {
    4.         "Connect-Fence.json":
    5.         {
    6.             "X": 1,
    7.             "Y": 0,
    8.             "Z": 0
    9.         }
    10.     }
    11. }]
    复制代码
    "Params"将匹配参数设为了"Bottom"，也就是说匹配"Model"下对应参数为"Bottom"的方块信息；
    "RelativeBlocks"匹配的是相对方块元素位置在(1,0,0)，类比命令方块的命令(~1 ~ ~)，是否存在于方块标签Connect-Fence.json中。由于使用的是使用的是方块集合表达式，所以也可以支持单独定义，例如前面举到的例子：
    1. G.json;1[0];stone[1];minecraft:oak_trapdoor[facing=north,half=bottom,open=false]
    复制代码
    解释一下匹配的时期，其实并非发生在读取资源时。
    因为涉及到了对方块元素的操作，所以匹配实际发生在生成模型时。

    强调一点，最后匹配的结果是模型枚举(An Enum)，而且可以是多个，最后一起成为方块元素模型。
  • Elements
    是一个列表，储存了一个模型枚举下的所有模型枚举元素。
    一个模型枚举元素有以下属性
    • from：三个坐标运算表达式，定义模型枚举元素的起点。
    • to：三个坐标运算表达式，定义模型枚举元素的终点。
    • Texture：继承材质名。
    一个例子(ModelInfos/Half.json中的部分)：
    1. "Elements": [{
    2.     "from": [
    3.         "-$sx",
    4.         "0.5-$sy",
    5.         "-$sz"
    6.     ],
    7.     "to": [
    8.         "$sx",
    9.         "0.5",
    10.         "$sz"
    11.         ],
    12.     "Texture": "A"
    13. }]
    复制代码
    "from"和"to"在【表达式】中解释已经非常清楚了，如果还有不理解可以看下方[关于from,to的解释]。
    "Texture"是继承方块信息中"Model"下的"Textures"中定义的一个"Texture"。一个模型枚举元素只有一个"Texture"。

  • 结构的进一步理解
    枚举列表(Enums)是一个仓库，里面有一堆箱子，一个箱子就是模型枚举(An Enum)。
    箱子里装着的东西是一系列模型枚举元素(An Element)，都在模型枚举元素列表(Elements)中。
    条件列表(Conditions)是每个箱子的锁，而方块信息中"Model"下的内容则是钥匙。

    定义一把钥匙，匹配的是一把锁。

    当我们访问一个方块元素的方块信息中的"Model"时，我们相当于在仓库(Enums)中用这把钥匙去试里面一组箱子，如果能打开这个箱子(An Enum)，那么就取这个箱子中的内容(Elements)作为方块元素的模型。
    如果一把钥匙能开多个箱子，则这些箱子的内容(Elements)都可以作为方块元素的模型。
  • 关于from,to的解释
    from,to的原理和Json模型中一样，通过两个点确定一个长方体，这个长方体就是一个模型枚举元素。
    [Json模型教程-方块模型-from,to]的解释已经足矣了，这边我图解一下：

    红    黄两个点定义了即可表示一个长方体。而from和to就分别记录了这两个点的坐标。

    那么如何结合坐标表达式呢？下面是个例子：
    (ModelInfos/Half.json中的"Bottom"部分)
    1. "Elements": [{
    2.     "from": [
    3.         "-$sx",
    4.         "-0.5",
    5.         "-$sz"
    6.     ],
    7.     "to": [
    8.         "$sx",
    9.         "-0.5+$sy",
    10.         "$sz"
    11.     ],
    12.     "Texture": "A"
    13. }]
    复制代码

    首先，相对坐标系的原点在立方体元素中心：

    我们定义的from和to的坐标分别为：
    1. (-$sx,-0.5,-$sz)    ($sx,-0.5+$sy,$sz)
    复制代码
    "$sx"、"$sy"和"$sz"继承了方块信息的"Size"，以Size:{X:0.3,Y:1,Z:0.3}为例，代换后的坐标即：
    1. (-0.3,-0.5,-0.3)    (0.3,-0.5+1,0.3)
    复制代码
    然后这个元素模型就成为了如下所示：

    这些坐标都是相对于中心原点而言的（即蓝点）。
    我们发现即使"$sx"、"$sy"和"$sz"在变化，坐标也只能按照我们所定义的表达式对应唯一的值，铵一定规律变化，所以我们也可以把坐标表达式理解为自变量为Size(X,Y,Z)的函数。

    所以如果你要制作一个自定义的模型枚举元素，你需要对你所构建的元素进行提炼归纳，得出通用的表达式，这是一个难点。
    当然，如果不被Size影响，表达式中也可以省略掉"$sx"、"$sy"和"$sz"。
  • 多模型枚举元素的组合
    为什么每个模型枚举可包含多个模型枚举元素呢？
    这是为了让一个模型枚举能够对应一组模型枚举元素，而非仅仅一个（可以理解为对应多个长方体）。
    这样，便让一个方块元素能够拥有更复杂的模型。

    下面是个例子：
    (这是一个随便举的例子)
    1. "Elements": [{
    2.     "from": [
    3.         "-$sx",
    4.         "-$sz",
    5.         "0.5-$sy"
    6.     ],
    7.     "to": [
    8.         "$sx",
    9.         "$sz",
    10.         "0.5+$sy"
    11.     ],
    12.     "Texture": "A"
    13.     },{
    14.     "from": [
    15.         "-$sx",
    16.         "-$sz",
    17.         "-0.5"
    18.     ],
    19.     "to": [
    20.         "$sx",
    21.         "$sz",
    22.         "-0.5+$sy"
    23.     ],
    24.     "Texture": "A"
    25. }]
    复制代码
    在"Elements"下存在多个"Element"，最终可以表达一个复杂的方块元素模型，如果继承Size:{X:0.3,Y:0.5,Z:0.3}，则如图所示：

    关于这个模型的构造就不做过多解释了。
    然而当结合条件(Conditions)后，枚举的效率就太低了。
    纯靠对每种情况的枚举，我们需要将各种情况对应的枚举元素排列组合，如何解决这种弊端呢？
    别忘了方块元素模型最终是取所有符合条件的模型枚举，不只是一个。
    我们可以利用这个特点实现模型在不同条件下的部分枚举。

    下面是个例子：
    (ModelInfos/Connect-Fence.json，文件很长，只选取关键部分)
    1. {
    2.         "Enums": [{
    3.                 "Conditions": [{
    4.                         "Params": "Default"
    5.                 }],
    6.                 "Elements": [{
    7.                         ...
    8.                 }]
    9.         }, {
    10.                 "Conditions": [{
    11.                         "Params": "Bottom"
    12.                 }],
    13.                 "Elements": [{
    14.                         ...
    15.                 }]
    16.         }, {
    17.                 "Conditions": [{
    18.                         "Params": "Bottom",
    19.                         "RelativeBlocks": {
    20.                                 "Connect-Fence.json": {
    21.                                         "X": 1,
    22.                                         "Y": 0,
    23.                                         "Z": 0
    24.                                 }
    25.                         }
    26.                 }],
    27.                 "Elements": [{
    28.                         ...
    29.                 }]
    30.         }, {
    31.                 "Conditions": [{
    32.                         "Params": "Bottom",
    33.                         "RelativeBlocks": {
    34.                                 "Connect-Fence.json": {
    35.                                         "X": -1,
    36.                                         "Y": 0,
    37.                                         "Z": 0
    38.                                 }
    39.                         }
    40.                 }],
    41.                 "Elements": [{
    42.                         ...
    43.                 }]
    44.         },...
    45. ]}
    复制代码
    Connect-Fence.json的模型信息用于栅栏。我们希望当这个方块元素(栅栏)旁边有能够连接的方块，它的模型能够发生变化。
    (下面的图示都以继承Size:{X:0.2,Y:0.8,Z:0.2}为例)
    • 主体枚举部分：栅栏的中心柱
      Params:"Default"是默认的模型枚举，表示如果没有参数设定，默认就取这个枚举。设置这个项是为了避免发生错误。
      Params:"Bottom"所表示的是仅当参数为Bottom时才能取到。
      它们表示的中心柱：
    • 部分枚举部分：栅栏的连接部分
      在下面的枚举中，我们改变了"RelativeBlocks"。
      通过枚举能够连接的方块(Connect-Fence.json标签下的所有方块)的不同坐标(相对坐标)，构成部分枚举。
      如图所示，如果所有部分枚举都符合各自的条件：

    如果所有美剧都符合条件，包括了一开始主体枚举部分：

    本质上部分枚举使枚举更加灵活。


BlockInfo - 方块元素信息
方块元素信息，是对方块的定义集。读取方块文件后借由这些定义生成对应的方块元素。
定义包括方块的基本信息(Id、Data)，大小(Size)，模型(Model)，以及信息所适用的版本。

[Block2Json-Wiki-BlockInfos]介绍了BlockInfo.json的基本结构和意义。
详解
Block2Json所内置的BlockInfo.json的内容都很多，不便于举出，这里直接进入结构的分析。
我们以小见大，先从一个方块信息变种(A BlockInfo)开始分析：
  • 全部标签

    • VersionFrom
    • VersionTo
    • Id
    • Data
    • Size
    • Model
  • 方块信息变种的理解与VersionFrom、VersionTo
    方块信息的变种，顾名思义是一个方块信息的不同形式。
    这里的变种，并不是指同一个方块Id，不同的方块Data，而是指不同版本的不同信息。
    随着Minecraft的更新，不同版本中的同种方块都可能有所改变（一个例子便是1.13技术更新）。
    改变的可能是材质路径、方块名称、方块数据、增加或删除了变种等等...

    方块信息的变种储存了不同版本范围内的不同信息，而这里的"VersionFrom"、"VersionTo"就是用于定义这个版本范围。
    • VersionFrom：所适用的起始版本。0表示-∞。
    • VersionTo：所适用的截止版本。0表示+∞。
    范围最终为：
    1. VersionFrom≤CurrentVersion(目标版本)＜VersionTo
    复制代码
    例如：
    1. "VersionFrom": 0, "VersionTo": 1.13
    复制代码
    表示1.13以前（包括1.12、1.11、1.10…）

    你可以通过[cmd命令-version]设置CurrentVersion(目标版本)。
  • Id和Data

    • Id：方块的Id，需要加上命名空间，如"minecraft:"。
    • Data：方块的数据值，若值为"x"或"null"表示匹配时可以忽略数据值。多个Data用','隔开，外部不需要方括号。
    Id和Data只是用于匹配，首先是匹配到其所在的方块信息变种，在通过目标版本进一步匹配对应的方块信息。

    例如：
    1. "Id": "foo", "Data": "foo=1,fooo=blablabla",
    复制代码
    Id需要符合方块文件中的标准，例如要严格遵循.nbt文件中方块名称。
    Data可以是数字（1.13之前），也可以是States形式（1.13之后）。

    总之你需要保证Id和Data能够被匹配得到。
  • Size
    用于定义方块元素模型的大小，代入坐标运算表达式。
    包含了三个量：
    • X
    • Y
    • Z
    传参给模型信息文件(ModelInfo.json)，分别被坐标运算表达式中的"$sx"、"$sy"和"$sz"继承，用于生成方块元素模型。
  • Model
    定义设定方块元素模型的相关参数，用于匹配和设定方块元素模型。
    • Name：模型信息文件(ModelInfo.json)的名称。例如"Half.json"
    • Params：传递的参数。例如"Bottom"。
    • Textures：传递的所有材质信息。是材质(A Texture)的集合。材质(A Texture)包含了以下信息：

      • Path：材质的路径。
      • Params：材质的参数。目前只有ColorMap。具体用法在【生成模型-材质获取】。
      举个例子：
      (BlockInfos/Slab.json的部分)
      1. "Model": {
      2.         "Name": "Half.json",
      3.         "Params": "Bottom",
      4.         "Textures": {
      5.                 "A": {
      6.                         "Path": "blocks/stone_slab_top"
      7.                 }
      8.         }
      9. }
      复制代码
      关键解释一下材质(A Texture)是怎么定义的。
      前面的"A"就是这个材质的名字。

      你会在模型信息文件(ModelInfo.json)看到一个模型枚举元素中有"Texture": "A"，表示这个模型枚举元素选择了材质"A"。

    正如在【ModelInfo - 元素模型信息】的介绍，Model中的内容主要用于传递给模型信息，生成方块元素模型。


接下来我们来解释一个方块信息变种(A BlockInfo)外部的结构：
  1. [
  2.     [
  3.         {
  4.             A BlockInfo
  5.         }, {
  6.             A BlockInfo
  7.         },...
  8.     ]
  9. ]
复制代码
基本架构中有一个嵌套列表，外层表示的是方块信息集(A Block Class)，内层表示的是方块信息变种集(A BlockInfo List)。
在[Block2Json-Wiki-BlockInfos]中有笼统的解释，这里我详细解释一下：
  • 方块信息集(A Block Class)：方块信息变种集的父集，储存的是所有方块信息变种集。
  • 方块信息变种集(A BlockInfo List)：方块信息的变种集，储存的是多个方块信息变种。
总体来讲这个嵌套列表整合并分类了所有方块信息变种(A BlockInfo)，是匹配中方块信息变种(A BlockInfo)的基本条件。

从涵义上讲
  • 方块信息集(A Block Class)就是匹配池
  • 方块信息变种集(A BlockInfo List)代表的就是一个方块
  • 方块信息变种(A BlockInfo)才是一个方块在一个版本范围内的所具有的方块信息

BlockTag - 方块标签
方块标签，是一组方块的集合，其意义类似于Minecraft1.13中更新的datapacks的tags。
设置方块标签目的是为了简化对方块重复的枚举过程。

方块标签用于很多地方，像滤器、模型信息等。
如果以单个方块做大量的枚举，效率低而且工程量巨大，方块标签是一个很好的简化方式。

[Block2Json-Wiki-BlockTags]介绍了BlockTag.json的基本结构和意义。
详解
增添与移除 Plus & Minus
增添，同"datapacks的tags"；而移除，是优于目前"tags"的功能。
再次说明BlockTags所代表的是一组方块的集合
  • 增添(Plus)：向方块标签中添加一个或一组方块。
  • 移除(Minus)：从方块标签中移除一个或一组方块（只有当方块存在于标签时）。
基本结构：
  1. {
  2.     "Plus": [
  3.         ...
  4.     ],
  5.     "Minus": [
  6.         ...
  7.     ]
  8. }
复制代码
结构非常清晰了，下面以一个例子展开来讲：
  1. {
  2.     "Plus": [
  3.         "1",
  4.         "2",
  5.         "3",
  6.         "4",
  7.         "5",
  8.         "A/abc.json"
  9.     ]
  10.     "Minus": null
  11. }
复制代码
在方块标签中，使用的格式类似于方块集合表达式，只不过是以json的写法。
例如在上面的例子中我们在方块标签中不仅添加了Id为1~5的方块，还继承了A文件夹下的方块标签abc.json中的全部方块。
注："Plus"允许继承别的标签，但不能继承自身。
其中"Minus"留空，或者填null，都代表没有需要移除的方块。

"Minus"的效果等同于删去"Plus"中与自己的交集，最后方块标签中所表示的方块为?[sub]Plus[/sub](Plus∩Minus)。
  1. {
  2.     "Plus": [
  3.         "1",
  4.         "2",
  5.         "3",
  6.         "4",
  7.         "5"
  8.     ],
  9.     "Minus": [
  10.         "5",
  11.         "6",
  12.         "7",
  13.         "8",
  14.         "9"
  15.     ]
  16. }
复制代码
最终方块标签中表示的方块为1~4。

当然"Minus"中也允许继承：
  1. {
  2.     "Plus": [
  3.         "All.json"
  4.     ],
  5.     "Minus": [
  6.         "Full-Block.json"
  7.     ]
  8. }
复制代码
这个方块标签中表示的是所有不属于方块标签Full-Block.json中的所有方块。
为什么是“所有”呢？因为All.json所表示的是所有存在于./BlocksInfos文件夹中的方块信息，是自动生成的。
那么方块标签就介绍完了。如果你不懂方块集合表达式？请在【详解-表达式】中查询。

BiomeList - 生物群系列表
生物群系列表中定义的是生物群系。
一个生物群系的特性主要包括降水(Rainfall)和温度(Temperature)

生物群系主要控制的是使用ColorMap材质的uv(例如./BlockInfo/ColorMap.json中的方块)，可以通过biome命令设置。

关于生物群系详细解释：[Wiki-生物群系]
关于生物群系列表的结构和标签：[Block2Json-Wiki-BiomeList]

这里就不做详解了，一个例子大家都能看懂：
  1. {
  2.         "Ocean": {
  3.                 "Temperature": 0.5,
  4.                 "Rainfall": 0.5
  5.         },
  6.         "Plains": {
  7.                 "Temperature": 0.8,
  8.                 "Rainfall": 0.4
  9.         },
  10.         "Desert": {
  11.                 "Temperature": 2.0,
  12.                 "Rainfall": 0.0
  13.         },
  14.         "ExtremeHills": {
  15.                 "Temperature": 0.2,
  16.                 "Rainfall": 0.3
  17.         }...
  18. }
复制代码
需要说明的是生物群系列表只是一个文件，即./BiomeList/Biome.json，读取资源时只会从这个文件读取生物群系信息。
如果想修改或添加生物群系，你只能修改这个文件。
读取方块文件
读取资源后，便是输入命令行了。命令行在[Block2Json-Wiki-CommandLine]或者本帖的【命令行】有详解，这里不做多余的解释了。
接下来，就是解析方块文件，将其中的方块提取出来，匹配方块信息，生成方块组。

在这一步骤中，命令行中的滤器会发挥作用。
滤器
滤器用于过滤所指定的方块，有两种滤器：这两个滤器的具体作用，详见[Block2Json-Wiki-CommandLine-filter_classes]、[Block2Json-Wiki-CommandLine-filter_blocks]或者本帖的【命令行】。
简单来说，过滤掉的对象都不会出现在最后生成的模型中。
生成模型
在读取方块文件后得到了方块组，依靠方块组最终生成Json模型。

在这一步中，有很多关键的操作，包括材质获取(uv)、二次处理(hollow、fillflow)、压缩以及最终调整大小。
下面将讲解具体的过程。
材质获取
材质获取的主要过程就是对./textures下的材质获取像素uv。

二次处理
二次处理是对方块组的进一步处理，目前包括hollow(镂空实心物体)和fillflow(液体填充)。
二次操作的弊端
二次操作中将方块元素视作立方体元素处理，因此无法顾及方块模型最终大小不是(1*1*1)的方块元素。
就如同上面的hollow中，岩浆对应模型并非完整方块，出现了缝隙；
fillflow中，活板门并非完整方块，但液体填充时并没有溢出到外部。
另外，fillflow过程在hollow之后。
压缩
想让你的模型更小，让模型在游戏中资源消耗越少，必然涉及到这一环节。
目前有三种压缩的方法。

调整大小
Json模型最大为32*32*32(单位1表示一个1/16的像素)，
也就是最大为2*2*2(单位1表示一个方块)。
这一步是调整Json模型大小至这个范围。

unlimit将控制这个环节，其意义在[Block2Json-Wiki-CommandLine-unlimit]或本帖的【命令行】已经交代了，我不再赘述了。

举个例子，若想将Json模型的大小控制在1格方块内，那么方块文件大小不得超过16*16*16。
日志与忽略错误
命令行命令log（详见[Block2Json-Wiki-CommandLine-log]或本帖的【命令行】），启用日志输出。这个日志不会包括所有处理过程信息，只是包括其中涉及到的错误信息（包括读取方块未识别，材质路径错误等等）。

命令行命令nopause（详见[Block2Json-Wiki-CommandLine-nopause]或本帖的【命令行】），启用跳过所有错误信息。某些错误是会导致程序中断的，nopause将跳过这些中断，并在生成模型后直接关闭程序。
命令行命令



◎ version=

『用于定义模型所适用的版本』



ep:

  1. version=1.122
复制代码

将模型版本设置为1.122（即Minecraft Jave Edition 1.12.2）  

- 材质、方块的更新，让模型无法兼容不同的版本
- 不同版本的模型往往出现材质缺失的问题，即元素表现为紫黑材质
- 通过定义［BlockInfo］中的VersionFrom和VersionTo，分析［texture］中的材质，解决不同版本的兼容问题
= 版本格式：小数


◎ unlimit

『不限制模型大小』

ep:

  1. unlimit
复制代码

启用后，模型大小不会被程序缩至2^3

- 即便启用，模型导入后仍将被游戏自动缩至2^3
- 对于大小在2^3内的模型（即原方块文件的长宽高在32^3内）无效
= 不启用将省去导入时游戏缩放模型的过程，提升模型的导入速度  


◎ nocompress

『不对模型进行压缩』



ep:

  1. nocompress
复制代码

启用后，跳过压缩过程，模型将保留原始的文件大小

- 压缩的原理是删除元素中的重合面
= 压缩是压缩模型文件大小，并降低导入模型后在游戏内的资源消耗  


◎ surface

『仅保留表面』

ep:

  1. surface
复制代码

启用后，删除所有不可见面，仅保留表面

- 对模型进一步压缩，尤其是对空心的物体
- 处理时间很长
= 基于模型的面处理，十分精准  


◎ hollow

『镂空实心物体内部』



ep:

  1. hollow
复制代码

启用后，镂空实心物体内部。

- 将方块元素作为立方体元素处理
= 会在一定程度上增加模型的大小  


◎ fillflow

『液体填充』



ep:

  1. fillflow=(7,7,7)35[1]
复制代码

在坐标(7,7,7)生成液体流，液体浸没的区域被填充为橙色羊毛

- 将方块元素作为立方体元素处理
- 加上前缀'r'进行反向填充处理
= 一般可以用r(0,0,0)air快速删去不可见面（前提启用compress）  


◎ smooth

『使用平滑材质』



ep:

  1. smooth
复制代码

启用后，同种方块将使用统一的材质

- 主要控制元素的uv，让材质平滑
- 不启用时，元素的uv是随机的，让材质有噪点  


◎ nopause

『不暂停』

ep:

  1. nopause
复制代码

忽略所有错误导致的暂停，并自动退出


◎ log

『生成日志文件』

ep:

  1. log
复制代码

收集所有错误信息，在程序执行结束后生成一个日志文件


◎ biome=

『用于定义模型所在的生物群系』



ep:

  1. biome=TheVoid
复制代码

将模型生物群系设为The Void

- 使用colormap材质的模型，在不同生物群系下颜色不同
- 通过设定［BlockInfo］中Textures的Params，设置相关参数
= 生物群系名称格式：首字母大写&无空格  


● filter_classes=

『过滤所选的模型类型』



ep:

  1. filter_classes=Building.json;Liquid.json
复制代码

- 将所选的［BlockInfo］从资源列表中过滤掉
- 模型中不会出现所选的［BlockInfo］中所有定义的元素
= 滤器格式：  

  1. BlockInfo.json; ...
复制代码

(.json不可省略、用;分隔不同的［BlockInfo］)


● filter_blocks=

『过滤所选的模型类型』



ep:

  1. filter_classes=Full-Block.json;1[0];stone[1];minecraft:oak_trapdoor[facing=north,half=bottom,open=false]
复制代码

- 将所选的［Block］从资源列表中过滤掉
- 模型中不会出现所选的［Block］中所对应的元素
= 滤器格式  (即方块集合表达式)：  

  1. BlockTag.json;Id[Data]; ...
复制代码

(.json不可省略且表示［BlockInfo］、用;分隔不同的［Block］、Id和Data既支持数字也支持字符串)
FAQ-常见问题及解答
问答
Q:Block2Json转化的模型能否作为资源包模型？
A:这要视情况而定。你可能会质疑在上面所有展示过的模型大小，都在数M甚至数十M。
其实上面的展示都是演示的模型，长宽高所占的区域逾百万格，包含的方块也超过十万个，可以说精度相当高了。

经过压缩，这些模型也可以有一个可观的大小。例如首页展示的武装直升机，结构大小为227*80*234，最终模型大小为8M。
一般来讲，制作普通的武器、工具或物品的模型，结构大小在16*16*16或者32*32*32已足矣，最终模型大小仅在1~2M或者数百K。

所以对于展示级别的模型，大小的确有些大（30M~50M）；但用于资源包中的不要求高精度的模型，是完全能够承载的。
Q:如何将模型压缩到最小？
A:在【压缩】中有过详解，在这里我不免需要再唠叨一句。
对于一般地实心结构，默认压缩即可；
对于存在空心结构，精度高但耗时长的方法是启用surface，精度低但耗时短的方法是使用fillflow=r(0,0,0)air。
Q:如何反馈问题
A:在本帖回复即可。
最起码的要求是提供原方块文件(.schematic或.nbt)，因为它大小仅为数k到数百k，方便上传。
最好配上截图，和问题的描述，有条件的话提供一下问题模型，能够方便我调试。

相关链接
方块处理软件插件，有很多，例如：
Mcedit-Unified（Mcedit2的.schematic格式目前不支持）
WorldEdit模组
WorldPainter
[Wiki-辅助程序与编辑器-地图工具]
当然还有很多，上面列举的只是典型。
接下来是模型处理软件，能够对Json模型处理：
CubikStudio（只能用于查看Block2Json的模型）
[Wiki-辅助程序与编辑器-3D建模工具]

展示所用的方块文件下载：
方块文件资源链接（其中大部分来源于www.minecraft-schematics.com）

相关Wiki链接：
https://minecraft-zh.gamepedia.com/模型
https://minecraft-zh.gamepedia.com/生物群系[groupid=546]Command Block Logic[/groupid]
作者: ROF    时间: 2018-2-13 11:14
dalao诈尸了
抢个前排
MC建筑转为json？强势
顶一个
作者: KonpakuYoumu_    时间: 2018-2-13 11:39
Json……太强了 支持
作者: leavessoft    时间: 2018-2-13 12:05
这太厉害了……json
作者: zjxx    时间: 2018-2-13 12:25
哇诈尸贰逼！滋滋
作者: ⊙v⊙    时间: 2018-2-13 12:32
本帖最后由 ⊙v⊙ 于 2018-2-12 18:36 编辑

6哦...时泪白梅
这次的json贴图还是用方块原本的贴图吗好像在目录里看到了答案...
作者: ⭐✔️    时间: 2018-2-13 12:35
⊙v⊙ 发表于 2018-2-13 12:32
6哦...时泪白梅
这次的json贴图还是用方块原本的贴图吗

默认引用的就是原版材质路径
当然你也可以自定义，详见【BlockInfo】
作者: MCxxx不一般    时间: 2018-2-22 11:15
emmm，nb啊兄dei
作者: volta薯片~    时间: 2018-2-25 01:08
哇塞找到神器一枚
作者: bhyzgzz    时间: 2018-5-19 10:33
适用于MI吗
作者: ⭐✔️    时间: 2018-9-30 20:41
bhyzgzz 发表于 2018-5-19 10:33
适用于MI吗

Mi是什么
作者: bhyzgzz    时间: 2018-10-3 16:31
贰逼 发表于 2018-9-30 20:41
Mi是什么

Mine-imator
作者: ⭐✔️    时间: 2018-10-3 20:46
bhyzgzz 发表于 2018-10-3 16:31
Mine-imator

我没接触过Mi，不过在游戏内能被正常读取的json模型应该是可以被Mi读取的把
作者: bhyzgzz    时间: 2018-10-5 08:29
贰逼 发表于 2018-10-3 20:46
我没接触过Mi，不过在游戏内能被正常读取的json模型应该是可以被Mi读取的把 ...

好Der，我去试试
作者: SIZ    时间: 2018-11-15 13:16
作者，导出的json模型在CubikStudio里看不到材质呢，材质的文件夹我拖出来了，点击右边的元素后也看的到材质，但是主界面就是不显示材质，连块都看不到
作者: ⭐✔️    时间: 2018-11-15 23:21
SIZ 发表于 2018-11-15 13:16
作者，导出的json模型在CubikStudio里看不到材质呢，材质的文件夹我拖出来了，点击右边的元素后也看的到材 ...

Cubik难以支持其他非Cubik制作的模型
cubik导出的文件包括材质划分很细，json文件中还有特殊格式作为标记

建议使用B2J前使用类似Mcedit等的方块编辑器，不建议生成模型后利用模型处理软件处理模型
作者: SIZ    时间: 2018-11-17 13:43
贰逼 发表于 2018-11-15 23:21
Cubik难以支持其他非Cubik制作的模型
cubik导出的文件包括材质划分很细，json文件中还有特殊格式作为标记 ...

嗯好的，那如果我是用您的软件制作武器模型，那么json中的display信息（拿在手中的位置，地上的位置等）都只能凭感觉配置了吗，还是说有什么讲究？
作者: ⭐✔️    时间: 2018-11-17 20:47
SIZ 发表于 2018-11-17 13:43
嗯好的，那如果我是用您的软件制作武器模型，那么json中的display信息（拿在手中的位置，地上的位置等） ...

https://minecraft-zh.gamepedia.com/模型#物品模型
看display标签，对模型显示位置作出调整
作者: SIZ    时间: 2018-11-17 22:40
贰逼 发表于 2018-11-17 20:47
https://minecraft-zh.gamepedia.com/模型#物品模型
看display标签，对模型显示位置作出调整 ...

好的，谢谢，我这就去试试
作者: 1252782752    时间: 2018-11-26 00:13
为什么我打不开啊，总是说没找到文件
作者: ⭐✔️    时间: 2018-11-26 22:19
1252782752 发表于 2018-11-26 00:13
为什么我打不开啊，总是说没找到文件

不介意的话发下截图
作者: Plants-Stars    时间: 2018-12-21 20:08
命令行具体怎么使用？....



作者: ⭐✔️    时间: 2018-12-21 22:53
Plant-star 发表于 2018-12-21 20:08
命令行具体怎么使用？....

[file]表示文件路径
例如要转化"c:\1.schematic"
那么就是
  1. c:\1.schematic version=1.13
复制代码


为得到这个文件路径，可以将文件拖入控制台窗口
作者: Plants-Stars    时间: 2018-12-23 09:50
为什么和想象中的不一样.....

我觉得您应该弄个方向选项....





作者: ⭐✔️    时间: 2018-12-23 11:55
本帖最后由 贰逼 于 2018-12-23 12:16 编辑
Plant-star 发表于 2018-12-23 09:50
为什么和想象中的不一样.....
我觉得您应该弄个方向选项....

这个问题我也知道，但是毕竟基于B2J，靠参数设置显示方式很复杂，包括使用3D显示方式，也违背了我开发一键式软件的宗旨。
display的问题也是许多用户反映的问题，刚才尝试了一下用BlockBench(因为Cubik我在楼上说了亲测无效)
解决方法如下：去BlockBench官网下载BlockBench
进入BlockBench导入模型，也许会提示需要载入一个资源包，直接无视选“OK”


接下来在左边的检视窗口全选模型的Cube，右键，把材质设为空白("Blank")

来到上方的显示("Display")视窗，对模型显示进行调整

一开始它会是这样的：

调整参数让它正常：

同样，可以把这些参数应用到左手：

接下来切换到第一人称：

调整过后：

你甚至可以来点好玩的，比如头部：


调整完成后直接导出，不要替换掉原来的模型：

点开新的模型文件，找到display这一段，复制：

将其粘贴到源模型：

然后可以把导出的新模型删掉了，别忘了保存修改后的源模型。

导入到游戏内：


(如果想要修改第一人称物品栏中的材质，不需要再修改模型了，只需要替换textures中的材质)

之所以不用导出的新模型新模型首先是因为导出的模型没有材质，再就是blockbench导出后的模型打乱了B2J的元素顺序，破坏了压缩结构，模型大小成倍增长。
同时需要注意BlockBench不太适合超大的模型，除非内存过硬。
作者: Plants-Stars    时间: 2018-12-23 14:00
贰逼 发表于 2018-12-23 11:55
这个问题我也知道，但是毕竟基于B2J，靠参数设置显示方式很复杂，包括使用3D显示方式，也违背了我开发一键 ...

有几点没看明白，比如怎么导入模型，怎么调到第一人称，还有物品栏中的材质，求大佬解答qwq（我好笨）
作者: ⭐✔️    时间: 2018-12-23 14:29
Plant-star 发表于 2018-12-23 14:00
有几点没看明白，比如怎么导入模型，怎么调到第一人称，还有物品栏中的材质，求大佬解答qwq（我好笨[/ ...

blockbench下载完了以后，凭初中英语水平就可以知道怎样import；调第一人称看我给的图，有个display面板

如果不了解json模型，推荐阅读wiki
作者: Plants-Stars    时间: 2018-12-23 16:27
贰逼 发表于 2018-12-23 14:29
blockbench下载完了以后，凭初中英语水平就可以知道怎样import；调第一人称看我给的图，有个display面板
...

可是导出后我看了看源代码，没有材质代码，不会导出后就空白吧....emmm....
作者: ⭐✔️    时间: 2018-12-23 16:38
Plant-star 发表于 2018-12-23 16:27
可是导出后我看了看源代码，没有材质代码，不会导出后就空白吧....emmm.... ...

导出后只需要display下的属性，不需要材质
作者: Plants-Stars    时间: 2018-12-23 17:51
贰逼 发表于 2018-12-23 16:38
导出后只需要display下的属性，不需要材质

然后就成了这副模样233333



作者: Yusai    时间: 2019-1-17 01:18
可是感觉这样用的模型块好多啊
作者: ⭐✔️    时间: 2019-1-17 22:45
微-葑-破 发表于 2019-1-17 01:18
可是感觉这样用的模型块好多啊

毕竟追求精度的代价
作者: @用户名    时间: 2019-1-28 19:25
mcbbs有你更快乐~~~
作者: 呵呵啊哈额    时间: 2019-2-12 14:47
找这么久 不容易呀！
作者: Nu_ta    时间: 2019-3-19 12:31
这么强啊，之前咋没找到，厉害厉害
作者: 1717ssss    时间: 2019-3-30 20:38
好复杂的样子
作者: ☆娜娜★    时间: 2019-4-13 18:20
谢谢分享
作者: xiezijing123    时间: 2019-4-13 20:29
这个模型能用于MC行为包的生物模型吗？
作者: 活的高    时间: 2019-5-13 01:45
MC建筑怎么转换慰NBT？
作者: 无限生稽    时间: 2019-7-25 17:49
怎么用？              
作者: 大海Sea    时间: 2020-3-26 09:48
生成json之后为什么拖进blockbench里面啥都没有，都是透明的
C:\Users\Administrator\Desktop\1.schematic smooth pause fillflow=r(0,0,0)air
用的这个指令
作者: ⭐✔️    时间: 2020-3-26 10:53
972063175 发表于 2020-3-26 09:48
生成json之后为什么拖进blockbench里面啥都没有，都是透明的
C:%users\Administrator\Desktop\1.schematic  ...

可以看一看json模型里有没有内容
有内容，看官网-快速制作工具，里面详细介绍了如何在blockbench中修改
没内容，说明命令有问题或者bug
作者: 大海Sea    时间: 2020-3-26 13:58
本帖最后由 972063175 于 2020-3-26 14:11 编辑
抖星 发表于 2020-3-26 10:53
可以看一看json模型里有没有内容
有内容，看官网-快速制作工具，里面详细介绍了如何在blockbench中修改
...

有内容，放到游戏里也可以正常显示，但是放blockbench里面做调整的时候所有方块都是透明的，只有点右上角画板模式才可以看到大致的样子，或者编辑模式下左上角-视图-切换线框图，但是这样虽然能看到，在做左右手调整时一保存就会把原来的代码都删了，只留了display
作者: 小楠4786    时间: 2020-3-26 15:55
json是什么呀？？？
作者: ⭐✔️    时间: 2020-3-26 16:58
972063175 发表于 2020-3-26 13:58
有内容，放到游戏里也可以正常显示，但是放blockbench里面做调整的时候所有方块都是透明的，只有点右上角 ...

这是因为Blockbench没关联材质
前面操作正确
保存后需要把新文件的display插入到原文件中
作者: 大海Sea    时间: 2020-3-27 08:12
抖星 发表于 2020-3-26 16:58
这是因为Blockbench没关联材质
前面操作正确
保存后需要把新文件的display插入到原文件中 ...

我把软件里面的材质放到了材质包一份，Bb左下角也显示了材质