A version-independent data generator for Iris. Downloads Minecraft jar files and extracts block shapes and entity dimensions into JSON files.

Not automatically installed:

• python3 (requests)
• wget (Linux only)
• java and javac (JDK)

Automatically installed:

• Reconstruct ProGuard deobfuscator
• CFR Java decompiler
• Vineflower Java decompiler

Install Java 21 JDK, Python3 (or from the Windows Store) and the Python requests module from the websites given in the README.

Update your PATH for Java and Python 3 if it has not already been done before.

sudo apt install openjdk-21-jdk python3-requests wget

sudo dnf install java-21-openjdk-devel python3-requests wget

sudo pacman -S jdk21-openjdk python-requests wget

NOT TESTED

Install the JDK for Java, wget and Python3 and the module requests using brew or something else.

To extract data for a given Minecraft version, run ./extract.sh <version number>, e.g.

./extract.sh 1.20.4

or on Windows:

extract.bat 1.20.4

To clean everything up, run ./clean.sh

For example:

./clean.sh
./extract 1.20.4

• --decompile [cfr|vineflower]: enable decompilation of the deobfuscated Minecraft jar file, optionally add a specific decompiler (default is CFR)