![\"env.json](\"https:\/\/github.com\/MModding\/art\/blob\/main\/mods\/env_json\/logo_named.png?raw=true\"){kind=logo}
<\/p>\n<\/p>\n
# env.json<\/p>\n
<\/p>\n
## Supports<\/p>\n
![\"Supports](\"https:\/\/github.com\/JR1811\/Boatism\/blob\/5bdbea79b11428101353c4a67ccd4b3821200a76\/extrernal\/promo\/badges\/supported_on_fabric_loader.png?raw=true\")
\n![\"Supports](\"https:\/\/github.com\/JR1811\/Boatism\/blob\/5bdbea79b11428101353c4a67ccd4b3821200a76\/extrernal\/promo\/badges\/supported_on_quilt_loader.png?raw=true\")
<\/p>\n
## Requirements<\/p>\n
![\"Requires](\"https:\/\/github.com\/JR1811\/Boatism\/blob\/5bdbea79b11428101353c4a67ccd4b3821200a76\/extrernal\/promo\/badges\/requires_fabric_api.png?raw=true\")
<\/p>\n
## Concept<\/p>\n
env.json is a Minecraft Library introducing a new sub json file extension format, with the goal of
\nredirecting minecraft resources to other ones based on the environment context.<\/p>\n
## Implementations<\/p>\n
env.json doesn’t provide these redirections directly, but only the operations around env.json files
\nand their resource reload management.<\/p>\n
There is currently two official implementations of env.json:<\/p>\n
– Environment Driven Assets (EDA)<\/p>\n
Mod Identifier: env-driven-assets.<\/p>\n
Environments: Client<\/p>\n
Applies env.json operations to Minecraft Vanilla asset types.<\/p>\n
– Environment Driven Data (EDD)<\/p>\n
Mod Identifier: env-driven-data.<\/p>\n
Environments: Common & Server<\/p>\n
Applies env.json operations to Minecraft Vanilla data types.<\/p>\n
## The env.json Format<\/p>\n
“`json
\n[
\n {
\n “rules”: [ \/\/ the primary set of rules, is an “any” type
\n {
\n “type”: “sequence”, \/\/ all rules in the sequence must pass
\n “rule”: [] \/\/ the rules
\n },
\n {
\n “type”: “any”, \/\/ passes if at least one rule passes
\n “rule”: [] \/\/ the rules
\n },
\n {
\n “type”: “not”, \/\/ reverses the rule
\n “rule”: { \/\/ the rule
\n “type”: “…”,
\n “rule”: “…”
\n }
\n },
\n {
\n “type”: “dimension”, \/\/ passes if the current dimension matches this one
\n “rule”: “minecraft:overworld” \/\/ the dimension, can also be a tag
\n },
\n {
\n “type”: “biome”, \/\/ passes if the current biome matches this one
\n “rule”: “minecraft:plains” \/\/ the biome, can also be a tag
\n },
\n {
\n “type”: “x_coord”, \/\/ passes if the following operations on the x-axis are valid
\n “rule”: {
\n “comparator”: “==”, \/\/ must be <, >, ==, <=, >=, =< or =>
\n “value”: “100” \/\/ must be an integer
\n }
\n },
\n {
\n “type”: “y_coord”, \/\/ passes if the following operations on the y-axis are valid
\n “rule”: {
\n “comparator”: “==”, \/\/ must be <, >, ==, <=, >=, =< or =>
\n “value”: “100” \/\/ must be an integer
\n }
\n },
\n {
\n “type”: “z_coord”, \/\/ passes if the following operations on the z-axis are valid
\n “rule”: {
\n “comparator”: “==”, \/\/ must be <, >, ==, <=, >=, =< or =>
\n “value”: “100” \/\/ must be an integer
\n }
\n },
\n {
\n “type”: “submerged”, \/\/ passes if the current context is surrounded by water or not
\n “rule”: true \/\/ true for “if it is submerged” and false for “if it is not submerged”
\n },
\n {
\n “type”: “sky”, \/\/ passes if the context is above the sky limit, at or below
\n “rule”: “at” \/\/ must be “above”, “at” or “below”
\n },
\n {
\n “type”: “water”, \/\/ passes if the context is above the water level, at or below
\n “rule”: “at” \/\/ must be “above”, “at” or “below”
\n },
\n {
\n “type”: “void”, \/\/ passes if the context is above the void limit, at or below
\n “rule”: “at” \/\/ must be “above”, “at” or “below”
\n }
\n ],
\n “result”: “minecraft:block\/stone” \/\/ the redirected resource
\n }
\n]
\n“`<\/p>\n
The file must be registered under this format: `redirected_resource_name-redirected_resource_extension.env.json`.<\/p>\n
## Usage For Developers<\/p>\n
In your `build.gradle`
\n“`groovy
\nrepositories {
\n \/\/ …
\n maven { url ‘https:\/\/jitpack.io’ }
\n}<\/p>\n
\/\/ …<\/p>\n
dependencies {
\n \/\/ …
\n modImplementation “com.mmodding:env.json:${theMostBeautifulVersionYouCanFind}”
\n}
\n“`<\/p>\n
You can now get your `EnvJson` object from a `Resource` object thanks to `ExtendedResource#of(Resource)#getEnvJson`
\nor parse it with `EnvJson#parse(Path)` or `EnvJson#parse(InputStream)`.<\/p>\n
## Badge For Developers<\/p>\n
![\"Requires](\"https:\/\/github.com\/MModding\/art\/blob\/main\/mods\/env_json\/requires_env_json.png?raw=true\")
<\/p>\n
``<\/p>\n
## Promotion<\/p>\n
![\"ModFest](\"https:\/\/raw.githubusercontent.com\/ModFest\/art\/3bf66556e674d670e30f647d6a48c4e1798c21d4\/badge\/128h\/ModFest%201.20%20Badge%20Cozy.png\")
<\/p>\n","protected":false},"excerpt":{"rendered":"
A small FabricMC library allowing to convert an `env.json` file into a Java Object. It is mostly used by Environment Driven Assets and Environment Driven Data.<\/p>\n","protected":false},"featured_media":64810,"template":"","meta":{"_minecraft_slug":"env.json","_minecraft_project_id":"ZKEKrxKq","_minecraft_author":"MModding","_minecraft_license":"LicenseRef-Code-PolyForm-Shield-1.0.0-Assets-ARR","_minecraft_downloads":3197,"_minecraft_follows":11,"_minecraft_client_side":"optional","_minecraft_server_side":"optional","_minecraft_storage_type":"zip","_minecraft_archive_name":"env.json.zip","_minecraft_size_bytes":1217504,"_minecraft_version_count":18,"_minecraft_updated_at":"2026-05-17T01:31:23.408271Z","_minecraft_date_created":"2023-12-30T21:11:29.840212Z","_minecraft_date_modified":"2024-09-09T18:54:10.452115Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/env.json","_minecraft_icon_attachment_id":64810,"_minecraft_imported_at":"2026-06-03T17:35:35+00:00","_minecraft_import_hash":"6e093f57a3b7b4618af17c063ffb50fc","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,97,89,873,126,98,867,92],"mod_loader":[99,100],"minecraft_version":[36,60,93,94,101,102,62,37],"class_list":["post-64809","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-fabric","mod_category-game-mechanics","mod_category-library","mod_category-management","mod_category-quilt","mod_category-social","mod_category-utility","mod_loader-fabric","mod_loader-quilt","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1"],"yoast_head":"\n