Duel.Remove

Signature

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

Description

Banishes targets in position pos for reason and returns the number of cards actually banished. If reason includes REASON_TEMPORARY, the banish is treated as temporary and the card can later be returned with Duel.ReturnToField. Use POS_FACEDOWN only when the effect requires a face-down banish; ordinary banish effects usually use POS_FACEUP.

How To Use It

Use this for banishing cards. The second argument is the banished position, usually POS_FACEUP or POS_FACEDOWN.

if c:IsRelateToEffect(e) then
    Duel.Remove(c,POS_FACEUP,REASON_EFFECT)
end

For temporary banish effects, scripts commonly include REASON_TEMPORARY; those cards can later be returned with Duel.ReturnToField.

Related Functions

• Card.IsAbleToRemove
• Duel.ReturnToField
• Duel.SetOperationInfo

Parameters

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

Returns

• int

Source

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

Guided Examples

Learn how to use this function in context:

• Methods for Affecting Cards
• Fusion Procedure Guide
• Functions That Move Cards Across Locations
• Special Summon-Only Monster Guide

Used By

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

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

Card	ID	Script	Detected Calls
Lady's Dragonmaid	48658295	Scripts/c48658295.lua	1
Astrograph Sorcerer	76794549	Scripts/c76794549.lua	1
Accel Synchro Stardust Dragon	30983281	Scripts/c30983281.lua	1
Ashtraja Susanoo	17020474	Scripts/c17020474.lua	2
Deftero Enneacraft - "alazoneIA"	92171126	Scripts/c92171126.lua	1
Destiny HERO - Destro-Dogma	25158975	Scripts/c25158975.lua	1
Mixousia the Confounder	80843006	Scripts/c80843006.lua	1
Invoked Sorath	43989315	Scripts/c43989315.lua	1
Ehther the Heavenly Monarch	96570609	Scripts/c96570609.lua	1
Destratification Dino Stratiae	3841104	Scripts/c3841104.lua	1
Am Duazenet	45151304	Scripts/c45151304.lua	1
Hecahands Tartaros	57809669	Scripts/c57809669.lua	1
Ursarctic Polari	27693363	Scripts/c27693363.lua	1
Prank-Kids Weather Washer	44509529	Scripts/c44509529.lua	1
Enneacraft - Asta.PIXEA	28454232	Scripts/c28454232.lua	1
Converging Wishes	20007374	Scripts/c20007374.lua	2
Tohushaddoll Grysta	95072744	Scripts/c95072744.lua	1
Predaplant Bal Teah	66787942	Scripts/c66787942.lua	1
PSY-Framelord Omega	74586817	Scripts/c74586817.lua	1
Teleport Fusion	36494597	Scripts/c36494597.lua	1
D/D/D/D Dimensional King Arc Crisis	71398055	Scripts/c71398055.lua	1
Dark End Evaporation Dragon	62002838	Scripts/c62002838.lua	1
Nekroz Kaleidoscope	51124303	Scripts/c51124303.lua	1
Junoldo the Shadespirit Power Patron	10266279	Scripts/c10266279.lua	2
...and 1639 more

Script Examples

Lady's Dragonmaid (48658295)

Source: Scripts/c48658295.lua

	local sg=e:GetLabelObject()
	c:SetMaterial(sg)
	Duel.Remove(sg,POS_FACEUP,REASON_COST)
end
function s.spfilter(c,e,tp)

Astrograph Sorcerer (76794549)

Source: Scripts/c76794549.lua

	local sg=mg:SelectSubGroupEach(tp,c76794549.hnchecks,false,c76794549.hngoal,e,tp,c)
	sg:AddCard(c)
	Duel.Remove(sg,POS_FACEUP,REASON_COST)
end
function c76794549.hntg(e,tp,eg,ep,ev,re,r,rp,chk)

Accel Synchro Stardust Dragon (30983281)

Source: Scripts/c30983281.lua

	local te=rc:IsHasEffect(84012625,tp)
	if te then
		Duel.Remove(rc,POS_FACEUP,REASON_COST+REASON_REPLACE)
	else
		Duel.Release(rc,REASON_COST)