Duel.GetTargetsRelateToChain

Signature

Duel.GetTargetsRelateToChain() -> Group

Description

Returns all target cards currently related to the resolving Chain. This is the relation-aware helper for multi-target operations; targets that left their expected place are omitted from the returned Group. The returned Group can be empty, so check its count before applying a follow-up action.

How To Use It

Use this during resolution when a targeting effect selected more than one card and only the targets still related to the Chain should be affected.

local g=Duel.GetTargetsRelateToChain()
if #g>0 then
    Duel.Destroy(g,REASON_EFFECT)
end

The returned Group can be empty. It is built from the current Chain's target cards and relation state, so it is usually clearer than manually filtering CHAININFO_TARGET_CARDS.

Related Functions

• Duel.SelectTarget
• Duel.GetFirstTarget
• Card.IsRelateToEffect

Returns

• Group - New Group containing the current Chain targets whose Chain relation is still valid; empty when none qualify.

Source

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

Guided Examples

Learn how to use this function in context:

• Selection And Group Handling
• Targeting Flow

Used By

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

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

Card	ID	Script	Detected Calls
Astrograph Sorcerer, the Starfrost Magician	48171151	Scripts/c48171151.lua	1
Ashtraja Susanoo	17020474	Scripts/c17020474.lua	1
D/D/D Alfred the Divine Sage King	11852093	Scripts/c11852093.lua	1
Artmage Masterwork -Succession-	37517035	Scripts/c37517035.lua	1
GMX Associate Noma	83528184	Scripts/c83528184.lua	1
Dracotail Shaulas	42125140	Scripts/c42125140.lua	1
Ecclesia and the Dark Dragon	78397661	Scripts/c78397661.lua	1
S:P Little Knight	29301450	Scripts/c29301450.lua	1
Divine Serpent Apophis	97800311	Scripts/c97800311.lua	1
Arms of Genex Return Zero	61775475	Scripts/c61775475.lua	1
Ghoti Fury	65898344	Scripts/c65898344.lua	1
Astrazma Urania	18738846	Scripts/c18738846.lua	1
Purrelyeap!?	82983267	Scripts/c82983267.lua	1
Yummy☆Surprise	29369059	Scripts/c29369059.lua	1
Traptrix Atypus	48183890	Scripts/c48183890.lua	1
R.B. Shepherd's Crook	80071619	Scripts/c80071619.lua	1
Radiant Typhoon Mandate	53813120	Scripts/c53813120.lua	1
Ryu-Ge Rivalry	81549048	Scripts/c81549048.lua	1
Lunalight Perfume Dancer	81196066	Scripts/c81196066.lua	1
Heraldic Beast Stad Whale	97662494	Scripts/c97662494.lua	1
Possessed Destiny - Wynn	60516416	Scripts/c60516416.lua	1
White Circle Reef	21579049	Scripts/c21579049.lua	1
Unchained Firelord of Yama	94014327	Scripts/c94014327.lua	1
Zefra Metaltron	85216896	Scripts/c85216896.lua	1
...and 153 more

Script Examples

Astrograph Sorcerer, the Starfrost Magician (48171151)

Source: Scripts/c48171151.lua

	if not c:IsRelateToChain() then return end
	if Duel.SpecialSummon(c,0,tp,tp,false,false,POS_FACEUP)==0 then return end
	local desg=Duel.GetTargetsRelateToChain():Filter(s.spfilter1,nil,e,tp)
	if #desg>0 and Duel.SelectYesNo(tp,aux.Stringid(id,3)) then
		Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_SPSUMMON)

Ashtraja Susanoo (17020474)

Source: Scripts/c17020474.lua

function s.setop(e,tp,eg,ep,ev,re,r,rp)
	local c=e:GetHandler()
	local g=Duel.GetTargetsRelateToChain()
	if aux.NecroValleyNegateCheck(g) then return end
	local sg=g:Filter(aux.NecroValleyFilter(),nil)

D/D/D Alfred the Divine Sage King (11852093)

Source: Scripts/c11852093.lua

end
function s.tfop(e,tp,eg,ep,ev,re,r,rp)
	local g=Duel.GetTargetsRelateToChain()
	local sct=Duel.GetLocationCount(tp,LOCATION_SZONE)
	local ct=math.min(g:GetCount(),sct)