Duel.SendtoDeck

Signature

Duel.SendtoDeck(Card|Group targets, [int|nil player], int seq, int reason, [int reason_player], [bool send_activating]) -> int

Description

Returns targets to the Deck or Extra Deck for reason and returns the number of cards moved. If player is nil, each card returns to its owner. Use sequence constants such as SEQ_DECKTOP, SEQ_DECKBOTTOM, or SEQ_DECKSHUFFLE to control placement. Check the return value when a later action depends on the cards actually reaching the Deck or Extra Deck.

How To Use It

Use this for returning cards to the Main Deck or Extra Deck.

player can be nil for the normal return destination. seq controls placement: SEQ_DECKTOP, SEQ_DECKBOTTOM, or SEQ_DECKSHUFFLE.

if #g>0 then
    Duel.SendtoDeck(g,nil,SEQ_DECKSHUFFLE,REASON_EFFECT)
end

Check the return value when a later part of the effect depends on a card actually reaching the Deck or Extra Deck.

Related Functions

• Card.IsAbleToDeck
• Duel.SetOperationInfo
• Auxiliary.PlaceCardsOnDeckTop

Parameters

• targets Card|Group
• player int|nil optional
• seq int
• reason int
• reason_player int optional
• send_activating bool optional

Returns

• int

Source

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

Guided Examples

Learn how to use this function in context:

• Fusion Procedure Guide
• Functions That Move Cards Across Locations

Used By

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

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

Card	ID	Script	Detected Calls
Salamandra with Chain	62091148	Scripts/c62091148.lua	1
Astrograph Sorcerer, the Starfrost Magician	48171151	Scripts/c48171151.lua	1
Pendulum Evolution	55795155	Scripts/c55795155.lua	1
Lady's Dragonmaid	48658295	Scripts/c48658295.lua	1
Spellbook of the Grand Circle	11911336	Scripts/c11911336.lua	1
Ashtraja Susanoo	17020474	Scripts/c17020474.lua	1
Destiny HERO - Destro-Dogma	25158975	Scripts/c25158975.lua	1
Yomagna the Fire Phantom	17350692	Scripts/c17350692.lua	1
Fiendsmith's Sequence	49867899	Scripts/c49867899.lua	1
D/D/D Alfred the Divine Sage King	11852093	Scripts/c11852093.lua	1
Mementotlan Fusion	66518509	Scripts/c66518509.lua	1
Lubellion the Searing Dragon	70534340	Scripts/c70534340.lua	1
Magnet Bonding	65514302	Scripts/c65514302.lua	1
Odd-Eyes Revolution Dragon	16306932	Scripts/c16306932.lua	1
Resurgam Xyz	49082032	Scripts/c49082032.lua	1
PSY-Framelord Omega	74586817	Scripts/c74586817.lua	1
Artmage Masterwork -Succession-	37517035	Scripts/c37517035.lua	1
Odd-Eyes Arcray Dragon	6218704	Scripts/c6218704.lua	1
Ultimate Crystal Rainbow Dragon Overdrive	84544192	Scripts/c84544192.lua	1
GMX Associate Noma	83528184	Scripts/c83528184.lua	3
Kewl Tune Crackle	39576656	Scripts/c39576656.lua	1
Dracotail Shaulas	42125140	Scripts/c42125140.lua	1
PSY-Framelord Zeta	37192109	Scripts/c37192109.lua	1
The Gaze of Timaeus	22283204	Scripts/c22283204.lua	1
...and 902 more

Script Examples

Salamandra with Chain (62091148)

Source: Scripts/c62091148.lua

				Duel.HintSelection(gg)
			end
			Duel.SendtoDeck(mat1,nil,SEQ_DECKSHUFFLE,REASON_EFFECT+REASON_MATERIAL+REASON_FUSION)
			Duel.BreakEffect()
			Duel.SpecialSummon(tc,SUMMON_TYPE_FUSION,tp,tp,false,false,POS_FACEUP)

Astrograph Sorcerer, the Starfrost Magician (48171151)

Source: Scripts/c48171151.lua

				Duel.HintSelection(cg)
			end
			Duel.SendtoDeck(mat,nil,SEQ_DECKSHUFFLE,REASON_EFFECT+REASON_MATERIAL+REASON_FUSION)
			Duel.BreakEffect()
			Duel.SpecialSummon(tc,SUMMON_TYPE_FUSION,tp,tp,false,false,POS_FACEUP)

Pendulum Evolution (55795155)

Source: Scripts/c55795155.lua

	e:SetLabel(g:GetFirst():GetCode())
	Duel.ConfirmCards(1-tp,g)
	Duel.SendtoDeck(g,nil,SEQ_DECKSHUFFLE,REASON_COST)
	Duel.SetOperationInfo(0,CATEGORY_TOHAND,nil,1,tp,LOCATION_DECK)
end