Duel.IsExistingTarget

Signature

Duel.IsExistingTarget([function|nil f], int player, int s, int o, int count, [Card|Group|nil ex], ... any) -> bool

Description

Checks whether the specified locations contain at least count cards that satisfy filter f, are not excluded by ex, and can be targeted by the currently handled effect. Use this in Target callbacks when the card must become an official effect target.

How To Use It

Use this in a Target callback when the effect text chooses target cards.

Duel.IsExistingTarget is like Duel.IsExistingMatchingCard, but it also checks whether each candidate can become a target of the current effect. That matters for cards unaffected by targeting, cards protected by effects, and target restrictions.

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,LOCATION_MZONE,1,nil)
    end
    Duel.SelectTarget(tp,s.filter,tp,LOCATION_MZONE,LOCATION_MZONE,1,1,nil)
end

Parameters

• 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.
• count int - Minimum number of legal targets required.
• ex Card|Group|nil optional - Card or Group excluded from the search.
• ... any - Extra values passed to f after the candidate card.

Returns

• bool - True if at least count matching cards can be targeted by the current effect.

Source

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

Guided Examples

Learn how to use this function in context:

• Common Script Errors And Debugging
• Filters, Card Objects, and Group Objects
• Write Your First Custom Card
• First Scripts To Study
• Normal And Continuous Traps
• Quick-Play Spells

More guided lessons (2)

• Selection And Group Handling
• Targeting Flow

Used By

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

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

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
Melffy Playtime Surprise	58036097	Scripts/c58036097.lua	1
Ashtraja Susanoo	17020474	Scripts/c17020474.lua	1
Fiendsmith's Sequence	49867899	Scripts/c49867899.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 4904 more

Script Examples

Salamandra with Chain (62091148)

Source: Scripts/c62091148.lua

	if chkc then return chkc:IsControler(tp) and chkc:IsLocation(LOCATION_MZONE) and s.filter(chkc) end
	if chk==0 then return e:IsCostChecked()
		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)

Pendulum Evolution (55795155)

Source: Scripts/c55795155.lua

function c55795155.atktg(e,tp,eg,ep,ev,re,r,rp,chk,chkc)
	if chkc then return chkc:IsLocation(LOCATION_MZONE) and chkc:IsControler(tp) and chkc:IsCode(13331639) and chkc:IsFaceup() end
	if chk==0 then return Duel.IsExistingTarget(c55795155.atkfilter,tp,LOCATION_MZONE,0,1,nil) end
	Duel.Hint(HINT_OPSELECTED,1-tp,e:GetDescription())
	Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_FACEUP)

Surprise Fusion (35167375)

Source: Scripts/c35167375.lua

function s.target(e,tp,eg,ep,ev,re,r,rp,chk,chkc)
	if chkc then return chkc:IsLocation(LOCATION_MZONE) and chkc:IsControler(tp) and chkc:IsFaceup() and s.rafilter(chkc) end
	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()