สรุปสั้น ๆ
เรียกเซอร์วิสด้วย game:GetService("TweenService") อธิบายการเคลื่อนไหวด้วย TweenInfo.new(time, easingStyle, easingDirection) แล้วเรียก TweenService:Create(part, info, { Position = goal }) และสั่ง :Play() ที่ทวีนที่ได้ ทวีนได้ทุกพร็อพเพอร์ตีชนิด number, Vector3, CFrame, Color3, UDim2 และชนิดคล้ายกัน ถ้าจะรอให้จบ ใช้ tween.Completed:Wait() ส่วนการขยับไปกลับไม่รู้จบ ให้ตั้งจำนวนรอบซ้ำใน TweenInfo เป็น -1 และเปิด reverses
- ทวีนพาร์ตบนเซิร์ฟเวอร์ เมื่อผู้เล่นทุกคนต้องเห็น และทวีนบนไคลเอนต์ เมื่อเอฟเฟกต์มีไว้สำหรับผู้เล่นคนนั้นคนเดียว
- ตั้งพาร์ตที่ทวีนให้ Anchored ไม่อย่างนั้นฟิสิกส์จะรบกวนทวีน
- Model ไม่มี Position หรือ CFrame ให้ทวีน: ให้ทวีน NumberValue แล้วขยับโมเดลด้วย
PivotTo
ในหน้านี้
สามบรรทัดที่ทวีนทุกตัวต้องมี
ใส่ Part ใน Workspace ติ๊ก Anchored แล้วเอาเมาส์ไปวางที่มัน กด + และใส่ Script สคริปต์นี้ยกพาร์ตขึ้น 10 สตัดในเวลา 2 วินาที:
-- Script ข้างใน Part
local TweenService = game:GetService("TweenService")
local part = script.Parent :: BasePart
local info = TweenInfo.new(2) -- 2 วินาที ใช้ easing ค่าเริ่มต้น
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }
local tween = TweenService:Create(part, info, goal)
tween:Play()
เป้าหมายคือตารางของชื่อพร็อพเพอร์ตีและค่าที่ต้องการให้จบ ทวีนหลายพร็อพเพอร์ตีพร้อมกันได้: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) } ทวีนเริ่มจากค่าที่มีอยู่ตอนเรียก Play คุณจึงกำหนดแค่จุดจบเสมอ
| ชนิด | ทวีนได้นุ่มนวลไหม? | ตัวอย่าง |
|---|---|---|
| number | ได้ | Transparency, Reflectance, Value ของ NumberValue |
| Vector3, CFrame | ได้ | Position, Size, CFrame, Orientation |
| Color3 | ได้ | Color |
| UDim2, Vector2 | ได้ | Size และ Position ของ GUI |
| boolean, EnumItem | สลับค่าตอนจบ | CanCollide, Material |
| string, Instance | ไม่ได้ | เกิดข้อผิดพลาด cannot be tweened due to type mismatch |
ขั้นตอนที่ 1: การตั้งค่าทั้งหมดของ TweenInfo
TweenInfo.new รับค่าได้สูงสุดหกค่าตามลำดับนี้ ค่าท้าย ๆ ไม่ใส่ก็ได้
| ค่า | ค่าเริ่มต้น | หน้าที่ |
|---|---|---|
time | 1 | จำนวนวินาทีต่อการเล่นหนึ่งครั้ง |
easingStyle | Quad | รูปแบบการเคลื่อนไหว: Linear (ความเร็วคงที่), Sine, Quad, Cubic, Back (เลยเป้าแล้วกลับ), Bounce, Elastic, Exponential |
easingDirection | Out | Out เริ่มเร็วแล้วช้าลง In เริ่มช้า InOut ทำทั้งสองแบบ |
repeatCount | 0 | จำนวนครั้งที่เล่นซ้ำหลังการเล่นครั้งแรก -1 ซ้ำไม่รู้จบ |
reverses | false | กลับไปที่จุดเริ่มหลังการเล่นแต่ละครั้ง |
delayTime | 0 | จำนวนวินาทีที่รอก่อนเริ่ม |
-- Script ข้างใน Part ชื่อ Platform
-- เลื่อนไปกลับ 12 สตัดไม่รู้จบ นุ่มนวลที่ปลายทั้งสองด้าน
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- วินาทีในแต่ละทิศทาง
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- ซ้ำไม่รู้จบ
true -- กลับทางทุกครั้ง
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
ถ้าแพลตฟอร์มต้องพาผู้เล่นที่ยืนอยู่บนมันไปด้วย พึงรู้ว่า: พาร์ตที่ Anchored และมีทวีนจะเลื่อนอยู่ใต้ผู้เล่น แต่ไม่พาเขาไปด้วย กรณีนี้อธิบายไว้ในคู่มือแพลตฟอร์มเคลื่อนที่
ขั้นตอนที่ 2: การหมุน ขนาด และการจางหาย
ถ้าจะหมุนพาร์ต ให้ทวีน CFrame ไปที่ CFrame ปัจจุบันคูณด้วยการหมุน การทวีน Orientation ก็ใช้ได้ แต่ด้วย CFrame พาร์ตจะหมุนอยู่กับที่ ในตัวอย่างนี้ เมื่อสคริปต์เริ่ม กำแพงจะหมุน แล้วค่อย ๆ จางและหดลง และถูกลบหลังทวีนจบ:
-- Script ข้างใน Part ชื่อ FadingWall
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- หมุนหนึ่งในสี่รอบรอบแกนตั้งของมันเองใน 1 วินาที
local turn = TweenService:Create(wall, TweenInfo.new(1), {
CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- ทำต่อเมื่อหมุนเสร็จแล้วเท่านั้น
-- จากนั้นทำให้จางหายและหดลงพร้อมกัน
local fade = TweenService:Create(wall, TweenInfo.new(0.8, Enum.EasingStyle.Quad, Enum.EasingDirection.In), {
Transparency = 1,
Size = wall.Size * 0.2,
})
fade:Play()
fade.Completed:Wait()
wall:Destroy()
Completed ทำงานพร้อม PlaybackState: Completed ถ้าทวีนไปถึงเป้าหมาย หรือ Cancelled ถ้าถูกหยุดด้วย tween:Cancel() อย่ารอ Completed ของทวีนที่ซ้ำไม่รู้จบ: มันจะไม่มีวันจบ
ขั้นตอนที่ 3: ไอเทมที่ลอยและหมุน
ทวีนแบบวนลูปสองตัวบนคนละพร็อพเพอร์ตีทำงานพร้อมกันได้ ทวีนหมุนครบ 360 องศาผ่าน CFrame จะไม่ทำอะไร เพราะจุดเริ่มกับจุดจบเป็นการหมุนเดียวกัน การหมุนจึงทวีน NumberValue จาก 0 ถึง 360 แล้วตั้ง CFrame ตามค่านั้น ใส่ Script นี้ในพาร์ตที่ Anchored:
-- Script ข้างใน Part ชื่อ Gem ลอยขึ้นลงและหมุนไม่รู้จบ
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- สตัดเหนือจุดที่คุณวางไว้
local FLOAT_SECONDS = 1.2 -- ในแต่ละทิศทาง
local SPIN_SECONDS = 3 -- หมุนครบหนึ่งรอบ
local gem = script.Parent :: BasePart
gem.Anchored = true
local baseCFrame = gem.CFrame
local height = Instance.new("NumberValue")
local angle = Instance.new("NumberValue")
local function apply()
gem.CFrame = baseCFrame * CFrame.new(0, height.Value, 0) * CFrame.Angles(0, math.rad(angle.Value), 0)
end
height.Changed:Connect(apply)
angle.Changed:Connect(apply)
TweenService:Create(height, TweenInfo.new(FLOAT_SECONDS, Enum.EasingStyle.Sine, Enum.EasingDirection.InOut, -1, true), {
Value = FLOAT_HEIGHT,
}):Play()
TweenService:Create(angle, TweenInfo.new(SPIN_SECONDS, Enum.EasingStyle.Linear, Enum.EasingDirection.In, -1), {
Value = 360,
}):Play()
การหมุนใช้ Linear easing จึงหมุนด้วยความเร็วคงที่ และแต่ละรอบเริ่มใหม่ที่ 0 ซึ่งเป็นมุมเดียวกับ 360 จึงไม่มีการกระตุก คู่มือการเก็บเหรียญนำไอเทมแบบนี้ไปใช้ในเกม
ขั้นตอนที่ 4: ทวีนทั้งโมเดล
Model ไม่มีพร็อพเพอร์ตี Position หรือ CFrame ดังนั้น TweenService:Create(model, ...) จึงไม่มีอะไรให้ขยับ ให้ทวีน NumberValue จาก 0 ถึง 1 แทน แล้วขยับโมเดลด้วย PivotTo ซึ่งย้ายพาร์ตทั้งหมดข้างในไปพร้อมกัน:
-- Script ข้างใน Model ชื่อ Elevator
-- ขยับทั้งโมเดลขึ้น 20 สตัดแล้วกลับลงมา พาร์ตทั้งหมดไปด้วยกัน
local TweenService = game:GetService("TweenService")
local elevator = script.Parent :: Model
local startPivot = elevator:GetPivot()
local endPivot = startPivot * CFrame.new(0, 20, 0)
local progress = Instance.new("NumberValue")
progress.Changed:Connect(function(alpha: number)
elevator:PivotTo(startPivot:Lerp(endPivot, alpha))
end)
local info = TweenInfo.new(4, Enum.EasingStyle.Quad, Enum.EasingDirection.InOut, -1, true, 2)
TweenService:Create(progress, info, { Value = 1 }):Play()
ตั้งทุกพาร์ตของโมเดลให้ Anchored เลขสองท้าย TweenInfo คือการหน่วงก่อนการเล่นแต่ละครั้ง ลิฟต์จึงหยุดรอที่ด้านบนและด้านล่าง คู่มือประตูใช้วิธีเดียวกันในการเปิดประตูที่มีหลายพาร์ต
เซิร์ฟเวอร์หรือไคลเอนต์?
ทวีนที่เริ่มใน Script ฝั่งเซิร์ฟเวอร์เปลี่ยนพาร์ตบนเซิร์ฟเวอร์ และค่าใหม่จะถูกส่งต่อ (replicate) ไปยังผู้เล่นทุกคน ทุกคนจึงเห็น ทวีนใน LocalScript เปลี่ยนพาร์ตแค่บนหน้าจอของผู้เล่นคนนั้น
| รันใน | เมื่อไร | ตัวอย่าง |
|---|---|---|
| Script ฝั่งเซิร์ฟเวอร์ | การเปลี่ยนแปลงสำคัญต่อเกมหรือต่อทุกคน | ประตู สิ่งกีดขวางที่เคลื่อนที่ สะพานที่ค่อย ๆ ปรากฏ |
| LocalScript | เฉพาะผู้เล่นคนนี้ที่ต้องเห็น หรือเป็นเอฟเฟกต์ภาพล้วน ๆ | ไอเทมที่จางหายสำหรับผู้เล่นที่เก็บมัน, UI |
การ replicate ส่งการอัปเดตหลายครั้งต่อวินาที ทวีนฝั่งเซิร์ฟเวอร์จึงดูนุ่มนวลสำหรับผู้เล่นส่วนใหญ่ แต่ทวีนฝั่งเซิร์ฟเวอร์ที่เร็วมากหรือมีจำนวนมากอาจดูไม่นุ่มนวลบนเน็ตช้า ถ้าการเคลื่อนไหวเพื่อตกแต่งมีจำนวนมาก (เหรียญหมุนหลายร้อยเหรียญ) ให้รันทวีนใน LocalScript บนไคลเอนต์แต่ละเครื่อง
ข้อผิดพลาดที่พบบ่อยและวิธีแก้
เปิดหน้าต่าง Output (เมนู Window แล้ว Output) ก่อนกด Play
พาร์ตไม่ขยับเลย
ตรวจว่าคุณเรียก :Play() ที่ทวีนแล้ว ชื่อพร็อพเพอร์ตีในเป้าหมายสะกดถูกต้อง (Position ไม่ใช่ position) และเป็น Script ในที่ที่สคริปต์ทำงาน (ข้างในพาร์ตใน Workspace หรือใน ServerScriptService)
พาร์ตตกหรือสั่นระหว่างทวีน
มันไม่ได้ Anchored แรงโน้มถ่วงและการชนจึงรบกวนทวีน ติ๊ก Anchored
TweenService:Create property cannot be tweened due to type mismatch
ค่าเป้าหมายผิดชนิด เช่นใส่ตัวเลขให้พร็อพเพอร์ตีชนิด Vector3 ดูหน้าข้อผิดพลาด (ภาษาอังกฤษ)
Unable to cast to Dictionary หรือ Unable to cast value to Object
อาร์กิวเมนต์ผิดลำดับหรือผิดชนิด ลำดับต้องเป็น Create(instance, tweenInfo, goalTable) เสมอ ดู Unable to cast value to Object (ภาษาอังกฤษ)
ทำด้วย RoCode
ถ้าไม่อยากเขียนทวีนเอง RoCode สร้างให้ใน place ที่คุณเปิดอยู่ได้ RoCode คือเอเจนต์ AI สำหรับ Roblox Studio ที่เป็นอิสระ ไม่ได้มาจาก Roblox: คุณอธิบายการเปลี่ยนแปลงในเว็บแชต แล้วปลั๊กอินสำหรับ Studio จะสร้างสคริปต์ใน Explorer ของคุณ จึงไม่ต้องวางโค้ดเอง
ทำให้โมเดลสะพานใน Workspace เลื่อนออกไปด้านข้าง 15 สตัดเมื่อรอบเริ่ม ด้วยการทวีน NumberValue และ PivotTo และพร้อมกันนั้นให้พาร์ตกั้นสีแดงค่อย ๆ จางหายใน 1 วินาที
- หาพาร์ตและโมเดลที่ต้องใช้ด้วย Search Game ได้ก่อนเขียนอะไร
- เขียน Script ด้วย Create Script และถูกกำหนดให้ตรวจการคอมไพล์ด้วย Check Script
- วางจุดย้อนกลับก่อนและหลังทุกชุดการเปลี่ยนแปลง Ctrl+Z จึงย้อนได้ทีละชุด
กับปลั๊กอิน 3.9 ขึ้นไป RoCode รันเพลย์เทสต์สั้น ๆ และอ่านข้อผิดพลาดได้ แต่การเคลื่อนไหวดูด้วยตาตัวเองง่ายที่สุด ดังนั้นกด Play แล้วดู RoCode เชื่อมกับ Studio อย่างไร
คำถามที่พบบ่อย
ใช้ TweenService ใน Roblox อย่างไร?
เรียกเซอร์วิส สร้าง TweenInfo เรียก TweenService:Create(object, info, { Property = goal }) แล้วสั่ง :Play() ที่ผลลัพธ์ ในส่วนแรกมีตัวอย่างสามบรรทัด
จะวนลูปทวีนไม่รู้จบได้อย่างไร?
ส่ง -1 เป็นค่าที่สี่ใน TweenInfo.new (repeatCount) และ true เป็นค่าที่ห้า ถ้าต้องการให้ไปกลับ
จะรอให้ทวีนจบได้อย่างไร?
เรียก tween.Completed:Wait() หลัง tween:Play() หรือเชื่อมฟังก์ชันกับ tween.Completed
ทวีน Model ได้ไหม?
โดยตรงไม่ได้ ให้ทวีน NumberValue จาก 0 ถึง 1 และทุกครั้งที่ค่าเปลี่ยนให้เรียก model:PivotTo(start:Lerp(goal, value)) เหมือนในขั้นตอนที่ 4
จะหยุดทวีนได้อย่างไร?
เรียก tween:Cancel() เพื่อหยุดและปล่อยพาร์ตไว้ที่เดิม หรือ tween:Pause() เพื่อเล่นต่อภายหลังด้วย Play()
แหล่งข้อมูลและบทความแนะนำ
- Roblox Creator Docs: TweenService (ภาษาอังกฤษ). Create, ชนิดที่ทวีนได้ และการยกเลิก
- Roblox Creator Docs: TweenInfo (ภาษาอังกฤษ)
- Roblox Creator Docs: Tween (ภาษาอังกฤษ). Play, Pause, Cancel และ Completed
- Roblox Creator Docs: UI animation and tweens (ภาษาอังกฤษ). สไตล์และทิศทางของ easing ด้วยตัวอย่าง UI
- Roblox Creator Docs: PVInstance:PivotTo (ภาษาอังกฤษ)
วิธีตรวจโค้ด: ทุกสคริปต์ในหน้านี้ผ่านตัวตรวจชนิดข้อมูลแบบ strict ของ Luau พร้อมคำจำกัดความของ Roblox API (luau-lsp, 20 พฤศจิกายน 2569) การตรวจชนิดข้อมูลจับได้เฉพาะชื่อ API ที่พิมพ์ผิดและชนิดข้อมูลที่ไม่ถูกต้อง ไม่ได้ตรวจตรรกะของเกม ดังนั้นควรทดสอบใน Studio ก่อนเผยแพร่