מדריך · יסודות הסקריפטים

TweenService ב-Roblox: מזיזים, מסובבים ומסתירים פארטים

טווין משנה מאפיין בצורה חלקה מהערך הנוכחי עד היעד בזמן נתון: פלטפורמה מחליקה, קריסטל מסתובב, קיר נמוג. TweenService מחשב בעצמו את שלבי הביניים, ולכן לא צריך לכתוב לולאה שמזיזה את הפארט בכל פריים. במדריך הזה: שלוש השורות שאף טווין לא מסתדר בלעדיהן, מה כל הגדרה של TweenInfo עושה, הזזה, סיבוב והעלמה של פארטים, לולאות, המתנה לסוף הטווין וטריק לטווין של מודל שלם (Model).

עודכן 20 בנובמבר 20265 דק׳ קריאהמאת:

בקצרה

קבלו את השירות דרך 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 studs תוך 2 שניות:

Script בתוך Part ב-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 בתוך Part ב-Workspace בשם Platform
-- 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 ב-Workspace בשם FadingWall
-- 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 ב-Workspace בשם FloatingGem
-- 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 בתוך מודל ב-Workspace בשם Elevator
-- 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, ובו-זמנית תעלים את פארטי המחסום האדומים תוך שנייה אחת.

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().

מקורות וקריאה נוספת

איך הקוד נבדק: כל סקריפט בעמוד הזה עובר את בודק הטיפוסים המחמיר של Luau עם הגדרות ה-API של Roblox (luau-lsp, 20 בנובמבר 2026). בדיקת טיפוסים תופסת שגיאות בשמות API וטיפוסים שגויים, אבל לא שגיאות בלוגיקת המשחק, אז בדקו הכול ב-Studio לפני הפרסום.

נסו את RoCode במשחק שלכם.

קרדיטים חינמיים בכל יום, בלי כרטיס אשראי. התקינו את הפלאגין, תארו פיצ'ר ובדקו מה מופיע ב-Studio.