Lyhyesti
Kokoa ovi Partina tai Modelina, rastita Anchored, siirrä sen pivot saranoiden reunaan (Model-välilehti, Pivot) ja lisää tagi Door Properties-ikkunassa. Yksi Script ServerScriptServicessä löytää kaikki tagilla merkityt ovet CollectionService-palvelulla, lisää ProximityPromptin ("Open", E:n pito) ja tweenaa Triggered-tapahtumassa NumberValuen 0:sta 1:een liikuttaen ovea kutsulla door:PivotTo(closedPivot:Lerp(openPivot, alpha)). Jokaisen oven attribuutit määräävät saranan tai liu’un, kulman, ajan, automaattisen sulkeutumisen ja avaimen.
- Modelin sijaintia ei voi tweenata suoraan: Modelilla ei ole CFrame- tai Position-ominaisuutta, ja sen
WorldPivotmäärää vain pivotin paikan. Tweenaa NumberValue ja liikuta oveaPivotTo-kutsulla: Roblox kutsuu sitä päätavaksi liikuttaa malleja skriptistä. - Avaa ovet palvelimella. LocalScriptistä avattu ovi liikkuu vain kyseisen pelaajan näytöllä.
- Tarkista avain ja etäisyys palvelimella. Robloxin turvallisuusoppaassa sanotaan, että ProximityPromptia voi käyttää väärin samoin kuin RemoteEventiä, ja siellä on myös esimerkki tarkistuksesta, joka palvelimen on pakko tehdä: onko pelaajalla oven avaamiseen tarvittava avain.
Tällä sivulla
Miten skriptattu ovi toimii
Oikeassa pelissä toimivaa ovea täytyy liikuttaa palvelimen. Jos LocalScript liikuttaa sitä, ovi aukeaa yhden pelaajan näytöllä ja pysyy kiinni kaikille muille, koska asiakkaan tekemä muutos jää tälle laitteelle (katso mikä replikoituu ja mikä ei). Siksi tässä oppaassa pelaajan laite vain näyttää kehotteen ja ilmoittaa näppäimen painalluksesta, ja kaiken muun tekee yksi palvelimen Script. Yksi oven käyttö näyttää tältä:
- Pelaaja tulee alle 8 studin päähän ovesta, ja kehote ilmestyy toiminnolla Open, objektin nimellä Door ja näppäimistön E-näppäimellä. Peliohjaimella tai kosketusnäytöllä Roblox näyttää sopivan painikkeen.
- Pelaaja pitää E:tä 0.2 sekuntia. Kehotteen
Triggered-tapahtuma laukeaa palvelimella tämän pelaajan kanssa. - DoorService tarkistaa pelaajan: elossa, tarpeeksi lähellä, ei spämmää kehotetta ja kantaa avainta, jos ovi sitä vaatii.
- Skripti tweenaa luvun 0:sta (kiinni) 1:een (auki). Aina luvun muuttuessa se siirtää oven
PivotTo-kutsulla tämän osuuden matkasta suljetusta asennosta avoimeen. - Neljä sekuntia täyden avautumisen jälkeen ovi sulkeutuu samalla tavalla. Painallus liikkeen aikana kääntää oven takaisin siitä kohdasta, jossa se on.
| Osa | Missä se on | Mitä se tekee |
|---|---|---|
Script DoorService | ServerScriptService | Löytää kaikki ovet, lisää jokaiselle kehotteen, tarkistaa jokaisen käytön ja liikuttaa ovea. Tämän oppaan ainoa skripti. |
Tagi Door | Jokaisessa oven Partissa tai Modelissa | Merkitsee, mikä on ovi. Tagit lisätään Properties-ikkunassa ja tallentuvat paikan mukana. |
Attribuutit, kuten Style ja KeyName | Jokaisessa ovessa (valinnainen) | Yhden oven asetukset: saranoitu vai liukuva, kulma, nopeus, automaattinen sulkeutuminen ja avain. |
ProximityPrompt DoorPrompt | Oven sisällä (DoorService lisää sen) | Näyttää "Open" tai "Close" ja laukaisee Triggered-tapahtuman, kun pelaaja pitää E:tä. |
NumberValue DoorProgress | Oven sisällä (DoorService lisää sen) | Luku, jota tween liikuttaa 0:n ja 1:n välillä. Jokainen muutos liikuttaa ovea. |
Tool RedKey (valinnainen) | StarterPack, testejä varten | Avain lukittuun oveen. Mikä tahansa Tool käy, jos sen nimi vastaa oven KeyName-arvoa. |
Workspace
FrontDoor Part new
VaultDoor Model new
Panel Part new
Knob Part new
ServerScriptService
DoorService Script new
StarterPack
RedKey Tool new
Handle Part new
Vaihe 1: kokoa ovi ja määritä sarana
- Vie Explorerissa osoitin Workspacen päälle, paina +-painiketta ja lisää Part. Nimeä se
FrontDoor, asetaSizenoin4, 7, 0.5(4 studia leveä, 7 korkea, puoli studia paksu) ja sijoita se oviaukkoon. Usean partin ovikin käy: valitse ne ja paina Ctrl+G ryhmitelläksesi ne Modeliksi. - Rastita Anchored oven jokaisessa partissa ja jätä CanCollide päälle. Ankkuroidut partit eivät koskaan liiku painovoiman tai törmäysten vuoksi, mutta skripti voi silti liikuttaa niitä, ja juuri sitä DoorService tekee.
- Määritä sarana. Valitse ovi, avaa Model-välilehti ja ota Pivot käyttöön. Paina ja pidä pohjassa Pivot-painikkeen kulmassa olevaa pientä nuolta ja rastita Snap, jotta pivot tarttuu kulmien, reunojen ja keskipisteiden kiinnekohtiin. Vedä pivot oven siihen reunaan, jossa saranat olisivat. Liukuovessa pivot voi jäädä keskelle.
- Lisää tagi. Pidä ovi valittuna, vieritä Properties-ikkuna kohtaan Tags, paina + ja kirjoita
Doorisolla D:llä. Jos ovi on Model, laita tagi itse Modeliin, ei sen sisällä oleviin partteihin. - Kokoa toinen ovi, sitä tarvitaan liukuovia ja avainta käsittelevissä osioissa. Lisää Workspaceen vielä kaksi Partia:
Panel, kooltaan noin4, 7, 0.5, jaKnob, noin0.5, 0.5, 0.5, Panelin jonkin pinnan viereen. Valitse molemmat, paina Ctrl+G ja nimeä uusi Model uudelleenVaultDoor. Ankkuroi molemmat partit, sijoita malli toiseen aukkoon ja lisää Modeliin tagiDoor. Sen pivot voi jäädä keskelle, koska tästä ovesta tulee liukuovi.
Pivot on tärkeä, koska saranaovi kääntyy sen ympäri. Jos jätät sen keskelle, ovi pyörii paikallaan kuin kaupan pyöröovi. Partilla asettamasi pivot tallentuu PivotOffset-arvona, ja GetPivot huomioi sen, joten skripti kääntää oven täsmälleen valitsemasi pisteen ympäri. Jos Modelilla on PrimaryPart, mallin pivot on tämän partin pivot, ja DoorService laittaa kehotteenkin siihen. Ilman PrimaryPartia kehote menee ensimmäiseen mallin sisältä löytyvään partiin. Jos asetat PrimaryPartin, tee se ennen pivotin siirtämistä: PrimaryPartin asettaminen siirtää mallin pivotin tämän partin pivotiin, kuten Robloxin Pivot tools -sivulla mainitaan.
Oven asetukset (attribuutit)
Mikä tahansa ovi toimii alla olevan taulukon oletusarvoilla. Muuttaaksesi yhtä ovea valitse se, vieritä Properties-ikkuna kohtaan Attributes, paina +, kirjoita nimi, valitse tyyppi ja paina Save, ja aseta sitten arvo. DoorService lukee attribuutit kerran, kun se määrittää oven, joten muuta niitä pelin ollessa pysäytettynä.
| Attribuutti | Tyyppi | Oletus | Mitä se tekee |
|---|---|---|---|
Style | string | Swing | Swing kääntää ovea sen pivotin ympäri. Slide siirtää sitä sivulle leveyden suuntaisesti. |
OpenAngle | number | 90 | Montako astetta saranaovi kääntyy. Negatiivinen luku avaa sen toiseen suuntaan. Pidä arvo välillä -179 ja 179: ovi kulkee aina lyhyttä kaarta, joten DoorService rajaa kulman näihin rajoihin. |
SlideDistance | number | sen leveys | Montako studia liukuovi liikkuu leveytensä suuntaisesti. Negatiivinen luku siirtää sen toiseen suuntaan. |
OpenSeconds | number | 0.6 | Kuinka kauan täysi avautuminen tai sulkeutuminen kestää, välillä 0.05-10. |
AutoCloseSeconds | number | 4 | Kuinka kauan ovi on täysin auki ennen kuin sulkeutuu itsestään. 0 jättää sen auki, kunnes joku sulkee sen. |
KeyName | string | ei | Sen Toolin nimi, joka pelaajalla täytyy olla oven avaamiseksi, esimerkiksi RedKey. Älä aseta sitä ovelle, jonka kuka tahansa saa avata. |
Vaihe 2: lisää oviskripti
Vie osoitin ServerScriptServicen päälle, lisää Script nimeltä DoorService ja liitä siihen alla oleva koodi. Se hallitsee kaikkia paikan ovia, merkitsitpä niitä tagilla kuinka monta tahansa. Alun kolme asetusta koskevat kaikkia ovia; vaiheen 1 attribuutit muuttavat yhtä ovea.
-- Script ServerScriptServicessä nimeltä DoorService.
-- Avaa ja sulkee jokaisen "Door"-tagilla merkityn Partin tai Modelin E:n pidon kehotteella.
-- Ovea liikuttaa palvelin, joten kaikki pelaajat näkevät saman oven, ja palvelin myös
-- tarkistaa etäisyyden ja avaimen, joten kukaan ei avaa lukittua ovea kaukaa.
--
-- Valinnaiset attribuutit jokaisessa ovessa (asetetaan Properties-ikkunassa):
-- Style string "Swing" (oletus) tai "Slide"
-- OpenAngle number montako astetta saranaovi kääntyy pivotin ympäri (oletus 90, -179...179)
-- SlideDistance number montako studia liukuovi liikkuu leveytensä suuntaisesti (oletus: sen leveys)
-- OpenSeconds number kuinka kauan avautuminen kestää (oletus 0.6)
-- AutoCloseSeconds number sulje uudelleen näin monen sekunnin jälkeen; 0 jättää auki (oletus 4)
-- KeyName string sen Toolin nimi, joka pelaajalla täytyy olla, esimerkiksi "RedKey"
local CollectionService = game:GetService("CollectionService")
local TweenService = game:GetService("TweenService")
local DOOR_TAG = "Door"
local PROMPT_DISTANCE = 8 -- studeina
local MIN_SECONDS_BETWEEN_USES = 0.3 -- ovea kohden, kehotteen spämmäystä vastaan
local doorsSetUp: { [Instance]: boolean } = {}
local function attribute(door: Instance, name: string, default: any): any
local value = door:GetAttribute(name)
if value == nil or typeof(value) ~= typeof(default) then
return default
end
if typeof(value) == "number" and (value ~= value or math.abs(value) == math.huge) then
return default -- NaN tai ääretön, kirjoitettu Properties-ikkunaan
end
return value
end
local function hasKey(player: Player, keyName: string): boolean
local backpack = player:FindFirstChildOfClass("Backpack")
local character = player.Character
local inBackpack = backpack and backpack:FindFirstChild(keyName)
local held = character and character:FindFirstChild(keyName)
return (inBackpack ~= nil and inBackpack:IsA("Tool")) or (held ~= nil and held:IsA("Tool"))
end
local function setUpDoor(door: Instance)
if doorsSetUp[door] or not (door:IsA("BasePart") or door:IsA("Model")) then
return -- jo toimiva ovi, tai tämä ei ole part eikä malli
end
local promptPart = if door:IsA("Model") then (door.PrimaryPart or door:FindFirstChildWhichIsA("BasePart", true)) else door
if not (promptPart and promptPart:IsA("BasePart")) then
warn(`DoorService: {door:GetFullName()} has no part to put the prompt on`)
return
end
doorsSetUp[door] = true
door.Destroying:Connect(function()
doorsSetUp[door] = nil
end)
-- Toimivan oven kopio tuo mukanaan vanhan kehotteen ja arvon: poistetaan ne
for _, leftover in door:GetDescendants() do
if leftover.Name == "DoorPrompt" or leftover.Name == "DoorProgress" then
leftover:Destroy()
end
end
-- Suljettu ja avoin asento lasketaan kerran siitä, missä ovi nyt on
local closedPivot = door:GetPivot()
local openPivot: CFrame
if attribute(door, "Style", "Swing") == "Slide" then
-- Liu'utaan oven pidemmän vaakasivun eli leveyden suuntaisesti. Model mitataan
-- pivotinsa sivujen suuntaisesti, Part oman Sizensa mukaan, joten älä käännä liukupartin pivotia
local size = if door:IsA("Model") then door:GetExtentsSize() else (door :: BasePart).Size
local alongX = size.X >= size.Z
local width = if alongX then size.X else size.Z
local direction = if alongX then Vector3.xAxis else Vector3.zAxis
openPivot = closedPivot * CFrame.new(direction * attribute(door, "SlideDistance", width))
else
-- Lerp kääntää aina lyhyttä kaarta, joten suurempi kulma avaisi oven väärään suuntaan
local angle = math.clamp(attribute(door, "OpenAngle", 90), -179, 179)
openPivot = closedPivot * CFrame.Angles(0, math.rad(angle), 0)
end
local openSeconds = math.clamp(attribute(door, "OpenSeconds", 0.6), 0.05, 10)
local autoClose = math.max(attribute(door, "AutoCloseSeconds", 4), 0)
local keyName = attribute(door, "KeyName", "")
-- Tweenataan lukua 0:sta (kiinni) 1:een (auki) ja liikutetaan ovea sen mukana.
-- PivotTo liikuttaa yhtä partia tai koko mallia sen pivotin ympäri.
local progress = Instance.new("NumberValue")
progress.Name = "DoorProgress"
progress.Parent = door
progress.Changed:Connect(function(alpha: number)
door:PivotTo(closedPivot:Lerp(openPivot, alpha))
end)
local prompt = Instance.new("ProximityPrompt")
prompt.Name = "DoorPrompt"
prompt.ActionText = "Open"
prompt.ObjectText = if keyName ~= "" then `Needs {keyName}` else "Door"
prompt.HoldDuration = 0.2
prompt.MaxActivationDistance = PROMPT_DISTANCE
prompt.RequiresLineOfSight = false
prompt.Parent = promptPart
local isOpen = false
local lastUse = 0
local moveCount = 0
local function move(open: boolean)
isOpen = open
moveCount += 1
door:SetAttribute("Open", open) -- muut skriptit voivat lukea tämän
prompt.ActionText = if open then "Close" else "Open"
-- Uusi tween samalla arvolla peruu vanhan, joten ovi voi kääntyä takaisin puolivälissä.
-- Aika skaalataan sen mukaan, kuinka paljon sillä on vielä matkaa.
local target = if open then 1 else 0
local seconds = openSeconds * math.abs(target - progress.Value)
TweenService:Create(progress, TweenInfo.new(seconds, Enum.EasingStyle.Quad, Enum.EasingDirection.Out), { Value = target }):Play()
if open and autoClose > 0 then
local thisMove = moveCount
task.delay(openSeconds + autoClose, function()
if moveCount == thisMove and isOpen then
move(false)
end
end)
end
end
prompt.Triggered:Connect(function(player: Player)
local now = os.clock()
if now - lastUse < MIN_SECONDS_BETWEEN_USES then
return
end
-- Robloxin turvallisuusoppaan mukaan kehotteita voi käyttää väärin kuin remoteja, joten tarkistetaan tässä uudelleen
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
local rootPart = humanoid and humanoid.RootPart
if not (humanoid and rootPart) or humanoid.Health <= 0 then
return
end
if (rootPart.Position - promptPart.Position).Magnitude > PROMPT_DISTANCE + 6 then
return -- liian kaukana käyttääkseen kehotetta rehellisesti
end
if keyName ~= "" and not isOpen and not hasKey(player, keyName) then
return -- lukittu, eikä tällä pelaajalla ole avainta
end
lastUse = now
move(not isOpen)
end)
end
-- Kaikki nyt tagilla merkityt ovet ja kaikki myöhemmin tagin saavat (myös skriptien kloonaamat ovet)
for _, door in CollectionService:GetTagged(DOOR_TAG) do
setUpDoor(door)
end
CollectionService:GetInstanceAddedSignal(DOOR_TAG):Connect(setUpDoor)
DoorService lisää itse DoorPromptin ja DoorProgressin jokaiseen oveen pelin käynnistyessä, joten mitään ei tarvitse lisätä käsin. Pidä skriptistä yksi kopio: se palvelee jo kaikkia tagilla merkittyjä ovia.
| Skriptin osa | Mitä se tekee | Miksi |
|---|---|---|
attribute() | Lukee yhden attribuutin ja palauttaa oletusarvon, jos attribuuttia ei ole, se on väärää tyyppiä tai se ei ole oikea luku (NaN tai ääretön). | Kirjoitusvirhe Properties-ikkunassa antaa oven oletusasetuksilla eikä rikkinäistä ovea. |
doorsSetUp ja leftover-silmukka | Määrittää jokaisen oven kerran ja poistaa ensin toisesta ovesta kopioidut DoorPromptin tai DoorProgressin. | Muuten toimivan oven kopiolla olisi kaksi kehotetta, joista toinen ei toimi. |
closedPivot ja openPivot | Lasketaan kerran siitä, missä ovi on määrityshetkellä. Saranaovi kääntää pivotia sen oman pystyakselin ympäri; liukuovi siirtää sitä oven pidemmän sivun suuntaisesti. | Lerp suljetusta pivotista avoimeen pitää pivotin paikallaan oven kääntyessä, joten saranareuna ei siirry koko käännön aikana. |
DoorProgress ja PivotTo | Tween muuttaa lukua; jokainen muutos asettaa oven kohtaan closedPivot:Lerp(openPivot, alpha). | TweenService osaa tweenata NumberValuen, ja PivotTo liikuttaa partia tai mallia kaikkine partteineen niin, että pivot osuu tähän CFrameen. |
| Kehote | HoldDuration 0.2, MaxActivationDistance 8, RequiresLineOfSight pois päältä. Lukittu ovi näyttää "Needs RedKey". | Näköyhteyden ollessa päällä kehote piiloutuu, kun jokin peittää sen partin; ilman sitä karmi tai malliovien muut osat eivät piilota kehotetta. |
move() | Käynnistää tweenin kohti 1:tä tai 0:aa ja skaalaa ajan sen mukaan, kuinka paljon ovella on vielä matkaa. | Uusi tween samalla arvolla peruu vanhan, joten puolivälissä käännetty ovi kulkee pehmeästi takaisin ja käyttää siihen puolet ajasta. |
| Automaattinen sulkeutuminen | Odottaa avautumisajan plus AutoCloseSeconds ja sulkee oven vain, jos moveCount ei ole muuttunut. | Vanha ajastin ei koskaan paiskaa kiinni ovea, jonka joku on sillä välin sulkenut ja avannut uudelleen. |
Tarkistukset Triggeredissä | Yksi oven käyttö 0.3 sekunnin välein, elävä hahmo, enintään 14 studia kehotepartista ja avain, mutta vain avaamiseen. | Kaikkea, minkä asiakas voi laukaista, voi käyttää väärin, joten palvelin toistaa tarkistukset. 14 studia on kehotteen 8 studia plus 6 studia varaa pelaajalle, joka liikkui E:tä pitäessään. |
Open-attribuutti | Asetetaan oveen jokaisella liikkeellä. | Palvelimella asetetut attribuutit replikoituvat kaikille pelaajille, joten muut skriptit, myös LocalScriptit, voivat kuunnella sitä GetAttributeChangedSignal("Open")-kutsulla. |
Kaikkien ovien merkitseminen tagilla ja hallitseminen yhdestä skriptistä on Robloxin itse suosittelema tapa: CollectionServicen ohjeessa sanotaan, että jos lisäät saman skriptin moneen objektiin, CollectionServiceä käyttävä skripti voi olla parempi. GetTagged palauttaa ovet, jotka ovat olemassa skriptin käynnistyessä, ja GetInstanceAddedSignal nappaa myöhemmin merkityt tai lisätyt ovet. Tällainen paikan järjestämistapa käydään läpi asiakas- ja palvelinskriptien oppaassa.
Miten tehdään liukuovi
Valitse VaultDoor, lisää string-tyyppinen attribuutti nimeltä Style ja anna arvoksi Slide. Nyt ovi ei käänny vaan liukuu sivulle: oman leveytensä verran tai SlideDistance studia, jos asetit sen. Jotta se liukuu toiseen suuntaan, aseta negatiivinen matka, esimerkiksi -4 4 studia leveälle ovelle. Mistä tahansa muusta ovesta, myös FrontDoorista, tulee liukuovi samoin heti, kun se saa tämän attribuutin.
DoorService mittaa oven kaksi vaakamittaa, leveyden ja paksuuden, ja liikuttaa sitä suuremman suuntaisesti. Modelin se mittaa GetExtentsSize-kutsulla, jonka laatikko seuraa mallin pivotin suuntaa, joten ryhmittelyn jälkeen 90 astetta käännetty ovikin liukuu leveytensä eikä paksuutensa suuntaisesti. Partin se mittaa partin oman Sizen mukaan, joten älä käännä liukupartin pivotia. Sen siirtäminen on sallittua.
- Pariovet: kaksi tagilla merkittyä puolikasta vierekkäin, molemmissa
Styleon Slide, ja toisessa negatiivinenSlideDistance, jotta ne erkanevat keskeltä. Saranoituihin pariovikin aseta kunkin puolikkaan pivot sen ulkoreunaan ja anna toiselle puolikkaalle negatiivinenOpenAngle. Kummallakin puolikkaalla on oma kehotteensa, ja se aukeaa erikseen. Jos puolikkaat liukuvat toisiaan kohti, siirrä miinusmerkki toiseen puolikkaaseen. - Ylös nousevat portit: tämä skripti liikuttaa ovea vain leveyden suuntaisesti. Jotta ovet nousevat, aseta skriptin
directionarvoonVector3.yAxis(silloin kaikki liukuovet liikkuvat ylös) ja anna jokaiselleSlideDistance, joka on sen korkeus. - Fysiikkaovi: Robloxin liikkuvia objekteja käsittelevä tutoriaali liikuttaa partteja yhtä akselia pitkin PrismaticConstraintilla. Kuten saranaovi, se on fysiikkaa, ilman kehotetta ja lukkoa, kunnes kirjoitat ne itse.
Miten ovi lukitaan avaimella
Lukittu ovi aukeaa vain pelaajalle, jolla on oikean niminen Tool. Tee avain ja kerro sitten ovelle sen nimi:
- Vie osoitin StarterPackin päälle, paina + ja lisää Tool nimeltä
RedKey. Lisää siihen yksi Part nimeltäHandle, partti, jota hahmo pitää kädessään, ja varmista, ettei sitä ole ankkuroitu: ankkuroitu part työkalussa kahlitsee hahmon paikalleen. Poista ToolinCanBeDropped-rasti, jos pelaajat eivät saa pudottaa avainta jollekulle toiselle: sen ollessa päällä Backspace pudottaa varustetun työkalun Workspaceen. - Valitse VaultDoor, lisää string-tyyppinen attribuutti nimeltä
KeyNameja anna arvoksiRedKey. Nyt kehotteen objektinimessä lukee Needs RedKey.
DoorService etsii avainta kahdesta paikasta. Tool on pelaajan Backpackissa, kunnes se varustetaan, ja varustaminen siirtää sen hahmoon, joten ovi aukeaa, oli avain pikapalkissa tai kädessä. Tarkistus tehdään palvelimella, koska Robloxin turvallisuusopas mainitsee juuri tämän tapauksen, onko pelaajalla avain oveen, oikeutena, joka palvelimen on pakko tarkistaa. Avainta tarvitaan vain avaamiseen: kuka tahansa voi sulkea avoimen oven, ja se sulkeutuu itsestään AutoCloseSeconds-ajan jälkeen.
StarterPack antaa avaimen kaikille jokaisella syntymällä, ja testeihin se on juuri sopiva. Oikeassa pelissä anna se toisin:
- Kaupasta: kaupan GUI -opas antaa Toolin ServerStoragesta ostajan Backpackiin ja StarterGeariin.
- Hahmolta: NPC-dialogiopas antaa Toolin kansiosta
ServerStorage.DialogueItems, kun pelaaja valitsee vaihtoehdon, jossa on toimintoGiveItem. Laita kansioon Tool nimeltä RedKey ja anna DialogueDatassa vaihtoehdolleaction = "GiveItem"jaitem = "RedKey", niin avain annetaan keskustelussa. - Inventaarioesineenä: inventaariojärjestelmän kanssa avainesine toimii heti, kun pelaaja varustaa sen, koska varustaminen laittaa sen Toolin kopion Backpackiin ja käteen.
Backpackissa oleva avain katoaa, kun hahmo kuolee, koska Roblox täyttää Backpackin jokaisella syntymällä uudelleen StarterPackista ja StarterGearista. Säilyttääksesi sen laita kopio myös pelaajan StarterGeariin, kuten kaupan opas tekee. Jos avaimen pitää päinvastoin kulua, etsi avaimen Tool pelaajan Backpackista tai hahmosta ja tuhoa se Triggered-käsittelijässä heti onnistuneen avaintarkistuksen jälkeen.
Missä vanhat ovitutoriaalit menevät pieleen
Jos vertaat tätä opasta videoon tai foorumiviestiin, tässä ovat kikat, joista useimmat ”oveni ei toimi” -ketjut syntyvät, ja mitä tämä opas tekee niiden sijaan.
| Tutoriaali | Ongelma | Tämä opas |
|---|---|---|
Tweenaa Model-oven CFramea | Modelin ohjeessa ei ole CFrame- tai Position-ominaisuutta. Sen WorldPivot määrää vain mallin pivotin paikan, joten sen tweenaaminen liikuttaa pivot-pistettä, ja partit jäävät paikalleen. | Tweenaa NumberValuen ja liikuttaa koko mallia PivotTo-kutsulla. |
Liikuttaa mallia SetPrimaryPartCFrame-kutsulla | Vanhentunut: Roblox neuvoo käyttämään uusissa projekteissa PivotTo-kutsua. | Käyttää PivotTo-kutsua, jota Roblox kutsuu Modelien skriptistä liikuttamisen pääfunktioksi. |
| Hitsaa kaikki partit yhteen saranapartiin ja tweenaa vain saranan | Toimii, kun kaikki Weldit ovat paikallaan, mutta jokainen hitsaamaton part jää jälkeen saranan liikkuessa. | Pitää kaikki partit ankkuroituina, ilman Weldejä. PivotTo liikuttaa ovea ja kaikkea sen sisällä olevaa. |
| Kopioi saman skriptin jokaiseen oveen | Jokainen korjaus pitää toistaa jokaisessa kopiossa. Roblox ehdottaa objektien merkitsemistä tageilla ja käsittelemistä yhdellä skriptillä CollectionServicen kautta. | Yksi DoorService ja tagi Door. |
| Avaa oven LocalScriptissä | Ovi aukeaa vain kyseisen pelaajan näytöllä, ja kaikki muut näkevät sen yhä kiinni. | Ovea liikuttaa palvelin, joten kaikki pelaajat näkevät saman oven. |
Avaa oven Touchedilla | Touched laukeaa monta kertaa peräkkäin yhdestä kosketuksesta (Robloxin debounce-sivu), ja pelaajan laite voi ohjata, milloin Touched laukeaa sen omalle hahmolle (Robloxin turvallisuusdokumentaatio). | Kehote, jonka palvelin tarkistaa. |
Liikuttaa ovea askelittain wait()-silmukassa | Roblox merkitsee wait()-funktion korvatuksi task.wait()-funktiolla, eikä silmukka voi kääntyä takaisin puolivälissä, kun joku painaa uudelleen. | Yksi tween liikettä kohden. Uusi tween samalla arvolla peruu vanhan, joten ovi kääntyy takaisin siitä kohdasta, jossa se on. |
| Tarkistaa avaimen LocalScriptissä tai ei lainkaan | Huijari hallitsee kaikkea laitteellaan, joten asiakkaan tarkistus ei pysäytä ketään. | Palvelin etsii Toolin pelaajan Backpackista ja hahmosta. |
| Kehotteella ei ole latausaikaa | Robloxin turvallisuusoppaan mukaan kehotteet ovat alttiita väärinkäytölle samoin kuin remotet, joten mikään ei estä laukaisemasta sitä yhä uudelleen. | Yksi oven käyttö 0.3 sekunnin välein. |
Mitä huijari voi ja ei voi tehdä
Oleta, että huijari hallitsee kaikkea laitteellaan, myös hahmoaan. Tässä on, mitä se tarkoittaa näille oville.
| Huijari yrittää | Tulos | Miksi |
|---|---|---|
| Laukaista kehotteen kartan toiselta laidalta | Ohitetaan, jos hänen hahmonsa ei ole oven luona | DoorService mittaa etäisyyden hahmon juuripartista kehotepartiin ja ohittaa kaiken yli 14 studin. Huijari voi ensin teleportata hahmonsa oven luo (katso viimeinen rivi), joten etäisyystarkistus suojaa kaukokäytöltä, ei teleportilta. |
| Laukaista sitä monta kertaa sekunnissa | Enintään yksi oven käyttö 0.3 sekunnin välein | Palvelin säilyttää jokaisen oven viimeisimmän käytön ajan. |
| Avata avainoven ilman avainta | Hylätään | Palvelin etsii Toolin hänen Backpackistaan ja hahmostaan siellä, missä se itse ne näkee, eikä huijarin näytöltä. |
| Käyttää ovea hahmon ollessa kuollut | Ohitetaan | DoorService tarkistaa, että on Humanoid, jonka terveys on yli 0, ja juuripart. |
| Kulkea silti suljetun oven läpi | Mahdollista | Robloxin turvallisuusdokumentaatio luettelee fyysisten esteiden ohittamisen ja omien törmäysten muuttamisen niiden asioiden joukossa, joita asiakas voi tehdä hahmollaan. |
| Teleportata oven taakse | Mahdollista | Sama dokumentaatio mainitsee oman hahmon teleporttaamisen mihin tahansa kohtaan. |
Vaihe 3: testaa
- Paina Play (F5). Kävele FrontDoorin luo: 8 studin päässä ilmestyy kehote toiminnolla Open ja objektinimellä Door. Pidä E:tä. 0.2 sekunnin jälkeen ovi kääntyy 90 astetta saranareunan ympäri 0.6 sekunnissa, ja kehotteessa lukee nyt Close.
- Kulje ovesta ja odota. Neljä sekuntia täyden avautumisen jälkeen ovi sulkeutuu itsestään. Pidä E:tä sen sulkeutuessa: se kääntyy ja aukeaa siitä kohdasta, jossa se oli.
- Testaa lukko. Jos RedKey on StarterPackissa, siirrä se toistaiseksi ServerStorageen, paina Play ja pidä E:tä VaultDoorin luona: kehotteessa lukee Needs RedKey, eikä mikään liiku. Pysäytä peli, palauta RedKey StarterPackiin ja käynnistä uudelleen: VaultDoor aukeaa, oli avain pikapalkissa tai kädessä.
- Testaa liukuovi. VaultDoor, Model, jonka
Styleon Slide, liukuu avautuessaan sivulle leveytensä verran. Pysäytä peli, valitse VaultDoor, käännä sitä 90 astetta Rotate-työkalulla ja käynnistä uudelleen: sen pitäisi edelleen liukua leveytensä eikä paksuutensa suuntaisesti. Kun olet valmis, käännä se takaisin. - Valitse testitilojen pudotusvalikosta Server & Clients, aseta 2 asiakasta ja paina Play. Avaa ovi yhden asiakkaan ikkunassa: se on auki myös toisessa ikkunassa ja sulkeutuu molemmissa.
- Pysäytä peli, valitse ovi ja paina Ctrl+D tehdäksesi kaksoiskappaleen, ja siirrä kopio toiseen aukkoon. Tarkista, että kopion Tagsissa on yhä Door, ja paina Play: kopio toimii ilman lisäskriptiä.
Pidä Output-ikkuna auki (Window-valikko, sitten Output). Kun kaikki toimii, DoorService ei tulosta mitään. Varoitus siitä, että ovella "has no part to put the prompt on", tarkoittaa, ettei tagilla merkityn Modelin sisällä ole partteja. Muut tapaukset löydät osiosta Yleiset virheet.
Miten laajennetaan
Automaattiovet
Jotta ovi aukeaa, kun joku lähestyy, kutsu move(true) setUpDoorin sisältä odottamatta kehotetta. Käynnistä setUpDoorin lopussa silmukka task.spawn-kutsulla, koska tavallinen silmukka ei siellä koskaan päättyisi, eikä DoorService etenisi ensimmäistä ovea pidemmälle. Anna sen toimia vain niin kauan kuin ovi on pelissä: task.spawn(function() while door.Parent do ... task.wait(0.5) end end). Tarkista silmukan sisällä workspace:GetPartBoundsInBox-kutsulla, onko hahmo oviaukon ympärillä olevan laatikon sisällä, ja kutsu move(true), kun hän on siellä ja ovi on kiinni. Sen jälkeen automaattinen sulkeutuminen sulkee sen kuten ennenkin. Aseta kehotteen Enabled arvoon false, jos oven pitää aueta vain itsestään.
VIP-ovet
Pelipassiopas kokoaa jo VIP-oven, jonka läpi passin omistajat kulkevat suoraan, törmäysryhmillä. VIP-ovea varten, joka aukeaa E:llä, lisää Triggered-käsittelijään vielä yksi tarkistus avaintarkistuksen viereen: tee return, jos player:GetAttribute("OwnsPass_VIP") == true ei täyty, mikä on pelipassioppaan palvelinskriptin asettama attribuutti. Lue se vain palvelimella.
Koodipaneeli
Ovelle, joka aukeaa syötetyllä koodilla, säilytä koodi palvelimen Scriptissä tai ServerStoragessa, joita pelaajat eivät koskaan saa, äläkä missään tapauksessa LocalScriptissä, josta huijari voi lukea sen. Paneelin LocalScript lähettää RemoteEventillä vain syötetyt numerot. Tarkista palvelimella, että pelaaja on oven lähellä, rajoita yritysten tiheyttä, vertaa numeroita ja kutsu vasta sitten move(true). RemoteEvent-opas näyttää, miten remoten vastaanottama tieto tarkistetaan.
Äänet
Laita Sound oven partin sisään, jotta se soi tämän partin sijainnista, ja kutsu sen Play-metodia moven alussa. Tai toista se LocalScriptistä, joka kuuntelee oven Open-attribuuttia GetAttributeChangedSignal("Open")-kutsulla, sillä palvelin asettaa tämän attribuutin jokaisella liikkeellä.
Pelin aikana lisätyt ovet
Kloonaa uudet ovet suljetusta mallista ServerStoragessa. DoorService lukee oven suljetun asennon sen ilmestymishetkellä, joten kopio ovesta, joka oli sillä hetkellä auki, pitäisi avointa asentoaan suljettuna. Sijoita kopio aukkoon PivotTo-kutsulla ennen kuin asetat sen Parentiksi Workspacen, jotta DoorService muistaa tämän paikan suljettuna. Kopion mukana tulleet vanhat kehotteet ja arvot poistetaan automaattisesti. Ovesta, joka vie pelaajat toiselle alueelle tai toiseen paikkaan, lue teleporttioppaasta.
Yleiset virheet ja ratkaisut
Avaa Output-ikkuna (Window-valikko, sitten Output) ennen kuin painat Play. Useimmat oviongelmat johtuvat tagista, pivotista tai attribuutista, joka on hieman erilainen kuin skripti odottaa.
Ovelle ei ilmesty kehotetta
Tarkista järjestyksessä: DoorService on Script eikä LocalScript ja on suoraan ServerScriptServicessä; ovella on tagi Door isolla D:llä, malliovella itse Modelissa; ovi on part (Part, MeshPart tai muu BasePart) tai Model; ja seisot enintään 8 studin päässä partista, jossa kehote on. Outputin varoitus siitä, että ovella "has no part to put the prompt on", tarkoittaa, ettei tagilla merkityn Modelin sisällä ole partteja.
Ovi putoaa, ajelehtii tai sitä työnnetään pelin käynnistyessä
Jokin sen parteista ei ole ankkuroitu. Valitse oven kaikki partit ja rastita Anchored. Ankkuroidut partit eivät koskaan liiku fysiikan vuoksi, mutta DoorService voi silti liikuttaa niitä.
Muutin attribuuttia, mutta ovi ei välitä siitä
Tarkista kolme asiaa. Tyyppi: OpenAngle, SlideDistance, OpenSeconds ja AutoCloseSeconds on oltava number-tyyppisiä attribuutteja ja Style ja KeyName string-tyyppisiä; väärällä tyypillä DoorService käyttää oletusarvoa. Kirjoitusasu: nimiä verrataan tarkasti, joten openAngle on eri attribuutti. Arvojakin verrataan tarkasti: Style-arvon täytyy olla Slide isolla S:llä ja ilman välilyöntejä. Ajankohta: DoorService lukee attribuutit kerran, kun se määrittää oven, joten muutos pelitestin aikana ei vaikuta, ennen kuin käynnistät pelin uudelleen.
Ovi kääntyy väärään suuntaan tai kaatuu kyljelleen
Jotta se aukeaa toiseen suuntaan, tee OpenAngle-arvosta negatiivinen, esimerkiksi -90. Jos se kääntyy vaaka-akselin ympäri eikä pystysaranan ympäri, itse pivot on käännetty: ota Pivot käyttöön Model-välilehdellä ja käännä pivot takaisin pystyyn.
Liukuovi menee seinän sisään tai liikkuu vain vähän
Anna sille negatiivinen SlideDistance, jotta se liukuu toiseen suuntaan. Jos se liikkuu liian vähän tai liian pitkälle, aseta SlideDistance-arvoksi haluamasi studimäärä äläkä luota mitattuun leveyteen.
Minulla on avain, mutta ovi ei aukea
Avaimen täytyy olla Tool eikä Part tai Model, ja sen nimen täytyy vastata KeyName-arvoa tarkasti, isot kirjaimet mukaan lukien. Sen täytyy olla Backpackissasi tai kädessä. Tarkista myös, että oven KeyName on string-tyyppinen attribuutti.
Tee se RoCodella
Jos et halua määrittää tätä kaikkea käsin, RoCode voi koota sen paikkaan, joka sinulla on auki. RoCode on itsenäinen tekoälyagentti Roblox Studioon, ei Robloxin tekemä: kuvailet muutoksen verkkochatissa, ja sen Studio-lisäosa luo skriptit ja objektit Exploreriisi, joten koodia ei tarvitse liittää.
Tee niin, että Door-tagilla merkityt ovet aukeavat E:n pidon kehotteella: käännös 90 astetta pivotin ympäri 0.6 sekunnissa, sulkeutuminen 4 sekunnin jälkeen, liuku käännön sijaan, kun Style-attribuutti on Slide, ja ovi pysyy kiinni, jos pelaajalla ei ole KeyNamen nimistä Toolia. Kaikki palvelimella, etäisyystarkistuksella.
- Voi käydä paikkasi läpi, kun vaihe sitä tarvitsee, Search Gamella ja Search Scriptsillä nojatakseen jo olemassa oleviin esineisiin, remoteihin tai tallennuskoodiin eikä lisätäkseen toista järjestelmää
- Kirjoittaa Scriptin ServerScriptServiceen Create Scriptillä, voi luoda oven partin Create Instancella ja asettaa siihen attribuutteja, kuten Style ja KeyName
- Sitä on ohjeistettu tarkistamaan jokaisen kirjoitetun skriptin kääntyminen Check Scriptillä, joka kääntää sen Studiossa ajamatta
- Asettaa kumouspisteen ennen jokaista muutoserää ja sen jälkeen, joten Ctrl+Z peruu yhden erän kerrallaan
Tarkista ennen testiä jokaisen oven pivot Studion Pivot-työkalulla: ovi kääntyy sen ympäri. Lisäosalla 3.9 tai uudemmalla RoCode voi ajaa lyhyen pelitestin ja lukea virheet, ja lisäosalla 3.9.15 tai uudemmalla se voi ohjata testihahmoa, joka kävelee ja painaa näppäimiä, mutta se tarkistaa vain sen, minkä se itse päätti testata, joten kävele jokaisen oven luo ja pidä E:tä itse. Miten RoCode yhdistyy Studioon.
Usein kysytyt kysymykset
Miten ovi saadaan aukeamaan E:llä Roblox Studiossa?
Laita oveen ProximityPrompt ja kytke sen Triggered-tapahtuma palvelimen Scriptiin, joka liikuttaa ovea. DoorService tekee molemmat jokaiselle Door-tagilla merkitylle ovelle. E on kehotteen oletusnäppäin, ja Roblox näyttää oikean syötteen näppäimistöille, peliohjaimille ja kosketusnäytöille.
Miksi oveni pyörii keskikohtansa ympäri?
Sen pivot on yhä keskellä. Ota Pivot käyttöön Model-välilehdellä ja vedä pivot saranareunaan; skripti kääntää ovea pivotin ympäri.
Miten tehdään liukuovi?
Anna oven Style-attribuutille arvo Slide. Se liukuu sivulle leveytensä verran tai SlideDistance studia; negatiivinen matka siirtää sen toiseen suuntaan.
Voiko oven tehdä ilman skriptejä?
Kyllä. Robloxin saranaovitutoriaali kiinnittää ankkuroimattoman oven karmiin HingeConstraintilla rajoituksin, ja pelaajat avaavat sen työntämällä keholla. Tällaisessa ovessa ei ole kehotetta, lukkoa eikä automaattista sulkeutumista.
Miten tehdään ovi, jonka vain VIP:t voivat avata?
Ota pelipassioppaan VIP-ovi, jonka läpi passin omistajat kulkevat, tai lisää DoorServicen Triggered-käsittelijään tarkistus, joka lukee palvelimella ennen avaamista, omistaako pelaaja passin, esimerkiksi tuon oppaan asettaman OwnsPass_VIP-attribuutin.
Miksi ovi aukeaa minulle mutta ei muille pelaajille?
Sen avaa LocalScript, ja LocalScriptin tekemä muutos jää kyseisen pelaajan laitteelle. Siirrä avauskoodi palvelimen Scriptiin, kuten DoorServicessä, jotta muutos menee kaikille.
Lähteet ja lisälukemista
- Roblox Creator Docs: PVInstance:PivotTo (englanniksi). partin tai koko mallin siirtäminen sen pivotista
- Roblox Creator Docs: Pivot tools (englanniksi). pivotin siirto, Snap ja kiinnekohdat, pivot PrimaryPartin kanssa
- Roblox Creator Docs: Model (englanniksi). WorldPivot, GetExtentsSize seuraa pivotia, SetPrimaryPartCFrame on vanhentunut
- Roblox Creator Docs: CFrame:Lerp (englanniksi). kierto interpoloidaan lyhintä kaarta
- Roblox Creator Docs: TweenService (englanniksi). mitä voi tweenata ja miten toinen tween samassa ominaisuudessa peruu ensimmäisen
- Roblox Creator Docs: Proximity prompts (englanniksi). kehotteiden luonti ja asetukset, syöte millä tahansa laitteella ja näköyhteys
- Roblox Creator Docs: ProximityPrompt (englanniksi). oletusnäppäin ja -painike, HoldDuration, MaxActivationDistance ja Triggered
- Roblox Creator Docs: CollectionService (englanniksi). tagit, GetTagged ja GetInstanceAddedSignal
- Roblox Creator Docs: Properties window (englanniksi). tagien ja attribuuttien lisääminen Studiossa
- Roblox Creator Docs: Securing the client-server boundary (englanniksi). ProximityPrompt hyökkäyspintana ja ”avain ja ovi” -oikeuden tarkistus
- Roblox Creator Docs: Network ownership, movement validation, and physics (englanniksi). mitä asiakas voi tehdä hahmollaan
- Roblox Creator Docs: Build a hinged door (englanniksi). HingeConstraint-ovi ilman koodia
- Roblox Creator Docs: In-game tools (englanniksi). Handle, ankkurointi ja StarterPack
- Roblox Creator Docs: Tool.CanBeDropped (englanniksi). mitä Backspace tekee varustetulle työkalulle
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.