Duel.SelectTarget

Signature

Duel.SelectTarget(int sel_player, [function|nil f], int player, int s, int o, int min, int max, [Card|Group|nil ex], ... any) -> Group

Description

Lets sel_player choose min to max cards that satisfy filter f, are not excluded by ex, and can be targeted by the currently handled effect. The selected cards are registered as the current Chain's target cards. For non-continuous effects, the core also creates Chain relations used by IsRelateToEffect and related helpers. This requires a current Chain; use Duel.SelectMatchingCard or Group.Select for ordinary resolution choices.

How To Use It

Use this in the Target callback of an activated effect that targets cards.

The selected cards are saved as the Chain's targets. This function needs a current Chain; use Duel.SelectMatchingCard or Group.Select for ordinary resolution choices. For one target, read it with Duel.GetFirstTarget and check tc:IsRelateToEffect(e) before applying the effect. For several targets, use Duel.GetTargetsRelateToChain to get the target group that is still related to the resolving Chain.

function s.target(e,tp,eg,ep,ev,re,r,rp,chk,chkc)
    if chkc then return chkc:IsOnField() and s.filter(chkc) end
    if chk==0 then return Duel.IsExistingTarget(s.filter,tp,LOCATION_MZONE,0,1,nil) end
    Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_TARGET)
    Duel.SelectTarget(tp,s.filter,tp,LOCATION_MZONE,0,1,1,nil)
end

function s.operation(e,tp,eg,ep,ev,re,r,rp)
    local tc=Duel.GetFirstTarget()
    if tc and tc:IsRelateToEffect(e) then
        Duel.Destroy(tc,REASON_EFFECT)
    end
end

Related Functions

• Duel.IsExistingTarget
• Duel.GetFirstTarget
• Duel.GetTargetsRelateToChain

Parameters

• sel_player int - Player who makes the selection.
• f function|nil optional - Filter called with each candidate card first, then any extra arguments after ex.
• player int - Viewpoint player for s and o.
• s int - Locations on player's side to search.
• o int - Locations on the opponent's side to search.
• min int - Minimum number of cards to select.
• max int - Maximum number of cards to select.
• ex Card|Group|nil optional - Card or Group excluded from the selection.
• ... any - Extra values passed to f after the candidate card.

Returns

• Group - Group of cards selected by sel_player and registered as current Chain targets. If there is no current Chain or sel_player is invalid, the core returns no value.

Source

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

Guided Examples

Learn how to use this function in context:

• Beginner Script Ladder
• Categories, Properties, And Hint Timing
• Client UI And Prompt Behavior
• Common Script Errors And Debugging
• Filters, Card Objects, and Group Objects
• Write Your First Custom Card

More guided lessons (6)

• First Scripts To Study
• Min/Max Stat Card Selection
• Normal And Continuous Traps
• Quick-Play Spells
• Selection And Group Handling
• Targeting Flow

Used By

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

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

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
Ashtraja Susanoo	17020474	Scripts/c17020474.lua	1
Fiendsmith's Sequence	49867899	Scripts/c49867899.lua	1
D/D/D Alfred the Divine Sage King	11852093	Scripts/c11852093.lua	1
El Shaddoll Apkallone	50907446	Scripts/c50907446.lua	1
Meteoroa Drytron	24166324	Scripts/c24166324.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	1
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
Tohushaddoll Grysta	95072744	Scripts/c95072744.lua	1
PSY-Framelord Omega	74586817	Scripts/c74586817.lua	2
Teleport Fusion	36494597	Scripts/c36494597.lua	1
Graydle Split	75361204	Scripts/c75361204.lua	1
Enneacraft - Archa.TAIL	81237046	Scripts/c81237046.lua	1
D/D/D/D Dimensional King Arc Crisis	71398055	Scripts/c71398055.lua	1
...and 5075 more

Script Examples

Salamandra with Chain (62091148)

Source: Scripts/c62091148.lua

		and Duel.IsExistingTarget(s.filter,tp,LOCATION_MZONE,LOCATION_MZONE,1,nil) end
	Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_EQUIP)
	Duel.SelectTarget(tp,s.filter,tp,LOCATION_MZONE,LOCATION_MZONE,1,1,nil)
	Duel.SetOperationInfo(0,CATEGORY_EQUIP,e:GetHandler(),1,0,0)
end

Pendulum Evolution (55795155)

Source: Scripts/c55795155.lua

	Duel.Hint(HINT_OPSELECTED,1-tp,e:GetDescription())
	Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_FACEUP)
	Duel.SelectTarget(tp,c55795155.atkfilter,tp,LOCATION_MZONE,0,1,1,nil)
end
function c55795155.atkop(e,tp,eg,ep,ev,re,r,rp)

Surprise Fusion (35167375)

Source: Scripts/c35167375.lua

	if chk==0 then return Duel.IsExistingTarget(s.rafilter,tp,LOCATION_MZONE,0,1,nil) end
	Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_FACEUP)
	local tc=Duel.SelectTarget(tp,s.rafilter,tp,LOCATION_MZONE,0,1,1,nil):GetFirst()
	local race,att
	Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_RACE)