Duel.GetFirstTarget

Signature

Duel.GetFirstTarget() -> Card|nil

Description

Returns the first target card currently recorded for the resolving Chain. If multiple target cards were recorded, the remaining target cards are returned as additional values in recorded order. For effects that target several cards and affect only the remaining valid targets, Duel.GetTargetsRelateToChain is usually clearer.

How To Use It

Use this during resolution when the effect selected exactly one target card.

The binding returns all stored Chain targets as Lua return values; scripts commonly keep the first one when the effect selected exactly one card. Always check that the returned card still exists and is still related to the resolving effect before moving, destroying, equipping, or changing it:

local tc=Duel.GetFirstTarget()
if tc and tc:IsRelateToEffect(e) then
    Duel.SendtoHand(tc,nil,REASON_EFFECT)
end

For multiple targets, use Duel.GetTargetsRelateToChain() when you need the group of targets that are still related to the resolving Chain.

Related Functions

• Duel.SelectTarget
• Card.IsRelateToEffect
• Duel.GetTargetsRelateToChain

Returns

• Card|nil - First recorded target card, followed by any additional target cards as extra Lua return values. No value is returned when the current Chain has no target cards.

Source

• D:\Programs\GitHub\ygopro-core\libduel.cpp:4949

Guided Examples

Learn how to use this function in context:

• Client UI And Prompt Behavior
• Common Script Errors And Debugging
• First Scripts To Study
• Quick-Play Spells
• Selection And Group Handling
• Targeting Flow

Used By

Generated from the local Scripts/ folder and cards.cdb.

• Detected in 4747 indexed script(s).
• Search this function in the Script Explorer with Duel.GetFirstTarget.

Card	ID	Script	Detected Calls
Salamandra with Chain	62091148	Scripts/c62091148.lua	1
Pendulum Evolution	55795155	Scripts/c55795155.lua	1
Surprise Fusion	35167375	Scripts/c35167375.lua	1
Ultra Polymerization	76647978	Scripts/c76647978.lua	1
Goyo Emperor	59255742	Scripts/c59255742.lua	1
Melffy Playtime Surprise	58036097	Scripts/c58036097.lua	1
Fiendsmith's Sequence	49867899	Scripts/c49867899.lua	1
El Shaddoll Apkallone	50907446	Scripts/c50907446.lua	1
Mixousia the Confounder	80843006	Scripts/c80843006.lua	1
Invoked Sorath	43989315	Scripts/c43989315.lua	1
Performage Cup Tricker	6812770	Scripts/c6812770.lua	2
Spirit Illusion	71939275	Scripts/c71939275.lua	1
Ghostrick Renovation	61818176	Scripts/c61818176.lua	2
Hecahands Tartaros	57809669	Scripts/c57809669.lua	1
Enneacraft - Asta.PIXEA	28454232	Scripts/c28454232.lua	1
Odd-Eyes Revolution Dragon	16306932	Scripts/c16306932.lua	1
Resurgam Xyz	49082032	Scripts/c49082032.lua	1
PSY-Framelord Omega	74586817	Scripts/c74586817.lua	1
Teleport Fusion	36494597	Scripts/c36494597.lua	1
Graydle Split	75361204	Scripts/c75361204.lua	1
Enneacraft - Archa.TAIL	81237046	Scripts/c81237046.lua	1
Shining Draw	35906693	Scripts/c35906693.lua	2
Dark End Evaporation Dragon	62002838	Scripts/c62002838.lua	1
Plunder Patroll Shipshape Ships Shipping	44227727	Scripts/c44227727.lua	1
...and 4723 more

Script Examples

Salamandra with Chain (62091148)

Source: Scripts/c62091148.lua

	local c=e:GetHandler()
	if not c:IsRelateToEffect(e) or c:IsStatus(STATUS_LEAVE_CONFIRMED) then return end
	local tc=Duel.GetFirstTarget()
	if tc:IsRelateToEffect(e) and tc:IsFaceup() and Duel.Equip(tp,c,tc) then
		local e1=Effect.CreateEffect(c)

Pendulum Evolution (55795155)

Source: Scripts/c55795155.lua

end
function c55795155.atkop(e,tp,eg,ep,ev,re,r,rp)
	local tc=Duel.GetFirstTarget()
	if tc:IsRelateToEffect(e) then
		local e1=Effect.CreateEffect(e:GetHandler())

Surprise Fusion (35167375)

Source: Scripts/c35167375.lua

	local c=e:GetHandler()
	local race,att=e:GetLabel()
	local ec=Duel.GetFirstTarget()
	if ec:IsRelateToChain() and ec:IsFaceup() and ec:IsType(TYPE_MONSTER) then
		local cres=ec:GetRace()~=race or ec:GetAttribute()~=att