RushDuel.SelectAndDoAction

Alias: RD.SelectAndDoAction. Requires the matching Rush Duel Lua bootstrap.

Signature

lua

RushDuel.SelectAndDoAction(int hint, function filter, int tp, int s_range, int o_range, int min, int max, Card|Group|nil expect, function action) -> any

Description

Finds matching cards in the specified locations, asks tp to select a non-cancelable Group of min to max cards, and immediately calls action(selected_group). Use during resolution, not during a chk==0 legality test. This helper does not select activation targets or store a target relation. The public wrapper passes only a Card to filter and only the selected Group to action; capture other values in closures or compose a filter with RD.Filter. It emits a selection hint for public-location searches. If there are too few candidates or the selected Group is empty, it returns numeric 0 without calling action. On a nonempty selection it forwards every return value from action unchanged. A callback with no return makes this helper return no values (nil in a single-value assignment); it does not automatically return the selected count or success.

Parameters

hint int: Selection prompt identifier, such as HINTMSG_TOGRAVE or aux.Stringid(id, n).
filter function: Card predicate. Include the needed operation-legality checks.
tp int: Selecting player; 0 or 1.
s_range int: Locations on tp's side.
o_range int: Locations on the opponent's side.
min int: Minimum selected count.
max int: Maximum selected count.
expect Card|Group|nil: Card(s) excluded from matching; pass nil for no exclusion. The upstream parameter is spelled expect.
action function: Called as action(selected_group) immediately after a nonempty selection.

Returns

any: Exactly the callback's return values when invoked; otherwise numeric 0. A callback may return no values.

Example

lua

local moved = RD.SelectAndDoAction(HINTMSG_TOGRAVE,
    Card.IsAbleToGrave, tp, LOCATION_MZONE, 0, 1, 1, nil,
    function(g) return Duel.SendtoGrave(g, REASON_EFFECT) end)
if moved > 0 then
    -- The returned movement count is positive.
end

Source

Rush/Utilities/RDAction.lua:102

lua

function RushDuel.SelectAndDoAction(hint, filter, tp, s_range, o_range, min, max, expect, action)
    local hint_selection = RushDuel._private_is_include_public(s_range, o_range)
    return RushDuel._private_action_select_match(hint, filter, tp, s_range, o_range, min, max, expect, hint_selection, false, action)
end

Guided Examples

Learn how to use this function in context:

Rush Selection, Actions, And Temporary Stats

Used By

Generated from the local Rush/Scripts/ folder and rush_cards.cdb.

Detected in 988 indexed script(s).
Search this function in the Script Explorer with RushDuel.SelectAndDoAction.

Card	ID	Script	Detected Calls
Elemental Circulation	`120263030`	Rush/Scripts/c120263030.lua	1
Moonforce Ziggy	`120300014`	Rush/Scripts/c120300014.lua	1
Freshberry Collaboration	`120301071`	Rush/Scripts/c120301071.lua	1
Voidalfr Star Mayfly	`120300034`	Rush/Scripts/c120300034.lua	1
Player #C39: Home Run Smasher V	`120305028`	Rush/Scripts/c120305028.lua	1
Invitation to a Delirious Dream	`120261066`	Rush/Scripts/c120261066.lua	1
Light of Bewitchment	`120301074`	Rush/Scripts/c120301074.lua	1
Dark-Guiding Kuriboh	`120280009`	Rush/Scripts/c120280009.lua	1
Delirium Lampyris	`120231061`	Rush/Scripts/c120231061.lua	1
Super Galaxy King Lord of Galactica [R]	`120254039`	Rush/Scripts/c120254039.lua	1
Fuden Issen	`120309034`	Rush/Scripts/c120309034.lua	1
Wako Gozen Riletta	`120309021`	Rush/Scripts/c120309021.lua	1
Sparkhearts Makma	`120298023`	Rush/Scripts/c120298023.lua	1
Imaginary Arc Turbulence	`120196013`	Rush/Scripts/c120196013.lua	1
Major Breaking News!	`120304060`	Rush/Scripts/c120304060.lua	1
Abyssal Dragon Lord Abyss Poseidra [L]	`120239013`	Rush/Scripts/c120239013.lua	1
Wish of the Skysavior	`120253064`	Rush/Scripts/c120253064.lua	1
Fairy of the Stars	`120305016`	Rush/Scripts/c120305016.lua	1
Necromaid Trickment	`120294063`	Rush/Scripts/c120294063.lua	1
Spice Cross Secret Recipe	`120261060`	Rush/Scripts/c120261060.lua	1
Magical Retribution	`120254028`	Rush/Scripts/c120254028.lua	1
Nobody Phantom Thief	`120244060`	Rush/Scripts/c120244060.lua	1
Nobody Phantom Thief	`120273005`	Rush/Scripts/c120273005.lua	1
Mega Jointech Fortrex [R]	`120249005`	Rush/Scripts/c120249005.lua	2
...and 964 more

Script Examples

Elemental Circulation (`120263030`)

Source: Rush/Scripts/c120263030.lua

lua

function cm.activate(e,tp,eg,ep,ev,re,r,rp)
	if RD.Draw()~=0 then
		RD.SelectAndDoAction(HINTMSG_TOGRAVE,Card.IsAbleToGrave,tp,LOCATION_HAND,0,1,1,nil,function(g)
			Duel.BreakEffect()
			Duel.SendtoGrave(g,REASON_EFFECT)

Moonforce Ziggy (`120300014`)

Source: Rush/Scripts/c120300014.lua

lua

end
function cm.operation(e,tp,eg,ep,ev,re,r,rp)
	RD.SelectAndDoAction(aux.Stringid(m,1),cm.filter,tp,0,LOCATION_MZONE,1,1,nil,function(g)
		local tc=g:GetFirst()
		local e1=Effect.CreateEffect(e:GetHandler())

Freshberry Collaboration (`120301071`)

Source: Rush/Scripts/c120301071.lua

lua

function cm.operation(e,tp,eg,ep,ev,re,r,rp)
	local filter=RD.Filter(cm.filter,e,tp)
	RD.SelectAndDoAction(HINTMSG_POSCHANGE,filter,tp,LOCATION_MZONE,0,1,1,nil,function(g)
		if RD.ChangePosition(g,e,tp,REASON_EFFECT,POS_FACEUP_DEFENSE)~=0 and e:GetLabel()==1 then
			RD.CanSelectAndDoAction(aux.Stringid(m,1),HINTMSG_DESTROY,cm.desfilter,tp,0,LOCATION_MZONE,1,1,nil,function(sg)

RushDuel.SelectAndDoAction ​

Signature ​

Description ​

Parameters ​

Returns ​

Example ​

Source ​

Guided Examples ​

Used By ​

Script Examples ​

Elemental Circulation (120263030) ​

Moonforce Ziggy (120300014) ​

Freshberry Collaboration (120301071) ​