manabrew-engine 0.4.1

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

//! AssembleContraption — assemble contraptions from the contraption deck (Unstable).
//! Ported from Java's AssembleContraptionEffect: moves top card of contraption
//! deck to battlefield, assigns a sprocket.

use forge_foundation::ZoneType;

use super::EffectContext;
use crate::parsing::keys;
use crate::replacement::replacement_handler::{apply_replacements, ReplacementEvent};
use crate::replacement::ReplacementResult;

/// Struct form of this effect so it can participate in the
/// `SpellAbilityEffect` trait hierarchy — mirrors Java's
/// `AssembleContraptionEffect` class extending `SpellAbilityEffect`.
#[manabrew_engine_macros::spell_effect(AssembleContraptionEffect)]
fn resolve(ctx: &mut EffectContext, sa: &crate::spellability::SpellAbility) {
    let source = match sa.source {
        Some(s) => s,
        None => return,
    };

    let amount = super::resolve_numeric_svar(ctx.game, sa, "Amount", 1).max(1);

    let controller = sa.activating_player;

    // Run AssembleContraption replacement effects before assembling.
    let mut event = ReplacementEvent::AssembleContraption { player: controller };
    let result = apply_replacements(ctx.game, &mut event);
    if result == ReplacementResult::Skipped || result == ReplacementResult::Replaced {
        return;
    }

    for _ in 0..amount {
        let contraption = ctx
            .game
            .cards_in_zone(ZoneType::ContraptionDeck, controller)
            .first()
            .copied()
            .or_else(|| {
                // Compatibility fallback until full deck-section setup is wired.
                ctx.game
                    .cards
                    .iter()
                    .find(|c| {
                        c.owner == controller
                            && c.zone == ZoneType::Sideboard
                            && c.type_line
                                .subtypes
                                .iter()
                                .any(|s| s.eq_ignore_ascii_case("Contraption"))
                    })
                    .map(|c| c.id)
            });

        if let Some(card_id) = contraption {
            let old_zone = ctx.game.card(card_id).zone;
            ctx.game
                .move_card(card_id, ZoneType::Battlefield, controller);
            super::emit_zone_trigger(
                ctx.trigger_handler,
                card_id,
                old_zone,
                ZoneType::Battlefield,
            );

            // Assign a sprocket (1-3)
            let sprocket = (ctx.rng.next_int(3) + 1).to_string();
            ctx.game
                .card_mut(card_id)
                .svars
                .insert("Sprocket".to_string(), sprocket);

            if sa.param_is_true(keys::REMEMBER) {
                ctx.game.card_mut(source).add_remembered_card(card_id);
            }
        }
    }
}