Duel.ChangePosition

Signature

Duel.ChangePosition(Card|Group targets, int au, [int ad], [int du], [int dd], [bool noflip]) -> int

Description

Changes the battle position of targets and returns the number of cards whose position actually changed. The position arguments map by current position: au for face-up Attack Position, ad for face-down Attack Position, du for face-up Defense Position, and dd for face-down Defense Position. Omitted values use au.

How To Use It

Use this when an effect changes battle position during resolution.

The short form changes every target to the same position:

if tc:IsRelateToEffect(e) then
    Duel.ChangePosition(tc,POS_FACEUP_DEFENSE)
end

For mixed current positions, pass the destination for face-up Attack, face-down Attack, face-up Defense, and face-down Defense in that order. MDPro4's core does not read the old seventh setavailable argument.

Related Functions

• Card.IsCanChangePosition
• Card.IsPosition

Parameters

• targets Card|Group
• au int
• ad int optional - default: au
• du int optional - default: au
• dd int optional - default: au
• noflip bool optional - default: false

Returns

• int

Source

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

Guided Examples

Learn how to use this function in context:

• Methods for Affecting Cards
• Battle Position Effects
• Write Your First Custom Card
• First Scripts To Study
• Quick-Play Spells

Used By

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

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

Card	ID	Script	Detected Calls
Salamandra with Chain	62091148	Scripts/c62091148.lua	1
Deftero Enneacraft - "alazoneIA"	92171126	Scripts/c92171126.lua	1
Enneacraft - Asta.PIXEA	28454232	Scripts/c28454232.lua	1
Enneacraft - Archa.TAIL	81237046	Scripts/c81237046.lua	1
Enneacraft - Atil.SPIA	71801447	Scripts/c71801447.lua	1
Enneacraft - Aiza.LEON	82359538	Scripts/c82359538.lua	1
Recette de Viande (Meat Recipe)	14166715	Scripts/c14166715.lua	1
Regenesis Birth	27781371	Scripts/c27781371.lua	1
Chaos Magical Hats	2372506	Scripts/c2372506.lua	1
Magical Hats	81210420	Scripts/c81210420.lua	1
Power Tool Braver Dragon	63265554	Scripts/c63265554.lua	1
Enneacraft - Atori.MAR	54842941	Scripts/c54842941.lua	2
Mimighoul Maker	13204145	Scripts/c13204145.lua	3
Ekto Enneacraft - "tromarIA"	29570824	Scripts/c29570824.lua	1
Enato Enneacraft - "oknirIA"	55965529	Scripts/c55965529.lua	1
Enneacraft Reverth	80015408	Scripts/c80015408.lua	1
Amaze Attraction Thrill Train	36591747	Scripts/c36591747.lua	1
Scrap-Iron Sacred Statue	85520170	Scripts/c85520170.lua	1
Trito Enneacraft - "exapatisIA"	44716748	Scripts/c44716748.lua	1
Proto Enneacraft - "orgIA"	56187077	Scripts/c56187077.lua	1
Performapal Corn	33103459	Scripts/c33103459.lua	1
Arbitration of White	57964143	Scripts/c57964143.lua	1
First Penguin	12975671	Scripts/c12975671.lua	1
VARefar, the Judge of Ball	19743887	Scripts/c19743887.lua	1
...and 493 more

Script Examples

Salamandra with Chain (62091148)

Source: Scripts/c62091148.lua

			Duel.HintSelection(g)
			local tc2=g:GetFirst()
			Duel.ChangePosition(tc2,POS_FACEDOWN_DEFENSE)
		end
	else

Deftero Enneacraft - "alazoneIA" (92171126)

Source: Scripts/c92171126.lua

function s.thcost2(e,tp,eg,ep,ev,re,r,rp,chk)
	if chk==0 then return true end
	Duel.ChangePosition(e:GetHandler(),POS_FACEUP_DEFENSE)
end
function s.thfilter2(c)

Enneacraft - Asta.PIXEA (28454232)

Source: Scripts/c28454232.lua

function s.discost(e,tp,eg,ep,ev,re,r,rp,chk)
	if chk==0 then return true end
	Duel.ChangePosition(e:GetHandler(),POS_FACEUP_DEFENSE)
end
function s.distg(e,tp,eg,ep,ev,re,r,rp,chk)