Lyhyesti
Hae palvelu kutsulla game:GetService("TweenService"), kuvaa liike kutsulla TweenInfo.new(time, easingStyle, easingDirection), kutsu sitten TweenService:Create(part, info, { Position = goal }) ja käynnistä saatu tween kutsulla :Play(). Tweenata voi mitä tahansa ominaisuutta, jonka tyyppi on number, Vector3, CFrame, Color3, UDim2 tai vastaava. Lopun odottamiseen käytä tween.Completed:Wait(), ja loputtomaan edestakaiseen liikkeeseen aseta TweenInfo-olioon toistojen määräksi -1 ja ota reverses käyttöön.
- Tweenaa partti palvelimella, kun kaikkien pelaajien pitää nähdä se, ja asiakkaalla, kun efekti on tarkoitettu vain tälle pelaajalle.
- Ankkuroi (Anchored) tweenattavat partit, muuten fysiikka häiritsee tweeniä.
- Modelilla ei ole tweenattavaa Position- tai CFrame-ominaisuutta: tweenaa NumberValue ja liikuta mallia
PivotTo-kutsulla.
Tällä sivulla
Kolme riviä, joita jokainen tween tarvitsee
Lisää Part Workspaceen, rastita Anchored, vie sitten osoitin sen päälle, paina + ja lisää Script. Tämä skripti nostaa parttia 10 studia 2 sekunnissa:
-- Script Partin sisällä.
local TweenService = game:GetService("TweenService")
local part = script.Parent :: BasePart
local info = TweenInfo.new(2) -- 2 sekuntia, oletus-easing
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }
local tween = TweenService:Create(part, info, goal)
tween:Play()
Tavoite on taulukko ominaisuuksien nimistä ja arvoista, joihin niiden pitää päätyä. Useita ominaisuuksia voi tweenata kerralla: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. Tween alkaa niistä arvoista, jotka ovat voimassa Play-kutsun hetkellä, joten annat aina vain lopun.
| Tyyppi | Tweenautuuko pehmeästi? | Esimerkkejä |
|---|---|---|
| number | Kyllä | Transparency, Reflectance, NumberValuen Value |
| Vector3, CFrame | Kyllä | Position, Size, CFrame, Orientation |
| Color3 | Kyllä | Color |
| UDim2, Vector2 | Kyllä | GUI:n Size ja Position |
| boolean, EnumItem | Vaihtuu lopussa | CanCollide, Material |
| string, Instance | Ei | Antaa virheen cannot be tweened due to type mismatch |
Vaihe 1: kaikki TweenInfo-asetukset
TweenInfo.new ottaa enintään kuusi arvoa tässä järjestyksessä. Viimeiset voi jättää pois.
| Arvo | Oletus | Mitä se tekee |
|---|---|---|
time | 1 | Sekunnit yhteen toistokertaan. |
easingStyle | Quad | Liikkeen muoto: Linear (tasainen nopeus), Sine, Quad, Cubic, Back (ylitys), Bounce, Elastic, Exponential. |
easingDirection | Out | Out alkaa nopeasti ja hidastuu; In alkaa hitaasti; InOut tekee molemmat. |
repeatCount | 0 | Montako kertaa toistetaan ensimmäisen kerran jälkeen. -1 toistaa loputtomasti. |
reverses | false | Palataanko alkuun jokaisen toistokerran jälkeen. |
delayTime | 0 | Montako sekuntia odotetaan ennen alkua. |
-- Script Partin sisällä, jonka nimi on Platform.
-- Liikkuu loputtomasti edestakaisin 12 studia, pehmeästi molemmissa päissä.
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- sekuntia kumpaankin suuntaan
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- toista loputtomasti
true -- palaa joka kerta takaisin
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
Jos tasanteen pitää kuljettaa sen päällä seisovia pelaajia, huomaa: tweenattu ankkuroitu partti liikkuu heidän altaan, mutta ei vie heitä mukanaan. Tämä tapaus käydään läpi liikkuvan tasanteen oppaassa.
Vaihe 2: kierto, koko ja häivytys
Kääntääksesi parttia tweenaa CFrame kohti nykyistä CFramea kerrottuna kierrolla. Orientation-tween toimii myös, mutta CFramella partti kääntyy paikallaan. Tässä seinä kääntyy skriptin käynnistyessä, sitten häipyy ja pienenee, ja tweenin päätyttyä se poistetaan:
-- Script Partin sisällä, jonka nimi on FadingWall.
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- neljänneskierros oman pystyakselin ympäri 1 sekunnissa
local turn = TweenService:Create(wall, TweenInfo.new(1), {
CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- jatketaan vasta, kun kääntö on valmis
-- sitten häivytetään ja pienennetään samanaikaisesti
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 laukeaa PlaybackState-arvolla: Completed, jos tween ehti tavoitteeseen, tai Cancelled, jos sen pysäytti tween:Cancel(). Älä odota Completed-tapahtumaa tweeniltä, joka toistuu loputtomasti: se ei pääty koskaan.
Vaihe 3: leijuva ja pyörivä esine
Kaksi silmukoitua tweeniä eri ominaisuuksissa kulkee samanaikaisesti. Täyden 360 asteen kierroksen tween CFramen kautta ei tee mitään, koska alku ja loppu ovat sama kierto, joten pyöriminen tweenaa NumberValuen 0:sta 360:een ja asettaa CFramen sen mukaan. Laita tämä Script ankkuroituun parttiin:
-- Script Partin sisällä, jonka nimi on Gem. Leijuu loputtomasti ylös ja alas ja pyörii.
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- studia sen kohdan yläpuolella, johon asetit sen
local FLOAT_SECONDS = 1.2 -- kumpaankin suuntaan
local SPIN_SECONDS = 3 -- yksi täysi kierros
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()
Pyöriminen käyttää Linear-easingia, joten se pyörii tasaisella nopeudella, ja jokainen kierros alkaa taas 0:sta, joka on sama kulma kuin 360, joten nykäystä ei tule. Kolikoiden keräämisen opas rakentaa tällaiset esineet peliin.
Vaihe 4: koko mallin tweenaus
Modelilla ei ole Position- tai CFrame-ominaisuutta, joten TweenService:Create(model, ...) ei voi liikuttaa mitään. Tweenaa sen sijaan NumberValue 0:sta 1:een ja liikuta mallia PivotTo-kutsulla, joka siirtää kaikki sen sisällä olevat partit yhdessä:
-- Script Modelin sisällä, jonka nimi on Elevator.
-- Liikuttaa koko mallia 20 studia ylös ja takaisin, kaikki partit yhdessä.
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()
Ankkuroi mallin kaikki partit. Kakkonen TweenInfon lopussa on viive ennen jokaista toistokertaa, joten hissi pysähtyy ylhäällä ja alhaalla. Ovien opas avaa samalla tavalla useista parteista koostuvia ovia.
Palvelin vai asiakas?
Palvelimen Scriptissä käynnistetty tween muuttaa parttia palvelimella, ja uudet arvot replikoituvat kaikille pelaajille, joten kaikki näkevät sen. LocalScriptin tween muuttaa parttia vain kyseisen pelaajan näytöllä.
| Käynnistä | Milloin | Esimerkki |
|---|---|---|
| Palvelimen Scriptissä | Muutos on tärkeä pelille tai kaikille. | Ovet, liikkuvat esteet, avautuva silta |
| LocalScriptissä | Vain tämän pelaajan pitää nähdä se, tai se on puhtaasti visuaalinen efekti. | Esine, joka häipyy sen poimineelta pelaajalta, UI |
Replikointi lähettää päivityksiä monta kertaa sekunnissa, joten palvelimen tweenit näyttävät useimmille pelaajille pehmeiltä, mutta hyvin nopeat tai hyvin lukuisat palvelimen tweenit voivat näyttää vähemmän pehmeiltä hitaalla yhteydellä. Suurelle määrälle koristeellista liikettä (satoja pyöriviä kolikoita) käynnistä tweenit LocalScriptissä jokaisella asiakkaalla.
Yleiset virheet ja ratkaisut
Avaa Output-ikkuna (Window-valikko, sitten Output) ennen kuin painat Play.
Partti ei liiku lainkaan
Tarkista, että kutsuit tweenille :Play(), että ominaisuuden nimi tavoitteessa on kirjoitettu tarkasti (Position, ei position) ja että kyseessä on Script paikassa, jossa skriptit ajetaan (partin sisällä Workspacessa tai ServerScriptServicessä).
Partti putoaa tai tärisee tweenin aikana
Se ei ole ankkuroitu, joten painovoima ja törmäykset häiritsevät tweeniä. Rastita Anchored.
TweenService:Create property cannot be tweened due to type mismatch
Tavoitearvo on väärää tyyppiä, esimerkiksi luku Vector3-tyyppiselle ominaisuudelle. Katso virhesivu (englanniksi).
Unable to cast to Dictionary tai Unable to cast value to Object
Argumentit ovat väärässä järjestyksessä tai väärää tyyppiä. Järjestys on aina Create(instance, tweenInfo, goalTable). Katso Unable to cast value to Object (englanniksi).
Tee RoCodella
Jos et halua kirjoittaa tweenejä käsin, RoCode voi rakentaa ne paikkaan, joka on auki Studiossasi. RoCode on itsenäinen tekoälyagentti Roblox Studioon, ei Robloxin tekemä: kuvaat muutoksen verkkochatissa, ja sen Studio-lisäosa luo skriptit Exploreriisi, joten koodia ei tarvitse liittää.
Tee niin, että Workspacen siltamalli liukuu 15 studia sivuun, kun kierros alkaa, NumberValue-tweenillä ja PivotTo-kutsulla, ja häivytä samanaikaisesti punaiset este-partit 1 sekunnissa.
- Voi etsiä oikeat partit ja mallit Search Game -työkalulla ennen kuin kirjoittaa mitään
- Kirjoittaa Scriptin Create Script -työkalulla, ja sitä on ohjeistettu tarkistamaan käännös Check Script -työkalulla
- Asettaa kumouspisteen ennen jokaista muutoserää ja sen jälkeen, joten Ctrl+Z peruu yhden erän kerrallaan
Lisäosan versiolla 3.9 tai uudemmalla RoCode voi ajaa lyhyen pelitestin ja lukea virheet, mutta liikettä on helpointa arvioida omin silmin, joten paina Play ja katso. Miten RoCode yhdistyy Studioon.
Usein kysytyt kysymykset
Miten TweenServiceä käytetään Robloxissa?
Hae palvelu, luo TweenInfo, kutsu TweenService:Create(object, info, { Property = goal }) ja käynnistä tulos kutsulla :Play(). Ensimmäisessä osiossa on kolmen rivin esimerkki.
Miten tween saadaan toistumaan ikuisesti?
Anna TweenInfo.new-kutsulle neljänneksi arvoksi -1 (repeatCount) ja viidenneksi true, jos sen pitää kulkea edestakaisin.
Miten odotan tweenin päättymistä?
Kutsu tween.Completed:Wait() kutsun tween:Play() jälkeen tai yhdistä funktio tween.Completed-tapahtumaan.
Voiko Modelia tweenata?
Suoraan ei. Tweenaa NumberValue 0:sta 1:een ja kutsu jokaisella muutoksella model:PivotTo(start:Lerp(goal, value)), kuten vaiheessa 4.
Miten tween pysäytetään?
Kutsu tween:Cancel() pysäyttääksesi sen ja jättääksesi partin siihen, missä se on, tai tween:Pause(), jotta voit jatkaa myöhemmin kutsulla Play().
Lähteet ja lisälukemista
- Roblox Creator Docs: TweenService (englanniksi). Create, mitkä tyypit tweenautuvat ja peruminen
- Roblox Creator Docs: TweenInfo (englanniksi)
- Roblox Creator Docs: Tween (englanniksi). Play, Pause, Cancel ja Completed
- Roblox Creator Docs: UI animation and tweens (englanniksi). easing-tyylit ja -suunnat UI-esimerkillä
- Roblox Creator Docs: PVInstance:PivotTo (englanniksi)
Miten koodi tarkistettiin: jokainen tämän sivun skripti läpäisee Luaun tiukan tyyppitarkistuksen Roblox API:n määrittelyillä (luau-lsp, 20. marraskuuta 2026). Tyyppitarkistus löytää virheet API-nimissä ja väärät tyypit, mutta ei pelilogiikan virheitä, joten testaa kaikki Studiossa ennen julkaisua.