I have this rudimentary carousel UI thing going on for a character selection/purchase shop that I’m working on and am wondering if this can be improved in any way. From what I can tell so far it seems to be working alright.
This code is a segment of a bigger LocalScript, but I think all the relevant code is there:
--services
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")
local TweenService = game:GetService("TweenService")
local RunService = game:GetService("RunService")
local Workspace = game:GetService("Workspace")
--modules
local modulesFolder = ReplicatedStorage.modules
local playerModule = require(modulesFolder.playerModule)
local characters = require(modulesFolder.characters)
--folders
local remotesFolder = ReplicatedStorage.remotes
local uiFolder = ReplicatedStorage.clientAssets.UI
local characterTemplate = uiFolder.characterTemplate
local canvasGroup = script.Parent
--shop ui
local shopFrame = canvasGroup.ShopFrame
local shopBackButton = shopFrame.back
local charactersContainer = shopFrame.characterContainer
local selectedIndex = 1
local spinSpeed = 35 -- degrees per second
--adjust spacing and size based on device
local viewportSizeX = 0.25
local viewportSpacing = if playerModule.getPlayerDevice() == "Mobile" then 120 else 300
local characterShopTweenInfo = TweenInfo.new(0.2, Enum.EasingStyle.Quad)
local viewportFrames = {}
local dragTween = nil
local isDragging = false
local selectDebounce = false
local dragStartPos = 0
local dragDelta = 0
--helpers
function numberClamp(v)
return math.clamp(v, 0, 9999)
end
function getViewportYSize(selected)
if playerModule.getPlayerDevice() == "Mobile" then return selected and 0.3 or 0.15 end --0.3 selected size, 0.15 not selected size
return selected and 0.5 or 0.25 --0.5 selected size, 0.25 not selected size
end
local viewMinY = getViewportYSize(false) --size when not selected
local viewMaxY = getViewportYSize(true)--size when selected
function eased(t)
t = math.clamp(t, 0, 1)
return t * t * (3 - 2 * t)
end
--create viewportFrames
function createViewport(characterData, index)
local vp = characterTemplate:Clone()
vp.Visible = true
vp.Name = characterData.Name
vp.Size = UDim2.new(viewportSizeX, 0, viewMinY, 0)
vp.Position = UDim2.new(0.5, (index - 1) * viewportSpacing, 0.5, 0)
vp.AnchorPoint = Vector2.new(0.5, 0.5)
vp.Parent = charactersContainer
local char = characterData.Model:Clone()
char.CFrame = CFrame.new(0, 5.113, 0) * CFrame.Angles(0, math.rad(-180), 0)
char:SetAttribute("BaseCFrame", char.CFrame)
char:SetAttribute("Name", characterData.Name)
char.Name = "Character"
char.Parent = vp
return vp
end
for i, data in ipairs(characters.Characters) do
viewportFrames[i] = createViewport(data, i)
end
--viewportFrame positioning/sizing
function setSelected(index)
dragDelta = 0
dragTween = nil
selectedIndex = index
for i, vp in ipairs(viewportFrames) do
if not vp.Character then continue end
local selected = (i == index)
if not selected then continue end
local targetX = (i - index) * viewportSpacing
TweenService:Create(vp, characterShopTweenInfo, {
Position = UDim2.new(0.5, targetX, 0.5, 0),
Size = UDim2.new(viewportSizeX, 0, selected and viewMaxY or viewMinY, 0)
}):Play()
print("Selected character: ".. vp.Character:GetAttribute("Name"))
end
task.wait(0.2)
selectDebounce = false
end
function setUnSelected(index)
for i, vp in ipairs(viewportFrames) do
if not vp.Character then continue end
if i == index then continue end
local base = vp.Character:GetAttribute("BaseCFrame")
if not base then continue end
TweenService:Create(vp.Character, characterShopTweenInfo, {CFrame = base}):Play()
end
end
function updateViewportPositions()
if #viewportFrames == 0 then return end
local centerX = camera.ViewportSize.X * 0.5
for i, vp in ipairs(viewportFrames) do
local targetX = (i - selectedIndex + dragDelta / viewportSpacing) * viewportSpacing
vp.Position = UDim2.new(0.5, targetX, 0.5, 0)
local vpCenter = vp.AbsolutePosition.X + vp.AbsoluteSize.X * 0.5
local dist = math.abs(vpCenter - centerX)
local ratio = eased(1 - dist / viewportSpacing)
vp.Size = UDim2.new(viewportSizeX, 0, viewMinY + (viewMaxY - viewMinY) * ratio, 0)
end
end
--dragging
function tweenDragToCenter(nearestIndex)
if selectDebounce then return end
selectDebounce = true
if dragTween then
dragTween.Completed:Wait()
end
nearestIndex = math.clamp(nearestIndex, 1, #viewportFrames)
local goalDelta = (selectedIndex - nearestIndex) * viewportSpacing
local proxy = Instance.new("NumberValue")
proxy.Value = dragDelta
proxy.Changed:Connect(function()
dragDelta = proxy.Value
updateViewportPositions()
end)
dragTween = TweenService:Create(proxy, characterShopTweenInfo, {Value = goalDelta})
dragTween:Play()
dragTween.Completed:Connect(function()
setSelected(nearestIndex)
end)
setUnSelected(nearestIndex)
end
function onDragStart(input)
if not shopFrame.Visible or selectDebounce then return end
if input.UserInputType ~= Enum.UserInputType.Touch and input.UserInputType ~= Enum.UserInputType.MouseButton1 then return end
isDragging = true
dragStartPos = input.Position.X
dragDelta = 0
end
function onDragMove(input)
if not isDragging then return end
if input.UserInputType ~= Enum.UserInputType.Touch and input.UserInputType ~= Enum.UserInputType.MouseMovement then return end
dragDelta = input.Position.X - dragStartPos
updateViewportPositions()
end
function onDragEnd(input)
if not isDragging then return end
if input.UserInputType ~= Enum.UserInputType.Touch and input.UserInputType ~= Enum.UserInputType.MouseButton1 then return end
isDragging = false
local offset = (dragDelta + viewportSpacing / 2) / viewportSpacing
local nearest = selectedIndex - math.floor(offset)
tweenDragToCenter(nearest)
dragDelta = 0
end
UserInputService.InputBegan:Connect(onDragStart)
UserInputService.InputChanged:Connect(onDragMove)
UserInputService.InputEnded:Connect(onDragEnd)
UserInputService.InputBegan:Connect(function(input, gpe)
if not shopFrame.Visible or selectDebounce or gpe then return end
if input.UserInputType ~= Enum.UserInputType.Keyboard then return end
local key = input.KeyCode
if key == Enum.KeyCode.A or key == Enum.KeyCode.Left then
tweenDragToCenter(selectedIndex - 1)
elseif key == Enum.KeyCode.D or key == Enum.KeyCode.Right then
tweenDragToCenter(selectedIndex + 1)
end
end)
mouse.WheelForward:Connect(function()
if not shopFrame.Visible or selectDebounce then return end
tweenDragToCenter(selectedIndex + 1)
end)
mouse.WheelBackward:Connect(function()
if not shopFrame.Visible or selectDebounce then return end
tweenDragToCenter(selectedIndex - 1)
end)
RunService.RenderStepped:Connect(function(dt)
if not shopFrame.Visible then return end
local vp = viewportFrames[selectedIndex]
if vp and vp.Character then
vp.Character.CFrame *= CFrame.Angles(0, math.rad(spinSpeed * dt), 0)
end
updateViewportPositions()
end)