Battler Mechanics: A Comprehensive Overview

Introduction

In the BattleTech Battler platform, an Agent is represented by a token contract address. When Agents engage in battle, they compete for a share of each other’s deposited liquidity—every battle produces a clear outcome.

Battle Process: Step by Step

When two Agents battle, the following sequence occurs:

• Setup:
  Agent A and Agent B each have liquidity provided by their supporters.
• Matchmaking: Agents are paired based on their liquidity bracket. Agents within the same bracket are randomly matched to ensure fair competition.
• Battle:
  Agent A and Agent B battle, and a winner is randomly chosen based on calculated odds derived from their market caps and bonuses.
• Liquidity Sale:
  A predetermined portion of the losing Agent’s (Agent B’s) deposited liquidity is sold.
• Token Purchase:
  The proceeds are used to purchase an equivalent value of the winning Agent’s token.
• Reward Distribution:
  After deducting platform fees, the purchased tokens are distributed among the winning Agent’s depositors in proportion to their contribution. The higher a depositor’s share, the greater the reward—this reward is lifetime as long as the Agent continues battling.

Agents & Eligibility

Importing and Activating an Agent

• Import: Anyone can import an Agent to the platform.
• Activation: An Agent becomes eligible for battle once a cumulative minimum of $200 worth of liquidity (from one or more wallets) is deposited AND the Agent's external DEX liquidity pool remains above $6,000.

Agent Deactivation & Reactivation

• Deactivation: Agents are automatically deactivated if their liquidity falls below the minimum battle wager—currently set at $5.
• Reactivation: To reactivate, the Agent must once again meet the $200 minimum deposit.

Matchmaking & Brackets

Fair Matchmaking Algorithm

The matchmaking algorithm ensures fair battles by pairing Agents based on their liquidity bracket. Here's how it works in detail:

1. Bracket Assignment: Each Agent is assigned to a bracket based on their current liquidity in USD. The bracket is determined by comparing the Agent's liquidity against predefined bracket ranges.
2. Grouping Agents: Agents are grouped by their assigned brackets.
3. Balancing Brackets: Starting from the highest bracket, if a bracket has an odd number of Agents, one random Agent is moved down to the next lower bracket. This process continues downward, ensuring that as many Agents as possible are paired for battle.
4. Random Pairing: Within each bracket, Agents are randomly shuffled and paired off for battles.

Brackets Overview

There are 14 brackets defined by the liquidity ranges:

• Bracket Prizing: Higher brackets bring higher absolute rewards due to larger liquidity pools, but the percentage of liquidity transferred decreases as brackets increase.

Battling Mechanics

Dynamic Lore Generation

Each battle unfolds within the immersive BattleTech Lore. An AI dynamically generates a narrative based on each Agent’s battle history, abilities, and opponent—recording the sequence of events that led to victory.

Smart Contract Operations

The smart contract automates and secures the battle transactions by:

• Selling a predetermined portion of the losing Agent’s deposited liquidity.
• Using the proceeds to purchase an equivalent value of the winning Agent’s token.
• Distributing the purchased tokens (after deducting platform fees) among the winning Agent’s depositors proportionally.

Winning Odds & Reward Structure

Determining Winning Odds

• Calculation:
  The chance to win is based on an Agent’s market cap and any applicable bonuses. A higher market cap yields a higher probability of victory.
• Formula (subject to future adjustments):

base_chance = marketcapA / (marketcapA + marketcapB)
modified_chance = (base_chance * (1 + bonusesA)) / ((base_chance * (1 + bonusesA)) + ((1 - base_chance) * (1 + bonusesB)))
MIN_WIN_CHANCE = 0.1
final_chance = min(max(modified_chance, MIN_WIN_CHANCE), 1 - MIN_WIN_CHANCE)

Reward Dynamics

• Reward Factors: Rewards are influenced by both the available liquidity and the Agent’s win chance.

  The battle reward is calculated by taking the smaller of the two agents' liquidity pools (to ensure fair risk exposure), multiplying it by the bracket's transfer percentage (which decreases as brackets get higher) and a 2x multiplier, then adjusting this amount based on win probability.

  Since the reward is inversely proportional to the winner's original win chance, it creates a balanced system where underdogs have lower win rates but can score significantly larger rewards when they do win.

• Formula (subject to future adjustments):

liqTransferPct = bracket.liquidityTransfer
liquidityMultiplier = 2
minLiquidity = min(agentA_liquidity, agentB_liquidity)
baseTransferAmount = liqTransferPct * minLiquidity * liquidityMultiplier

if agentA wins:
    effectiveTransferAmount = baseTransferAmount * (1 - agentA_win_chance)
else:
    effectiveTransferAmount = baseTransferAmount * agentA_win_chance

pctToTransfer = effectiveTransferAmount / losingAgent_liquidity

Fee Structure

• Battle Fee: A total fee of 3% is applied per battle:
• 1.5% to depositors.
• 1.5% to platform and community rewards.

Chance to Win Bonuses

• Deposit Bonus: The number of deposit can increase an Agent’s chance to win by up to an additional 5% (applied multiplicatively). The maximum bonus is achieved with 5 unique depositors, each contributing a minimum of $5.