Issue MekHQ#6619: Move RestoreUnitAction::copyC3Networks from MekHQ to MegaMek's C3Utils

Author: psikomonkie

megamek/src/megamek/common/Entity.java

@@ -5942,7 +5942,7 @@ public boolean hasAnyC3System() {
         return hasC3() || hasNhC3();
     }
 
-    public String getC3NetId() {
+    public @Nullable String getC3NetId() {
         if (c3NetIdString == null) {
             if (hasC3()) {
                 c3NetIdString = "C3." + getId();
@@ -6012,6 +6012,16 @@ public void setC3NetIdSelf() {
         }
     }
 
+    /**
+     * Explicitly set the C3 Net ID using a string.
+     * @see megamek.common.util.C3Util
+     * @see #setC3NetId(Entity)
+     * @param c3NetId string value the id should be set to
+     */
+    public void setC3NetId(@Nullable String c3NetId) {
+        c3NetIdString = c3NetId;
+    }
+
     /**
      * Determine the remaining number of other C3 Master computers that can connect to this <code>Entity</code>.
      * <p>

megamek/src/megamek/common/util/C3Util.java

@@ -99,4 +99,24 @@ public static List<Entity> wireC3(Game game, Entity entity) {
 
         return affectedUnits;
     }
+
+    /**
+     * Copies the C3 network setup from the source to the target.
+     *
+     * @param source The source {@link Entity}.
+     * @param target The target {@link Entity}.
+     */
+    public static void copyC3Networks(Entity source, Entity target) {
+        target.setC3UUIDAsString(source.getC3UUIDAsString());
+        target.setC3Master(source.getC3Master(), false);
+        target.setC3MasterIsUUIDAsString(source.getC3MasterIsUUIDAsString());
+
+        // Reassign the C3NetId
+        target.setC3NetId(source.getC3NetId());
+
+        for (int pos = 0; pos < Entity.MAX_C3i_NODES; ++pos) {
+            target.setC3iNextUUIDAsString(pos, source.getC3iNextUUIDAsString(pos));
+            target.setNC3NextUUIDAsString(pos, source.getNC3NextUUIDAsString(pos));
+        }
+    }
 }