Card.RegisterFlagEffect

Signature

Card.RegisterFlagEffect(Card c, int code, int reset_flag, int property, int reset_count, [int label], [int desc]) -> Effect

Description

Registers a special single-card flag effect on c and returns the created Effect. Flag effects are script markers: their code is kept separate from regular effect codes, they cannot be disabled, and count=0 is treated as 1. When reset_flag contains RESET_PHASE without RESET_SELF_TURN or RESET_OPPO_TURN, the core applies both turn sides. See the Reset Flags And Effect Duration learning guide for full patterns. Use card flags for markers tied to one card's lifecycle; use Duel.RegisterFlagEffect for player markers.

How To Use It

Use this to place a marker on one card, usually to remember that the card used an effect or entered a temporary state.

c:RegisterFlagEffect(id,RESET_EVENT+RESETS_STANDARD+RESET_PHASE+PHASE_END,0,1)

The local binding masks the code as a flag-effect code, adds EFFECT_FLAG_CANNOT_DISABLE, treats count 0 as 1, and adds both turn sides to phase resets when no turn side is specified.

Related Functions

• Card.GetFlagEffect
• Card.GetFlagEffectLabel
• Card.ResetFlagEffect
• Effect.SetReset

Parameters

• c Card - Card that receives the marker.
• code int - Flag-effect code; the core masks it with MAX_CARD_ID and adds EFFECT_FLAG_EFFECT.
• reset_flag int - RESET_* mask controlling when the marker expires; phase resets without an explicit turn side apply to both players' turns.
• property int - Effect property flags stored on the created marker; EFFECT_FLAG_CANNOT_DISABLE is always added.
• reset_count int - Reset counter for the created marker; 0 is treated as 1.
• label int optional - Optional integer payload stored on the marker.
• desc int optional - Optional client description id for marker hints.

Returns

• Effect - The created flag effect.

Source

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

Guided Examples

Learn how to use this function in context:

• Common Script Errors And Debugging
• Flag Effects
• Reset Flags And Effect Duration

Used By

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

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

Card	ID	Script	Detected Calls
Salamandra with Chain	62091148	Scripts/c62091148.lua	1
Artmage Non-Finito	74631897	Scripts/c74631897.lua	2
Astrograph Sorcerer	76794549	Scripts/c76794549.lua	2
Ultra Polymerization	76647978	Scripts/c76647978.lua	1
Goyo Emperor	59255742	Scripts/c59255742.lua	1
Deftero Enneacraft - "alazoneIA"	92171126	Scripts/c92171126.lua	1
Ehther the Heavenly Monarch	96570609	Scripts/c96570609.lua	1
Resurgam Xyz	49082032	Scripts/c49082032.lua	1
Converging Wishes	20007374	Scripts/c20007374.lua	1
PSY-Framelord Omega	74586817	Scripts/c74586817.lua	1
Graydle Split	75361204	Scripts/c75361204.lua	2
Enneacraft - Archa.TAIL	81237046	Scripts/c81237046.lua	2
Shining Draw	35906693	Scripts/c35906693.lua	1
Barian's Chaos Draw	97769122	Scripts/c97769122.lua	1
Future Fusion Nova	92058902	Scripts/c92058902.lua	1
Enneacraft - Atil.SPIA	71801447	Scripts/c71801447.lua	1
Enneacraft - Aiza.LEON	82359538	Scripts/c82359538.lua	2
D/D/D/D Super-Dimensional Sovereign Emperor Zero Paradox	97417863	Scripts/c97417863.lua	1
Shooting Majestic Star Dragon	40939228	Scripts/c40939228.lua	1
Ursarctic Polar Star	62714453	Scripts/c62714453.lua	1
Kewl Tune Crackle	39576656	Scripts/c39576656.lua	2
Albion the Branded Dragon	87746184	Scripts/c87746184.lua	1
PSY-Framelord Zeta	37192109	Scripts/c37192109.lua	1
The Gaze of Timaeus	22283204	Scripts/c22283204.lua	1
...and 853 more

Script Examples

Salamandra with Chain (62091148)

Source: Scripts/c62091148.lua

			fop(ce,e,tp,tc,mat2)
		end
		tc:RegisterFlagEffect(id,RESET_EVENT+RESETS_STANDARD,0,1)
		tc:CompleteProcedure()
		local e2=Effect.CreateEffect(e:GetHandler())

Artmage Non-Finito (74631897)

Source: Scripts/c74631897.lua

		local tc2=g:SelectUnselect(nil,tp,false,true,1,1)
		if tc2 then
			tc2:RegisterFlagEffect(id+o,RESET_EVENT+RESETS_STANDARD,0,1)
			local sg=Group.FromCards(tc,tc2)
			sg:KeepAlive()

Astrograph Sorcerer (76794549)

Source: Scripts/c76794549.lua

	while tc do
		if tc:IsLocation(LOCATION_GRAVE+LOCATION_REMOVED) then
			tc:RegisterFlagEffect(76794549,RESET_EVENT+0x1f20000+RESET_PHASE+PHASE_END,0,1)
		elseif tc:IsLocation(LOCATION_EXTRA) then
			tc:RegisterFlagEffect(76794549,RESET_EVENT+RESETS_STANDARD+RESET_PHASE+PHASE_END,0,1)