Class BattleCode24Arena

codeclash/arenas/battlecode24/battlecode24.py:40–377

BattleCode24 arena implementation. Lifecycle: 1. validate_code() - Source-level structural checks only (in agent container) 2. execute_round() - Compile and run simulations (in game container) 3. get_results() - Parse logs and determine winner Failure handling: - If one age

class BattleCode24Arena(CodeArena):
    """BattleCode24 arena implementation.

    Lifecycle:
    1. validate_code() - Source-level structural checks only (in agent container)
    2. execute_round() - Compile and run simulations (in game container)
    3. get_results() - Parse logs and determine winner

    Failure handling:
    - If one agent fails to compile, the other wins automatically
    - If both fail to compile, round is a no-contest (tie)
    - Individual simulation failures don't count toward either player
    """

    name: str = "BattleCode24"
    description: str = """Battlecode 2024: Breadwars is a real-time strategy game where your Java bot controls a team of robots competing to capture the opponent's flags.
Your mission: capture all 3 of the opponent's flags before they capture yours. Robots can attack, heal, build traps, dig/fill terrain, and specialize in different skills through experience.
The game features a setup phase (first 200 rounds) where teams are separated by a dam, followed by open combat. Robots gain experience and level up their attack, build, and heal specializations."""
    default_args: dict = {
        "maps": "DefaultSmall",
    }
    submission: str = "src/mysubmission"

    def __init__(self, config, **kwargs):
        super().__init__(config, **kwargs)
        assert len(config["players"]) == 2, "BattleCode24 is a two-player game"

        # Build base run command
        self.run_cmd_base: str = "./gradlew --no-daemon run"
        for arg, val in self.game_config.get("args", self.default_args).items():
            if isinstance(val, bool):
                if val:
                    self.run_cmd_base += f" -P{arg}=true"
            else:
                self.run_cmd_base += f" -P{arg}={val}"

        # Round state (set by execute_round, used by get_results)
        self._round_result: RoundResult | None = None

    def validate_code(self, agent: Player) -> tuple[bool, str | None]:
        """Validate source structure. No compilation - that happens in execute_round.

        Checks:
        1. src/mysubmission/ directory exists
        2. RobotPlayer.java file exists
        3. run(RobotController rc) method signature present
        4. Correct package declaration
        """
        # Check for mysubmission directory
        ls_output = agent.environment.execute("ls src")["output"]
        if BC24_FOLDER not in ls_output:
            return False, f"There should be a `src/{BC24_FOLDER}/` directory"

        # Check for RobotPlayer.java file
        ls_mysubmission = agent.environment.execute(f"ls src/{BC24_FOLDER}")["output"]
        if "RobotPlayer.java" not in ls_mysubmission:
            return False, f"There should be a `src/{BC24_FOLDER}/RobotPlayer.java` file"