Duel.Destroy

Signature

Duel.Destroy(Card|Group targets, int reason, [int dest], [int reason_player]) -> int

Description

Destroys targets for reason and returns the number of cards actually destroyed. dest defaults to LOCATION_GRAVE. reason_player defaults to the current Chain's reason player. Use REASON_EFFECT for normal card effects and reserve REASON_RULE for rule/procedure cleanup. Use Duel.SetOperationInfo with CATEGORY_DESTROY in the target callback when the cards or source location are known before resolution.

How To Use It

Use this during resolution after checking that the target is still related to the effect.

The return value is important. It is 0 when no card was actually destroyed, for example because the card left the expected place or could not be destroyed.

local tc=Duel.GetFirstTarget()
if tc and tc:IsRelateToEffect(e) and Duel.Destroy(tc,REASON_EFFECT)>0 then
    -- follow-up that requires successful destruction
end

Use Duel.SetOperationInfo(0,CATEGORY_DESTROY,...) in the Target callback when the destruction is known before resolution.

Related Functions

• Card.IsDestructable
• Duel.SetOperationInfo
• Duel.SendtoGrave

Parameters

• targets Card|Group
• reason int
• dest int optional
• reason_player int optional

Returns

• int

Source

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

Guided Examples

Learn how to use this function in context:

• Methods for Affecting Cards
• Categories, Properties, And Hint Timing
• First Scripts To Study
• Functions That Move Cards Across Locations
• Quick-Play Spells

Used By

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

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

Card	ID	Script	Detected Calls
Astrograph Sorcerer, the Starfrost Magician	48171151	Scripts/c48171151.lua	1
Astrograph Sorcerer	76794549	Scripts/c76794549.lua	1
Mementotlan Fusion	66518509	Scripts/c66518509.lua	1
Enneacraft - Asta.PIXEA	28454232	Scripts/c28454232.lua	1
Odd-Eyes Revolution Dragon	16306932	Scripts/c16306932.lua	1
Graydle Split	75361204	Scripts/c75361204.lua	2
Enneacraft - Archa.TAIL	81237046	Scripts/c81237046.lua	1
D/D/D/D Dimensional King Arc Crisis	71398055	Scripts/c71398055.lua	1
Dark End Evaporation Dragon	62002838	Scripts/c62002838.lua	1
Future Fusion Nova	92058902	Scripts/c92058902.lua	2
Enneacraft - Atil.SPIA	71801447	Scripts/c71801447.lua	2
Enneacraft - Aiza.LEON	82359538	Scripts/c82359538.lua	1
Junoldo the Shadespirit Power Patron	10266279	Scripts/c10266279.lua	2
D/D/D/D Super-Dimensional Sovereign Emperor Zero Paradox	97417863	Scripts/c97417863.lua	2
Bujinki Ahashima	71095768	Scripts/c71095768.lua	1
Tellusion the Magna Warrior	24431911	Scripts/c24431911.lua	1
Vidolium the Unstable Power Patron of Unity	70488851	Scripts/c70488851.lua	1
Chronograph Sorcerer	12289247	Scripts/c12289247.lua	1
DoSolfachord Coolia	80776622	Scripts/c80776622.lua	1
Rescue Hamster	50485594	Scripts/c50485594.lua	1
A Bao A Qu, the Lightless Shadow	4731783	Scripts/c4731783.lua	1
Camelot, Realm of Noble Knights and Noble Arms	15635751	Scripts/c15635751.lua	1
Earthbound Servant Geo Gremlin	8690387	Scripts/c8690387.lua	1
Mitsurugi Magatama	76725398	Scripts/c76725398.lua	1
...and 2720 more

Script Examples

Astrograph Sorcerer, the Starfrost Magician (48171151)

Source: Scripts/c48171151.lua

	local c=e:GetHandler()
	if not c:IsRelateToChain() then return end
	if Duel.Destroy(c,REASON_EFFECT)==0 then return end
	Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_TOFIELD)
	local g=Duel.SelectMatchingCard(tp,s.pfilter,tp,LOCATION_HAND+LOCATION_DECK,0,1,1,nil,tp)

Astrograph Sorcerer (76794549)

Source: Scripts/c76794549.lua

function c76794549.rpop(e,tp,eg,ep,ev,re,r,rp)
	local c=e:GetHandler()
	if c:IsRelateToEffect(e) and Duel.Destroy(c,REASON_EFFECT)>0 then
		Duel.Hint(HINT_SELECTMSG,tp,aux.Stringid(76794549,6))
		local g=Duel.SelectMatchingCard(tp,c76794549.rpfilter,tp,LOCATION_HAND+LOCATION_DECK,0,1,1,nil,e,tp)

Mementotlan Fusion (66518509)

Source: Scripts/c66518509.lua

	Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_DESTROY)
	local g=Duel.SelectMatchingCard(tp,aux.TRUE,tp,LOCATION_MZONE,0,1,1,nil)
	if Duel.Destroy(g,REASON_EFFECT)<1 then return end
	Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_ATOHAND)
	local sg=Duel.SelectMatchingCard(tp,s.filter,tp,LOCATION_DECK,0,1,1,nil)