Method scry

forge-game/src/main/java/forge/game/GameAction.java:2581–2658

(final List<Player> players, int numScry, SpellAbility cause)

    }

    public void scry(final List<Player> players, int numScry, SpellAbility cause) {
        if (numScry <= 0) {
            // CR 701.22b If a player is instructed to scry 0, no scry event occurs.
            return;
        }

        // in case something alters the scry amount
        Map<Player, Integer> actualPlayers = Maps.newLinkedHashMap();

        for (final Player p : players) {
            int playerScry = numScry;
            final Map<AbilityKey, Object> repParams = AbilityKey.mapFromAffected(p);
            repParams.put(AbilityKey.Source, cause);
            repParams.put(AbilityKey.Num, playerScry);

            switch (game.getReplacementHandler().run(ReplacementType.Scry, repParams)) {
                case NotReplaced:
                    break;
                case Updated: {
                    playerScry = (int) repParams.get(AbilityKey.Num);
                    break;
                }
                default:
                    continue;
            }
            if (playerScry > 0) {
                actualPlayers.put(p, playerScry);

                // no real need to separate out the look if there is only one player scrying
                if (players.size() > 1) {
                    revealTo(p.getCardsIn(ZoneType.Library, playerScry), p);
                }
            }
        }

        // make the decisions
        Map<Player, ImmutablePair<CardCollection, CardCollection>> decisions = Maps.newLinkedHashMap();
        for (final Map.Entry<Player, Integer> e : actualPlayers.entrySet()) {
            final Player p = e.getKey();
            final CardCollection topN = new CardCollection(p.getCardsIn(ZoneType.Library, e.getValue()));
            ImmutablePair<CardCollection, CardCollection> decision = p.getController().arrangeForScry(topN);
            decisions.put(p, decision);
            int numToTop = decision.getLeft() == null ? 0 : decision.getLeft().size();
            int numToBottom = decision.getRight() == null ? 0 : decision.getRight().size();

            // publicize the decision
            game.fireEvent(new GameEventScry(PlayerView.get(p), numToTop, numToBottom));
        }
        // do the moves after all the decisions (maybe not necessary, but let's
        // do it the official way)
        for (Map.Entry<Player, ImmutablePair<CardCollection, CardCollection>> e : decisions.entrySet()) {
            // no good iterate simultaneously in Java
            final Player p = e.getKey();
            final CardCollection toTop = e.getValue().getLeft();
            final CardCollection toBottom = e.getValue().getRight();
            int numLookedAt = 0;
            if (toTop != null) {
                numLookedAt += toTop.size();