tools/README.md

   1 # MineClone 2 Tools
   2 This directory is for tools and scripts for MineClone 2.
   3 Currently, the only tool is Texture Converter.
   4
   5 ## Texture Converter (EXPERIMENTAL)
   6 This is a Python script which converts a resource pack for Minecraft to
   7 a texture pack for Minetest so it can be used with MineClone 2.
   8
   9 **WARNING**: This script is currently incomplete, not all textures will be
  10 converted. Some texture conversions are even buggy!
  11 Coverage is close to 100%, but it's not quite there yet.
  12 For a 100% complete texture pack, a bit of manual work on the textures
  13 will be required afterwards.
  14
  15 Modes of operation:
  16 - Can create a Minetest texture pack (default)
  17 - Can update the MineClone 2 textures
  18
  19 Requirements:
  20 - Know how to use the console
  21 - Python 3
  22 - ImageMagick
  23
  24 Usage:
  25 - Make sure the file “`Conversion_Table.csv`” is in the same directory as the script
  26 - In the console, run `./Texture_Converter.py -h` to learn the available options
  27 - Convert the textures
  28 - Put the new texture directory in the Minetest texture pack directory, just like
  29   any other Minetest texture pack