# New Unit Owner

Grammar — New unit owner
Flags — Native | Function

Returns the new owner of a unit, when used in response to “Unit Owner Changes”.

Returns — int

native int EventUnitOwnerNew();

# Supported triggers

Unit Owner Changes — TriggerAddEventUnitChangeOwner

Category: Unit / Basic

Unit Show Kill Display — void — UnitShowKillDisplay
Unit Can Path To Point — bool — UnitPathableToPoint
Unit Can Path To Unit — bool — UnitPathableToUnit
Create Units With Default Facing — void — libNtve_gf_CreateUnitsWithDefaultFacing
Create Units With Point Facing — void — libNtve_gf_CreateUnitsAtPoint2
Create Units Facing Angle — unitgroup — UnitCreate
Create Units Facing Point — unitgroup — libNtve_gf_UnitCreateFacingPoint
Last Created Unit — unit — UnitLastCreated
Last Created Units — unitgroup — UnitLastCreatedGroup
Original Caster Of Unit — unit — UnitGetOriginalCaster
Effect That Created Unit — string<gamelink::Effect> — UnitGetOriginalEffect
Replace Unit — void — libNtve_gf_ReplaceUnit
Last Replaced Unit — unit — libNtve_gf_LastReplacedUnit
Change Owner — void — UnitSetOwner
Unit Owner Changes — void — TriggerAddEventUnitChangeOwner
Old Unit Owner — int — EventUnitOwnerOld
New Unit Owner — int — EventUnitOwnerNew
Rescue Unit — void — libNtve_gf_RescueUnit
Rescue Unit Group — void — libNtve_gf_RescueUnit2
Kill Unit — void — UnitKill
Revive Unit — void — UnitRevive
Remove Unit — void — UnitRemove
Owner Of Unit — int — UnitGetOwner
Unit Is Alive — bool — UnitIsAlive
Unit Is Valid — bool — UnitIsValid
Unit Group Is Dead — bool — libNtve_gf_UnitGroupIsDead
Move Unit Instantly — void — UnitSetPosition
Make Unit Face Angle — void — UnitSetFacing
Make Unit Face Point — void — libNtve_gf_MakeUnitFacePoint
Position Of Unit — point — UnitGetPosition
Goal Position Of Unit — point — UnitGetGoalPosition
Facing Angle Of Unit — fixed — UnitGetFacing
Pause/Unpause Unit — void — libNtve_gf_PauseUnit
Pause/Unpause All Units — void — UnitPauseAll
Sleep/WakeUp Unit — void — libNtve_gf_SleepUnit
Show/Hide Unit — void — libNtve_gf_ShowHideUnit
Share Vision of Unit — void — libNtve_gf_ShareVisionofUnit
Unit Is Paused — bool — libNtve_gf_UnitIsPaused
Unit Is Sleepiing — bool — libNtve_gf_UnitIsSleepiing
Unit Is Hidden — bool — libNtve_gf_UnitIsHidden
Unit Is Visible To Player — bool — libNtve_gf_UnitIsVisibleToPlayer
Set Unit Custom Value — void — UnitSetCustomValue
Custom Value Of Unit — fixed — UnitGetCustomValue
Unit Enters/Leaves Region — void — TriggerAddEventUnitRegion
Triggering Region — region — EventUnitRegion
Unit Enters/Leaves Point — void — TriggerAddEventUnitRangePoint
Unit Enters/Leaves Range Of Unit — void — TriggerAddEventUnitRange
Triggering Range Unit — unit — EventUnitRangeUnit
Unit In Region — bool — libNtve_gf_UnitInRegion
Triggering Unit — unit — EventUnit
Load Unit Model — void — UnitLoadModel
Unload Unit Model — void — UnitUnloadModel
Agent Of Player For Unit — unit — UnitAgent
Change Empty Unit Variables In Events — void — UnitEventSetNullVariableInvalid
Name of Unit — text — UnitGetName
Ideal Harvester Count — int — UnitIdealWorkerCount
Current Harvester Count — int — UnitCurrentWorkerCount

# Examples

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/paiur06.sc2map/MapScript.galaxy:3132

    // Conditions
    if (testConds) {
        if (!((EventUnitOwnerNew() == gv_pLAYER_08_NERAZIM))) {
            return false;
        }

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pcampaigntest.sc2map/MapScript.galaxy:870

    }

    if ((EventUnitOwnerNew() == gv_pLAYER_01_USER)) {
        ActorSend(libNtve_gf_MainActorofUnit(EventUnit()), libNtve_gf_SetTintColor(Color(0.00, 0.00, 100.00), 1.0, 0.0));
    }

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pcampaigntest.sc2map/MapScript.galaxy:874

    }
    else {
        if (((libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_Enemy) == true) || (libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_EnemyMutual) == true))) {
            ActorSend(libNtve_gf_MainActorofUnit(EventUnit()), libNtve_gf_SetTintColor(Color(100.00, 0.00, 0.00), 1.0, 0.0));
        }

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pcampaigntest.sc2map/MapScript.galaxy:874

    }
    else {
        if (((libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_Enemy) == true) || (libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_EnemyMutual) == true))) {
            ActorSend(libNtve_gf_MainActorofUnit(EventUnit()), libNtve_gf_SetTintColor(Color(100.00, 0.00, 0.00), 1.0, 0.0));
        }

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pcampaigntest.sc2map/MapScript.galaxy:878

        }
        else {
            if (((libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_Neutral) == true) || (libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_NeutralMutual) == true))) {
                ActorSend(libNtve_gf_MainActorofUnit(EventUnit()), libNtve_gf_SetTintColor(Color(100.00, 100.00, 0.00), 1.0, 0.0));
            }

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pcampaigntest.sc2map/MapScript.galaxy:878

        }
        else {
            if (((libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_Neutral) == true) || (libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_NeutralMutual) == true))) {
                ActorSend(libNtve_gf_MainActorofUnit(EventUnit()), libNtve_gf_SetTintColor(Color(100.00, 100.00, 0.00), 1.0, 0.0));
            }

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pcampaigntest.sc2map/MapScript.galaxy:882

            }
            else {
                if (((libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_Ally) == true) || (libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_NeutralMutual) == true))) {
                    ActorSend(libNtve_gf_MainActorofUnit(EventUnit()), libNtve_gf_SetTintColor(Color(0.00, 100.00, 0.00), 1.0, 0.0));
                }

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pcampaigntest.sc2map/MapScript.galaxy:882

            }
            else {
                if (((libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_Ally) == true) || (libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_NeutralMutual) == true))) {
                    ActorSend(libNtve_gf_MainActorofUnit(EventUnit()), libNtve_gf_SetTintColor(Color(0.00, 100.00, 0.00), 1.0, 0.0));
                }

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/paiur06.sc2map — MapScript.galaxy:3132

    // Conditions
    if (testConds) {
        if (!((EventUnitOwnerNew() == gv_pLAYER_08_NERAZIM))) {
            return false;
        }

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pcampaigntest.sc2map — MapScript.galaxy:870

    }

    if ((EventUnitOwnerNew() == gv_pLAYER_01_USER)) {
        ActorSend(libNtve_gf_MainActorofUnit(EventUnit()), libNtve_gf_SetTintColor(Color(0.00, 0.00, 100.00), 1.0, 0.0));
    }

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pcampaigntest.sc2map — MapScript.galaxy:874

    }
    else {
        if (((libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_Enemy) == true) || (libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_EnemyMutual) == true))) {
            ActorSend(libNtve_gf_MainActorofUnit(EventUnit()), libNtve_gf_SetTintColor(Color(100.00, 0.00, 0.00), 1.0, 0.0));
        }

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pcampaigntest.sc2map — MapScript.galaxy:874

    }
    else {
        if (((libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_Enemy) == true) || (libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_EnemyMutual) == true))) {
            ActorSend(libNtve_gf_MainActorofUnit(EventUnit()), libNtve_gf_SetTintColor(Color(100.00, 0.00, 0.00), 1.0, 0.0));
        }

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pcampaigntest.sc2map — MapScript.galaxy:878

        }
        else {
            if (((libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_Neutral) == true) || (libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_NeutralMutual) == true))) {
                ActorSend(libNtve_gf_MainActorofUnit(EventUnit()), libNtve_gf_SetTintColor(Color(100.00, 100.00, 0.00), 1.0, 0.0));
            }

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pcampaigntest.sc2map — MapScript.galaxy:878

        }
        else {
            if (((libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_Neutral) == true) || (libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_NeutralMutual) == true))) {
                ActorSend(libNtve_gf_MainActorofUnit(EventUnit()), libNtve_gf_SetTintColor(Color(100.00, 100.00, 0.00), 1.0, 0.0));
            }

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pcampaigntest.sc2map — MapScript.galaxy:882

            }
            else {
                if (((libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_Ally) == true) || (libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_NeutralMutual) == true))) {
                    ActorSend(libNtve_gf_MainActorofUnit(EventUnit()), libNtve_gf_SetTintColor(Color(0.00, 100.00, 0.00), 1.0, 0.0));
                }

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pcampaigntest.sc2map — MapScript.galaxy:882

            }
            else {
                if (((libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_Ally) == true) || (libNtve_gf_PlayerIsEnemy(EventUnitOwnerNew(), gv_pLAYER_01_USER, libNtve_ge_PlayerRelation_NeutralMutual) == true))) {
                    ActorSend(libNtve_gf_MainActorofUnit(EventUnit()), libNtve_gf_SetTintColor(Color(0.00, 100.00, 0.00), 1.0, 0.0));
                }

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOMU.galaxy:10497

    }

    if ((PlayerGroupHasPlayer(libCOOC_gf_HumanPlayers(), EventUnitOwnerOld()) == false) && (PlayerGroupHasPlayer(libCOOC_gf_HumanPlayers(), EventUnitOwnerNew()) == true)) {
        libCOMU_gf_CT_RemoveAvenger(EventUnit());
        libCOMU_gf_CT_RemoveUnitSpeed(EventUnit());

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOMU.galaxy:10503

    }

    if ((PlayerGroupHasPlayer(libCOOC_gf_HumanPlayers(), EventUnitOwnerOld()) == true) && (PlayerGroupHasPlayer(libCOOC_gf_HumanPlayers(), EventUnitOwnerNew()) == false)) {
        libCOMU_gf_CT_RemoveStructureStealBehavior(EventUnit());
    }

mods/warcoop/warclassicsystem.sc2mod — base.sc2data/TriggerLibs/WarClassicSystem.galaxy:765


    // Variable Initialization
    lv_playerNew = EventUnitOwnerNew();
    lv_playerOld = EventUnitOwnerOld();

# New Unit Owner

# Supported triggers

# Related

# Examples