Duel.SpecialSummon

Signature

Duel.SpecialSummon(Card|Group targets, int sumtype, int sumplayer, int target_player, bool nocheck, bool nolimit, int pos, [int zone]) -> int

Description

Special Summons targets to target_player's field in position pos and returns the number of cards successfully Summoned. sumplayer is the player performing the Summon and sumtype records the Summon type. nocheck skips Summoning-condition checks; nolimit skips revive-limit checks. Check zone availability and Card.IsCanBeSpecialSummoned before activation, then recheck needed zones during resolution if the Chain can change them. For revive-limit monsters, a successful Duel.SpecialSummon does not automatically mark the card as properly Summoned. Call Card.CompleteProcedure only when this resolving effect is intended to be that card's proper Summon method.

How To Use It

targets can be one Card or a Group. The return value is the number of cards actually Special Summoned, so check it if later steps depend on success.

sumplayer is the player performing the Summon. target_player is the player whose field receives the monster. For most simple effects, both are tp.

local g=Duel.SelectMatchingCard(tp,s.spfilter,tp,LOCATION_GRAVE,0,1,1,nil,e,tp)
if #g>0 then
    Duel.SpecialSummon(g,0,tp,tp,false,false,POS_FACEUP)
end

Use nocheck=true only when the effect intentionally ignores the monster's usual Summoning condition. Use nolimit=true only when the effect intentionally ignores the proper Summon/revive limit.

Related Functions

• Card.IsCanBeSpecialSummoned
• Duel.SpecialSummonStep
• Duel.SpecialSummonComplete
• Duel.GetLocationCount

Parameters

• targets Card|Group - Card or Group to Special Summon.
• sumtype int - Summon type value recorded for the Summon.
• sumplayer int - Player treated as performing the Special Summon.
• target_player int - Player whose field receives the Summoned cards.
• nocheck bool - If true, skips Summoning-condition checks, including EFFECT_SPSUMMON_CONDITION-style restrictions.
• nolimit bool - If true, skips revive-limit and proper-Summon completion checks.
• pos int - POS_* position mask for the Summon.
• zone int optional - Allowed Monster Zone bitmask; default: 0xff.

Returns

• int - Number of cards successfully Special Summoned.

Source

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

Guided Examples

Learn how to use this function in context:

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

More guided lessons (1)

• Spell Card Patterns

Used By

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

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

Card	ID	Script	Detected Calls
Salamandra with Chain	62091148	Scripts/c62091148.lua	1
Astrograph Sorcerer, the Starfrost Magician	48171151	Scripts/c48171151.lua	3
Artmage Non-Finito	74631897	Scripts/c74631897.lua	1
Pendulum Evolution	55795155	Scripts/c55795155.lua	1
Levia-Dragoon - Daedalus	78579058	Scripts/c78579058.lua	1
Lady's Dragonmaid	48658295	Scripts/c48658295.lua	2
Azure Ocean Dragon Lord - Neo-Daedalus Rage	41570943	Scripts/c41570943.lua	1
Eternal Favorite	87532344	Scripts/c87532344.lua	1
Surprise Fusion	35167375	Scripts/c35167375.lua	1
Astrograph Sorcerer	76794549	Scripts/c76794549.lua	3
Spellbook of the Grand Circle	11911336	Scripts/c11911336.lua	1
Ultra Polymerization	76647978	Scripts/c76647978.lua	1
Goyo Emperor	59255742	Scripts/c59255742.lua	1
Accel Synchro Stardust Dragon	30983281	Scripts/c30983281.lua	1
Melffy Playtime Surprise	58036097	Scripts/c58036097.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
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
Meteoroa Drytron	24166324	Scripts/c24166324.lua	1
Favorite HERO Flame Wingman	13243124	Scripts/c13243124.lua	2
...and 4660 more

Script Examples

Salamandra with Chain (62091148)

Source: Scripts/c62091148.lua

			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)
		else
			local mat2=Duel.SelectFusionMaterial(tp,tc,mg3,nil,chkf)

Astrograph Sorcerer, the Starfrost Magician (48171151)

Source: Scripts/c48171151.lua

	local c=e:GetHandler()
	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

Artmage Non-Finito (74631897)

Source: Scripts/c74631897.lua

			Duel.SendtoGrave(mat1,REASON_EFFECT+REASON_MATERIAL+REASON_FUSION)
			Duel.BreakEffect()
			Duel.SpecialSummon(tc,SUMMON_TYPE_FUSION,tp,tp,false,false,POS_FACEUP)
		elseif ce then
			local mat2=Duel.SelectFusionMaterial(tp,tc,mg2,nil,chkf)