Implement RFE #7032 / Core Rules - Walk on deployment

megamek/src/megamek/client/commands/MoveCommand.java

@@ -230,6 +230,10 @@ private void clearAllMoves() {
             } else if (currentEntity().getMovementMode().isQuadSwim()) {
                 currentEntity().setMovementMode(EntityMovementMode.QUAD);
             }
+            if (cmd.contains(MoveStepType.DEPLOY)) {
+                currentEntity().setDeployed(false);
+                currentEntity().setPosition(null);
+            }
 
             cmd = new MovePath(getClient().getGame(), currentEntity());
         } else {

megamek/src/megamek/client/ui/panels/phaseDisplay/MovementDisplay.java

@@ -615,6 +615,11 @@
         if ((selectedEntity instanceof Mek climbingMek) && climbingMek.isClimbing()) {
             SwingUtilities.invokeLater(() -> promptContinueClimbing(climbingMek));
         }
+
+        // If it has not deployed yet, draw the deployment
+        if (Game.rulesManager.getRulesGame().walkOnInitiative() && !selectedEntity.isDeployed()) {
+            clientgui.boardViews().forEach(bv -> ((BoardView) bv).markDeploymentHexesFor(selectedEntity));
+        }
     }
 
     /**
@@ -1683,6 +1688,7 @@
         }
 
         startTimer();
+
     }
 
     /**
@@ -1843,6 +1849,12 @@
             currentlySelectedEntity.setMovementMode(EntityMovementMode.QUAD);
         }
 
+        // If it was walk-on deployment, invalidate the deployment
+        if ((cmd != null) && cmd.contains(MoveStepType.DEPLOY)) {
+            currentEntity().setDeployed(false);
+            currentEntity().setPosition(null);
+        }
+
         // create new current and considered paths
         cmd = new MovePath(game, currentlySelectedEntity);
         clientgui.updateFiringArc(currentlySelectedEntity);
@@ -2565,6 +2577,23 @@
             return;
         }
 
+        if (Game.rulesManager.getRulesGame().walkOnInitiative()) {
+            if (!currentlySelectedEntity.isDeployed() && boardViewEvent.getType() == BoardViewEvent.BOARD_HEX_DRAGGED) {
+                if (game.getBoard(boardViewEvent.getBoardId())
+                      .isLegalDeployment(boardViewEvent.getCoords(), currentlySelectedEntity)) {
+                    currentlySelectedEntity.setPosition(boardViewEvent.getCoords());
+                    cmd.addStep(MoveStepType.DEPLOY);
+                    Hex hex = game.getBoard(boardViewEvent.getBoardId()).getHex(boardViewEvent.getCoords());
+                    currentlySelectedEntity.setDeployed(true);
+                    clientgui.boardViews().forEach(bv -> ((BoardView) bv).redrawEntity(currentlySelectedEntity));
+                } else {
+                    // Message about choosing a legal deployment area
+                }
+                return;
+
+            }
+        }
+
         // check for shifty goodness
         if (shiftHeld == ((boardViewEvent.getModifiers() & InputEvent.SHIFT_DOWN_MASK) == 0)) {
             shiftHeld = (boardViewEvent.getModifiers() & InputEvent.SHIFT_DOWN_MASK) != 0;

megamek/src/megamek/common/board/Board.java

@@ -59,6 +59,7 @@
 import megamek.common.equipment.FuelTank;
 import megamek.common.event.board.BoardEvent;
 import megamek.common.event.board.BoardListener;
+import megamek.common.game.Game;
 import megamek.common.hexArea.HexArea;
 import megamek.common.loaders.MapSettings;
 import megamek.common.units.AbstractBuildingEntity;
@@ -941,6 +942,12 @@ public boolean isLegalDeployment(Coords c, int zoneType, int startingWidth, int
         int maxX = width - startingOffset;
         int maxy = height - startingOffset;
 
+        // Walk on initiative only allows for 1 hex width deployment zones
+        if (Game.rulesManager.getRulesGame().walkOnInitiative()) {
+            startingWidth = 1;
+        }
+
+
         return switch (zoneType) {
             case START_ANY -> (((startingAnyNWx == Entity.STARTING_ANY_NONE) || (c.getX() >= startingAnyNWx))
                   && ((startingAnySEx == Entity.STARTING_ANY_NONE) || (c.getX() <= startingAnySEx))
@@ -1379,8 +1386,8 @@ public void removeInfernoFrom(Coords coords) {
     }
 
     /**
-     * Record that a fire at the given coordinates was started by a fuel-fed flamer (TO:AuE p.153). Such fires are harder
-     * for firefighting engineers to extinguish.
+     * Record that a fire at the given coordinates was started by a fuel-fed flamer (TO:AuE p.153). Such fires are
+     * harder for firefighting engineers to extinguish.
      *
      * @param coords the <code>Coords</code> of the flamer-started fire
      */

megamek/src/megamek/common/enums/MoveStepType.java

@@ -118,7 +118,8 @@ public enum MoveStepType {
     CHAFF(false, "Chaff"),
     PICKUP_CARGO(false, "Pickup Cargo"),
     DROP_CARGO(false, "Drop Cargo"),
-    CHANGE_BOARD(true, "Change Board");
+    CHANGE_BOARD(true, "Change Board"),
+    DEPLOY(false, "Deploy");
 
     private final boolean entersNewHex;
     private final String humanReadableLabel;

megamek/src/megamek/common/moves/DeployStep.java

@@ -0,0 +1,59 @@
+package megamek.common.moves;
+
+/*
+ * Copyright (C) 2026 The MegaMek Team. All Rights Reserved.
+ *
+ * This file is part of MegaMek.
+ *
+ * MegaMek is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License (GPL),
+ * version 3 or (at your option) any later version,
+ * as published by the Free Software Foundation.
+ *
+ * MegaMek is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty
+ * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU General Public License for more details.
+ *
+ * A copy of the GPL should have been included with this project;
+ * if not, see <https://www.gnu.org/licenses/>.
+ *
+ * NOTICE: The MegaMek organization is a non-profit group of volunteers
+ * creating free software for the BattleTech community.
+ *
+ * MechWarrior, BattleMech, `Mech and AeroTech are registered trademarks
+ * of The Topps Company, Inc. All Rights Reserved.
+ *
+ * Catalyst Game Labs and the Catalyst Game Labs logo are trademarks of
+ * InMediaRes Productions, LLC.
+ *
+ * MechWarrior Copyright Microsoft Corporation. MegaMek was created under
+ * Microsoft's "Game Content Usage Rules"
+ * <https://www.xbox.com/en-US/developers/rules> and it is not endorsed by or
+ * affiliated with Microsoft.
+ */
+
+import java.util.EnumSet;
+import java.util.Set;
+
+import megamek.common.enums.MoveStepType;
+import megamek.common.game.Game;
+import megamek.common.pathfinder.CachedEntityState;
+import megamek.common.units.Entity;
+
+public class DeployStep implements PhasePass {
+    private static final EnumSet<MoveStepType> TYPES = EnumSet.of(MoveStepType.DEPLOY);
+
+    @Override
+    public Set<MoveStepType> getTypesOfInterest() {
+        return TYPES;
+    }
+
+    @Override
+    public PhasePassResult preCompilation(final MoveStep moveStep, final Game game, final Entity entity, MoveStep prev,
+          final CachedEntityState cachedEntityState) {
+        moveStep.setDeploying(true);
+        moveStep.setDistance(1);
+        return PhasePassResult.BREAK;
+    }
+}

megamek/src/megamek/common/moves/MoveStep.java

@@ -69,7 +69,6 @@
 import megamek.common.pathfinder.CachedEntityState;
 import megamek.common.planetaryConditions.Atmosphere;
 import megamek.common.planetaryConditions.PlanetaryConditions;
-import megamek.common.rules.core.CoreRulesManager;
 import megamek.common.units.*;
 import megamek.logging.MMLogger;
 
@@ -167,6 +166,7 @@ public class MoveStep implements Serializable {
     private boolean isHittingDeck = false;
     private boolean isClearingRubble = false;
     private boolean isClimbing = false;
+    private boolean isDeploying = false;
     private int climbingTotalLevels = 0;
     private int climbingChargedLevels = 0;
     private boolean isTakingCover = false;
@@ -706,7 +706,7 @@ void compileMove(final Game game, final Entity entity, MoveStep prev, CachedEnti
         }
         // check for water
         if (Game.rulesManager.getRulesMovement().cannotRunInWater(entity.getMovementMode(),
-                                                                  cachedEntityState.hasWorkingMisc(MiscType.F_FULLY_AMPHIBIOUS))
+              cachedEntityState.hasWorkingMisc(MiscType.F_FULLY_AMPHIBIOUS))
               && !isPavementStep()
               && (destHex.terrainLevel(Terrains.WATER) > 0)
               && !(destHex.containsTerrain(Terrains.ICE) && (elevation >= 0))
@@ -3726,7 +3726,7 @@ public boolean isMovementPossible(Game game, Coords src, int srcEl, CachedEntity
               (movementType == EntityMovementType.MOVE_VTOL_WALK) ||
               (movementType == EntityMovementType.MOVE_VTOL_RUN) ||
               (movementType == EntityMovementType.MOVE_VTOL_SPRINT);
-        
+
         if ((movementType != EntityMovementType.MOVE_JUMP) && !isVTOLFlight) {
             int maxDown = Game.rulesManager.getRulesTerrain().getMaxElevationChangeAllowed(srcHex, destHex,
                   entity.getMaxElevationDown(srcAlt));
@@ -3789,7 +3789,7 @@ public boolean isMovementPossible(Game game, Coords src, int srcEl, CachedEntity
         boolean isDownCliff = !src.equals(dest) &&
               srcHex.hasCliffTopTowards(destHex) &&
               (stepHeight == -1 || stepHeight == -2);
-        
+
         // For vehicles exc. VTOL, WIGE, upward Sheer Cliffs is forbidden
         // QuadVees in vehicle mode drive as vehicles, IO p.133
         if ((vehicleAffectedByCliff || quadVeeVehicleMode) && isUpCliff && !isPavementStep) {
@@ -3859,7 +3859,7 @@ public boolean isMovementPossible(Game game, Coords src, int srcEl, CachedEntity
               (movementType == EntityMovementType.MOVE_VTOL_RUN) ||
               (movementType == EntityMovementType.MOVE_VTOL_SPRINT)) &&
               Game.rulesManager.getRulesMovement().cannotRunInWater(nMove,
-                                                                    cachedEntityState.hasWorkingMisc(MiscType.F_FULLY_AMPHIBIOUS)) &&
+                    cachedEntityState.hasWorkingMisc(MiscType.F_FULLY_AMPHIBIOUS)) &&
               (destHex.terrainLevel(Terrains.WATER) > 0) &&
               !(destHex.containsTerrain(Terrains.ICE) && (elevation >= 0)) &&
               !dest.equals(entity.getPosition()) &&
@@ -4649,4 +4649,20 @@ public int getBoardId() {
     public boolean isClimbMode() {
         return (type == MoveStepType.CLIMB_MODE_ON) || (type == MoveStepType.CLIMB_MODE_OFF);
     }
+
+    /**
+     * Set it is deployment
+     *
+     * @param isDeploying
+     */
+    public void setDeploying(boolean isDeploying) {
+        this.isDeploying = isDeploying;
+    }
+
+    /**
+     * get deployment state of this step
+     *
+     * @return isDeploying
+     */
+    public boolean isDeploying() {return isDeploying;}
 }

megamek/src/megamek/common/moves/PhasePassSelector.java

@@ -79,6 +79,7 @@ class PhasePassSelector {
     private static final PhasePass BOOTLEGGER_STEP = new BootleggerStep();
     private static final PhasePass BRACE_STEP = new BraceStep();
     private static final PhasePass DEFAULT_STEP = new DefaultStep();
+    private static final PhasePass DEPLOY_STEP = new DeployStep();
 
     /**
      * Returns the correct phase pass for  {@link MoveStep} compilation based on the move step type.
@@ -124,6 +125,7 @@ static PhasePass getPhasePass(MoveStepType moveStepType) {
             case CONVERT_MODE -> CONVERT_MODE_STEP;
             case BOOTLEGGER -> BOOTLEGGER_STEP;
             case BRACE -> BRACE_STEP;
+            case DEPLOY -> DEPLOY_STEP;
             default -> DEFAULT_STEP;
         };
     }

megamek/src/megamek/common/rules/RulesGame.java

@@ -53,8 +53,10 @@ public abstract class RulesGame {
 
     /**
      * Is an entity eligible for a phase
+     *
      * @param entity the unit being considered
-     * @param phase what phase it is in
+     * @param phase  what phase it is in
+     *
      * @return is it eligible
      */
     public abstract boolean eligibleForPhase(Entity entity, @Nullable GamePhase phase);
@@ -63,37 +65,43 @@ public abstract class RulesGame {
      * Return the number of units to move.
      *
      * @param num_normal_turns array of normal turns
-     * @param index the current index
-     * @param min the minimum value
-     * @param frontLoadOption true if front load option is enabled
+     * @param index            the current index
+     * @param min              the minimum value
+     * @param frontLoadOption  true if front load option is enabled
+     *
      * @return the initiative order
      */
     public abstract int getInitiativeOrder(int[] num_normal_turns, int index, int min, boolean frontLoadOption);
 
     /**
      * Is there a BV bump for tag?
-     * 
-     * @param entity The entity being considered
-     * @param bvReport the report
+     *
+     * @param entity     The entity being considered
+     * @param bvReport   the report
      * @param adjustedBV the adjusted BV so far
-     * @param tagCount how many tags in the force
-     * @param hasGuided does it have guided? (default false)
+     * @param tagCount   how many tags in the force
+     * @param hasGuided  does it have guided? (default false)
+     *
      * @return adjusted BV value with bump if applicable
      */
     public abstract double tagBVBump(Entity entity, CalculationReport bvReport, double adjustedBV,
           long tagCount, boolean hasGuided);
 
     /**
      * Allow minefields or not
+     *
      * @param toMinefields OptionsConstants.ADVANCED_MINEFIELDS
+     *
      * @return
      */
     public abstract boolean allowMinefields(boolean toMinefields);
 
     /**
      * Helped function for tagBVBump to get the equipment descriptor for a mounted item.
+     *
      * @param mounted
      * @param entity
+     *
      * @return
      */
     public String equipmentDescriptor(Mounted<?> mounted, Entity entity) {
@@ -105,7 +113,9 @@ public String equipmentDescriptor(Mounted<?> mounted, Entity entity) {
             if (mounted.isMekTurretMounted()) {
                 descriptor += " (T)";
             }
-            if (mounted.isRearMounted() || (mounted.getType().hasFlag(WeaponType.F_VGL) && (mounted.getFacing() >= 2) && (mounted.getFacing() <= 4))) {
+            if (mounted.isRearMounted() || (mounted.getType().hasFlag(WeaponType.F_VGL)
+                  && (mounted.getFacing() >= 2)
+                  && (mounted.getFacing() <= 4))) {
                 descriptor += " (R)";
             }
             return descriptor;
@@ -118,4 +128,13 @@ public String equipmentDescriptor(Mounted<?> mounted, Entity entity) {
             return mounted.getType().getShortName();
         }
     }
+
+    /**
+     * Is walk on initiative supported?
+     *
+     * @return Default to false.
+     */
+    public boolean walkOnInitiative() {
+        return false;
+    }
 }