Last updated: Aug 1, 20262 min read

Multi-Select Dropdown

Checkbox choice list allowing selection of multiple options concurrently.

Multi-Select Selector#

LUA Script
1local MultiDropdown = Section:CreateMultiDropdown(name, list, default, callback, description)
  • default (array): Initial checked options.

Multi-Select Methods#

  • MultiDropdown:SetValue(valueTable): Force check multiple values.
  • MultiDropdown:Refresh(newList, newDefault): Rebuild options list dynamically.
  • MultiDropdown:GetValue(): Returns array of checked option strings.

Complete Code Example#

Here is a complete copy-pasteable script showing how to build and read multi-select dropdown widgets:

LUA Script
1local ValincUi = loadstring(game:HttpGet("https://cdn.vinzhub.com/scripts/Liblery%20Ui/VALINC-QUARTZ/57319f29599c47672f19f8d56d53ffbe/a6b3ccb1f04d1d7d06232a9c5d25779e2af89c12992bebae.lua"))()
2
3local Window = ValincUi:CreateWindow("Multi-Select Hub", "check-square", "gold")
4local Tab = Window:CreateTab("Loot Filter")
5local Section = Tab:CreateSection("Auto Pickup Items")
6
7local itemPool = {"Common Swords", "Rare Gems", "Legendary Chests", "Mythic Fruit"}
8local initialSelected = {"Rare Gems", "Legendary Chests"}
9
10-- Create a multi-select dropdown widget
11local LootDropdown = Section:CreateMultiDropdown("Target Items to Pickup", itemPool, initialSelected, function(selectedArray)
12 print("Selected Items Array Updated:")
13 for _, item in ipairs(selectedArray) do
14 print(" -> " .. item)
15 end
16end, "Check multiple item categories that your character will automatically collect.")
17
18-- Update choices programmatically
19Section:CreateButton("Select All Items", function()
20 LootDropdown:SetValue({"Common Swords", "Rare Gems", "Legendary Chests", "Mythic Fruit"})
21end, "Checks all available item category options.")