Card.IsCanBeSpecialSummoned

Signature

Card.IsCanBeSpecialSummoned(Card c, Effect e, int sumtype, int sumplayer, bool nocheck, bool nolimit, [int sumpos], [int toplayer], [int zone]) -> bool

Description

Checks whether c can be Special Summoned by effect e using sumtype, sumplayer, sumpos, target player, and optional zone. Use the same nocheck, nolimit, position, target player, and zone values that the later Duel.SpecialSummon call will use. If nocheck is true, c's Summoning condition is skipped. If nolimit is true, c's revive limit or proper-Summon limit is skipped. Leave both false unless the card text and local pattern justify bypassing those checks.

How To Use It

Use this in activation checks before selecting a monster to Special Summon.

The parameters should match the later Duel.SpecialSummon call as closely as possible: same effect, Summon type, Summon player, target player, position, and zone restrictions.

function s.spfilter(c,e,tp)
    return c:IsCanBeSpecialSummoned(e,0,tp,false,false,POS_FACEUP,tp)
end

This is only a legality check. It does not reserve a zone or Summon the card.

Parameters

• c Card - Card being checked.
• e Effect - Effect that would perform the Special Summon.
• sumtype int - Summon type value recorded for the Special Summon.
• sumplayer int - Player treated as performing the Special Summon.
• nocheck bool - If true, skips c's Summoning-condition check, including EFFECT_SPSUMMON_CONDITION-style restrictions.
• nolimit bool - If true, skips c's revive-limit or proper-Summon completion check.
• sumpos int optional - Summon position mask checked by the core; default: POS_FACEUP.
• toplayer int optional - Player whose field c would be Summoned to; default: sumplayer.
• zone int optional - Allowed Monster Zone bitmask; default: 0xff.

Returns

• bool - True if c can be Special Summoned with the supplied parameters.

Source

• D:\Programs\GitHub\ygopro-core\libcard.cpp:3637

Guided Examples

Learn how to use this function in context:

• Pendulum Procedure Guide
• Ritual Procedure Guide
• Special Summon-Only Monster Guide

Used By

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

• Detected in 4172 indexed script(s).
• Search this function in the Script Explorer with Card.IsCanBeSpecialSummoned.

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
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	2
Surprise Fusion	35167375	Scripts/c35167375.lua	1
Astrograph Sorcerer	76794549	Scripts/c76794549.lua	4
Spellbook of the Grand Circle	11911336	Scripts/c11911336.lua	1
Ultra Polymerization	76647978	Scripts/c76647978.lua	2
Goyo Emperor	59255742	Scripts/c59255742.lua	2
Accel Synchro Stardust Dragon	30983281	Scripts/c30983281.lua	2
Melffy Playtime Surprise	58036097	Scripts/c58036097.lua	1
Ashtraja Susanoo	17020474	Scripts/c17020474.lua	1
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
Mixousia the Confounder	80843006	Scripts/c80843006.lua	1
...and 4148 more

Script Examples

Salamandra with Chain (62091148)

Source: Scripts/c62091148.lua

function s.filter2(c,e,tp,m,f,chkf)
	return c:IsType(TYPE_FUSION) and c:IsAttribute(ATTRIBUTE_FIRE) and c:IsRace(RACE_WARRIOR+RACE_DRAGON) and (not f or f(c))
		and c:IsCanBeSpecialSummoned(e,SUMMON_TYPE_FUSION,tp,false,false) and c:CheckFusionMaterial(m,nil,chkf)
end
function s.sptg(e,tp,eg,ep,ev,re,r,rp,chk)

Astrograph Sorcerer, the Starfrost Magician (48171151)

Source: Scripts/c48171151.lua

end
function s.spfilter1(c,e,tp)
	if not c:IsCanBeSpecialSummoned(e,0,tp,false,false) or not c:IsControler(tp) then return false end
	if c:IsLocation(LOCATION_EXTRA) then return c:IsFaceup() and Duel.GetLocationCountFromEx(tp,tp,nil,c)>0 end
	if c:IsLocation(LOCATION_GRAVE) then return aux.NecroValleyFilter()(c) and Duel.GetLocationCount(tp,LOCATION_MZONE)>0 end

Artmage Non-Finito (74631897)

Source: Scripts/c74631897.lua

function s.filter2(c,e,tp,m,f,chkf)
	return c:IsType(TYPE_FUSION) and (not f or f(c))
		and c:IsCanBeSpecialSummoned(e,SUMMON_TYPE_FUSION,tp,false,false) and c:CheckFusionMaterial(m,nil,chkf)
end
function s.fsptg(e,tp,eg,ep,ev,re,r,rp,chk)