Usage¶
Now that you’ve installed pixelart
, you need
to also tell it where your Minecraft jar is.
Currently, the script has only been tested on jars
from Minecraft 1.11.x and 1.12.x. Older versions
which put all the textures into one image are
currently not supported.
You can also directly use a texture pack made for one of these recent versions of Minecraft, instead of finding the jar. However, this might mean (unless you use the faithful pack) that viewers of your pixel art won’t be able to view it with the right colors!
Finding your Minecraft jar¶
This really depends on which launcher you use, and the platform you are running on. If using the default launcher, it should be in:
%appdata%/.minecraft/versions/VERSION
(Windows)~/.minecraft/versions/VERSION
(Linux)
If you are using MultiMC, it should be in the installation directory, or somewhere else if you are using the AUR package.
Using the graphical interface¶
Now that you’ve found the minecraft jar, you can actually use the script.
- Run
pixelart-gui
in the python prompt/shell, wherever you ran thepip
command. - Click Select textures... and pick your Minecraft jar file or pre-extracted image directory.
- Click Select image to pixelart... and pick the image you wish to convert.
- Optionally, scale the image by specifying scaling values and pushing Scale. This will be the size of the image in blocks.
- Set any desired options by clicking Options. (the defaults are usually ok)
- Click Start! and enter the file name to save to.
- Wait until processing is complete. A block report will be shown when the script is done processing the image. If you wish to keep this, currently you must take a screenshot.
- Build your pixelart!
Using the command-line interface¶
The pixelart
package also provides an interface
usable in the system shell. Run pixelart -h
to
get the options. The same features are supported as
in the graphical version, except the block report
is saved to a file instead of being shown in the GUI.