Description

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

For examples, see the README: https://github.com/lukebemish/JsonWrangler#readme

What means Verified?

• Compatibility: The mod should be compatible with the latest version of Minecraft and be clearly labeled with its supported versions.
• Functionality: The mod should work as advertised and not cause any game-breaking bugs or crashes.
• Security: The mod should not contain any malicious code or attempts to steal personal information.
• Performance: The mod should not cause a significant decrease in the game's performance, such as by causing lag or reducing frame rates.
• Originality: The mod should be original and not a copy of someone else's work.
• Up-to-date: The mod should be regularly updated to fix bugs, improve performance, and maintain compatibility with the latest version of Minecraft.
• Support: The mod should have an active developer who provides support and troubleshooting assistance to users.
• License: The mod should be released under a clear and open source license that allows others to use, modify, and redistribute the code.
• Documentation: The mod should come with clear and detailed documentation on how to install and use it.

How to Install