<h2>Give Pixel a plan, and it builds</h2>
<p><strong>Pixel Builder</strong> is an extension for <strong>AI Companion</strong> (the mod that adds <strong>Pixel</strong>, a companion you talk to in the chat). With it, Pixel can <strong>build from a building plan</strong>: you give it a file, tell it where, put the materials in its chest, and it places the blocks one by one.</p>
<p><strong>This extension needs the AI Companion mod</strong> (CurseForge project “Pixel ami”, version 1.0.0 or newer). Install both.</p>
<h2>How to use it</h2>
<ol>
<li><strong>Craft a Blueprint:</strong> a sheet of paper and a feather (shapeless recipe). In creative it is in the Tools tab.</li>
<li><strong>Aim at the ground</strong> where you want the building, then <strong>right-click</strong> with the Blueprint to open its screen.</li>
<li><strong>Add a plan file:</strong> click “Add a file…” (a normal file window opens) or drop the file on the game window. Supported: <code>.litematic</code> (Litematica), <code>.schem</code> (WorldEdit / Sponge) and <code>.nbt</code> (Minecraft structures).</li>
<li>Choose the <strong>rotation</strong> (0, 90, 180 or 270 degrees) and click <strong>“Pixel, build it where I aim”</strong>.</li>
<li><strong>Put the materials in Pixel’s chest</strong> (link a chest with the button in the chest screen, or <code>/companion chest</code>). Pixel fetches what it needs and builds, layer by layer, from the bottom up.</li>
</ol>
<p>If something is missing, Pixel stops and tells you exactly what (“I’m missing materials: 15 cobblestone”). Add it and say <strong>“Pixel, resume”</strong> in the chat: it carries on where it stopped, even after a “stop” or after restarting the game. Blocks that are already in place are skipped.</p>
<h2>Commands</h2>
<ul>
<li><code>/pixelbuilder plans</code>: lists the plans in the <code>pixelbuilder/plans</code> folder of your game (you can also put files there by hand).</li>
<li><code>/pixelbuilder info <plan></code>: size and list of materials.</li>
<li><code>/pixelbuilder build <plan> <x y z> <rotation></code> and <code>/pixelbuilder resume</code>.</li>
<li><code>/companion creative [on|off]</code> (operators): <strong>creative mode</strong>. Pixel builds without any material, takes no damage, and monsters ignore it. It is also active by itself while <em>you</em> are in creative game mode. Back in survival, everything is normal again.</li>
</ul>
<h2>What it does well</h2>
<ul>
<li>Reads plans from the internet or from your own builds, rotates them, and shows the material list first.</li>
<li>Walks around the build to reach every block, from the ground up.</li>
<li>Handles doors, beds, slabs, stairs, walls (old plans too), and other blocks with several states.</li>
<li>Clears grass, flowers and similar plants inside the plan before building. Terrain (dirt, stone) and trees are not touched.</li>
<li>Plans are only <em>data</em>: the mod reads the blocks and ignores anything else in the file. Very large or damaged files are refused.</li>
</ul>
<h2>Requirements</h2>
<ul>
<li>Minecraft <strong>26.3</strong> (Java Edition) with <strong>NeoForge 26.3.0.102</strong> or newer (Java 25 comes with the launcher).</li>
<li>The <strong>AI Companion</strong> mod, version 1.0.0 or newer.</li>
<li>Singleplayer, or a server where the host or an operator adds the plans.</li>
</ul>
<h2>Good to know (early version 0.1.0)</h2>
<ul>
<li>There is <strong>no ghost preview</strong> of the plan yet: Pixel builds directly where you aimed. A preview is planned.</li>
<li>Pixel builds from the ground: very tall buildings (more than 5 or 6 blocks high) will not be complete for now. Pixel skips what it cannot reach and tells you.</li>
<li>Big plans take time: Pixel walks and places blocks one at a time.</li>
<li>Chests, signs and banners are placed empty (their content is not copied). Water and lava are not placed. Blocks from mods you do not have are skipped (Pixel tells you).</li>
<li>A plan replaces what is at its place (except what is described above). Aim carefully.</li>
<li>Please report problems and ideas.</li>
</ul>
<h2>Credits and licence</h2>
<p>Pixel Builder is <strong>all rights reserved</strong>. It is an extension of AI Companion and is not an official Minecraft product; it is not approved by or associated with Mojang or Microsoft. Litematica, WorldEdit and Sponge are only mentioned as plan formats this mod can read; it is not affiliated with them.</p>
<p><em>The images on this page are illustrations, not in-game screenshots.</em></p>