Duel.SetOperationInfo

Signature

Duel.SetOperationInfo(int chainc, int category, Card|Group|nil targets, int count, int player, int param) -> void

Description

Records operation information for category on chainc. Use concrete targets and count when the affected cards are known. For unresolved non-targeting movement effects, pass nil targets with the expected count, target player, and target location. For LP effects, target_player is the affected player and target_param is the amount. This information announces intent; it does not perform the operation or create official card targets.

How To Use It

Call this in the Target callback when the Chain Link can announce a category, affected cards or players, count, amount, or source location.

Known targets can be passed directly:

local g=Duel.SelectTarget(tp,s.filter,tp,0,LOCATION_ONFIELD,1,1,nil)
Duel.SetOperationInfo(0,CATEGORY_DESTROY,g,1,0,0)

For unresolved movement from a location, pass nil for targets and use target_player plus target_param as the location or amount:

Duel.SetOperationInfo(0,CATEGORY_TOHAND,nil,1,tp,LOCATION_DECK)
Duel.SetOperationInfo(0,CATEGORY_DAMAGE,nil,0,1-tp,800)

This announces intent; the operation still has to recheck legality and perform the actual action.

Related Functions

• Effect.SetCategory
• Duel.GetOperationInfo
• Duel.SetTargetPlayer
• Duel.SetTargetParam

Parameters

• chainc int - Chain index/count passed to the core chain lookup; scripts commonly use 0 for the current Chain Link.
• category int - CATEGORY_* operation category to record.
• targets Card|Group|nil - Known affected cards. Card or Group values are cloned into a read-only Group; nil records only count, player, and param.
• count int - Expected number of affected cards.
• player int - Target player stored in the operation info.
• param int - Category-specific value, commonly a destination location, amount, or other operation parameter.

Source

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

Guided Examples

Learn how to use this function in context:

• Methods for Affecting Cards
• Beginner Script Ladder
• Categories, Properties, And Hint Timing
• Chain Timing And Activation Windows
• Client UI And Prompt Behavior
• Common Script Errors And Debugging

More guided lessons (11)

• Counter Traps
• Counters
• Conditions, Costs, Activation Procedures, and Resolution
• Write Your First Custom Card
• LP Recovery and Effect Damage
• Min/Max Stat Card Selection
• Functions That Move Cards Across Locations
• Player-Targeted Effects
• Quick-Play Spells
• Spell Card Patterns
• Targeting Flow

Used By

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

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

Card	ID	Script	Detected Calls
Salamandra with Chain	62091148	Scripts/c62091148.lua	3
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	3
Lady's Dragonmaid	48658295	Scripts/c48658295.lua	3
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	3
Astrograph Sorcerer	76794549	Scripts/c76794549.lua	3
Spellbook of the Grand Circle	11911336	Scripts/c11911336.lua	3
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	4
D/D/D Alfred the Divine Sage King	11852093	Scripts/c11852093.lua	3
El Shaddoll Apkallone	50907446	Scripts/c50907446.lua	2
Mementotlan Fusion	66518509	Scripts/c66518509.lua	4
Meteoroa Drytron	24166324	Scripts/c24166324.lua	2
...and 10748 more

Script Examples

Salamandra with Chain (62091148)

Source: Scripts/c62091148.lua

	Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_EQUIP)
	Duel.SelectTarget(tp,s.filter,tp,LOCATION_MZONE,LOCATION_MZONE,1,1,nil)
	Duel.SetOperationInfo(0,CATEGORY_EQUIP,e:GetHandler(),1,0,0)
end
function s.posfilter(c)

Astrograph Sorcerer, the Starfrost Magician (48171151)

Source: Scripts/c48171151.lua

	if chk==0 then return c:IsDestructable()
		and Duel.IsExistingMatchingCard(s.pfilter,tp,LOCATION_HAND+LOCATION_DECK,0,1,nil,tp) end
	Duel.SetOperationInfo(0,CATEGORY_DESTROY,c,1,0,0)
end
function s.pop(e,tp,eg,ep,ev,re,r,rp)

Artmage Non-Finito (74631897)

Source: Scripts/c74631897.lua

	end
	Duel.Hint(HINT_OPSELECTED,1-tp,e:GetDescription())
	Duel.SetOperationInfo(0,CATEGORY_SPECIAL_SUMMON,nil,1,tp,LOCATION_EXTRA)
end
function s.fspop(e,tp,eg,ep,ev,re,r,rp)