# Handle Of Player

Grammar — Handle of player p
Flags — Native | Function

Returns a unique Battle.net identifier for the player that will persist between name changes.

# Arguments

• int — Player

Returns — string

native string PlayerHandle(int inPlayer);

# 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/heroesbrawlmods/brawlmapmods/coop/deadmansstand.stormmod — base.stormdata/LibPEB1.galaxy:13282

    for ( ; ( (auto459D12F5_ai >= 0 && lv_player <= auto459D12F5_ae) || (auto459D12F5_ai < 0 && lv_player >= auto459D12F5_ae) ) ; lv_player += auto459D12F5_ai ) {
        TextExpressionSetToken("Param/Expression/lib_PEB1_42D787D2", "A", IntToText(lv_player));
        TextExpressionSetToken("Param/Expression/lib_PEB1_42D787D2", "B", StringToText(PlayerHandle(lv_player)));
        TriggerDebugOutput(1, TextExpressionAssemble("Param/Expression/lib_PEB1_42D787D2"), true);
    }

mods/heroesdata.stormmod — base.stormdata/TriggerLibs/GameLib.galaxy:18024

        StatEventAddDataString(lv_stat, "MapID", lv_mapID);
        StatEventAddDataInt(lv_stat, "PlayerID", lv_player);
        StatEventAddDataString(lv_stat, "PlayerHandle", PlayerHandle(lv_player));
        StatEventAddDataString(lv_stat, "WheelAction", lv_action);
        StatEventAddDataString(lv_stat, "HeroID", (UnitGetType(lv_heroUnit)));

mods/heroesdata.stormmod — base.stormdata/TriggerLibs/GameLib.galaxy:18176

        StatEventAddDataString(lv_stat, "MapID", lv_mapID);
        StatEventAddDataInt(lv_stat, "PlayerID", lv_yellingPlayer);
        StatEventAddDataString(lv_stat, "PlayerHandle", PlayerHandle(lv_yellingPlayer));
        StatEventAddDataString(lv_stat, "VoiceLineID", (lv_voiceLine));
        StatEventAddDataString(lv_stat, "HeroID", (UnitGetType(lv_heroUnit)));

mods/heroesdata.stormmod — base.stormdata/TriggerLibs/GameLib.galaxy:18252

        StatEventAddDataString(lv_stat, "MapID", lv_mapID);
        StatEventAddDataInt(lv_stat, "PlayerID", lv_sprayingPlayer);
        StatEventAddDataString(lv_stat, "PlayerHandle", PlayerHandle(lv_sprayingPlayer));
        StatEventAddDataString(lv_stat, "SprayID", (lv_spray));
        StatEventAddDataString(lv_stat, "HeroID", (UnitGetType(lv_heroUnit)));

mods/heroesdata.stormmod — base.stormdata/TriggerLibs/SupportLib.galaxy:648

        StatEventAddDataString(StatEventLastCreated(), "Controller", lv_controller);
        if ((PlayerType(lv_i) == c_playerTypeUser)) {
            lv_handle = PlayerHandle(lv_i);
            if ((lv_handle != "")) {
                StatEventAddDataString(StatEventLastCreated(), "ToonHandle", lv_handle);

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOOC.galaxy:5244

        libCOOC_gf_CC_StatEventAddInt("PlayerIndex", lv_indexPlayer, libCOOC_gf_CC_StatEventLast());
        if ((GameIsOnline() == true)) {
            libCOOC_gf_CC_StatEventAddStr("PlayerHandle", PlayerHandle(lv_indexPlayer), libCOOC_gf_CC_StatEventLast());
        }