Effect.SetTarget

Signature

Effect.SetTarget(Effect e, function targ_func) -> void

Description

Sets e's target callback. For activated effects, this callback performs activation legality checks and records target or operation information. Target callbacks normally use chk==0 only to answer legality, then use the real activation branch to select official targets with Duel.SelectTarget, record broad targets with Duel.SetTargetCard, or announce operation details with Duel.SetOperationInfo.

How To Use It

Target callbacks do two jobs for activated effects: answer activation legality during chk==0, then record targets and operation information when activation is accepted.

function s.target(e,tp,eg,ep,ev,re,r,rp,chk,chkc)
    if chkc then return chkc:IsOnField() and chkc:IsControler(1-tp) end
    if chk==0 then
        return Duel.IsExistingTarget(aux.TRUE,tp,0,LOCATION_ONFIELD,1,nil)
    end
    Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_DESTROY)
    Duel.SelectTarget(tp,aux.TRUE,tp,0,LOCATION_ONFIELD,1,1,nil)
    Duel.SetOperationInfo(0,CATEGORY_DESTROY,nil,1,1-tp,LOCATION_ONFIELD)
end

Use Duel.SelectTarget for cards that are official targets. Use Duel.SetOperationInfo so chained cards can see what the effect is expected to do.

Related Functions

• Duel.IsExistingTarget
• Duel.SelectTarget
• Duel.SetOperationInfo

Parameters

• e Effect - Effect whose target callback is replaced.
• targ_func function - Callback function stored on e.

Source

• D:\Programs\GitHub\ygopro-core\libeffect.cpp:626

Guided Examples

Learn how to use this function in context:

• Beginner Script Ladder
• Effects That Apply Continuously
• Continuous Stat Modifiers
• Cost, Target, And Operation Lifecycle
• Counter Traps
• Conditions, Costs, Activation Procedures, and Resolution

More guided lessons (5)

• Creation, Building, and Registration of an Effect Object
• Write Your First Custom Card
• First Scripts To Study
• Quick-Play Spells
• Targeting Flow

Used By

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

• Detected in 12432 indexed script(s).
• Search this function in the Script Explorer with Effect.SetTarget.

Card	ID	Script	Detected Calls
Salamandra with Chain	62091148	Scripts/c62091148.lua	2
Astrograph Sorcerer, the Starfrost Magician	48171151	Scripts/c48171151.lua	3
Artmage Non-Finito	74631897	Scripts/c74631897.lua	3
Pendulum Evolution	55795155	Scripts/c55795155.lua	3
Levia-Dragoon - Daedalus	78579058	Scripts/c78579058.lua	3
Lady's Dragonmaid	48658295	Scripts/c48658295.lua	3
Azure Ocean Dragon Lord - Neo-Daedalus Rage	41570943	Scripts/c41570943.lua	3
Eternal Favorite	87532344	Scripts/c87532344.lua	2
Surprise Fusion	35167375	Scripts/c35167375.lua	2
Astrograph Sorcerer	76794549	Scripts/c76794549.lua	3
Spellbook of the Grand Circle	11911336	Scripts/c11911336.lua	2
Ultra Polymerization	76647978	Scripts/c76647978.lua	2
Goyo Emperor	59255742	Scripts/c59255742.lua	5
Accel Synchro Stardust Dragon	30983281	Scripts/c30983281.lua	2
Melffy Playtime Surprise	58036097	Scripts/c58036097.lua	3
Ashtraja Susanoo	17020474	Scripts/c17020474.lua	2
Deftero Enneacraft - "alazoneIA"	92171126	Scripts/c92171126.lua	5
Destiny HERO - Destro-Dogma	25158975	Scripts/c25158975.lua	2
Yomagna the Fire Phantom	17350692	Scripts/c17350692.lua	3
Fiendsmith's Sequence	49867899	Scripts/c49867899.lua	2
D/D/D Alfred the Divine Sage King	11852093	Scripts/c11852093.lua	2
El Shaddoll Apkallone	50907446	Scripts/c50907446.lua	2
Mementotlan Fusion	66518509	Scripts/c66518509.lua	2
Meteoroa Drytron	24166324	Scripts/c24166324.lua	2
...and 12408 more

Script Examples

Salamandra with Chain (62091148)

Source: Scripts/c62091148.lua

	e1:SetCondition(aux.dscon)
	e1:SetCost(s.cost)
	e1:SetTarget(s.target)
	e1:SetOperation(s.operation)
	c:RegisterEffect(e1)

Astrograph Sorcerer, the Starfrost Magician (48171151)

Source: Scripts/c48171151.lua

	e1:SetRange(LOCATION_PZONE)
	e1:SetCountLimit(1,id)
	e1:SetTarget(s.ptg)
	e1:SetOperation(s.pop)
	c:RegisterEffect(e1)

Artmage Non-Finito (74631897)

Source: Scripts/c74631897.lua

	e3:SetRange(LOCATION_EXTRA)
	e3:SetCondition(s.spcon)
	e3:SetTarget(s.sptg)
	e3:SetOperation(s.spop)
	c:RegisterEffect(e3)