Group.SelectSubGroup

Signature

Group.SelectSubGroup(Group g, int tp, function f, bool cancelable, [int min], [int max], ... any) -> Group|nil

Description

Lets tp select a subgroup from g with size between min and max that satisfies f. It respects already selected cards and returns nil if no valid selection is completed. Use Group.CheckSubGroup for the legality check, then SelectSubGroup where the player actually chooses the cards. If the chosen Group is stored for a later callback, call KeepAlive and later DeleteGroup. Use this for group-level requirements; use Group.FilterSelect for ordinary one-card filters.

How To Use It

Use this when the player must choose a subset that satisfies a group-level rule, not just individual card filters.

local sg=g:SelectSubGroup(tp,s.goal,false,2,3)
if sg then
    Duel.SendtoGrave(sg,REASON_EFFECT)
end

Use the matching Group.CheckSubGroup shape in chk==0 legality checks so the real prompt only appears after activation is legal.

Related Functions

• Group.CheckSubGroup
• Group.SelectUnselect
• Group.Select

Parameters

• g Group
• tp int
• f function
• cancelable bool
• min int optional
• max int optional
• ... any

Returns

• Group|nil - The selected subgroup, or nil if no valid selection is completed.

Source

• Utilities/utility.lua:1258

Guided Examples

Learn how to use this function in context:

• Filters, Card Objects, and Group Objects
• Link Procedure Guide
• Pendulum Procedure Guide
• Ritual Procedure Guide
• Selection And Group Handling
• Special Summon-Only Monster Guide

Used By

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

• Detected in 648 indexed script(s).
• Search this function in the Script Explorer with Group.SelectSubGroup.

Card	ID	Script	Detected Calls
Pendulum Evolution	55795155	Scripts/c55795155.lua	1
Levia-Dragoon - Daedalus	78579058	Scripts/c78579058.lua	1
Lady's Dragonmaid	48658295	Scripts/c48658295.lua	1
Azure Ocean Dragon Lord - Neo-Daedalus Rage	41570943	Scripts/c41570943.lua	1
Spellbook of the Grand Circle	11911336	Scripts/c11911336.lua	1
Yomagna the Fire Phantom	17350692	Scripts/c17350692.lua	1
Meteoroa Drytron	24166324	Scripts/c24166324.lua	1
Performage Cup Tricker	6812770	Scripts/c6812770.lua	1
Ehther the Heavenly Monarch	96570609	Scripts/c96570609.lua	1
Pere-Zenet Em Heru	46273941	Scripts/c46273941.lua	1
Am Duazenet	45151304	Scripts/c45151304.lua	1
Ursarctic Polari	27693363	Scripts/c27693363.lua	1
Prank-Kids Weather Washer	44509529	Scripts/c44509529.lua	1
D/D/D/D Dimensional King Arc Crisis	71398055	Scripts/c71398055.lua	1
D/D Count Surveyor	5997110	Scripts/c5997110.lua	1
Shining Draw	35906693	Scripts/c35906693.lua	1
Barian's Chaos Draw	97769122	Scripts/c97769122.lua	2
Nekroz Kaleidoscope	51124303	Scripts/c51124303.lua	1
Artmage Masterwork -Succession-	37517035	Scripts/c37517035.lua	1
Enlightenment Dragon	46186135	Scripts/c46186135.lua	1
Bujinki Ahashima	71095768	Scripts/c71095768.lua	1
Ultimate Crystal Rainbow Dragon Overdrive	84544192	Scripts/c84544192.lua	1
Chimera Fusion	63136489	Scripts/c63136489.lua	1
Tellusion the Magna Warrior	24431911	Scripts/c24431911.lua	1
...and 624 more

Script Examples

Pendulum Evolution (55795155)

Source: Scripts/c55795155.lua

	Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_SPSUMMON)
	aux.GCheckAdditional=aux.PendOperationCheck(ft1,ft2,ft)
	local g=tg:SelectSubGroup(tp,aux.TRUE,false,1,math.min(#tg,ft))
	aux.GCheckAdditional=nil
	if not g then

Levia-Dragoon - Daedalus (78579058)

Source: Scripts/c78579058.lua

				Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_LMATERIAL)
				local cancel=Duel.IsSummonCancelable()
				local sg=mg:SelectSubGroup(tp,s.LCheckGoal,cancel,minc,maxc,tp,c,gf,lmat)
				if sg then
					sg:KeepAlive()

Lady's Dragonmaid (48658295)

Source: Scripts/c48658295.lua

	local g=Duel.GetMatchingGroup(s.fusfilter,cp,LOCATION_ONFIELD+LOCATION_GRAVE,0,nil)
	Duel.Hint(HINT_SELECTMSG,cp,HINTMSG_REMOVE)
	local sg=g:SelectSubGroup(cp,s.fselect,true,2,2)
	if sg then
		sg:KeepAlive()