Edytujesz Modele bloków

Wszystkie pliki modeli i wariantów są rozszerzenia <code>.json</code>. Modele [[Blok|bloków]] są wykorzystywane w celu przedstawienia wszystkich bloków w grze, podczas gdy modele [[Przedmioty|przedmiotów]] są używane do wyświetlania elementów w ręce [[Gracz|gracza]], na głowie ([[Hełm|hełmy]] i czapki), na ziemi i w [[Ekwipunek|ekwipunku]]. Dlatego nawet ikony używane w ekwipunku są określone w tych plikach.

== Warianty ==
Istnieje kilka różnych wariantów niektórych bloków, więc każdy blok posiada własny plik wariantu, który zawiera wszystkie swoje warianty i łączy je do odpowiedniego modelu. Pliki te są przechowywane w folderze <code>assets/minecraft/blockstates</code>. Nie należy zmieniać nazwy tych plików lub samych wariantów. Są one zakodowane w grze i również muszą być używane w [[Paczki zasobów|paczkach zasobów]].

<div class="treeview">
* {{nbt|compound}} Tag korzenia
** {{nbt|compound|variants:}} Mieści nazwy wszystkich wariantów bloku. 
*** {{nbt|compound|A variant:}} Nazwa wariantu, która składa się z odpowiednich ''BlockStates'' oddzielonych przecinkami. Blok z tylko jednym wariantem używa <code>normal</code> jako nazwy dla swojego wariantu. Każdy wariant zawiera właściwości swojego modelu. Jeśli stosuje się więcej niż jeden model, modele te muszą być określone w oddzielnych {{nbt|compound}}-tagach, które są potrzebne dla znacznika wariantu.
**** {{nbt|compound|A model:}} Zawiera właściwości modelu, jeśli więcej niż jeden jest wykorzystywany dla tego samego wariantu. Wszystkie określone modele występują naprzemiennie w grze.
***** {{nbt|string|model:}} Określa ścieżkę do pliku modelu bloku, począwszy od <code>assets/minecraft/models/blocks</code>. 
***** {{nbt|int|x:}} Obrót modelu na osi x, w odstępach co 90°.
***** {{nbt|int|y:}} Obrót modelu na osi y, w odstępach co 90°.
***** {{nbt|byte|uvlock:}} Obraca teksturę z blokiem, jeśli jest <code>false</code> (domyślnie).
***** {{nbt|int|weight:}} Prawdopodobieństwo użycia modelu w grze. Domyślną wartością jest 1 (=100%).
**** {{nbt|string|model:}} Określa ścieżkę do pliku modelu bloku, począwszy od <code>assets/minecraft/models/blocks</code>.
**** {{nbt|int|x:}} Obrót modelu na osi x, w odstępach co 90°.
**** {{nbt|int|y:}} Obrót modelu na osi y, w odstępach co 90.°
**** {{nbt|byte|uvlock:}} Obraca teksturę z blokiem, jeśli jest <code>false</code> (domyślnie).
</div>

=== Przykład: Pochodnia ===
[[Pochodnia]] posiada kilka wariantów: Może być umieszczona na ziemi lub na ścianie i być skierowana w cztery różne strony. Ten przykład pochodzi z pliku <code>torch.json</code>, który można znaleźć w <code>assets/minecraft/blockstates</code>.

<pre>
File: torch.json

{
    "variants": {
        "facing=up": { "model": "normal_torch" },
        "facing=east": { "model": "normal_torch_wall" },
        "facing=south": { "model": "normal_torch_wall", "y": 90 },
        "facing=west": { "model": "normal_torch_wall", "y": 180 },
        "facing=north": { "model": "normal_torch_wall", "y": 270 }
    }
}
</pre>

<code>"facing=up"</code> jest wariantem pochodni stojącym na ziemi i łączy się z modelem <code>"normal_torch"</code>. Pochodnia może być też postawiona na wszystkich czterech ścianach bloku, więc potrzebuje czterech różnych wariantów, jeden dla każdej strony. Nazywają się one <code>"facing=east"</code>, <code>"facing=west"</code>, <code>"facing=south"</code> i <code>"facing=north"</code>. Wszystkie 4 warianty używają <code>"normal_torch_wall"</code> jako ich modelu, który jest obracany o wielokrotność 90°, aby dostosować się do różnych stron bloku, na którym stoją.

=== Przykład: Blok trawy ===

[[Blok trawy]] posiada 2 warianty, przy czym jeden z nich przechowuje 4 modele. Ten przykład pochodzi z pliku <code>grass.json</code>, który znajduje się w <code>assets/minecraft/blockstates</code>.

<pre>
File: grass.json

{
    "variants": {
        "snowy=false": [
            { "model": "grass_normal" },
            { "model": "grass_normal", "y": 90 },
            { "model": "grass_normal", "y": 180 },
            { "model": "grass_normal", "y": 270 }
        ],
        "snowy=true":  { "model": "grass_snowed" }
    }
}
</pre>

Nieośnieżony blok trawy (<code>snowy=false</code>) przechowuje 4 modele, które korzystają z tego samego modelu bloku, lecz każdy z nich jest obrócony o wielokrotność 90°. Mimo iż istnieją 4 modele, <code>count</code>-tag nie jest używany przez żaden z nich, więc każdy ma szansę 25%, aby zostać wykorzystanym podczas postawienia bloku.

== Modele bloków ==

Folder <code>assets/minecraft/models/block</code> posiada pliki modeli dla wszystkich wymienionych wariantów. Nazwy plików mogą być zmienione, ale zawsze muszą odpowiadać nazwom używanym w plikach wariantów.

<div class="treeview">
* {{nbt|compound}} Tag korzenia
** {{nbt|string|parent:}} Ładuje inny model z danej ścieżki, począwszy od <code>assets/minecraft/models</code>.
** {{nbt|byte|ambientocclusion:}} Czy użyć okluzji otoczenia (<code>true</code> - domyślne), czy nie (<code>false</code>).
** {{nbt|compound|textures:}} Przechowuje tekstury modelu. Każda tekstura zaczyna się w <code>assets/minecraft/textures</code> lub może być inną zmienną tekstury.
*** {{nbt|string|particle:}} Z jakiej tektury ładować cząsteczki?
*** {{nbt|string|A texture variable:}} Definiuje zmienną teksury i zatwierdza ją.
** {{nbt|compound|elements:}} Zawiera wszystkie elementy modelu. Mogą mieć formę wyłącznie sześcienną.
*** {{nbt|compound|An element}}
**** {{nbt|list|from:}} Punkt początkowy sześcianu wg schematu <code>[x, y, z]</code>. Wartości muszą być pomiędzy -16 a 32.
**** {{nbt|list|to:}} Punkt końcowy sześcianu wg schematu <code>[x, y, z]</code>. Wartości muszą być pomiędzy -16 a 32.
**** {{nbt|compound|rotation:}} Określa obrót elementu.
***** {{nbt|list|origin:}} Ustawia środek obrotu wg schematu <code>[x, y, z]</code> (domyślnie <code>[8, 8, 8]</code>).
***** {{nbt|string|axis:}} Określa kierunek obrotu, może być <code>"x"</code>, <code>"y"</code> lub <code>"z"</code>.
***** {{nbt|int|angle:}} Określa kąt obrotu. Może być od 45° do -45° w wielokrotnościach po 22.5° (domyślnie 0°).
***** {{nbt|byte|rescale:}} Określa, czy skalować boki w całym bloku. Może być <code>true</code> lub <code>false</code> (domyślnie <code>false</code>).
**** {{nbt|byte|shade:}} Określa, czy cienie są renderowane (<code>true</code> - default), czy nie (<code>false</code>).
**** {{nbt|compound|faces:}} Przechowuje wszystkie boki sześcianu. Jeśli bok jest pominięty, to nie zostanie wyrenderowany.
***** {{nbt|compound|down, up, north, south, west or east:}} Zawiera właściwości określonych boków.
****** {{nbt|list|uv:}} Określa powierzchnię tekstury do użycia wg schematu <code>[x1, y1, x2, y2]</code>.
****** {{nbt|string|texture:}} Określa teksturę w formie zmiennej tekstury poprzedzanej przez <code>#</code>.
****** {{nbt|string|cullface:}} Określa, czy bok nie musi być renderowany, gdy jakiś blok dotyka go w wyznaczonej pozycji. Pozycje mogą być: <code>down</code>, <code>up</code>, <code>north</code>, <code>south</code>, <code>west</code>, albo <code>east</code>.
****** {{nbt|int|rotation:}} Obraca teksturę w wielokrotnościach po 90°.
****** {{nbt|list|tintindex:}} Określa, czy odcieniować teksturę za pomocą zakodowanego indeksu odcieni. Domyślnie nie używa odcienia, a każdy numer powoduje jego użycie. Pamiętaj, że tylko niektóre bloki mają indeks odcieni, wszystkie inne zostaną nietknięte.
</div>

=== Przykład: Stojąca pochodnia ===
Dla ułatwienia ten przykład pokazuje tylko stojącą [[Pochodnia|pochodnię]], która jest opisana w plikach <code>torch.json</code> i <code>normal_torch.json</code> przechowywanych w folderze <code>assets/minecraft/models/block</code>. 

<pre>
File: torch.json

{
    "ambientocclusion": false,
    "textures": {
        "particle": "#torch"
    },
    "elements": [
        {   "from": [ 7, 0, 7 ],
            "to": [ 9, 10, 9 ],
            "shade": false,
            "faces": {
                "down": { "uv": [ 7, 13, 9, 15 ], "texture": "#torch" },
                "up":   { "uv": [ 7,  6, 9,  8 ], "texture": "#torch" }
            }
        },
        {   "from": [ 7, 0, 0 ],
            "to": [ 9, 16, 16 ],
            "shade": false,
            "faces": {
                "west": { "uv": [ 0, 0, 16, 16 ], "texture": "#torch" },
                "east": { "uv": [ 0, 0, 16, 16 ], "texture": "#torch" }
            }
        },
        {   "from": [ 0, 0, 7 ],
            "to": [ 16, 16, 9 ],
            "shade": false,
            "faces": {
                "north": { "uv": [ 0, 0, 16, 16 ], "texture": "#torch" },
                "south": { "uv": [ 0, 0, 16, 16 ], "texture": "#torch" }
            }
        }
    ]
}
</pre>

Ten plik jest używany do tworzenia modelu pochodni, który używany jest przez zwykłą i [[Czerwona pochodnia|czerwoną]] pochodnię. Dlatego <code>elements</code>-tag jest używany do tworzenia trzech elementów lub sześcianów. Tylko 2 boki każdego sześcianu są renderowane, bo tylko 2 z nich zostały określone. <code>"uv"</code> jest stosowany do określenia obszaru, gdzie tekstura ma być używana. Zmienna tekstury <code>"#torch"</code> jest używana dla cząsteczek i sześcianów. Nie została jeszcze zdefiniowana.

<pre>
File: normal_torch.json

{
    "parent": "block/torch",
    "textures": {
        "torch": "blocks/torch_on"
    }
}
</pre>

Ten plik reprezentuje model normalnej stojącej pochodni. Ładuje on model poprzednio opisanej stojącej pochodni z pomocą <code>"parent"</code> i dziedziczy wszystkie właściwości pliku <code>torch.json</code>. Ponieważ ten plik jest używany tylko dla zwykłej pochodni, tekstura może być teraz określona. Tekstura <code>"torch_on"</code> jest teraz przypisana do zmiennej tekstury <code>"torch"</code> (bez <code>#</code>), zatem będzie używana dla poprzednio załadowanego modelu i jego cząsteczek, jak określono w drugim pliku.

=== Przykład: Każdy blok ===

Ten przykład opisuje fundamentalną strukturę większości normalnych bloków w [[Minecraft|Minecrafcie]]. Te bloki używają tego samego podstawowego modelu i stosują do niego tylko swoją teksturę, jak już opisano w przykładzie powyżej. Ten model znajduje się w pliku <code>cube.json</code>, który jest w folderze <code>assets/minecraft/models/block</code>.
<pre>
File: cube.json

{
    "elements": [
        {   "from": [ 0, 0, 0 ],
            "to": [ 16, 16, 16 ],
            "faces": {
                "down":  { "texture": "#down", "cullface": "down" },
                "up":    { "texture": "#up", "cullface": "up" },
                "north": { "texture": "#north", "cullface": "north" },
                "south": { "texture": "#south", "cullface": "south" },
                "west":  { "texture": "#west", "cullface": "west" },
                "east":  { "texture": "#east", "cullface": "east" }
            }
        }
    ]
}
</pre>

Cechy opisane powyżej nie zostaną ponownie wspomniane. Użycie <code>"cullface": "down"</code> zabezpiecza dolny bok bloku przed wyrenderowaniem, jeśli jakiś inny blok jest pod nim. To samo dzieje się z resztą boków.

=== Przykład: Sadzonka ===

Ten przykład opisuje fundamentalną strukturę używaną przez wszystkie [[Sadzonka|sadzonki]] bez przypisywania konkretnej tekstury. Ten model jest opisany w pliku <code>cross.json</code>, tekstura mogłaby np. zostać przypisana do <code>oak_sapling.json</code>. Oba pliki są przechowywane w folderze <code>assets/minecraft/models/block</code>.

<pre>
File: cross.json

{
    "ambientocclusion": false,
    "textures": {
        "particle": "#cross"
    },
    "elements": [
        {   "from": [ 0.8, 0, 8 ],
            "to": [ 15.2, 16, 8 ],
            "rotation": { "origin": [ 8, 8, 8 ], "axis": "y", "angle": 45, "rescale": true },
            "shade": false,
            "faces": {
                "north": { "uv": [ 0, 0, 16, 16 ], "texture": "#cross" },
                "south": { "uv": [ 0, 0, 16, 16 ], "texture": "#cross" }
            }
        },
        {   "from": [ 8, 0, 0.8 ],
            "to": [ 8, 16, 15.2 ],
            "rotation": { "origin": [ 8, 8, 8 ], "axis": "y", "angle": 45, "rescale": true },
            "shade": false,
            "faces": {
                "west": { "uv": [ 0, 0, 16, 16 ], "texture": "#cross" },
                "east": { "uv": [ 0, 0, 16, 16 ], "texture": "#cross" }
            }
        }
    ]
}
</pre>

Aby stworzyć zwykłego kształtu sadzonkę, oba elementy muszą być obrócone o 45°. Dlatego pochodzenie i oś obrotu są ustawione do określonych wartości, kąt jest ustawiony na 45° i <code>"rescale"</code> jest ustawiony na <code>true</code>. Ten ostatni powoduje, że model jest skalowany na osiach, które nie zostały obrócone tak, że zajmują to samo miejsce jak przed obrotem (zdjęcia poniżej).

{| class="wikitable"
|-
| <code>"rescale": true</code>
| <code>"rescale": false</code>
|-
| [[Plik:BlockModels_rescale_true.png|400px]]
| [[Plik:BlockModels_rescale_false.png|400px]]
|}

== Modele przedmiotów ==

Ponieważ [[Przedmioty|przedmioty]] nie mają różnych wariantów, nie potrzeba ich opisywać. Folder <code>assets/minecraft/models/item</code> zawiera wszystkie pliki modeli. Nazwy plików są zakodowane i nie powinny być zmieniane.

<div class="treeview">
* {{nbt|compound:}} Tag korzenia
** {{nbt|string|parent:}} Ładuje inny model z danej ścieżci, począwszy od <code>assets/minecraft/models</code>. 
*** Może być ustawione na <code>"builtin/generated"</code>, aby używać modelu stworzonego z określonej ikony.
*** Może być ustawione na <code>"builtin/entity"</code>, aby załadoać model z plików bytów. Ponieważ nie można określić bytu, to nie zadziała dla wszystkich przedmiotów (tylko dla [[Skrzynia|skrzyń]], [[Skrzynia Kresu|skrzyń Kresu]], [[Głowa|głów]] i [[Sztandar|sztandarów]]).
*** Musi być ustawione na <code>"builtin/compass"</code> lub <code>"builtin/clock"</code> dla [[Kompas|kompasu]] lub [[Zegarek|zegara]].
** {{nbt|compound|textures:}} Posiada tekstury modelu. Każda tekstura zaczyna się w <code>assets/minecraft/textures</code> lub może być inną zmienną tekstury.
*** {{nbt|string|layer#:}} Używane do określenia ikony przedmiotu w ekwipunku. Może być więcej niż jedna warstwa (np. dla [[Jajo (spawner)|jaj spawnujących]]), ale liczba możliwych warstw jest zakodowana dla każdego przedmiotu. Działa tylko w kombinacji z <code>"builtin/generated"</code>. 
*** {{nbt|string|particle:}} Z jakiej tekstury ładować cząsteczki?
*** {{nbt|compound|A texture variable:}} Określa zmienną tekstury i przypisuje ją.
** {{nbt|compound|elements:}} Zawiera wszystkie elementy modelu. Mogą mieć tylko formę sześcienną.
*** {{nbt|compound|An element}}
**** {{nbt|list|from:}} Punkt początkowy sześcianu wg schematu <code>[x, y, z]</code>. Wartości muszą być między -16 a 32.
**** {{nbt|list|to:}} Punkt końcowy sześcianu wg schematu <code>[x, y, z]</code>. Wartości muszą być między -16 a 32.
**** {{nbt|compound|rotation:}} Określa obrót elementu.
***** {{nbt|list|origin:}} Ustawia środek obrotu wg schematu <code>[x, y, z]</code> (domyślnie <code>[8, 8, 8]</code>).
***** {{nbt|string|axis:}} Określa kierunek obrotu. Może być <code>"x"</code>, <code>"y"</code> lub <code>"z"</code>.
***** {{nbt|int|angle:}} Określa kąt obrotu. Może być od 45° do -45° w wielokrotnościach po 22.5° (domyślnie 0°).
**** {{nbt|compound|faces:}} Przechowuje wszystkie boki sześcianu. Jeśli bok został pominięty, to nie zostanie wyrenderowany.
***** {{nbt|compound|down, up, north, south, west or east:}} Zawiera właściwości określonego boku.
****** {{nbt|list|uv:}} Określa powierzchnię tekstury do użycia wg schematu <code>[x1, y1, x2, y2]</code>.
****** {{nbt|string|textures:}} Określa teksturę w postaci zmiennej tekstury poprzedzonej przez <code>#</code>.
****** {{nbt|byte|cull:}} Określa, czy niewidoczne elementy powinny być renderowane (<code>true</code>), czy nie (<code>false</code>).
****** {{nbt|int|rotation:}} Obraca teksturę w wielokrotnościach po 90°.
** {{nbt|compound|display:}} Określa różne miejsca, gdzie modele przedmiotów są wyświetlane.
*** {{nbt|compound|thirdperson, firstperson, gui or head:}} Miejsce, gdzie model przedmiotu jest wyświetlany. Przechowuje jego obrót, tłumaczenie i skalę dla określonej sytuacji.
**** {{nbt|list|rotation:}} Określa obrót modelu wg schematu <code>[x, y, z]</code>.
**** {{nbt|list|translation:}} Określa tłumaczenie modelu wg schematu <code>[x, y, z]</code>.
**** {{nbt|list|scale:}} Określa skalę modelu wg schematu <code>[x, y, z]</code>.
</div>

=== Przykład: Pochodnia ===

Ten przykład opisuje pochodnię jako [[Przedmioty|przedmiot]]. Model znajduje się w pliku <code>torch.json</code>, który jest w folderze <code>assets/minecraft/models/item</code>.

<pre>
File: torch.json

{
    "parent": "builtin/generated",
    "textures": {
        "layer0": "blocks/torch_on"
    }
    "display": {
        "thirdperson": {
            "rotation": [ -90, 0, 0 ],
            "translation": [ 0, 1, -3 ],
            "scale": [ 0.55, 0.55, 0.55 ]
        },
        "firstperson": {
            "rotation": [ 0, -135, 25 ],
            "translation": [ 0, 4, 2 ],
            "scale": [ 1.7, 1.7, 1.7 ]
        }
    }
}
</pre>

<code>"parent"</code>-tag używa <code>"builtin/generated"</code>, więc gra używa zwykłego modelu pochodni, który został wygenerowany z grafiki 2D używanej dla ikony. Ikona jest określona <code>"layer0"</code>-tagiem i teksturą, która została już użyta dla modelu bloku, jest używana również dla ikony. Ponieważ tylko jedna warstwa jest zakodowana dla pochodni, nie można dodać więcej warstw. Ponadto właściwości ekranu dla pochodni są tak określone, że będzie on wyświetlany poprawnie w każdej możliwej sytuacji. Pochodnia nie może być postawiona na głowie gracza i używa określonej ikony w ekwipunku, więc nie trzeba dostosowywać modelu do tych sytuacji. By dopasować model do ręki gracza w widoku pierwszo- i trzecioosobowym, musi być on odpowiednio obracany, przesuwany i skalowany, co jest robione dla dwóch sytuacji oddzielnie.

== Historia ==

{{historia|r}}
{{historia||1.8|snap=14w06a|Dodano własne modele bloków.}}
{{historia||1.8|snap=14w07a|Przepisano on nowa format modeli. Zamiast posiadania tylko <code>"planes"</code>, ma on teraz <code>"planes"</code> i <code>"cubes"</code>. Obrót obiektów został ograniczony do jednego kierunku obrotu na obiekt w wielokrotnościach po 22.5°.}}
{{historia||1.8|snap=14w11a|Oświetlenie pełnego bloku już nie tworzy środkowej części kompletnie czarnej.}}
{{historia||1.8|snap=14w11b|Zwykłe bloki ładują modele zamiast wcześniej określonych kształtów.}}
{{historia||1.8|snap=April 12, 2014|slink={{reddit|22vu5w/upcoming_changes_to_the_block_model_system}}
|TheMogMiner postuje o nadchodzących zmianach w formacie modeli.}}
{{historia||1.8|snap=14w17a|Przekonwertowano większość pozostałych bloków do formatu modeli.|Dodano <code>"rotateVariantTextures"</code>, aby zapobiec szczegóły "uv" przed obrotem.}}
{{historia||1.8|snap=14w25a
|Usunięto atrybut kierunkowy z definicji "uv" i zamieniono na wyraźne odniesienia tekstur. <code>"textureFacing"</code> został zamieniony z <code>"texture"</code>, który jest poprzedzany krzyżykiem (<code>#</code>).
|<code>"useAmbientOcclusion"</code> zmieniono na <code>"ambientocclusion"</code>
|<code>"rotateVariantTextures"</code> zmieniono na <code>"UV lock"</code>
|<code>"cull"</code> zmieniono na <code>"cullface"</code>, ''specifies the opposite of which neighboring face causes culling to occur''<ref>Problemy z tłumaczeniem.</ref>.
|''Rotation made more verbose, it is now more clear that it can only occur on a single axis.''<ref>Problemy z tłumaczeniem.</ref> Przykład: obrót jednoego z dwóch boków modelu <code>"cross"</code> jest teraz: <code>"rotation": { "origin": [ 8, 8, 8 ], "axis": "y", "angle": 45, "rescale": true },</code>.
|Folder <code>models/blocks/meshes</code> został usunięty, a pliki są teraz przechowywane w <code>models/block</code>.
|Folder <code>blockstates</code> został dodany i przechowuje pliki wyboru modelu poprzednio zlokalizowane w <code>models/block</code>.
|Format modelu wspiera teraz własne modele przedmiotów.}}
{{historia||1.8|snap=14w27a|Zamieniono nazwy ''block state''<ref>Problemy z tłumaczeniem.</ref> z danymi, które lepiej odzwierciedlają dane wewnętrzne. Jeszcze nie odzwierciedla wszystkich danych dla niektórych bloków. Przełączy do rzeczywistych zapisanych danych w przyszłej wersji, gdy numeryczne wartości danych zostaną kompletnie porzucone na korzyść ''block states''<ref>Problemy z tłumaczeniem.</ref>.}}
{{historia||1.8|snap=14w27b|''The block state files now support an array of models allowing for random models.''<ref>Problemy z tłumaczeniem.</ref>}}
{{historia||1.8|snap=14w30a|Dodano model przedmiotów <code>"builtin/entity"</code>.}}
{{historia|pocketa}}
{{historia||0.8.0|Dodano losowy obrót bloków.}}
{{historia|foot}}

== Przypisy ==
<references/>

{{minecraft}}

[[en:Block models]]
[[zh:方块模型]]