Method surveil

forge-game/src/main/java/forge/game/player/Player.java:1059–1105

(int num, SpellAbility cause, Map<AbilityKey, Object> params)

    }

    public void surveil(int num, SpellAbility cause, Map<AbilityKey, Object> params) {
        num += StaticAbilitySurveilNum.surveilNumMod(this);

        final CardCollection topN = getTopXCardsFromLibrary(num);

        if (!topN.isEmpty()) {
            final Pair<CardCollection, CardCollection> lists = getController().arrangeForSurveil(topN);
            final CardCollection toTop = lists.getLeft();
            final CardCollection toGrave = lists.getRight();

            int numToGrave = 0;
            int numToTop = 0;

            if (toGrave != null) {
                for (Card c : toGrave) {
                    Card moved = getGame().getAction().moveToGraveyard(c, cause, params);
                    moved.setSurveilled(true);
                    numToGrave++;
                }
                if (cause.hasParam("RememberMoved")) {
                    cause.getHostCard().addRemembered(toGrave);
                }
            }

            if (toTop != null) {
                Collections.reverse(toTop); // the last card in list will become topmost in library, have to revert thus.
                for (Card c : toTop) {
                    getGame().getAction().moveToLibrary(c, cause, params);
                    numToTop++;
                }
                if (cause.hasParam("RememberKept")) {
                    cause.getHostCard().addRemembered(toTop);
                }
            }

            getGame().fireEvent(new GameEventSurveil(PlayerView.get(this), numToTop, numToGrave));
        }

        final Map<AbilityKey, Object> runParams = AbilityKey.mapFromPlayer(this);
        runParams.put(AbilityKey.FirstTime, surveilThisTurn == 0);
        if (params != null) {
            runParams.putAll(params);
        }
        getGame().getTriggerHandler().runTrigger(TriggerType.Surveil, runParams, false);

        surveilThisTurn++;
    }

    public int getSurveilThisTurn() {
        return surveilThisTurn;