Duel.MoveToField

Signature

Duel.MoveToField(Card c, int move_player, int target_player, int dest, int positions, bool enable, [int zone]) -> bool

Description

Moves c onto target_player's field and returns true if the move succeeds. dest is normally LOCATION_MZONE or LOCATION_SZONE. LOCATION_FZONE and LOCATION_PZONE are accepted and converted to the matching Spell & Trap Zone handling by the core. For LOCATION_PZONE, the core requires a Pendulum Card, lets the player choose an open Pendulum Zone, and sends the card to the GY by rule if no matching Pendulum Zone is usable. Use this for field placement, not for Equip relationships; Equip Cards should use Duel.Equip.

How To Use It

Use this for effects that place an existing card directly onto the field, such as moving a card to the Field Zone, Pendulum Zone, or Spell & Trap Zone.

if tc:IsRelateToEffect(e) then
    Duel.MoveToField(tc,tp,tp,LOCATION_SZONE,POS_FACEUP,true)
end

enable=true applies the moved card's field effects immediately. The optional zone mask restricts which zone can be used.

Related Functions

• Duel.GetLocationCount
• Duel.GetSZoneCount
• Duel.ReturnToField

Parameters

• c Card - Card to move.
• move_player int - Player making the placement selection.
• target_player int - Player whose field receives the card.
• dest int - Destination location. LOCATION_PZONE is accepted for Pendulum Zone placement.
• positions int - Allowed position mask, commonly POS_FACEUP for Pendulum Zone placement.
• enable bool - Whether to enable the card's field effects after it moves. Local Pendulum placement scripts commonly pass true.
• zone int optional - Optional zone mask. For LOCATION_PZONE, low bit 0 allows the left Pendulum Zone and low bit 1 allows the right Pendulum Zone; omitted defaults to both.

Returns

• bool - true if the move succeeds; false if the move is invalid or no usable zone is available.

Source

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

Guided Examples

Learn how to use this function in context:

• Counters
• Equip Spells and Equip Cards
• Field Spells
• Functions That Move Cards Across Locations
• Pendulum Procedure Guide

Used By

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

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

Card	ID	Script	Detected Calls
Astrograph Sorcerer, the Starfrost Magician	48171151	Scripts/c48171151.lua	1
Astrograph Sorcerer	76794549	Scripts/c76794549.lua	1
D/D/D Alfred the Divine Sage King	11852093	Scripts/c11852093.lua	1
Ghostrick Renovation	61818176	Scripts/c61818176.lua	1
Ursarctic Polari	27693363	Scripts/c27693363.lua	1
D/D/D/D Dimensional King Arc Crisis	71398055	Scripts/c71398055.lua	1
D/D/D/D Super-Dimensional Sovereign Emperor Zero Paradox	97417863	Scripts/c97417863.lua	2
Odd-Eyes Arcray Dragon	6218704	Scripts/c6218704.lua	2
Starving Venemy Dragon	93729065	Scripts/c93729065.lua	1
Chronograph Sorcerer	12289247	Scripts/c12289247.lua	1
Radiant Typhoon Varuroon, the Marine Eidolon	39341885	Scripts/c39341885.lua	2
Camelot, Realm of Noble Knights and Noble Arms	15635751	Scripts/c15635751.lua	2
Yummy★Snatchy	30581601	Scripts/c30581601.lua	1
Aroma Blend	25861589	Scripts/c25861589.lua	1
Chef de Nouvelles	29251488	Scripts/c29251488.lua	1
Starving Venom Wing Dragon	5148778	Scripts/c5148778.lua	1
Plunder Patrollship Jord	85969517	Scripts/c85969517.lua	1
Sea Stealth Attack	19089195	Scripts/c19089195.lua	2
D/D/D Deviser King Deus Machinex	46593546	Scripts/c46593546.lua	2
Odd-Eyes Rebellion Dragon Overlord	98452268	Scripts/c98452268.lua	1
Nirvana High Paladin	80896940	Scripts/c80896940.lua	1
Dreaming Nemleria	70155677	Scripts/c70155677.lua	1
Favorite Hero	11881272	Scripts/c11881272.lua	1
Yummy☆Surprise	29369059	Scripts/c29369059.lua	1
...and 240 more

Script Examples

Astrograph Sorcerer, the Starfrost Magician (48171151)

Source: Scripts/c48171151.lua

	local g=Duel.SelectMatchingCard(tp,s.pfilter,tp,LOCATION_HAND+LOCATION_DECK,0,1,1,nil,tp)
	local tc=g:GetFirst()
	if tc and Duel.MoveToField(tc,tp,tp,LOCATION_PZONE,POS_FACEUP,true) then
		local e1=Effect.CreateEffect(c)
		e1:SetType(EFFECT_TYPE_SINGLE)

Astrograph Sorcerer (76794549)

Source: Scripts/c76794549.lua

		end
		if op==0 then
			Duel.MoveToField(tc,tp,tp,LOCATION_PZONE,POS_FACEUP,true)
		else
			Duel.SpecialSummon(tc,0,tp,tp,false,false,POS_FACEUP)

D/D/D Alfred the Divine Sage King (11852093)

Source: Scripts/c11852093.lua

	end
	for tc in aux.Next(pg) do
		Duel.MoveToField(tc,tp,tp,LOCATION_SZONE,POS_FACEUP,true)
	end
	local sg=g:Filter(Card.IsLocation,nil,LOCATION_REMOVED)