Duel.RegisterFlagEffect

Signature

Duel.RegisterFlagEffect(int player, int code, int reset_flag, int property, int reset_count, [int label]) -> Effect|nil

Description

Registers a player/global flag effect on player and returns the created Effect. The flag effect is player-targeted, field-only, 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 player flags for player-wide markers; use Card.RegisterFlagEffect for markers tied to one card.

How To Use It

Use this to place a player marker, such as a once-per-turn or action-limit marker that is not attached to a specific card.

Duel.RegisterFlagEffect(tp,id,RESET_PHASE+PHASE_END,0,1)

The local binding creates a field-only player-target flag effect. Like card flags, count 0 becomes 1 and phase resets without a turn side apply to both players' turns.

Related Functions

• Duel.GetFlagEffect
• Duel.GetFlagEffectLabel
• Duel.ResetFlagEffect
• Effect.SetReset

Parameters

• player int - Player that receives the marker; invalid players make the core return no values.
• 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; player-target, field-only, and cannot-disable flags are 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.

Returns

• Effect|nil - The created flag effect, or nil if player is invalid.

Source

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

Guided Examples

Learn how to use this function in context:

• Flag Effects
• Reset Flags And Effect Duration

Used By

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

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

Card	ID	Script	Detected Calls
Artmage Non-Finito	74631897	Scripts/c74631897.lua	1
Pendulum Evolution	55795155	Scripts/c55795155.lua	1
Eternal Favorite	87532344	Scripts/c87532344.lua	2
Melffy Playtime Surprise	58036097	Scripts/c58036097.lua	1
Mementotlan Fusion	66518509	Scripts/c66518509.lua	2
Favorite HERO Flame Wingman	13243124	Scripts/c13243124.lua	2
Gem-Knight Dispersion	24220368	Scripts/c24220368.lua	3
Ghostrick Renovation	61818176	Scripts/c61818176.lua	1
Magnet Bonding	65514302	Scripts/c65514302.lua	2
Hecahands Tartaros	57809669	Scripts/c57809669.lua	2
Enneacraft - Archa.TAIL	81237046	Scripts/c81237046.lua	1
D/D/D/D Dimensional King Arc Crisis	71398055	Scripts/c71398055.lua	1
Ultimate Crystal Rainbow Dragon Overdrive	84544192	Scripts/c84544192.lua	1
Ashened to Endlessness	34813443	Scripts/c34813443.lua	1
Penetration Fusion	8778267	Scripts/c8778267.lua	1
Fiendsmith Kyrie	26434972	Scripts/c26434972.lua	1
Chef de Nouvelles	29251488	Scripts/c29251488.lua	2
Artmage Pact -Awakening-	23599634	Scripts/c23599634.lua	1
Trirealm Rift Judgment	65195679	Scripts/c65195679.lua	1
Hunting Horn	55421040	Scripts/c55421040.lua	1
Echelon of the Fire Kings	38798785	Scripts/c38798785.lua	1
Double Interlock	38129297	Scripts/c38129297.lua	2
Mementotlan Shleepy	50042011	Scripts/c50042011.lua	1
K9-X Forced Release	53792930	Scripts/c53792930.lua	2
...and 330 more

Script Examples

Artmage Non-Finito (74631897)

Source: Scripts/c74631897.lua

end
function s.regop(e,tp,eg,ep,ev,re,r,rp)
	Duel.RegisterFlagEffect(tp,id,RESET_PHASE+PHASE_END,0,1)
end
function s.spfilter(c,tp,sc)

Pendulum Evolution (55795155)

Source: Scripts/c55795155.lua

	local tc=g:GetFirst()
	while tc do
		Duel.RegisterFlagEffect(tc:GetSummonPlayer(),55795155,RESET_PHASE+PHASE_END,0,1)
		tc=g:GetNext()
	end

Eternal Favorite (87532344)

Source: Scripts/c87532344.lua

		and Duel.IsExistingMatchingCard(s.spfilter,tp,LOCATION_GRAVE+LOCATION_REMOVED,0,1,nil,e,tp) end
	Duel.Hint(HINT_OPSELECTED,1-tp,e:GetDescription())
	Duel.RegisterFlagEffect(tp,id,RESET_PHASE+PHASE_END,0,1)
	Duel.SetOperationInfo(0,CATEGORY_SPECIAL_SUMMON,nil,1,tp,LOCATION_GRAVE+LOCATION_REMOVED)
end