Generation von Blockmodellen

Ein Leitfaden zur Generierung von Blockmodellen und Blockzuständen mit dem Datengenerator.

WARNING

Diese Seite ist für die Version 1.21.10 geschrieben. Dokumentationen für ältere Versionen sind möglicherweise unvollständig.

VORAUSSETZUNGEN

Stelle sicher, dass du den Prozess der Einrichtung der Datengenerierung zuerst abgeschlossen hast.

Einrichten

Zuerst müssen wir unseren ModelProvider erstellen. Erstelle eine Klasse, welche extends FabricModelProvider. Implementiere beide abstrakten Methoden: generateBlockStateModels und generateItemModels. Zum Schluss, erstelle einen Konstruktor, der zu super passt.

java

No lines matched.

Registriere diese Klasse in deinem DataGeneratorEntrypoint innerhalb der onInitializeDataGenerator-Methode.

Blockzustände und Blockmodelle

java

@Override
public void generateBlockStateModels(BlockStateModelGenerator blockStateModelGenerator) {
}

Für Blockmodelle werden wir uns hauptsächlich auf die generateBlockStateModels-Methode fokusieren. Beachte den Parameter BlockStateModelGenerator blockStateModelGenerator - dieses Objekt wird für die Generierung aller JSON-Dateien verantwortlich sein. Hier sind einige praktische Beispiele, die du zur Generierung deiner gewünschten Modelle verwenden kannst:

Einfacher Cube All

java

No lines matched.

Dies ist die am häufigsten verwendete Funktion. Sie generiert eine JSON-Modell-Datei für ein normales cube_all Blockmodell. Eine Textur wird für alle sechs Seiten genutzt, in diesem Fall nutzen wir steel_block.

json

{
  "parent": "minecraft:block/cube_all",
  "textures": {
    "all": "example-mod:block/steel_block"
  }
}

Sie generiert auch eine Blockzustand-JSON-Datei. Da wir keine Blockzustand-Eigenschaften (z. B. Achsen, Ausrichtung, ...) haben, ist eine Variante ausreichend und wird jedes Mal verwendet, wenn der Block platziert wird.

json

{
  "variants": {
    "": {
      "model": "example-mod:block/steel_block"
    }
  }
}

Download 'Stahlblock'

Singletons

Die registerSingleton-Methode liefert JSON-Modelldateien basierend auf dem übergebenen TexturedModel und einer einzelnen Blockzustand-Variante.

java

No lines matched.

Diese Methode wird Modelle für einen normalen Würfel generieren, der die Texturdatei pipe_block für die Seiten und die Texturdatei pipe_block_top für die obere und untere Seite nutzt.

json

{
  "parent": "minecraft:block/cube_column",
  "textures": {
    "end": "example-mod:block/pipe_block_top",
    "side": "example-mod:block/pipe_block"
  }
}

TIP

Wenn du dich nicht entscheiden kannst, welches TextureModel du verwenden sollst, öffne die Klasse TexturedModel und sieh dir die TextureMaps an!

Download 'Rohrblock'

Block-Textur-Pool

java

No lines matched.

Eine andere nützliche Methode ist registerCubeAllModelTexturePool: Definiere die Texturen, indem du den "Basisblock" übergibst, und füge dann die "Kinder" hinzu, die die gleichen Texturen haben. In diesem Fall haben wir den RUBY_BLOCK übergeben, so dass die Treppe, die Stufe und der Zaun die Textur RUBY_BLOCK verwenden werden.

WARNING

Sie wird auch ein einfaches Cube All JSON-Modell für den "Basisblock" generieren, um sicherzustellen, dass er ein Blockmodell hat.

Sei dir dessen bewusst, wenn du das Blockmodell dieses bestimmten Blocks änderst, da dies zu einem Fehler führen wird.

Du kannst auch eine BlockFamily anhängen, die Modelle für alle ihre "Kinder" generieren wird.

java

No lines matched.

java

No lines matched.

Download 'Rubinblock'

Türen und Falltüren

java

No lines matched.

Türen und Falltüren sein ein wenig anders. Hier musst du drei neue Texturen erstellen - zwei für die Türe, und eine für die Falltüre.

Die Tür:

Sie hat zwei Teile - die obere und die untere Hälfte. Jede benötigt ihre eigene Textur: In diesem Fall ruby_door_top für die obere und ruby_door_bottom für die untere Hälfte.
Die Methode registerDoor() wird Modelle für alle Ausrichtungen der Tür, sowohl offen als auch geschlossen erstellen.
Du benötigst auch eine Itemtextur! Lege sie in dem Ordner assets/example-mod/textures/item/ ab.

Die Falltür:

Hier benötigst du nur eine Textur, die in diesem Fall ruby_trapdoor heißt. Diese wird für alle Seiten genutzt.
Da TrapdoorBlock eine Eigenschaft FACING hat, kannst du die auskommentierte Methode verwenden, um Modell-Dateien mit rotierten Texturen zu generieren = Die Falltüre wird "orientierbar" sein. Andernfalls sieht sie immer gleich aus, egal in welche Richtung sie gerichtet ist.

Download 'Rubintür und Falltür'

Benutzerdefinierte Blockklasse

In diesem Abschnitt werden wir die Modelle für eine vertikale Eichenstammstufe, mit einer Eichenstamm-Textur, erstellen.

Punkte 2. - 6. werden in einer inneren, statischen Hilfsklasse namens CustomBlockStateModelGenerator deklariert.

Benutzerdefinierte Blockmodelle

Erstelle einen Block VerticalSlab mit einer Eigenschaft FACING und einer boolean-Eigenschaft SINGLE, wie in dem Tutorial Block States beschrieben. SINGLE zeigt an, ob beide Stufen sind. Dann solltest du getOutlineShape und getCollisionShape überschreiben, so dass die Umrandung korrekt gerendert wird und der Block die richtige Kollisionsform hat.

java

No lines matched.

java

No lines matched.

Überschreibe auch die Methode canReplace(), sonst kannst du die Stufe nicht zu einem vollen Block machen.

java

No lines matched.

Und du bist fertig! Du kannst jetzt den Block austesten und im Spiel platzieren.

Übergeordnetes Blockmodell

Lasst und jetzt ein übergeordnetes Blockmodell erstellen. Es bestimmt die Größe, Position in der Hand oder in anderen Slots und die x und y Koordinaten der Textur. Es wird empfohlen für dies einen Editor, wie Blockbench zu verwenden, da die manuelle Erstellung ein wirklich mühsamer Prozess ist. Es sollte wie folgt aussehen:

json

{
  "parent": "minecraft:block/block",
  "textures": {
    "particle": "#side"
  },
  "display": {
    "gui": {
      "rotation": [
        30,
        -135,
        0
      ],
      "translation": [
        -1.5,
        0.75,
        0
      ],
      "scale": [
        0.625,
        0.625,
        0.625
      ]
    },
    "firstperson_righthand": {
      "rotation": [
        0,
        -45,
        0
      ],
      "translation": [
        0,
        2,
        0
      ],
      "scale": [
        0.375,
        0.375,
        0.375
      ]
    },
    "firstperson_lefthand": {
      "rotation": [
        0,
        315,
        0
      ],
      "translation": [
        0,
        2,
        0
      ],
      "scale": [
        0.375,
        0.375,
        0.375
      ]
    },
    "thirdperson_righthand": {
      "rotation": [
        75,
        -45,
        0
      ],
      "translation": [
        0,
        0,
        2
      ],
      "scale": [
        0.375,
        0.375,
        0.375
      ]
    },
    "thirdperson_lefthand": {
      "rotation": [
        75,
        315,
        0
      ],
      "translation": [
        0,
        0,
        2
      ],
      "scale": [
        0.375,
        0.375,
        0.375
      ]
    }
  },
  "elements": [
    {
      "from": [
        0,
        0,
        0
      ],
      "to": [
        16,
        16,
        8
      ],
      "faces": {
        "down": {
          "uv": [
            0,
            8,
            16,
            16
          ],
          "texture": "#bottom",
          "cullface": "down",
          "tintindex": 0
        },
        "up": {
          "uv": [
            0,
            0,
            16,
            8
          ],
          "texture": "#top",
          "cullface": "up",
          "tintindex": 0
        },
        "north": {
          "uv": [
            0,
            0,
            16,
            16
          ],
          "texture": "#side",
          "cullface": "north",
          "tintindex": 0
        },
        "south": {
          "uv": [
            0,
            0,
            16,
            16
          ],
          "texture": "#side",
          "tintindex": 0
        },
        "west": {
          "uv": [
            0,
            0,
            8,
            16
          ],
          "texture": "#side",
          "cullface": "west",
          "tintindex": 0
        },
        "east": {
          "uv": [
            8,
            0,
            16,
            16
          ],
          "texture": "#side",
          "cullface": "east",
          "tintindex": 0
        }
      }
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174

Für weitere Informationen, siehe dir an wie Blockzustände formatiert sind. Beachte die Schlüsselwörter #bottom, #top, #side. Sie dienen als Variablen, die von Modellen gesetzt werden können, die dieses Modell als übergeordnetes Modell haben:

json

{
  "parent": "minecraft:block/cube_bottom_top",
  "textures": {
    "bottom": "minecraft:block/sandstone_bottom",
    "side": "minecraft:block/sandstone",
    "top": "minecraft:block/sandstone_top"
  }
}

Der Wert bottom wird den Platzhalter #bottom ersetzen und so weiter. Füge es in den Ordner resources/assets/example-mod/models/block/ ein.

Benutzerdefiniertes Modell

Eine weitere Sache, die wir benötigen, ist eine Instanz der Klasse Model. Sie wird das tatsächliche übergeordnete Blockmodell in unserem Mod repräsentieren.

java

No lines matched.

Die Methode block() erstellt ein neues Model, das auf die Datei vertical_slab.json in unserem Ordner resources/assets/example-mod/models/block/ zeigt. Die TextureKeys repräsentieren die "Platzhalter" (#bottom, #top, ...) als ein Objekt.

Die Texture Map verwenden

Was macht die TextureMap? Sie liefert die Identifikatoren, die auf die Textur verweisen. Technisch gesehen verhält sie sich wie eine normale Map - man verbindet einen TextureKey (Schlüssel) mit einem ResourceLocation (Wert).

Du kannst entweder die von Vanilla verwenden, wie TextureMap.all() (die alle TextureKeys mit dem selben Identifikator verknüpft), oder eine neue erstellen, indem du eine neue Instanz erstellst und dann .put() aufrufst, um die Schlüssel mit Werten zu verknüpfen.

TIP

TextureMap.all() verknüpft alle TextureKeys mit dem selben Identifikator, egal wie viele es davon gibt!

Da wir die Eichenstammtexturen nutzen wollen, aber die BOTTOM, TOP und SIDE TextureKeys haben, müssen wir eine neue erstellen.

java

No lines matched.

Die bottom und top Flächen werden oak_log_top.png verwenden, die Seiten werden oak_log.png verwenden.

WARNING

Alle TextureKeys in deiner TextureMap müssen mit den TextureKeys in deinem übergeordneten Blockmodell übereinstimmen!

Benutzerdefinierte `BlockStateSupplier`-Methode

Der BlockStateSupplier beinhaltet alle Varianten an Blockzuständen, deren Rotation und anderen Optionen, wie uvlock.

java

No lines matched.

Zuerst erstellen wir einen neuen VariantsBlockStateSupplier mit Hilfe von VariantsBlockStateSupplier.create(). Dann erstellen wir eine neue BlockStateVariantMap, die Parameter für alle Varianten des Blocks beinhaltet, in diesem Fall FACING und SINGLE und übergeben diese in den VariantsBlockStateSupplier. Gebe an, welches Modell und welche Transformation (uvlock, rotation) bei der Verwendung von .register() genutzt wird. Zum Beispiel:

In der ersten Zeile, zeigt der Block nach Norden und ist einzeln => Wir verwenden das Modell ohne Rotation.
In der vierten Zeile, zeigt der Block nach Westen und ist einzeln => Wir rotieren das Modell auf der Y-Achse für 270°.
In der sechsten Zeile, zeigt der Block nach Osten, ist jedoch nicht einzeln => Er sieht aus wie ein normaler Eichenstamm => Wie müssen ihn nicht rotieren.

Benutzerdefinierte Methode für den Datengenerator

Der letzte Schritt - die Erstellung der tatsächlichen Methode, die du aufrufen kannst und die die JSONs generiert. Aber für was sind die Parameter?

BlockStateModelGenerator generator, das gleiche, dass wir an generateBlockStateModels übergeben haben.
Block vertSlabBlock ist der Block, zu dem wir die JSONs generieren werden.
Block fullBlock - ist das Modell, dass genutzt wird, wenn die Eigenschaft SINGLE false ist = der Stufenblock sieht wie ein voller Block aus.
TextureMap textures definiert die tatsächlichen Texturen, die das Modell nutzt. Siehe das Kapitel Die Texture Map nutzen verwenden.

java

No lines matched.

Zunächst erhalten wir den ResourceLocation des einzelnen Stufenmodell mit VERTICAL_SLAB.upload(). Dann erhalten wir den ResourceLocation des vollen Blockmodells mit ModelIds.getBlockModelId(), und übergeben diese beiden Modelle an createVerticalSlabBlockStates. Der BlockStateSupplier wird an den blockStateCollector übergeben, so dass die JSON-Dateien tatsächlich generiert werden. Außerdem, erstellen wir ein Modell für das Item der vertikalen Stufe mit BlockStateModelGenerator.registerParentedItemModel().

Und dies ist alles! Jetzt müssen wir nur noch unsere Methode in unserem ModelProvider aufrufen:

java

No lines matched.

Quellen und Links

Du kannst für weitere Informationen die Beispieltests in der Fabric API und im Referenz-Mod dieser Dokumentation ansehen.

Du kannst auch weitere Beispiele für die Verwendung von benutzerdefinierten Methoden für den Datengenerator finden, indem du den Open-Source-Code von Mods durchsuchst, zum Beispiel Vanilla+ Blocks und Vanilla+ Verticals von Fellteros.

Creating Your First Item

Block Entities

GUIs und Oberflächen

Partikel

Client Resources

Server Resources

Migrating Mappings

Seitenautoren

Referenzierte Dateien

Seitenautoren

Generation von Blockmodellen

Einrichten

Blockzustände und Blockmodelle

Einfacher Cube All

Singletons

Block-Textur-Pool

Türen und Falltüren

Benutzerdefinierte Blockklasse

Benutzerdefinierte Blockmodelle

Übergeordnetes Blockmodell

Benutzerdefiniertes Modell

Die Texture Map verwenden

Benutzerdefinierte `BlockStateSupplier`-Methode

Benutzerdefinierte Methode für den Datengenerator

Quellen und Links

Seitenautoren

Referenzierte Dateien

Seitenautoren

Generation von Blockmodellen ​

Einrichten ​

Blockzustände und Blockmodelle ​

Einfacher Cube All ​

Singletons ​

Block-Textur-Pool ​

Türen und Falltüren ​

Benutzerdefinierte Blockklasse ​

Benutzerdefinierte Blockmodelle ​

Übergeordnetes Blockmodell ​

Benutzerdefiniertes Modell ​

Die Texture Map verwenden ​

Benutzerdefinierte BlockStateSupplier-Methode ​

Benutzerdefinierte Methode für den Datengenerator ​

Quellen und Links ​

Generation von Blockmodellen

Einrichten

Blockzustände und Blockmodelle

Einfacher Cube All

Singletons

Block-Textur-Pool

Türen und Falltüren

Benutzerdefinierte Blockklasse

Benutzerdefinierte Blockmodelle

Übergeordnetes Blockmodell

Benutzerdefiniertes Modell

Die Texture Map verwenden

Benutzerdefinierte `BlockStateSupplier`-Methode

Benutzerdefinierte Methode für den Datengenerator

Quellen und Links