# Retry Mutation Index of Player

Grammar — Retry Mutation mutationNumber|Index of player p
Flags — Native | Function | Restricted

Returns the mutation index for retrying the previous random mutation game for a player. (Mutation Number shold be [0-3])

# Arguments

• int — Player
• int — Mutation Number

Returns — int

native int PlayerRetryMutation(int p, int mutationNumber);

# Related

Category: Player / Player Settings

• Modify Player Property (Integer) — void — PlayerModifyPropertyInt
• Modify Player Property (Real) — void — PlayerModifyPropertyFixed
• Player Property (Integer) — int — PlayerGetPropertyInt
• Player Property (Real) — fixed — PlayerGetPropertyFixed
• Modify Player Score (Integer) — void — PlayerScoreValueSetFromInt
• Modify Player Score (Real) — void — PlayerScoreValueSetFromFixed
• Player Score Value (Integer) — int — PlayerScoreValueGetAsInt
• Player Score Value (Real) — fixed — PlayerScoreValueGetAsFixed
• Turn Player Flag On/Off — void — PlayerSetState
• Player Flag Check — bool — PlayerGetState
• Player License Check — bool — PlayerHasLicense
• Player Access Check — bool — PlayerHasAccessTo
• Player Has Reward — bool — PlayerHasReward
• Player Has Talent — bool — PlayerHasTalent
• Name Of Player — text — PlayerName
• Handle Of Player — string — PlayerHandle
• Race Of Player — string<gamelink::Race> — PlayerRace
• Hero Of Player — string<gamelink::Hero> — PlayerHero
• Skin Of Player — string<gamelink::Skin> — PlayerSkin
• Mount Of Player — string<gamelink::Mount> — PlayerMount
• Spray Of Player — string<gamelink::Spray> — PlayerSpray
• Artifact Of Player — string<gamelink::Artifact> — PlayerArtifact
• Artifact Rank Of Player — int — PlayerArtifactRank
• Commander Of Player — string<gamelink::Commander> — PlayerCommander
• Commander Level Of Player — int — PlayerCommanderLevel
• Commander Mastery Level Of Player — int — PlayerCommanderMasteryLevel
• Commander Mastery Talent Rank Of Player — int — PlayerCommanderMasteryTalentRank
• Commander Selected Prestige Of Player — int — PlayerCommanderSelectedPrestige
• Brutal Plus Difficulty of Player — int — PlayerBrutalPlusDifficulty
• Retry Mutation Index of Player — int — PlayerRetryMutation
• Allied Commander Enemy Wave Type — int — PlayerACEnemyWaveType
• Start Location Of Player — point — PlayerStartLocation
• Controller Of Player — int<preset::PlayerController> — PlayerType
• Status Of Player — int<preset::PlayerStatus> — PlayerStatus
• Set Player Color — void — PlayerSetColorIndex
• Set Player Race — void — PlayerSetRace
• Set Player Hero — void — PlayerSetHero
• Set Player Skin — void — PlayerSetSkin
• Set Player Console Skin — void — PlayerSetConsoleSkin
• Apply Player Skin — void — PlayerApplySkin
• Apply Player Skin (Replacing Existing Unit) — void — libNtve_gf_PlayerApplySkinReplacingExistingUnit
• Set Player Mount — void — PlayerSetMount
• Set Player Spray — void — PlayerSetSpray
• Set Player Commander — void — PlayerSetCommander
• Set Player Commander Level — void — PlayerSetCommanderLevel
• Set Player Commander Mastery Level — void — PlayerSetCommanderMasteryLevel
• Set Player Death Timer — void — PlayerSetDeathTimer
• Set Player Bounds — void — PlayerSetBounds
• Add Player Talent — void — PlayerAddTalent
• Remove Player Talent — void — PlayerRemoveTalent
• Add Player Response — void — PlayerAddResponse
• Remove Player Response — void — PlayerRemoveResponse
• Clear Player Response — void — PlayerClearResponse
• Player Color — int<playercolor> — PlayerGetColorIndex
• Override Player Option — void — PlayerOptionOverride
• Player Hotkey Profile — string — PlayerGetHotkeyProfile
• Player Property Changed — void — TriggerAddEventPlayerPropChange
• Player Joins Game — void — TriggerAddEventPlayerJoin
• Player Leaves Game — void — TriggerAddEventPlayerLeft
• Triggering Player — int — EventPlayer
• Triggering Player Property — int<preset::Player_Property_Get> — EventPlayerProperty
• Triggering Player Property Change (Integer) — int — EventPlayerPropertyChangeInt
• Triggering Player Property Change (Real) — fixed — EventPlayerPropertyChangeFixed
• Player Add Label — void — PlayerAddLabel
• Player Remove Label — void — PlayerRemoveLabel
• Player Remove All Labels — void — PlayerRemoveAllLabels
• Player Has Label — bool — PlayerHasLabel
• Player Add Reward — void — PlayerAddReward

# Examples

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOMI.galaxy:1029

    }
    AIAddAirDangerCampaignUnits(lp_player);
    if ((libCOMI_gv_cM_CoopAIPlayer_CommanderShared == "None") && (PlayerRetryMutation(1, 0) > 0)) {
        libCOMI_gv_cM_CoopAIPlayer_Commander[lp_player] = libCOOC_gf_CC_AICommanderByUniqueIndex(PlayerACEnemyWaveType(1));
        libCOMI_gf_CM_CoopAIPersonalitySet(libCOMI_gv_cM_CoopAIPlayer_Commander[lp_player]);

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOMI.galaxy:12366

    if ((libCOMI_gf_DifficultyLevelForPlayerCoop(1) == 4) && (libCOMI_gf_DifficultyLevelForPlayerCoop(2) == 4) && ((lv_brutalPlusDiff >= 1) && (lv_brutalPlusDiff <= UserDataInstanceCount("MutationDifficultyLevels")))) {
        TriggerDebugOutput(1, StringExternal("Param/Value/lib_COMI_4F9E6618"), false);
        TextExpressionSetToken("Param/Expression/lib_COMI_C8E147FC", "A", IntToText(PlayerRetryMutation(1, 1)));
        TriggerDebugOutput(1, TextExpressionAssemble("Param/Expression/lib_COMI_C8E147FC"), false);
        if ((PlayerRetryMutation(1, 0) > 0)) {

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOMI.galaxy:12368

        TextExpressionSetToken("Param/Expression/lib_COMI_C8E147FC", "A", IntToText(PlayerRetryMutation(1, 1)));
        TriggerDebugOutput(1, TextExpressionAssemble("Param/Expression/lib_COMI_C8E147FC"), false);
        if ((PlayerRetryMutation(1, 0) > 0)) {
            TriggerDebugOutput(1, StringExternal("Param/Value/lib_COMI_519C94CF"), false);
            libCOMU_gf_CT_SetMutationDifficultyLevel("Plus1");

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOMI.galaxy:12374

            lv_mutatorCount = 0;
            for ( ; ( (auto389E0899_ai >= 0 && lv_mutatorCount <= auto389E0899_ae) || (auto389E0899_ai < 0 && lv_mutatorCount >= auto389E0899_ae) ) ; lv_mutatorCount += auto389E0899_ai ) {
                if ((PlayerRetryMutation(1, lv_mutatorCount) > 0)) {
                    lv_retrymutatorindex = PlayerRetryMutation(1, lv_mutatorCount);
                    libCOMU_gv_cT_MAbomination_MutatorsCount += 1;

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOMI.galaxy:12375

            for ( ; ( (auto389E0899_ai >= 0 && lv_mutatorCount <= auto389E0899_ae) || (auto389E0899_ai < 0 && lv_mutatorCount >= auto389E0899_ae) ) ; lv_mutatorCount += auto389E0899_ai ) {
                if ((PlayerRetryMutation(1, lv_mutatorCount) > 0)) {
                    lv_retrymutatorindex = PlayerRetryMutation(1, lv_mutatorCount);
                    libCOMU_gv_cT_MAbomination_MutatorsCount += 1;
                    libCOMU_gv_cT_MAbomination_Mutators[libCOMU_gv_cT_MAbomination_MutatorsCount] = UserDataInstance("Mutators", lv_retrymutatorindex);