Package mekhq.campaign.mission

Class AtBContract

java.lang.Object
mekhq.campaign.mission.Mission
mekhq.campaign.mission.Contract
mekhq.campaign.mission.AtBContract
Direct Known Subclasses:
AtBContract.AtBContractRef
public class AtBContract extends Contract
Contract class for use with Against the Bot rules

  • Field Details

    • MINIMUM_INTENSITY

      public static final double MINIMUM_INTENSITY
      The minimum intensity below which no scenarios will be generated
      See Also:

    • parentContract

      protected AtBContract parentContract

    • employerLiaison

      protected Person employerLiaison

    • clanOpponent

      protected Person clanOpponent

    • employerCode

      protected String employerCode

    • enemyCode

      protected String enemyCode

    • enemyMercenaryEmployerCode

      protected String enemyMercenaryEmployerCode

    • enemyName

      protected String enemyName

    • difficulty

      protected int difficulty

    • contractType

      protected AtBContractType contractType

    • allySkill

      protected megamek.common.enums.SkillLevel allySkill

    • allyQuality

      protected int allyQuality

    • enemySkill

      protected megamek.common.enums.SkillLevel enemySkill

    • enemyQuality

      protected int enemyQuality

    • allyBotName

      protected String allyBotName

    • enemyBotName

      protected String enemyBotName

    • allyCamouflage

      protected megamek.common.icons.Camouflage allyCamouflage

    • allyColour

      protected megamek.client.ui.util.PlayerColour allyColour

    • enemyCamouflage

      protected megamek.common.icons.Camouflage enemyCamouflage

    • enemyColour

      protected megamek.client.ui.util.PlayerColour enemyColour

    • extensionLength

      protected int extensionLength

    • requiredCombatTeams

      protected int requiredCombatTeams

    • requiredCombatElements

      protected int requiredCombatElements

    • moraleLevel

      protected AtBMoraleLevel moraleLevel

    • routEnd

      protected LocalDate routEnd

    • partsAvailabilityLevel

      protected int partsAvailabilityLevel

    • sharesPct

      protected int sharesPct

    • playerMinorBreaches

      protected int playerMinorBreaches

    • employerMinorBreaches

      protected int employerMinorBreaches

    • contractScoreArbitraryModifier

      protected int contractScoreArbitraryModifier

    • moraleMod

      protected int moraleMod

    • priorLogisticsFailure

      protected boolean priorLogisticsFailure

    • specialEventScenarioDate

      protected LocalDate specialEventScenarioDate
      If the date is non-null, there will be a special scenario or big battle on that date, but the scenario is not generated until the other battle rolls for the week.

    • specialEventScenarioType

      protected int specialEventScenarioType

    • battleTypeMod

      protected int battleTypeMod

    • nextWeekBattleTypeMod

      protected int nextWeekBattleTypeMod

  • Constructor Details

    • AtBContract

      protected AtBContract()

    • AtBContract

      public AtBContract(String name)

    • AtBContract

      public AtBContract(Contract contract, Campaign campaign)

  • Method Details

    • setRoutEndDate

      public void setRoutEndDate(LocalDate routEnd)
      Sets the end date of the rout. This should only be applied on contracts whose morale equals ROUTED
      Parameters:
      routEnd - the LocalDate representing the end date of the rout

    • initContractDetails

      public void initContractDetails(Campaign campaign)

    • pickRandomCamouflage

      public static megamek.common.icons.Camouflage pickRandomCamouflage(int currentYear, String factionCode)
      Selects a random camouflage for the given faction based on the faction code and year. If there are no available files in the faction directory, it logs a warning and uses default camouflage.
      Parameters:
      currentYear - the current year in the game.
      factionCode - the code representing the faction for which the camouflage is to be selected.

    • calculateLength

      public void calculateLength(boolean variable)

    • calculateBaseNumberOfRequiredLances

      @Deprecated(since="0.50.07", forRemoval=true) public static int calculateBaseNumberOfRequiredLances(Campaign campaign)
      Deprecated, for removal: This API element is subject to removal in a future version.
      use ContractUtilities.calculateBaseNumberOfRequiredLances(Campaign, boolean, boolean, double)

      Calculates the number of lances required for this contract, based on [campaign].

      Parameters:
      campaign - The campaign to reference.
      Returns:
      The number of lances required.

    • getEffectiveNumUnits

      @Deprecated(since="0.50.07", forRemoval=true) public static int getEffectiveNumUnits(Campaign campaign)
      Deprecated, for removal: This API element is subject to removal in a future version.
      use ContractUtilities.getEffectiveNumUnits(Campaign)

      Calculates the effective number of units available in the given campaign based on unit types and roles.

      This method iterates through all combat teams in the specified campaign, ignoring combat teams with the auxiliary role. For each valid combat team, it retrieves the associated force and evaluates all units within that force. The unit contribution to the total is determined based on its type:

      • TANK, VTOL, NAVAL, CONV_FIGHTER, AEROSPACE_FIGHTER: Adds 1 for non-clan factions, and 0.5 for clan factions.
      • PROTOMEK: Adds 0.2 to the total.
      • BATTLE_ARMOR, INFANTRY: Adds 0 (excluded from the total).
      • Other types: Adds 1 to the total.

      Units that aren’t associated with a valid combat team or can’t be fetched due to missing data are ignored. The final result is returned as an integer by flooring the calculated total.

      Parameters:
      campaign - the campaign containing the combat teams and units to evaluate
      Returns:
      the effective number of units as an integer

    • checkMorale

      public void checkMorale(Campaign campaign, LocalDate today)
      Checks and updates the morale which depends on various conditions such as the rout end date, skill levels, victories, defeats, etc. This method also updates the enemy status based on the morale level.
      Parameters:
      today - The current date in the context.

    • getRepairLocation

      public int getRepairLocation()
      Determines the repair location for the contract based on the contract type.

      The returned repair location corresponds to the type of operation:

      Overrides:
      getRepairLocation in class Mission
      Returns:
      the repair location constant based on the contract type

    • getBestRepairLocation

      public static int getBestRepairLocation(List<AtBContract> activeContracts)
      Determines the best available repair location from a list of active contracts.

      This method evaluates all active contracts and returns the highest quality repair facility available. Repair locations are ranked numerically, with higher values representing better facilities. If no active contracts exist, a basic facility is assumed to be available.

      Parameters:
      activeContracts - the list of active contracts to evaluate for repair facilities
      Returns:
      the numeric value of the best available repair location; returns Unit.SITE_FACILITY_BASIC if no contracts are active

    • getContractScore

      public int getContractScore(boolean isUseMaplessMode)
      Calculates the overall contract score based on scenario outcomes and modifiers.

      For StratCon campaigns, this returns the current victory points from the campaign state.

      For standard contracts, this aggregates scores from all completed scenarios and applies any arbitrary modifiers that have been set for this contract.

      Parameters:
      isUseMaplessMode - true if mapless mode is enabled in StratCon
      Returns:
      the total contract score, including victory points or scenario scores plus modifiers

    • getCurrentSupportPoints

      public int getCurrentSupportPoints()
      Returns:
      the total available support points, or 0 if StratCon is not enabled for this contract
      Since:
      0.50.10

    • getContractScoreArbitraryModifier

      public int getContractScoreArbitraryModifier()

    • doBonusRoll

      public boolean doBonusRoll(Campaign campaign, boolean isPostScenario)
      Performs a bonus roll to determine and execute a random campaign bonus. The roll is simulated using 1d6, and the outcome triggers different bonus effects based on the roll value. The effects may involve recruiting dependents, adding new units, or other benefits as determined by the campaign options and roll outcome.
      Parameters:
      campaign - the current Campaign instance.
      isPostScenario - a boolean indicating if this roll occurs post-scenario (used to determine specific behaviors for roll = 3).
      Returns:
      true if specific post-scenario behavior is triggered (roll = 3), otherwise false.
      Throws:
      IllegalStateException - if an unexpected roll value is encountered.

    • isSubcontract

      public boolean isSubcontract()

    • getParentContract

      public AtBContract getParentContract()

    • setParentContract

      public void setParentContract(AtBContract parent)

    • isMercSubcontract

      public boolean isMercSubcontract()

    • setMercSubcontract

      public void setMercSubcontract(boolean sub)

    • isAttacker

      public boolean isAttacker()

    • setAttacker

      public void setAttacker(boolean isAttacker)

    • checkEvents

      public void checkEvents(Campaign campaign)

    • getRandomDayOfMonth

      public LocalDate getRandomDayOfMonth(LocalDate today)

    • contractExtended

      public boolean contractExtended(Campaign campaign)

    • getMonthlyPayOut

      public Money getMonthlyPayOut()
      Overrides:
      getMonthlyPayOut in class Contract

    • writeToXMLBegin

      protected int writeToXMLBegin(Campaign campaign, PrintWriter pw, int indent)
      Overrides:
      writeToXMLBegin in class Contract

    • loadFieldsFromXmlNode

      public void loadFieldsFromXmlNode(Campaign campaign, megamek.Version version, Node node) throws ParseException
      Overrides:
      loadFieldsFromXmlNode in class Contract
      Throws:
      ParseException

    • restore

      public void restore(Campaign c)
      Restores any references to other contracts.
      Parameters:
      c - The Campaign which holds this contract.

    • getEmployerFaction

      public Faction getEmployerFaction()

    • getEmployerLiaison

      public Person getEmployerLiaison()

    • setEmployerLiaison

      public void setEmployerLiaison(Person employerLiaison)

    • createEmployerLiaison

      public void createEmployerLiaison(Campaign campaign)

    • getClanOpponent

      public Person getClanOpponent()

    • setClanOpponent

      public void setClanOpponent(Person clanOpponent)

    • createClanOpponent

      public void createClanOpponent(Campaign campaign)

    • getEmployerCode

      public String getEmployerCode()

    • setEmployerCode

      public void setEmployerCode(String code, int year)

    • getEmployerName

      public String getEmployerName(int year)

    • getEnemy

      public Faction getEnemy()

    • getEnemyCode

      public String getEnemyCode()

    • setEnemyCode

      public void setEnemyCode(String enemyCode)

    • getEnemyName

      public String getEnemyName(int year)
      Retrieves the name of the enemy for this contract.
      Parameters:
      year - The current year in the game.
      Returns:
      The name of the enemy.

    • getEnemyMercenaryEmployerCode

      @Nullable public String getEnemyMercenaryEmployerCode()

    • getEnemyMercenaryEmployer

      @Nullable public Faction getEnemyMercenaryEmployer()

    • setEnemyMercenaryEmployerCode

      public void setEnemyMercenaryEmployerCode(String enemyMercenaryEmployerCode)
      Sets the faction code representing the employer of the enemy mercenary forces.
      Parameters:
      enemyMercenaryEmployerCode - the faction code to assign as the employer of opposing mercenary units
      Since:
      0.50.10

    • getDifficulty

      public int getDifficulty()

    • setDifficulty

      public void setDifficulty(int difficulty)

    • getContractType

      public AtBContractType getContractType()

    • setContractType

      public void setContractType(AtBContractType contractType)

    • getAllySkill

      public megamek.common.enums.SkillLevel getAllySkill()

    • setAllySkill

      public void setAllySkill(megamek.common.enums.SkillLevel allySkill)

    • getEnemySkill

      public megamek.common.enums.SkillLevel getEnemySkill()

    • setEnemySkill

      public void setEnemySkill(megamek.common.enums.SkillLevel enemySkill)

    • getAllyQuality

      public int getAllyQuality()

    • setAllyQuality

      public void setAllyQuality(int allyQuality)

    • getEnemyQuality

      public int getEnemyQuality()

    • setEnemyQuality

      public void setEnemyQuality(int enemyQuality)

    • getAllyBotName

      public String getAllyBotName()

    • setAllyBotName

      public void setAllyBotName(String name)

    • getEnemyBotName

      public String getEnemyBotName()

    • setEnemyBotName

      public void setEnemyBotName(String name)

    • getAllyCamouflage

      public megamek.common.icons.Camouflage getAllyCamouflage()

    • setAllyCamouflage

      public void setAllyCamouflage(megamek.common.icons.Camouflage allyCamouflage)

    • getAllyColour

      public megamek.client.ui.util.PlayerColour getAllyColour()

    • setAllyColour

      public void setAllyColour(megamek.client.ui.util.PlayerColour allyColour)

    • getEnemyCamouflage

      public megamek.common.icons.Camouflage getEnemyCamouflage()

    • setEnemyCamouflage

      public void setEnemyCamouflage(megamek.common.icons.Camouflage enemyCamouflage)

    • getEnemyColour

      public megamek.client.ui.util.PlayerColour getEnemyColour()

    • setEnemyColour

      public void setEnemyColour(megamek.client.ui.util.PlayerColour enemyColour)

    • getRequiredCombatTeams

      public int getRequiredCombatTeams()

    • setRequiredCombatTeams

      public void setRequiredCombatTeams(int required)

    • getRequiredCombatElements

      public int getRequiredCombatElements()

    • setRequiredCombatElements

      public void setRequiredCombatElements(int required)

    • getPartsAvailabilityLevel

      public int getPartsAvailabilityLevel()

    • setPartsAvailabilityLevel

      public void setPartsAvailabilityLevel(int partsAvailabilityLevel)

    • getMoraleLevel

      public AtBMoraleLevel getMoraleLevel()

    • setMoraleLevel

      public void setMoraleLevel(AtBMoraleLevel moraleLevel)

    • changeMoraleLevel

      public AtBMoraleLevel changeMoraleLevel(int delta)
      Adjusts the current AtBMoraleLevel by the specified delta and returns the resulting morale level.

      The method computes a new integer morale value by adding the given delta to the unit's current morale level, then clamps the result to the valid range defined by MINIMUM_MORALE_LEVEL and MAXIMUM_MORALE_LEVEL. It then attempts to resolve the resulting value to a corresponding AtBMoraleLevel.

      If the resolved morale level is valid (i.e., non-null), the unit's internal morale state is updated. If no valid enum constant exists for the computed level, the method leaves the current morale unchanged and returns the existing level.

      Note: a positive delta improves the enemy morale, a negative delta decreases enemy morale.

      Parameters:
      delta - the amount to adjust the current morale level by; may be positive or negative
      Returns:
      the new AtBMoraleLevel after applying the delta; if no corresponding morale level exists for the computed value, the current morale level is returned unchanged
      Since:
      0.50.10

    • isPeaceful

      public boolean isPeaceful()

    • getRoutEnd

      public LocalDate getRoutEnd()

    • setRoutEnd

      public void setRoutEnd(LocalDate routEnd)

    • getSharesPercent

      public int getSharesPercent()
      Description copied from class: Contract
      Retrieves the percentage of shares for this contract. This currently returns a default value of 30.
      Overrides:
      getSharesPercent in class Contract
      Returns:
      the percentage of shares

    • setAtBSharesPercent

      public void setAtBSharesPercent(int pct)

    • isBatchallAccepted

      public boolean isBatchallAccepted()
      Checks if the Batchall has been accepted for the contract.
      Returns:
      true if the Batchall has been accepted, false otherwise.

    • setBatchallAccepted

      public void setBatchallAccepted(boolean batchallAccepted)
      Sets the batchallAccepted flag for this contract.
      Parameters:
      batchallAccepted - The value to set for the batchallAccepted flag.

    • addPlayerMinorBreach

      public void addPlayerMinorBreach()

    • addPlayerMinorBreaches

      public void addPlayerMinorBreaches(int num)

    • addEmployerMinorBreaches

      @Deprecated(since="0.50.06", forRemoval=true) public void addEmployerMinorBreaches(int num)
      Deprecated, for removal: This API element is subject to removal in a future version.
      no indicated uses.

    • setContractScoreArbitraryModifier

      public void setContractScoreArbitraryModifier(int newModifier)

    • getBattleTypeMod

      public int getBattleTypeMod()

    • getStratconCampaignState

      public StratConCampaignState getStratconCampaignState()

    • setStratConCampaignState

      public void setStratConCampaignState(StratConCampaignState state)

    • acceptContract

      public void acceptContract(Campaign campaign)
      Description copied from class: Contract
      Calculations to be performed once the contract has been accepted.
      Overrides:
      acceptContract in class Contract

    • clanTechSalvageOverride

      public void clanTechSalvageOverride()
      Applies a salvage override rule for Clan technology based on the contract timeline and faction involvement. This method checks the factions of both the enemy and employer and determines if a salvage exchange should be forced based on whether the battle occurs before the Battle of Tukayyid.

      This rule was implemented to better match canon employer behavior during this period.

    • initiateBatchall

      @Deprecated(since="0.50.07", forRemoval=true) public boolean initiateBatchall(Campaign campaign)
      Deprecated, for removal: This API element is subject to removal in a future version.
      This method initiates a batchall, a challenge/dialog to decide on the conduct of a campaign. Prompts the player with a message and options to accept or refuse the batchall.
      Parameters:
      campaign - The current campaign.
      Returns:
      true if the batchall is accepted, false otherwise.

    • getContractDifficultySkulls

      @Deprecated(since="0.50.06", forRemoval=true) public JPanel getContractDifficultySkulls(Campaign campaign)
      Deprecated, for removal: This API element is subject to removal in a future version.
      use getContractDifficultySkulls() instead

    • getContractDifficultySkulls

      public JPanel getContractDifficultySkulls()
      This method returns a JPanel that represents the difficulty skulls for a given mission.
      Returns:
      a JPanel with the difficulty skulls displayed

    • getBelligerentsPanel

      public JPanel getBelligerentsPanel(int gameYear)
      Creates and returns a JPanel containing the belligerent factions' logos for the specified game year.

      This panel displays the employer and enemy faction logos side by side, separated by a styled divider. The logos are determined based on the provided game year and faction codes, scaled appropriately for the GUI.

      Parameters:
      gameYear - the year used to determine which faction logos to display
      Returns:
      a JPanel with the employer and enemy faction logos, with a divider in between
      Since:
      0.50.06

    • calculateContractDifficulty

      public int calculateContractDifficulty(int gameYear, boolean useGenericBV, List<megamek.common.units.Entity> playerCombatUnits)
      Calculates the difficulty rating of a contract by comparing the estimated combat strength of the opposing force to the combat strength of the player's participating units.

      The method performs the following steps:

      1. Determines the opposing force's effective skill level by applying any faction-based adjustments to their base SkillLevel.
      2. Computes a skill multiplier and applies it to the estimated enemy force power, derived from the game year, force quality, and whether generic BV values are used.
      3. Estimates the total combat power of the player's units based on their BV values and optionally using generic BV rules.
      4. Computes the percentage difference between enemy and player power.
      5. Maps that percentage difference into a difficulty scale ranging from 1 (easiest) to 10 (hardest), centered around 5 as an even match.

      A negative percentage difference indicates that the player is stronger than the opposing force; a positive difference indicates the enemy is stronger. Each 20% shift away from parity increases (or decreases) difficulty by one step.

      If enemy combat strength cannot be computed, the method returns -99 to signal an error.

      Parameters:
      gameYear - the current in-game year used for estimating enemy technology and BV baselines
      useGenericBV - whether generic BV values should be used instead of unit-specific BV calculations
      playerCombatUnits - the list of player Entity objects expected to participate in the contract
      Returns:
      a difficulty rating from 1 to 10, where 5 represents roughly even forces; or -99 if the enemy power estimation fails

    • getCommandRoll

      public int getCommandRoll()
      Returns:
      the command roll that was used to determine command rights. Only used by CamOps Contract Market.

    • setCommandRoll

      public void setCommandRoll(int roll)
      Parameters:
      roll - the command roll that was used to determine command rights. Only used by CamOps Contract Market.

    • getSalvageRoll

      public int getSalvageRoll()
      Returns:
      the salvage roll that was used to determine salvage rights. Only used by CamOps Contract Market.

    • setSalvageRoll

      public void setSalvageRoll(int roll)
      Parameters:
      roll - the salvage roll that was used to determine salvage rights. Only used by CamOps Contract Market.

    • getSupportRoll

      public int getSupportRoll()
      Returns:
      the support roll that was used to determine support rights. Only used by CamOps Contract Market.

    • setSupportRoll

      public void setSupportRoll(int roll)
      Parameters:
      roll - the support roll that was used to determine support rights. Only used by CamOps Contract Market.

    • getTransportRoll

      public int getTransportRoll()
      Returns:
      the transport roll that was used to determine transport rights. Only used by CamOps Contract Market.

    • setTransportRoll

      public void setTransportRoll(int roll)
      Parameters:
      roll - the transport roll that was used to determine transport rights. Only used by CamOps Contract Market.

    • setRoutedPayout

      public void setRoutedPayout(@Nullable Money routedPayout)

    • getRoutedPayout

      @Nullable public Money getRoutedPayout()

    • getRequiredVictoryPoints

      public int getRequiredVictoryPoints()
      Calculates the number of required Victory Points (VP) needed to achieve overall success for this StratCon contract.

      The calculation is based on several averaged campaign parameters:

      • Base requirement — Required number of combat teams multiplied by the contract length.
      • Scenario odds — The mean scenario-odds percentage across all StratCon tracks, converted to a probability.
      • Turning point chance — A scaling factor based on command rights: INTEGRATED contracts assume a 100% chance, while all others use a one-third chance.

      The final result estimates the expected number of Turning Points the player must win for overall contract success. If the player loses a handful of Turning Points, they should still be able to win the contract by being proactive in the Area of Operations.

      Returns:
      the required number of Victory Points, rounded up to the nearest integer
      Since:
      0.50.10