Tutoriaali · Skriptauksen perusteet

TweenService Robloxissa: liikutetaan, käännetään ja häivytetään partteja

Tween muuttaa ominaisuutta pehmeästi nykyisestä arvosta tavoitteeseen annetussa ajassa: tasanne liukuu, kristalli pyörii, seinä häipyy. TweenService laskee välivaiheet itse, joten sinun ei tarvitse kirjoittaa silmukkaa, joka siirtää parttia joka ruudunpäivityksellä. Tässä oppaassa: kolme riviä, joita jokainen tween tarvitsee, mitä kukin TweenInfo-asetus tekee, parttien liike, kierto ja häivytys, silmukat, tweenin lopun odottaminen ja keino tweenata koko malli (Model).

Päivitetty 20. marraskuuta 20264 min lukuaikaKirjoittaja:

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
  1. Miten se toimii
  2. 1. TweenInfo
  3. 2. Kierto ja häivytys
  4. 3. Silmukat
  5. 4. Mallit
  6. Palvelin vai asiakas
  7. Common errors
  8. RoCodella
  9. Usein kysytyt kysymykset
  10. Lähteet ja lisälukemista

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 kohteessa partissa Workspacessa nimeltä Rise
-- 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.

Mitä voi ja mitä ei voi tweenata
TyyppiTweenautuuko pehmeästi?Esimerkkejä
numberKylläTransparency, Reflectance, NumberValuen Value
Vector3, CFrameKylläPosition, Size, CFrame, Orientation
Color3KylläColor
UDim2, Vector2KylläGUI:n Size ja Position
boolean, EnumItemVaihtuu lopussaCanCollide, Material
string, InstanceEiAntaa 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.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
ArvoOletusMitä se tekee
time1Sekunnit yhteen toistokertaan.
easingStyleQuadLiikkeen muoto: Linear (tasainen nopeus), Sine, Quad, Cubic, Back (ylitys), Bounce, Elastic, Exponential.
easingDirectionOutOut alkaa nopeasti ja hidastuu; In alkaa hitaasti; InOut tekee molemmat.
repeatCount0Montako kertaa toistetaan ensimmäisen kerran jälkeen. -1 toistaa loputtomasti.
reversesfalsePalataanko alkuun jokaisen toistokerran jälkeen.
delayTime0Montako sekuntia odotetaan ennen alkua.
Script kohteessa partissa Workspacessa nimeltä Platform
-- 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 kohteessa partissa Workspacessa nimeltä FadingWall
-- 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 kohteessa partissa Workspacessa nimeltä FloatingGem
-- 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 kohteessa mallissa Workspacessa nimeltä Elevator
-- 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ä.

Missä tween käynnistetään
KäynnistäMilloinEsimerkki
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ää.

Sinä kirjoitat

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.

RoCode tekee
  • 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

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.

Kokeile RoCodea omassa pelissäsi.

Ilmaisia krediittejä joka päivä, ei korttia. Asenna lisäosa, kuvaile ominaisuus ja katso, mitä Studioon ilmestyi.