manabrew_engine/ability/effects/
skip_turn_effect.rs

1use super::{resolve_defined_players, resolve_numeric_svar, EffectContext};
2use crate::parsing::keys;
3
4/// Resolve `SP$ SkipTurn` — make a player skip their next turn(s).
5///
6/// Mirrors Java `SkipTurnEffect.java`.
7/// Increments `player.skip_turns` counter. The game loop checks this
8/// at the start of a turn and skips it if > 0.
9///
10/// # Card script examples
11/// ```text
12/// A:SP$ SkipTurn | Defined$ Opponent | NumTurns$ 1
13/// ```
14/// Struct form of this effect so it can participate in the
15/// `SpellAbilityEffect` trait hierarchy — mirrors Java's
16/// `SkipTurnEffect` class extending `SpellAbilityEffect`.
17#[manabrew_engine_macros::spell_effect(SkipTurnEffect)]
18fn resolve(ctx: &mut EffectContext, sa: &crate::spellability::SpellAbility) {
19    let controller = sa.activating_player;
20    let num = resolve_numeric_svar(ctx.game, sa, keys::NUM_TURNS, 1);
21
22    let defined = sa.defined().unwrap_or("You");
23
24    let targets = resolve_defined_players(defined, controller, ctx.game);
25    for target in targets {
26        if ctx.game.player(target).is_alive() {
27            ctx.game.player_add_skip_turns(target, num);
28        }
29    }
30}
31
32#[cfg(test)]
33mod tests {
34    use crate::ability::spell_ability_effect::SpellAbilityEffect;
35    use std::collections::HashMap;
36
37    use crate::ability::effects::EffectContext;
38    use crate::agent::PassAgent;
39    use crate::game::GameState;
40    use crate::ids::PlayerId;
41    use crate::mana::ManaPool;
42    use crate::spellability::SpellAbility;
43    use crate::trigger::handler::TriggerHandler;
44
45    #[test]
46    fn skip_turn_increments_counter() {
47        let mut game = GameState::new(&["Alice", "Bob"], 20);
48        let p0 = PlayerId(0);
49        let p1 = PlayerId(1);
50
51        let sa =
52            SpellAbility::new_simple(None, p0, "SP$ SkipTurn | Defined$ Opponent | NumTurns$ 1");
53
54        let mut th = TriggerHandler::new();
55        let mut agents: Vec<Box<dyn crate::agent::PlayerAgent>> =
56            vec![Box::new(PassAgent), Box::new(PassAgent)];
57        let mut mp = vec![ManaPool::default(), ManaPool::default()];
58        let templates = HashMap::new();
59        let templates_variants = HashMap::new();
60        let token_fallback = HashMap::new();
61        let edition_dates: HashMap<String, String> = HashMap::new();
62        let mut rng_adapter = crate::game_rng::ThreadRngAdapter;
63        let mut ctx = EffectContext {
64            game: &mut game,
65            combat: None,
66            agents: &mut agents,
67            trigger_handler: &mut th,
68            token_templates: &templates,
69            token_art_variants: &templates_variants,
70            token_fallback: &token_fallback,
71            edition_dates: &edition_dates,
72            mana_pools: &mut mp,
73            parent_target_card: None,
74            rng: &mut rng_adapter,
75        };
76        super::SkipTurnEffect::resolve(&mut ctx, &sa);
77
78        assert_eq!(ctx.game.player(p1).skip_turns, 1);
79    }
80}
manabrew_engine/ability/effects/skip_turn_effect.rs

manabrew_engine/ability/effects/
skip_turn_effect.rs
