imported>Ja17: ko interwiki

2025-09-10T12:06:07Z

ko interwiki

New page

{{documentation header}}
{{lua|Block structure renderer}}
Displays a block structure renderer.

== Usage ==
You need to create a map of a letter to a block state, for example:

<pre>
A=glass
B=chest[facing=east,type=single,waterlogged=true]
C=water[level=0]
</pre>

Each block state must have all of its [[block states|properties]] defined. Missing properties might result in a mismatched model.

Two special characters cannot be overwritten: <code>-</code> represents [[structure void]]; <code>+</code> represents [[air]].

A block structure is defined in the from X to Z to Y. Comma indicates the end of this X row and the beginning of the next X row, meaning an increment of Z. Semicolon <code>;</code> ends the structure at this Y level and starts at (0,0) at the next level, meaning an increment of Y. Here is an example:

<pre>
A+A,+A+,A+A;+++,+B+,+++;+++,+C+,+++
</pre>

The <code>marks</code> parameter can be used to highlight certain blocks in the block structure. You need a coordinate and a color code to define a mark. To mark (x, y, z) with ''color'', write <code>''x'',''y'',''z''#''color''</code>. Separate marks with semicolons <code>;</code>. If there is no blocks to be marked, omit this parameter and the "render marks" checkbox will not appear in the renderer.

<pre>
1,0,1#114514;1,2,1#191981
</pre>

Combining these parts:

<syntaxhighlight lang="wikitext">
{{Block structure renderer
| A=glass
| B=chest[facing=east,type=single,waterlogged=true]
| C=water[level=0]
| A+A,+A+,A+A;+++,+B+,+++;+++,+C+,+++
| marks=1,0,1#114514;1,2,1#191981
}}
</syntaxhighlight>

{{Block structure renderer
| A=glass
| B=chest[facing=east,type=single,waterlogged=true]
| C=water[level=0]
| A+A,+A+,A+A;+++,+B+,+++;+++,+C+,+++
| marks=1,0,1#114514;1,2,1#191981
}}

Check browser's console warnings and errors to fix the errors in the parameters when applicable.

You can assign default values for the renderer's settings:
* <code>camera</code>: Sets the initial position and rotation of the camera. The format should be <code>''x'',''y'',''z'';''pitch'',''yaw''</code>, among which ''pitch'' and ''yaw'' are in degrees. The camera's default position is at the south of the structure, and the camera faces the center of the structure.
* <code>orthographic</code>: Whether to use orthographic projection. Can only be <code>true</code> or <code>false</code>. Other values are seen as <code>false</code>.
* <code>animatedtexture</code>: Whether to use animated texture. Can only be <code>true</code> or <code>false</code>. Other values are seen as <code>false</code>.
* <code>showinvisibleblocks</code>: Whether to render invisible blocks. Can only be <code>true</code> or <code>false</code>. Other values are seen as <code>false</code>.
* <code>displaymarks</code>: Whether to render marks. Does not take effect if the <code>marks</code> parameter does not exist. Can only be <code>true</code> or <code>false</code>. Other values are seen as <code>false</code>.
* <code>backgroundcolor</code>: Sets the background color. Defaults to <code>#808080</code>.
* <code>backgroundalpha</code>：Sets the opacity of the background. Defaults to 128.

== Scripts ==
Typically this template is not filled out by hand and is instead generated with a tool.

[https://github.com/Nickid2018/AutoGenerateWikiData/blob/master/tools/convert_structure.py This tool] converts Minecraft's structure files to this template. [https://github.com/maruohon/litematica This tool] is for litematic schematics.

== Limitations ==
Because [[Conduit]], [[End Portal (block)]] and [[End Gateway (block)]] cannot be baked, the renderer cannot render these blocks.

<includeonly>{{sandbox other||

[[ja:テンプレート:Block structure renderer]]
[[ko:틀:Block structure renderer]]
[[pt:Predefinição:Renderizador de estrutura de blocos]]
[[zh:Template:Block structure renderer]]
}}</includeonly>
<noinclude>

[[ja:テンプレート:Block structure renderer/doc]]
[[pt:Predefinição:Renderizador de estrutura de blocos/doc]]
[[zh:Template:Block structure renderer/doc]]
</noinclude>

Template:MC/Block structure renderer/doc - Revision history

imported>Ja17: ko interwiki