# JsonPatcher
\n
\n
\n
\n<\/p>\n
JsonPatcher is a mod that allows you to modify json files in datapacks and resourcepacks without overriding them.
\nThis is primarily useful for mod developers and pack makers, but can also be used by players to modify their own packs.<\/p>\n
## V2 Disclaimer
\nJsonPatcher v2 is currently in beta. V2 introduces a bunch of new features including global patches for mods and modpacks.
\nDocumentation for v2 is available at jsonpatcher-docs.mattidragon.dev.
\nThe documentation is however quite incomplete and partially outdated.
\nFor some cases it might be best to consult the old wiki instead.<\/p>\n
## Usage<\/p>\n You can add jsonpatcher to your mods buildscript like this: dependencies { To begin using jsonpatcher, just create a file with the `.jsonpatch` extension You’ll want to begin your patch with a `@version` meta tag like this. Next you’ll want to select the files you want to patch. Now you can begin modifying the target file. The patch files use a c-like syntax. For more info on the language, see the wiki.<\/p>\n","protected":false},"excerpt":{"rendered":" A tool for patching minecrafts json files, without overrding them, using a custom DSL<\/p>\n","protected":false},"featured_media":88601,"template":"","meta":{"_minecraft_slug":"jsonpatcher","_minecraft_project_id":"qlXnlZLG","_minecraft_author":"MattiDragon","_minecraft_license":"MIT","_minecraft_downloads":10354,"_minecraft_follows":11,"_minecraft_client_side":"optional","_minecraft_server_side":"optional","_minecraft_storage_type":"zip","_minecraft_archive_name":"jsonpatcher.zip","_minecraft_size_bytes":20438472,"_minecraft_version_count":36,"_minecraft_updated_at":"2026-05-16T05:35:34.004724Z","_minecraft_date_created":"2023-11-17T23:20:14.036250Z","_minecraft_date_modified":"2025-09-24T13:28:04.521512Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/jsonpatcher","_minecraft_icon_attachment_id":88601,"_minecraft_imported_at":"2026-06-05T01:32:04+00:00","_minecraft_import_hash":"0f24effb8d37a8ef30feabf04e467d93","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,873,126,98,92],"mod_loader":[99,100],"minecraft_version":[36,60,727,94,102,62,37],"class_list":["post-88600","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-library","mod_category-management","mod_category-quilt","mod_category-utility","mod_loader-fabric","mod_loader-quilt","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3-pre2","minecraft_version-1-20-4","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1"],"yoast_head":"\nGradle dependency (for mod developers)<\/summary>\n
\n“`groovy
\nrepositories {
\n maven {
\n url ‘https:\/\/jitpack.io’
\n }
\n}<\/p>\n
\n modImplementation(include(“com.github.mattidragon:jsonpatcher:${jsonpatcher_version}”))
\n}
\n“`<\/p>\n<\/details>\n
\nin the `data\/
\nor `assets\/
\nThis will let jsonpatcher know that your patch will work with this version.
\nIn the future you may be able to select a version in more ways.
\n“`
\n@version “1”
\n“`<\/p>\n
\nThis is done with the `@target` meta tag. All meta tags follow a json format.
\nYou can either select a single file with a string, use an object for broader selections,
\nor use an array for multiple selections. If any selector in the array matches, the patch will apply.<\/p>\n
\nYou can access the target files contents with `$`. It can be used like a variable,
\nor you can put the property you want to access directly after it.<\/p>\n