queengooborg's Minecraft Toolkit

A Python toolkit to scan Minecraft source code and generate helper files for server owners and developers.

This toolkit is designed to perform two main tasks:

• Decompiles, deobfuscates and scans the Minecraft source code to generate a list of items and their associated recipes
• Using the generated item data, create an EssentialsX worth.yml and a BossShopPro + BS-ItemShops set of shops

Developed and tested for 1.13 1.14.4 through 1.21.

Need a worth.yml with all the new items? Check out my fork of X00LA's file! https://gist.github.com/queengooborg/92d08120f0d6d25175f6c7a30e3ccac7

Requirements

• Java 8+
• Python 3.7+
• PyYAML (pip install pyyaml)
• DecompilerMC (added as a submodule)

generate_items.py

This script generates an items.json file in the output/ folder, which contains a structured list of all the items and their crafting recipes.

Note: the crafting recipes are pulled directly from Minecraft's source code, and may include useless recipes or ingredient names that aren't actual blocks. This will be adjusted over time.

python3 generate_items.py [mc_version] (-n/--no_cache)

generate_worth.py

This script generates a worth.yml for the EssentialsX Bukkit/Spigot/Paper server plugin. This is used to generate https://gist.github.com/queengooborg/92d08120f0d6d25175f6c7a30e3ccac7.

python3 generate_worth.py [mc_version] (-n/--no_cache) (-v/--vanilla)

generate_shops.py

This script uses the worth.yml file generated by the above script and generates a series of configuration files for the BossShopPro + BS-ItemShops Bukkit/Spigot/Paper server plugin.

python3 generate_shops.py [mc_version] (-n/--no_cache)