# User Instance From Reference

Grammar — User instance from reference
Flags — Native | Function

Returns the user instance associated with a user reference value stored in catalog data.

# Arguments

• string — Reference

Returns — string [ userinstance ]

native string UserDataInstanceFromReference(string inRef);

# Related

Category: User Data / Utility

• [F] — void — Reset User Data Value — ( UserDataResetValue )
• [F] — void — Reset User Data Instance — ( UserDataResetInstance )
• [F] — void — Reset User Data Type — ( UserDataResetType )
• [F] — void — Reset All User Data — ( UserDataResetAll )
• [F] — string [ gamelink::User ] — User Type From Reference — ( UserDataTypeFromReference )
• [F] — string [ userinstance ] — User Instance From Reference — ( UserDataInstanceFromReference )

# Examples

# campaigns/swarmstory.sc2campaign

— SwarmCampaignLib.galaxy

// L5189
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogMap, (lp_map), "UserReference", 1))

// L5994
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogObjective, (lp_objective), "UserReference", 1))

// L6546
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogLocation, (lp_planet), "UserReference", c_playerAny))

// L10089
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogArmyCategory, (lp_armyCategory), "UserReference", 1))

// L10547
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogArmyUpgrade, (lp_armyUpgrade), "UserReference", 1))

// L10639
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogArmyUnit, (lp_armyUnit), "UserReference", 1))

// L12079
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogHeroAbil, (lp_ability), "UserReference", c_playerAny))

# campaigns/swarmstoryutil.sc2mod

— Lib281DEC45.galaxy

// L477
UserDataInstanceFromReference(BankValueGetAsString(lv_storyBank, lv__SectionName, "DebugStoryScene"))

// L966
UserDataInstanceFromReference(DataTableGetString(true, lib281DEC45_gf_ZSS_UIArchivesDataString(BattleReportPanelGetSelectedBattleReport(1))))

// L1344
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogLocation, lp_location, "UserReference", 1))

// L1715
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogMap, (lp_map), "UserReference", 1))

// L6203
UserDataInstanceFromReference(DataTableGetString(true, lib281DEC45_gf_ZSS_UIArchivesDataString(BattleReportPanelGetSelectedBattleReport(1))))

# campaigns/voidstory.sc2campaign

— VoidCampaignLib.galaxy

// L1975
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogLocation, (lp_planet), "UserReference", c_playerAny))

// L2822
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogMap, (lp_map), "UserReference", 1))

// L3815
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogObjective, (lp_objective), "UserReference", 1))

// L4459
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogArmyCategory, (lp_armyCategory), "UserReference", 1))

// L4953
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogArmyUnit, (lp_armyUnit), "UserReference", 1))

# campaigns/voidstory.sc2campaign

— VoidCampaignStoryLib.galaxy

// L3758
UserDataInstanceFromReference(DataTableGetString(true, (libVCST_gv_pSC_REDIRECTPREFIX + (lp_character))))

# campaigns/voidstory.sc2campaign

— VoidCampaignUILib.galaxy

// L1539
UserDataInstanceFromReference(DataTableGetString(true, libVCUI_gf_PU_ArchivesDataString(BattleReportPanelGetSelectedBattleReport(1))))

// L1646
UserDataInstanceFromReference(DataTableGetString(true, libVCUI_gf_PU_ArchivesDataString(BattleReportPanelGetSelectedBattleReport(1))))

// L3114
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogLocation, lp_location, "UserReference", 1))

# mods/missionpacks/campaigncommon.sc2mod

— LibComC.galaxy

// L464
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogLocation, (lp_planet), "UserReference", c_playerAny))

// L817
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogMap, (lp_map), "UserReference", 1))

// L1470
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogObjective, (lp_objective), "UserReference", 1))

// L1997
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogArmyCategory, (lp_armyCategory), "UserReference", 1))

// L2276
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogArmyUnit, (lp_armyUnit), "UserReference", 1))

# mods/missionpacks/novacampaign.sc2mod

— LibNCST.galaxy

// L3227
UserDataInstanceFromReference(DataTableGetString(true, (libNCST_gv_nSC_REDIRECTPREFIX + (lp_character))))

# mods/missionpacks/novacampaign.sc2mod

— LibNCUI.galaxy

// L667
UserDataInstanceFromReference(DataTableGetString(true, libNCUI_gf_NU_ArchivesDataString(BattleReportPanelGetSelectedBattleReport(1))))

// L808
UserDataInstanceFromReference(DataTableGetString(true, libNCUI_gf_NU_ArchivesDataString(BattleReportPanelGetSelectedBattleReport(1))))

# mods/starcoop/starcoop.sc2mod

— LibCOOC.galaxy

// L333
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogMap, (lp_map), "UserReference", libCOOC_gv_cCC_DISREGARDPLAYER))

// L606
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogObjective, (lp_objective), "UserReference", libCOOC_gv_cCC_DISREGARDPLAYER))

// L1419
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogCommander, (lp_commander), "UserReference", libCOOC_gv_cCC_DISREGARDPLAYER))

// L2549
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogArmyCategory, (lp_armyCategory), "UserReference", libCOOC_gv_cCC_DISREGARDPLAYER))

// L2965
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogArmyUpgrade, (lp_armyUpgrade), "UserReference", libCOOC_gv_cCC_DISREGARDPLAYER))

// L3016
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogArmyUnit, (lp_armyUnit), "UserReference", libCOOC_gv_cCC_DISREGARDPLAYER))

# mods/voidprologue.sc2mod

— LibA3DDD02B.galaxy

// L4042
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogMap, (lp_map), "UserReference", 1))

// L4565
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogObjective, (lp_objective), "UserReference", 1))

// L5620
UserDataInstanceFromReference(CatalogFieldValueGet(c_gameCatalogArmyCategory, (lp_armyCategory), "UserReference", 1))

// L7366
UserDataInstanceFromReference(DataTableGetString(true, libA3DDD02B_gf_PP_ArchivesDataString(BattleReportPanelGetSelectedBattleReport(1))))

// L7400
UserDataInstanceFromReference(DataTableGetString(true, libA3DDD02B_gf_PP_ArchivesDataString(BattleReportPanelGetSelectedBattleReport(1))))