<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://wiki.mutigeraffe.com/index.php?action=history&amp;feed=atom&amp;title=BlockyRenderer%3AFAQ</id>
	<title>BlockyRenderer:FAQ - Revision history</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.mutigeraffe.com/index.php?action=history&amp;feed=atom&amp;title=BlockyRenderer%3AFAQ"/>
	<link rel="alternate" type="text/html" href="https://wiki.mutigeraffe.com/index.php?title=BlockyRenderer:FAQ&amp;action=history"/>
	<updated>2026-10-21T01:50:51Z</updated>
	<subtitle>Revision history for this page on the wiki</subtitle>
	<generator>MediaWiki 1.43.11</generator>
	<entry>
		<id>https://wiki.mutigeraffe.com/index.php?title=BlockyRenderer:FAQ&amp;diff=2485&amp;oldid=prev</id>
		<title>Maintenance script: BlockyRenderer wiki</title>
		<link rel="alternate" type="text/html" href="https://wiki.mutigeraffe.com/index.php?title=BlockyRenderer:FAQ&amp;diff=2485&amp;oldid=prev"/>
		<updated>2026-10-20T21:29:21Z</updated>

		<summary type="html">&lt;p&gt;BlockyRenderer wiki&lt;/p&gt;
&lt;p&gt;&lt;b&gt;New page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;== The preview does not open by itself ==&lt;br /&gt;
* Check that &amp;lt;code&amp;gt;blockyRenderer.autoOpenPreview&amp;lt;/code&amp;gt; is &amp;lt;code&amp;gt;true&amp;lt;/code&amp;gt;.&lt;br /&gt;
* The automatic preview opens only once per file. If you closed it, open it again with &amp;lt;code&amp;gt;Ctrl+K V&amp;lt;/code&amp;gt; or the title bar button.&lt;br /&gt;
* It does not open for a file that already has a Blocky Editor or Blocky Preview tab.&lt;br /&gt;
* It does not open for files that are not on disk, for example the old side of a Git diff.&lt;br /&gt;
&lt;br /&gt;
== Ctrl+Shift+V opens the Blocky preview instead of the Markdown preview ==&lt;br /&gt;
In &amp;lt;code&amp;gt;.blockymodel&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;.blockyanim&amp;lt;/code&amp;gt; files, &amp;lt;code&amp;gt;Ctrl+K V&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;Ctrl+Shift+V&amp;lt;/code&amp;gt; open the Blocky preview. In other files they keep their usual meaning.&lt;br /&gt;
&lt;br /&gt;
== The model shows no texture ==&lt;br /&gt;
The model file does not name its texture, so the preview looks for it by name in the model folder. See [[BlockyRenderer:Preview#Texture|Preview]] for the order. If your texture has a different name, pick it in the &amp;#039;&amp;#039;Texture&amp;#039;&amp;#039; list. Only PNG files in the model folder and in &amp;lt;code&amp;gt;&amp;amp;lt;Name&amp;amp;gt;_Textures/&amp;lt;/code&amp;gt; are offered.&lt;br /&gt;
&lt;br /&gt;
== Some faces are missing ==&lt;br /&gt;
Faces without an entry in &amp;lt;code&amp;gt;textureLayout&amp;lt;/code&amp;gt; are not drawn. A quad uses only the &amp;lt;code&amp;gt;front&amp;lt;/code&amp;gt; layout. A shape with a stretch of 0 on any axis is hidden.&lt;br /&gt;
&lt;br /&gt;
== The model looks different in the game ==&lt;br /&gt;
The lighting is only approximated. Only &amp;lt;code&amp;gt;fullbright&amp;lt;/code&amp;gt; is drawn self-lit, all other shading modes get the same simple light. Shape, UVs and proportions should match.&lt;br /&gt;
&lt;br /&gt;
== The animation plays on the wrong model ==&lt;br /&gt;
Pick the right model in the &amp;#039;&amp;#039;Model&amp;#039;&amp;#039; list, or use &amp;#039;&amp;#039;Other model…&amp;#039;&amp;#039;. The choice is stored for this animation in the workspace. See [[BlockyRenderer:Animations#Which model is used|Animations]] for how the model is chosen.&lt;br /&gt;
&lt;br /&gt;
== &amp;quot;n of m nodes missing&amp;quot; ==&lt;br /&gt;
The animation has tracks for node names the model does not have. Those tracks are skipped. Many vanilla animations do this, so it is not always an error. Hover over the hint to see the names.&lt;br /&gt;
&lt;br /&gt;
== My edit in the 3D view was ignored ==&lt;br /&gt;
If the JSON is broken or the text changed in the meantime, the 3D view does not match the file. The command is then discarded instead of changing the wrong node. Fix the JSON, and the view loads the current state.&lt;br /&gt;
&lt;br /&gt;
== The Nodes view still shows a model I closed ==&lt;br /&gt;
The &amp;#039;&amp;#039;&amp;#039;Nodes&amp;#039;&amp;#039;&amp;#039; view switches only when another &amp;lt;code&amp;gt;.blockymodel&amp;lt;/code&amp;gt; tab becomes active. Closing the tab does not clear it, and an active &amp;lt;code&amp;gt;.blockyanim&amp;lt;/code&amp;gt; tab does not change it either.&lt;br /&gt;
&lt;br /&gt;
== The Models view is missing a model ==&lt;br /&gt;
Files excluded by &amp;lt;code&amp;gt;files.exclude&amp;lt;/code&amp;gt; are not listed. Click ↻ (&amp;#039;&amp;#039;Refresh Model List&amp;#039;&amp;#039;) to search the workspace again.&lt;br /&gt;
&lt;br /&gt;
== How do I get files to open as text again? ==&lt;br /&gt;
Set &amp;lt;code&amp;gt;blockyRenderer.openFilesIn&amp;lt;/code&amp;gt; to &amp;lt;code&amp;gt;text&amp;lt;/code&amp;gt;, or choose &amp;#039;&amp;#039;Text with preview beside it&amp;#039;&amp;#039; in &amp;#039;&amp;#039;Open Blocky Files In…&amp;#039;&amp;#039;. This removes the extension&amp;#039;s entries from &amp;lt;code&amp;gt;workbench.editorAssociations&amp;lt;/code&amp;gt;. See [[BlockyRenderer:Renderer Only|Renderer Only]].&lt;br /&gt;
&lt;br /&gt;
== Does the extension change my files? ==&lt;br /&gt;
Only when you ask it to: commands in the Blocky Editor and the &amp;#039;&amp;#039;&amp;#039;Nodes&amp;#039;&amp;#039;&amp;#039; view, &amp;#039;&amp;#039;New Blocky Model…&amp;#039;&amp;#039;, &amp;#039;&amp;#039;Start with a Cube&amp;#039;&amp;#039;, and filling an empty &amp;lt;code&amp;gt;.blockymodel&amp;lt;/code&amp;gt; created in the Explorer (&amp;lt;code&amp;gt;blockyRenderer.newModelTemplate&amp;lt;/code&amp;gt;). The preview and the Blocky Preview only read files.&lt;br /&gt;
&lt;br /&gt;
{{BlockyRenderer Nav}}&lt;/div&gt;</summary>
		<author><name>Maintenance script</name></author>
	</entry>
</feed>