בקצרה
קבלו את השירות דרך 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 studs תוך 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 studs, בצורה חלקה בשני הקצוות.
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()
אם הפלטפורמה צריכה להסיע שחקנים שעומדים עליה, שימו לב: פארט מעוגן עם טווין זז מתחתם, אבל לא לוקח אותם איתו. המקרה הזה מוסבר במדריך לפלטפורמה זזה.
שלב 2: סיבוב, גודל והעלמה
כדי לסובב פארט, עשו טווין ל-CFrame אל ה-CFrame הנוכחי כפול סיבוב. גם טווין ל-Orientation עובד, אבל עם CFrame הפארט מסתובב במקום. כאן הקיר מסתובב כשהסקריפט מתחיל, אחר כך נמוג ומתכווץ, ואחרי סוף הטווין נמחק:
-- Script בתוך Part בשם FadingWall.
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- סיבוב של רבע סיבוב סביב הציר האנכי שלו תוך שנייה אחת
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 הזה בפארט מעוגן:
-- Script בתוך Part בשם Gem. מרחף למעלה ולמטה ומסתובב בלי סוף.
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- studs מעל המקום שבו הצבתם אותו
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 studs למעלה ובחזרה, כל הפארטים יחד.
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()
עגנו את כל הפארטים של המודל. ה-2 בסוף ה-TweenInfo הוא השהיה לפני כל הרצה, ולכן המעלית עומדת למעלה ולמטה. המדריך לדלתות פותח באותה דרך דלתות מכמה פארטים.
שרת או לקוח?
טווין שהופעל ב-Script של שרת משנה את הפארט בשרת, והערכים החדשים משוכפלים לכל השחקנים, ולכן כולם רואים אותו. טווין ב-LocalScript משנה את הפארט רק במסך של השחקן הזה.
| הפעילו ב | מתי | דוגמה |
|---|---|---|
| Script של שרת | השינוי חשוב למשחק או לכולם. | דלתות, מכשולים זזים, גשר שנפתח |
| LocalScript | רק השחקן הזה צריך לראות את זה, או שזה אפקט ויזואלי בלבד. | חפץ שנמוג אצל השחקן שהרים אותו, UI |
השכפול שולח עדכונים הרבה פעמים בשנייה, ולכן טווינים בשרת נראים חלקים לרוב השחקנים, אבל טווינים מהירים מאוד או רבים מאוד בשרת יכולים להיראות פחות חלקים בחיבור איטי. להרבה תנועה דקורטיבית (מאות מטבעות מסתובבים) הפעילו את הטווינים ב-LocalScript בכל לקוח.
שגיאות נפוצות ופתרונות
פתחו את חלון ה-Output (תפריט Window, ואז Output) לפני שלוחצים על Play.
הפארט בכלל לא זז
בדקו שקראתם ל-:Play() של הטווין, ששם המאפיין ביעד כתוב בדיוק (Position, לא position), ושזה Script במקום שבו סקריפטים רצים (בתוך פארט ב-Workspace או ב-ServerScriptService).
הפארט נופל או רועד בזמן הטווין
הוא לא מעוגן, ולכן כבידה והתנגשויות מפריעות לטווין. סמנו 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 יכול לבנות אותם בפלייס שפתוח אצלכם. RoCode הוא סוכן AI עצמאי ל-Roblox Studio, לא של Roblox: אתם מתארים את השינוי בצ׳אט באתר, והפלאגין שלו ל-Studio יוצר סקריפטים ב-Explorer שלכם, כך שלא צריך להדביק קוד.
תגרום למודל הגשר ב-Workspace לזוז 15 studs הצידה כשסיבוב מתחיל, דרך טווין של NumberValue ו-PivotTo, ובו-זמנית תעלים את פארטי המחסום האדומים תוך שנייה אחת.
- יכול למצוא את הפארטים והמודלים הנכונים עם 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 (באנגלית)
איך הקוד נבדק: כל סקריפט בעמוד הזה עובר את בודק הטיפוסים המחמיר של Luau עם הגדרות ה-API של Roblox (luau-lsp, 20 בנובמבר 2026). בדיקת טיפוסים תופסת שגיאות בשמות API וטיפוסים שגויים, אבל לא שגיאות בלוגיקת המשחק, אז בדקו הכול ב-Studio לפני הפרסום.