Effect.SetCategory

Signature

Effect.SetCategory(Effect e, int cate) -> void

Description

Sets e's operation category flags, such as CATEGORY_DESTROY, CATEGORY_TOHAND, or CATEGORY_SPECIAL_SUMMON. Categories describe what the effect may do; known operation details should still be recorded with Duel.SetOperationInfo in the Target callback.

How To Use It

Categories tell the engine and response checks what kind of action the effect may perform.

e1:SetCategory(CATEGORY_DESTROY+CATEGORY_TOHAND)

The category is not the actual operation. If the affected cards, player, or count are known during targeting, also call Duel.SetOperationInfo in the Target callback.

Related Functions

• Duel.SetOperationInfo
• Duel.GetOperationInfo

Parameters

• e Effect
• cate int

Source

• D:\Programs\GitHub\ygopro-core\libeffect.cpp:623

Guided Examples

Learn how to use this function in context:

• Categories, Properties, And Hint Timing
• Write Your First Custom Card

Used By

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

• Detected in 11516 indexed script(s).
• Search this function in the Script Explorer with Effect.SetCategory.

Card	ID	Script	Detected Calls
Salamandra with Chain	62091148	Scripts/c62091148.lua	2
Astrograph Sorcerer, the Starfrost Magician	48171151	Scripts/c48171151.lua	3
Artmage Non-Finito	74631897	Scripts/c74631897.lua	2
Pendulum Evolution	55795155	Scripts/c55795155.lua	2
Levia-Dragoon - Daedalus	78579058	Scripts/c78579058.lua	2
Lady's Dragonmaid	48658295	Scripts/c48658295.lua	2
Azure Ocean Dragon Lord - Neo-Daedalus Rage	41570943	Scripts/c41570943.lua	2
Eternal Favorite	87532344	Scripts/c87532344.lua	2
Surprise Fusion	35167375	Scripts/c35167375.lua	2
Astrograph Sorcerer	76794549	Scripts/c76794549.lua	3
Spellbook of the Grand Circle	11911336	Scripts/c11911336.lua	2
Ultra Polymerization	76647978	Scripts/c76647978.lua	2
Goyo Emperor	59255742	Scripts/c59255742.lua	3
Accel Synchro Stardust Dragon	30983281	Scripts/c30983281.lua	2
Melffy Playtime Surprise	58036097	Scripts/c58036097.lua	1
Ashtraja Susanoo	17020474	Scripts/c17020474.lua	3
Deftero Enneacraft - "alazoneIA"	92171126	Scripts/c92171126.lua	4
Destiny HERO - Destro-Dogma	25158975	Scripts/c25158975.lua	2
Yomagna the Fire Phantom	17350692	Scripts/c17350692.lua	1
Fiendsmith's Sequence	49867899	Scripts/c49867899.lua	2
D/D/D Alfred the Divine Sage King	11852093	Scripts/c11852093.lua	1
El Shaddoll Apkallone	50907446	Scripts/c50907446.lua	2
Mementotlan Fusion	66518509	Scripts/c66518509.lua	2
Meteoroa Drytron	24166324	Scripts/c24166324.lua	2
...and 11492 more

Script Examples

Salamandra with Chain (62091148)

Source: Scripts/c62091148.lua

	--
	local e1=Effect.CreateEffect(c)
	e1:SetCategory(CATEGORY_EQUIP+CATEGORY_POSITION+CATEGORY_MSET)
	e1:SetType(EFFECT_TYPE_ACTIVATE)
	e1:SetCode(EVENT_FREE_CHAIN)

Astrograph Sorcerer, the Starfrost Magician (48171151)

Source: Scripts/c48171151.lua

	local e1=Effect.CreateEffect(c)
	e1:SetDescription(aux.Stringid(id,0))
	e1:SetCategory(CATEGORY_DESTROY)
	e1:SetType(EFFECT_TYPE_IGNITION)
	e1:SetRange(LOCATION_PZONE)

Artmage Non-Finito (74631897)

Source: Scripts/c74631897.lua

	local e4=Effect.CreateEffect(c)
	e4:SetDescription(aux.Stringid(id,0))
	e4:SetCategory(CATEGORY_SSET)
	e4:SetType(EFFECT_TYPE_SINGLE+EFFECT_TYPE_TRIGGER_O)
	e4:SetCode(EVENT_SPSUMMON_SUCCESS)