manabrew-engine 0.6.0

Magic: The Gathering rules engine — a Rust port of Forge
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

//! Behold (reveal from hand or battlefield) as a cost. Mirrors Java's `CostBehold`.
//!
//! Behold extends CostReveal in Java, allowing reveal from Hand or Battlefield.
//! Optionally exiles the revealed cards.

use forge_foundation::ZoneType;

use crate::game::GameState;
use crate::ids::CardId;

/// Execute behold payment for selected cards.
/// Cards have already been chosen by the agent.
/// If `exile` is true, moves revealed cards to exile.
pub fn pay_as_decided_cards(game: &mut GameState, cards: &[CardId], exile: bool) -> bool {
    if exile {
        for &cid in cards {
            let owner = game.card(cid).owner;
            game.move_card(cid, ZoneType::Exile, owner);
        }
    }
    // Non-exile behold just reveals — no zone change needed
    true
}

pub const HASH_LKI: &str = "Beheld";
pub const HASH_CARDS: &str = "BeheldCards";

pub fn can_pay(
    game: &crate::game::GameState,
    _available_mana: &crate::mana::ManaPool,
    source: crate::ids::CardId,
    player: crate::ids::PlayerId,
    _ability: Option<&crate::spellability::SpellAbility>,
    part: &super::CostPart,
) -> bool {
    let super::CostPart::Behold {
        amount,
        type_filter,
        ..
    } = part
    else {
        return false;
    };
    let resolved_amount = amount.resolve(game, source, player);
    if type_filter.ends_with("ChosenType") {
        let mut cards = game.cards_in_zone(ZoneType::Hand, player).to_vec();
        cards.extend(
            game.cards_in_zone(ZoneType::Battlefield, player)
                .iter()
                .copied(),
        );
        for &cid in &cards {
            let shared = cards
                .iter()
                .filter(|&&other| super::shares_creature_type(game, cid, other))
                .count() as i32;
            if shared >= resolved_amount {
                return true;
            }
        }
        return false;
    }
    let mut count = 0i32;
    for &cid in game.cards_in_zone(ZoneType::Hand, player) {
        if cid == source {
            continue;
        }
        if type_filter == "Card"
            || type_filter.is_empty()
            || crate::ability::effects::matches_change_type(game.card(cid), type_filter, &[])
        {
            count += 1;
        }
    }
    for &cid in game.cards_in_zone(ZoneType::Battlefield, player) {
        if type_filter == "Card"
            || type_filter.is_empty()
            || crate::ability::effects::matches_change_type(game.card(cid), type_filter, &[])
        {
            count += 1;
        }
    }
    count >= resolved_amount
}

pub fn pay_with_decision(
    game: &mut GameState,
    _player: crate::ids::PlayerId,
    _source: CardId,
    part: &super::CostPart,
    decision: &crate::cost::payment_decision::PaymentDecision,
) -> bool {
    let super::CostPart::Behold { exile, .. } = part else {
        return false;
    };
    if let crate::cost::payment_decision::PaymentDecision::Cards(cards) = decision {
        return pay_as_decided_cards(game, cards, *exile);
    }
    false
}