Python script + boilerplate for creating custom texturepacks
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
build
tiles
tools
.gitignore
Makefile
readme.md

readme.md

Texturizer, a Minecraft Texture Pack Builder

Texturizer is a python script + boilerplate for quickly building custom texture packs. It consists of the following:

tools/texturizer.py

This is the brain of Texturizer, a python script for splitting the terrain file into 255 individual tiles, and then recombining them again. When splitting a terrain image, Texturizer automatically determines the tile sized based on the width of the input file. When joining, tile size will be that of the first tile it finds. This allows the script to work with textures of all sizes. Note, however, all tiles MUST be the same size.

tools/png.py

An open-source python library for reading and writing PNG image files.

tiles/

This is the folder containing all the individual texture tiles that will make up terrain.png. Each file is named ROW-COLUMN.png, starting at the top left corner. This repo contains all the tiles from the default terrain.png within Minecraft 1.8.

Makefile

This is an instruction file for the bsd/gnu make tool. On a unix/linux/osx system, typing make from within this folder will run texturizer.py, combining all the tiles in tiles/ into a terrain.png file within build/, and then compressing the contents of the build/ folder into pack.zip as a readymade texture pack.

build/

The build directory contains the contents of the texture pack you wish to produce. Anything beyond

Texturizer.py Usage

Usage: texturizer.py [OPTION]

  -h, --help                                     Show this information
  -c, --combine                                  Combine split png tiles into newterrain.png
  -t terrain.png, --terrain=terrain.png          Specify different terrain.png filename. png suffix is optional/assumed.
  -o terrain-new.png, --outfile=terrain-new.png  Specify different terrain-new.png output filename. png suffix is optional/assumed.
  -d, --dir                                      Split files are created/read from a directory of the same name (excluding extension) as the terrain file.

Default operation is splitting terrain.png.

Credits

  • The Texturizer boilerplate is assembled by Jarvis Badgley (chipersoft at gmail)
  • texturizer.py is written by Michael Lynn and included here with permission.
  • pypng library is written by Johann C. Rocholl and David Jones

License

Texturizer is released under a standard MIT license.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation files
(the "Software"), to deal in the Software without restriction,
including without limitation the rights to use, copy, modify, merge,
publish, distribute, sublicense, and/or sell copies of the Software,
and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.