JsonWrangler

JsonWrangler

A tool for all your JSON-modifying needs

Quilt version requires: QSL and GroovyDuvet

Forge version requires: GML

JsonWrangler is a Minecraft mod which allows for the modification of game data and resources, as stored in JSON files,
through groovy scripts which can be packaged in resource or data packs.

Usage

JsonWrangler should allow modification of basically any JSON file with a “winner takes all” behavior – for instance,
loot tables, models, worldgen data, or animation metadata files. If JsonWrangler fails to wrangle a file that you think
it should, please submit a bug report. If you wish to modify a file at a given path, say,
assets/minecraft/textures/block/magma.png.mcmeta or data/minecraft/loot_tables/chests/simple_dungeon.json, you
should create a groovy script at same path, but with a .groovy at the end – in this case,
assets/minecraft/textures/block/magma.png.mcmeta.groovy or data/minecraft/loot_tables/chests/simple_dungeon.json.groovy.
Inside of your groovy script, you are given several arguments, and must return a value which will replace the original
JSON file. Valid values to return include maps, where map keys must be strings and values may be
lists, maps, numbers, booleans, strings, or dates. In addition to normal groovy features, You have the following
variables at your disposal inside your script:

• json – the original JSON file, parsed into a map
• platform – either "quilt" or "forge", depending on which platform you are running on
• override – a method which, if called, will cause any further scripts attempting to modify the same file to not run

Multiple scripts in different datapacks or resource packs can target the same file – they are ran in order from highest
priority (the “top” pack) to lowest priority (the “bottom” pack). If a script calls override(), no further scripts
will run.

Servers

Note: As the groovy scripts that JsonWrangler loads can execute arbitrary code, JsonWrangler will not load scripts
from server resource packs. If you wish to load scripts from a server resource pack, you will have to copy it as a local
resource pack first.

Examples

Changing the texture of an item

Placing the following file at assets/minecraft/models/item/apple.json.groovy will change the texture of the apple to
use the potato texture:

json?.textures?.layer0 = 'minecraft:item/potato'

return json