บทเรียน · พื้นฐานการเขียนสคริปต์

TweenService ใน Roblox: ขยับ หมุน และทำให้พาร์ตจางหาย

ทวีน (tween) เปลี่ยนพร็อพเพอร์ตีอย่างนุ่มนวลจากค่าปัจจุบันไปยังเป้าหมายในเวลาที่กำหนด: แพลตฟอร์มเลื่อน คริสตัลหมุน กำแพงค่อย ๆ หายไป TweenService คำนวณขั้นตอนระหว่างทางให้เอง คุณจึงไม่ต้องเขียนลูปที่ขยับพาร์ตทุกเฟรม ในคู่มือนี้: สามบรรทัดที่ทวีนทุกตัวต้องมี การตั้งค่าแต่ละตัวของ TweenInfo ทำอะไร การขยับ หมุน และทำให้พาร์ตจางหาย การวนลูป การรอให้ทวีนจบ และเทคนิคทวีนทั้งโมเดล (Model)

อัปเดตเมื่อ 20 พฤศจิกายน 2569อ่าน 3 นาทีเขียนโดย

สรุปสั้น ๆ

เรียกเซอร์วิสด้วย 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
ในหน้านี้
  1. วิธีการทำงาน
  2. 1. TweenInfo
  3. 2. หมุนและจางหาย
  4. 3. ลูป
  5. 4. โมเดล
  6. เซิร์ฟเวอร์หรือไคลเอนต์
  7. Common errors
  8. ด้วย RoCode
  9. คำถามที่พบบ่อย
  10. แหล่งข้อมูลและบทความแนะนำ

สามบรรทัดที่ทวีนทุกตัวต้องมี

ใส่ Part ใน Workspace ติ๊ก Anchored แล้วเอาเมาส์ไปวางที่มัน กด + และใส่ Script สคริปต์นี้ยกพาร์ตขึ้น 10 สตัดในเวลา 2 วินาที:

Script ใน พาร์ตใน Workspace ชื่อ Rise
-- 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 รับค่าได้สูงสุดหกค่าตามลำดับนี้ ค่าท้าย ๆ ไม่ใส่ก็ได้

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
ค่าค่าเริ่มต้นหน้าที่
time1จำนวนวินาทีต่อการเล่นหนึ่งครั้ง
easingStyleQuadรูปแบบการเคลื่อนไหว: Linear (ความเร็วคงที่), Sine, Quad, Cubic, Back (เลยเป้าแล้วกลับ), Bounce, Elastic, Exponential
easingDirectionOutOut เริ่มเร็วแล้วช้าลง In เริ่มช้า InOut ทำทั้งสองแบบ
repeatCount0จำนวนครั้งที่เล่นซ้ำหลังการเล่นครั้งแรก -1 ซ้ำไม่รู้จบ
reversesfalseกลับไปที่จุดเริ่มหลังการเล่นแต่ละครั้ง
delayTime0จำนวนวินาทีที่รอก่อนเริ่ม
Script ใน พาร์ตใน Workspace ชื่อ Platform
-- 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 ใน พาร์ตใน Workspace ชื่อ FadingWall
-- 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 ใน พาร์ตใน Workspace ชื่อ FloatingGem
-- 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 ใน โมเดลใน Workspace ชื่อ Elevator
-- 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 วินาที

RoCode ทำให้
  • หาพาร์ตและโมเดลที่ต้องใช้ด้วย 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()

แหล่งข้อมูลและบทความแนะนำ

วิธีตรวจโค้ด: ทุกสคริปต์ในหน้านี้ผ่านตัวตรวจชนิดข้อมูลแบบ strict ของ Luau พร้อมคำจำกัดความของ Roblox API (luau-lsp, 20 พฤศจิกายน 2569) การตรวจชนิดข้อมูลจับได้เฉพาะชื่อ API ที่พิมพ์ผิดและชนิดข้อมูลที่ไม่ถูกต้อง ไม่ได้ตรวจตรรกะของเกม ดังนั้นควรทดสอบใน Studio ก่อนเผยแพร่

ลองใช้ RoCode กับเกมของคุณเอง

มีเครดิตฟรีทุกวัน ไม่ต้องใช้บัตร ติดตั้งปลั๊กอิน อธิบายฟีเจอร์ที่ต้องการ แล้วดูผลลัพธ์ใน Studio