Effect.SetTargetRange

Signature

Effect.SetTargetRange(Effect e, int s_range, int o_range) -> void

Description

Sets e's target range fields and clears EFFECT_FLAG_ABSOLUTE_TARGET. For most field effects, s_range is the affected locations on the handler's controller's side and o_range is the affected locations on the opponent's side. With EFFECT_FLAG_SPSUM_PARAM, they store Special Summon destination player and position. Use Effect.SetAbsoluteRange when the affected sides must be fixed to a specific player instead of relative to the handler.

How To Use It

Use this for the cards or players affected by a field-like effect, or for special meanings required by certain properties.

e1:SetRange(LOCATION_MZONE)
e1:SetTargetRange(0,LOCATION_MZONE)

The local binding writes s_range and o_range and clears EFFECT_FLAG_ABSOLUTE_TARGET. For absolute player-oriented ranges, use Effect.SetAbsoluteRange.

Related Functions

• Effect.SetRange
• Effect.SetAbsoluteRange
• Effect.SetProperty

Parameters

• e Effect - Effect whose target range fields are being set.
• s_range int - Usually the handler controller's affected locations. With EFFECT_FLAG_SPSUM_PARAM, this is the allowed Special Summon position.
• o_range int - Usually the opponent's affected locations. With EFFECT_FLAG_SPSUM_PARAM, this is the destination player value for the Special Summon.

Source

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

Guided Examples

Learn how to use this function in context:

• Battle Position Effects
• Common Script Errors And Debugging
• Effects That Apply Continuously
• Continuous Stat Modifiers
• Creation, Building, and Registration of an Effect Object
• EFFECT_TYPE Constants and Templates

More guided lessons (5)

• Field Spells
• First Scripts To Study
• Normal And Continuous Traps
• Special Summon-Only Monster Guide
• Tribute Summon Materials

Used By

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

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

Card	ID	Script	Detected Calls
Pendulum Evolution	55795155	Scripts/c55795155.lua	2
Azure Ocean Dragon Lord - Neo-Daedalus Rage	41570943	Scripts/c41570943.lua	1
Goyo Emperor	59255742	Scripts/c59255742.lua	1
Melffy Playtime Surprise	58036097	Scripts/c58036097.lua	1
Deftero Enneacraft - "alazoneIA"	92171126	Scripts/c92171126.lua	1
Gem-Knight Dispersion	24220368	Scripts/c24220368.lua	1
Lubellion the Searing Dragon	70534340	Scripts/c70534340.lua	1
Destratification Dino Stratiae	3841104	Scripts/c3841104.lua	1
Hecahands Tartaros	57809669	Scripts/c57809669.lua	2
Prank-Kids Weather Washer	44509529	Scripts/c44509529.lua	1
Enneacraft - Asta.PIXEA	28454232	Scripts/c28454232.lua	2
Odd-Eyes Revolution Dragon	16306932	Scripts/c16306932.lua	1
Resurgam Xyz	49082032	Scripts/c49082032.lua	1
Tohushaddoll Grysta	95072744	Scripts/c95072744.lua	1
Enneacraft - Archa.TAIL	81237046	Scripts/c81237046.lua	2
Dark End Evaporation Dragon	62002838	Scripts/c62002838.lua	1
Future Fusion Nova	92058902	Scripts/c92058902.lua	2
Enneacraft - Atil.SPIA	71801447	Scripts/c71801447.lua	1
Enneacraft - Aiza.LEON	82359538	Scripts/c82359538.lua	1
Ursarctic Polar Star	62714453	Scripts/c62714453.lua	1
Vidolium the Unstable Power Patron of Unity	70488851	Scripts/c70488851.lua	1
Starving Venemy Dragon	93729065	Scripts/c93729065.lua	1
W:P Fancy Ball	4993187	Scripts/c4993187.lua	2
Cerynemesia, Mystical Beast of the Forest	43632709	Scripts/c43632709.lua	1
...and 3023 more

Script Examples

Pendulum Evolution (55795155)

Source: Scripts/c55795155.lua

		e1:SetCode(EFFECT_EXTRA_PENDULUM_SUMMON)
		e1:SetProperty(EFFECT_FLAG_PLAYER_TARGET)
		e1:SetTargetRange(1,0)
		e1:SetValue(aux.TRUE)
		e1:SetReset(RESET_PHASE+PHASE_END)

Azure Ocean Dragon Lord - Neo-Daedalus Rage (41570943)

Source: Scripts/c41570943.lua

	e1:SetCode(EFFECT_CANNOT_SPECIAL_SUMMON)
	e1:SetReset(RESET_PHASE+PHASE_END)
	e1:SetTargetRange(1,0)
	Duel.RegisterEffect(e1,tp)
end

Goyo Emperor (59255742)

Source: Scripts/c59255742.lua

	e1:SetCode(EFFECT_REMOVE_BRAINWASHING)
	e1:SetProperty(EFFECT_FLAG_SET_AVAILABLE)
	e1:SetTargetRange(LOCATION_MZONE,LOCATION_MZONE)
	e1:SetTarget(aux.TargetEqualFunction(Card.GetFlagEffect,1,59255742))
	e1:SetLabelObject(tg)