Describe type + reason introduced in NeoForge 20.4.40-beta

docs/gettingstarted/modfiles.md

@@ -122,14 +122,15 @@ The features system allows mods to demand that certain settings, software, or ha
 
 Mods can specify their dependencies, which are checked by NeoForge before loading the mods. These configurations are created using the [array of tables][array] `[[dependencies.<modid>]]`, where `modid` is the identifier of the mod that consumes the dependency.
 
-| Property       |  Type   |    Default    |                                                               Description                                                               | Example                                      |
-|:---------------|:-------:|:-------------:|:---------------------------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------|
-| `modId`        | string  | **mandatory** |                                            The identifier of the mod added as a dependency.                                             | `modId="jei"`                                |
-| `mandatory`    | boolean | **mandatory** |                                     Whether the game should crash when this dependency is not met.                                      | `mandatory=true`                             |
-| `versionRange` | string  |     `""`      |  The acceptable version range of the language loader, expressed as a [Maven Version Range][mvr]. An empty string matches any version.   | `versionRange="[1, 2)"`                      |
-| `ordering`     | string  |   `"NONE"`    | Defines if the mod must load before (`"BEFORE"`) or after (`"AFTER"`) this dependency. If the ordering does not matter, return `"NONE"` | `ordering="AFTER"`                           |
-| `side`         | string  |   `"BOTH"`    |                    The [physical side][dist] the dependency must be present on: `"CLIENT"`, `"SERVER"`, or `"BOTH"`.                    | `side="CLIENT"`                              |
-| `referralUrl`  | string  |   *nothing*   |                                     A URL to the download page of the dependency. Currently unused.                                     | `referralUrl="https://library.example.com/"` |
+| Property       |  Type  |    Default    |                                                                                                                                                                                                                                                         Description                                                                                                                                                                                                                                                         | Example                                      |
+|:---------------|:------:|:-------------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------|
+| `modId`        | string | **mandatory** |                                                                                                                                                                                                                                      The identifier of the mod added as a dependency.                                                                                                                                                                                                                                       | `modId="jei"`                                |
+| `type`         | string |  `required`   | Replaced the `mandatory` field in NeoForge 20.4.40-beta. Specifies the nature of this dependency: `required` is the default and prevents the mod from loading if this dependency is missing. `optional` will not prevent the mod from loading if the dependency is missing, but still validates that the dependency is compatible. `incompatible` prevents the mod from loading if this dependency is present. `discouraged` still allows the mod to load if the dependency is present, but presents a warning to the user. | `type=incompatible`                          |
+| `reason`       | string |   *nothing*   |                                                                                                                                                                                        Available since NeoForge 20.4.40-beta. An optional user-facing message to describe why this dependency is required, or why it is incompatible                                                                                                                                                                                        |
+| `versionRange` | string |     `""`      |                                                                                                                                                                                            The acceptable version range of the language loader, expressed as a [Maven Version Range][mvr]. An empty string matches any version.                                                                                                                                                                                             | `versionRange="[1, 2)"`                      |
+| `ordering`     | string |   `"NONE"`    |                                                                                                                                                                                           Defines if the mod must load before (`"BEFORE"`) or after (`"AFTER"`) this dependency. If the ordering does not matter, return `"NONE"`                                                                                                                                                                                           | `ordering="AFTER"`                           |
+| `side`         | string |   `"BOTH"`    |                                                                                                                                                                                                              The [physical side][dist] the dependency must be present on: `"CLIENT"`, `"SERVER"`, or `"BOTH"`.                                                                                                                                                                                                              | `side="CLIENT"`                              |
+| `referralUrl`  | string |   *nothing*   |                                                                                                                                                                                                                               A URL to the download page of the dependency. Currently unused.                                                                                                                                                                                                                               | `referralUrl="https://library.example.com/"` |
 
 :::danger
 The `ordering` of two mods may cause a crash due to a cyclic dependency, for example if mod A must load `"BEFORE"` mod B and at the same time, mod B must load `"BEFORE"` mod A.