Deprecate ChanceLogic.FIRST (#4109)

Co-authored-by: Ghostipedia / Caitlynn <[email protected]>

Author: DilithiumThoride

docs/content/Modpacks/Changes/7.3.0.md

@@ -0,0 +1,11 @@
+---
+title: "Version 7.3.0"
+---
+
+
+# Updating from `7.2.1` to `7.3.0`
+
+## Chance Logics
+
+- `first` ChanceLogic has been Deprecated as its behavior is highly unreliable, and it will be fully removed in 8.0.0.
+  We recommend using `xor` instead.

docs/content/Modpacks/Recipes/Adding-and-Removing-Recipes.md

@@ -124,10 +124,12 @@ ServerEvents.recipes(event => {
     - Valid options for chanced logic are:
         - `or` - (default) Any item/fluid which succeeds on its chance roll is produced/consumed.
         - `and` - If _all_ items/fluids succeed on their chance roll, all are produced/consumed together. Otherwise, none are. 
-        - `xor` - Guarantees that exactly one of the chanced items/fluids will be produced/consumed on every run. 
-        Behavior was changed in 7.0.0.
+        - `xor` - Normalizes ingredient chances, and guarantees that exactly one of the chanced items/fluids will be 
+        produced/consumed on every run. XOR's behavior was changed in 7.0.0.
         - `first` - Makes a chance roll for each item/fluid, in order of registration. Only the first item which succeeds 
-        on its roll is returned. Prior to 7.0.0, this was the behavior of `xor` logic.
+        on its roll is returned. Prior to 7.0.0, this was the behavior of `xor` logic. 
+            - Because of its unpredictable behavior, FIRST has been Deprecated as of 7.3.0, and is scheduled for removal
+            in 8.0.0.
 - Ranged Ingredients:
     - Item or Fluid ingredients that will be consumed or produced in a random amount within a `min, max` range (inclusive).
 - Circuits

src/main/java/com/gregtechceu/gtceu/api/recipe/chance/logic/ChanceLogic.java

@@ -117,7 +117,9 @@ public String toString() {
 
     /**
      * Chanced Output Logic where only the first ingredient succeeding its roll will be produced
+     * Deprecated following the rewrite of XOR
      */
+    @Deprecated
     public static final ChanceLogic FIRST = new ChanceLogic("first") {
 
         @Override