Skip to content

AgustinSRG/ImageToMapMC

Repository files navigation

ImageToMapMC

Build (Windows) Build (Linux) License

This is a tool for converting images to Minecraft maps, in order to import images into the game without using mods.

Written in C++ as a desktop application for Windows and Linux.

Installation

In order to install the tool, go to the releases section in this repository and download the binaries for your system.

If there are no binaries available for your system, you can always compile them from the source code.

Guides

Reference documentation

Screenshots

Main view

Map in-game (Minecraft)

Building from source code

In order to compile the project, you'll need the following:

  • A C++ compiler
  • CMAKE installed.
  • ZLIB installed and available for your C++ compiler.
  • wxWidgets installed and available for your C++ compiler.
  • libzip installed and available for your C++ compiler.

In order to build the release version with CMAKE use:

cmake -DCMAKE_BUILD_TYPE=Release -Ssrc -Brelease

cmake --build release --config Release

After it is successfully built, your binaries will be available in the release folder.

Specific library installation instructions for Windows

Make sure Visual Studio is installed. Preferably the latest version. Ensure the build tools for C++ are also installed.

Once installed, set the MSVC_CRT_DLL_PATH environment variable to the path where the dll files for the Visual Studio C++ runtime are located. Example value: C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Redist\MSVC\14.44.35112\x64\Microsoft.VC143.CRT.

For external dependencies, use VCPKG. Make sure to install it and configure it for CMAKE, which also needs to be installed.

Install the required libraries:

vcpkg install wxwidgets zlib libzip --triplet=x64-windows

Specific library installation instructions for Linux

Install the C++ dependencies via APT:

sudo apt install zipcmp zipmerge ziptool zlib1g-dev libzip-dev libgtk-3-dev libglew-dev libwxgtk3.2-dev

You'll also need the tar tool in order to package the project:

sudo apt install -y tar