Inwerken voor ontwikkelaars

*Deze inhoud is vertaald met behulp van AI (bèta) en kan fouten bevatten. Klik hier om deze pagina in het Engels te bekijken.

Deze pagina behandelt de basisprincipes van Roblox die ingenieurs die van andere engines komen het vaakst nodig hebben in hun eerste weken. Elke sectie legt het kernidee uit en linkt naar de gedetailleerde gids.

Veelvoorkomende termen

  • Spel: Een verzameling plaatsen waar spelers zich aansluiten via de startplaats van het spel. Datastores, geheimen, analyses en in-game aankopen zijn allemaal beperkt tot het spel, dat je ook een ervaring of een universum kunt noemen.
  • Plaats: Een scène of zone binnen een spel, met zijn eigen datamodel. Elke server draait één plaats, en het verplaatsen van spelers tussen plaatsen vereist een teleport.
  • Instantie: Een knooppunt in het datamodel, met eigenschappen, methoden en gebeurtenissen. Parts en Models zijn de meest voorkomende instanties voor het bouwen van fysieke objecten.
  • Asset: Geüpload inhoud met een wereldwijd unieke asset-ID, zoals een afbeelding, mesh, geluid of animatie. Sommige assettypes, zoals modellen en animaties, kunnen ter plaatse worden bijgewerkt, terwijl andere, zoals afbeeldingen en geluiden, vereisen dat er een nieuwe asset wordt geüpload.
  • Script: Code die is opgeslagen als een instantie in het datamodel. Het kopiëren van een script maakt een volledige, onafhankelijke kop, geen verwijzing naar een bronbestand.

Voor meer informatie over hoe spellen en plaatsen zich verhouden, zie Spellen en plaatsen.

Structuur van het datamodel

Het datamodel is de boom van instanties die een plaats vormt. De top-level services hebben elk een specifiek doel en replicatiegedrag:

ServiceWat daar hoort
WorkspaceDe enige 3D-wereld van de plaats. Wanneer je het in Studio bewerkt, bewerk je het zicht van de server op de wereld, en een deel ervan wordt gerepliceerd naar elke client.
ReplicatedStorageModules, clientcode, effecten en andere instanties die zowel de client als de server altijd nodig hebben.
ReplicatedFirstInhoud die als eerste naar clients wordt gerepliceerd, meestal laadschermen.
ServerStorageServer-only instanties waar clients geen constante toegang toe nodig hebben, zoals kaarten die je in en uit de workspace wisselt.
ServerScriptServiceServer-only scripts en modules.
StarterGuiScreenGuis en andere UI die naar elke speler wordt gekopieerd.
StarterPlayerScripts en instellingen voor spelers en personages, hoewel grotere projecten meestal de code in ReplicatedStorage houden.
Het bewerken van het datamodel naast het runtime datamodel, dat laat zien hoe StarterGui, StarterPack, StarterCharacterScripts en StarterPlayerScripts naar elke speler en elk personage worden gekopieerd tijdens runtime.

De hiërarchie in de Explorer is voornamelijk organisatorisch:

  • Onderdelen gebruiken wereldruimte-transformaties, niet transformaties ten opzichte van hun ouder. Om onderdelen aan elkaar te bevestigen, gebruik je beperkingen, meestal een WeldConstraint. Voor details, zie Mechanische beperkingen.
  • Attachments zijn een uitzondering, omdat ze zich positioneren ten opzichte van hun ouderonderdeel.
  • Models gebruiken hun PrimaryPart als referentiepunt voor het verplaatsen en draaien van het hele model.

Scriptingmodel

In de meeste gevallen heb je slechts twee soorten scripts nodig:

  • Een Script met zijn RunContext ingesteld op Server of Client.
  • Een ModuleScript, dat een waarde retourneert die andere scripts laden met require(). Gebruik modules voor gedeelde bibliotheken, functies en gegevens.

Vermijd de Legacy runcontext en LocalScripts. Hun gedrag hangt af van waar ze zijn geplaatst, wat het organiseren van code moeilijker maakt. Voor aanbevolen locaties, zie Scripttypes en locaties.

Server scripts repliceren nooit naar clients. Modules repliceren naar clients wanneer ze in een container staan die clients kunnen openen, zoals ReplicatedStorage. Houd server-only modules in ServerScriptService of ServerStorage.

Netwerken en replicatie

Roblox gebruikt een client-servermodel:

  • Wijzigingen die de server aan instanties aanbrengt, inclusief eigenschappen, attributen en tags, repliceren automatisch naar clients.
  • Wijzigingen die een client aanbrengt, repliceren niet naar de server, met een paar uitzonderingen. De belangrijkste uitzonderingen zijn de fysica voor onderdelen die de client bezit, zoals zijn eigen personage, en invoer van het invoersysteem.
  • De engine verdeelt de fysicasimulatie tussen de server en clients. Clients simuleren de onderdelen die ze bezitten en sturen posities en snelheden naar de server.

Om te communiceren tussen de client en server, gebruik je remote events en callbacks:

  • RemoteEvent en RemoteFunction zijn betrouwbaar en geordend.
  • UnreliableRemoteEvent is onbetrouwbaar en ongeordend, voor frequente updates waarbij een verloren bericht niet uitmaakt.
  • Remotes zijn standaard niet beveiligd. Valideer altijd de gegevens die de server van clients ontvangt.
Een diagram van één client die communiceert met de server.

Serverautoriteit

Voor competitieve spellen maakt serverautoriteit de server autoritatief over fysica en gameplay, terwijl clients hun eigen personages en nabijgelegen fysica-objecten voorspellen. Wanneer een client verkeerd voorspelt, wordt deze teruggedraaid en opnieuw gesimuleerd.

Invoer

Behandel invoer met het invoersysteem. Je definieert acties, zoals springen of sprinten, in InputContext instanties en bindt ze aan toetsen, knoppen en aanraakbedieningen met InputBinding instanties. Wanneer je serverautoriteit gebruikt, moet elke InputContext een afstammeling zijn van een Player, zodat de engine weet welke speler het bezit. Een benadering is om je contexten in ReplicatedStorage te houden en ze naar elke speler te klonen vanuit een server script. Voor details, zie Invoeren acties.

Een InputContext-instantie genaamd PlayContext binnen ReplicatedStorage.

Streaming

Instantie streaming laadt delen van de workspace naar elke client terwijl spelers door de wereld bewegen, wat de laadtijden en het geheugen laag houdt op alle apparaten.

  • Instanties in ReplicatedStorage repliceren volledig wanneer een speler zich aansluit, voordat scripts worden uitgevoerd, zodat ze onmiddellijk veilig toegankelijk zijn.
  • Instanties in de workspace streamen in en uit. Clientcode moet omgaan met instanties die nog niet zijn geladen.
  • Instanties die door beperkingen zijn verbonden, streamen samen om de fysica stabiel te houden.

Elke Model heeft een ModelStreamingMode die controleert hoe het streamt:

ModusGedragGoed voor
DefaultOnderdelen streamen individueel, zodat een model gedeeltelijk kan worden geladen.Statische omgevingsstukken
AtomicHet hele model streamt in één keer wanneer een van zijn onderdelen nodig is.Personages, voertuigen en andere discrete, dynamische objecten
PersistentAltijd gestreamd, en nooit gestreamd uit.Lobbies, menu's en herkenningspunten die altijd zichtbaar moeten zijn
PersistentPerPlayerPersistent voor spelers die je toevoegt met Model:AddPersistentPlayer(), en atomair voor iedereen die niet is toegevoegd.Inhoud die slechts enkele spelers altijd nodig hebben

Assets zoals texturen, meshes en audio streamen ook tijdens runtime. Afbeeldingen worden eerst op een lage resolutie geladen en verbeteren vervolgens op basis van het apparaat en hoe groot ze op het scherm verschijnen.

Gegevenspersistentie

DataStoreService slaat spelergegevens op tussen sessies. De API's zijn laag niveau, dus lees Datastores en Spelergegevens en aankopen voordat je je opslagsysteem ontwerpt. Deze gidsen behandelen veelvoorkomende valkuilen zoals snelheidslimieten, sessievergrendeling en het veilig afhandelen van aankopen.

Datastores zijn beperkt tot het spel. Om testgegevens uit productie te houden, gebruik je een apart spel voor ontwikkeling. Voor details, zie Omgevingen.

Veelvoorkomende taken oplossen

Gedrag hergebruiken tussen instanties

Omdat gekopieerde scripts onafhankelijke kopieën zijn, vermijd het om een kopie van hetzelfde script in elke instantie te plaatsen die het nodig heeft. Tag in plaats daarvan instanties met CollectionService en schrijf één script, ondersteund door een ModuleScript, dat gedrag aan elke getagde instantie hecht.

Gebruik een aangepast personage

Personages kunnen het platformavatar, het platformrig met een aangepaste uitstraling, of een volledig aangepast rig gebruiken. Om het standaard spawn-systeem te behouden maar het personage te vervangen, plaats je een model genaamd StarterCharacter in StarterPlayer.

Overschrijf de standaard besturingsscripts

Roblox voegt standaard camera- en besturingsscripts toe aan elke speler. Om ze te vervangen:

  1. Schakel Workspace.PlayerScriptsUseInputActionSystem in, wat de standaard spelerscripts onder StarterPlayer verplaatst.
  2. Stel StarterPlayer.CreateDefaultPlayerModule in op false, zodat de standaard camera- en besturingsscripts niet worden toegevoegd.
  3. Voeg je eigen camera- en besturingsscripts toe.

Maak shader-achtige effecten

Roblox ondersteunt geen aangepaste shaders. Gebruik in plaats daarvan:

Prestaties

De prestaties op Roblox hangen voornamelijk af van de inhoud die je toevoegt en de tijd die je scripts elke frame nodig hebben. Test regelmatig op je doelhardware en stel vroeg budgetten in voor scènecomplexiteit (driehoeken, tekenopdrachten en dynamische lichten), fysica, replicatie en script tijd per frame. De meeste prestatieproblemen komen voort uit inhoud die verkeerd is geconfigureerd, en het laat oplossen ervan betekent vaak dat je assets opnieuw moet bewerken.

  • Automatische kwaliteit: De meeste spelers gebruiken automatische grafische kwaliteit, die 10 niveaus heeft. Naarmate het niveau daalt om de framerates hoog te houden, verlaagt de engine de renderafstand, geometrische kwaliteit zoals detailniveau en SLIM, schaduwkwaliteit, verlichtingkwaliteit, schaduwen, deeltjesemissie en streamingradius. De tekenafstand daalt nooit onder de 500 studs, schaduwen worden uitgeschakeld onder niveau 4, en terreinwater en stralen zien er op elk niveau hetzelfde uit. Roblox past deze waarden continu aan, dus ontwerp niet rond exacte cijfers. Om een voorbeeld te bekijken, wijzig je Editor Quality Level in de Studio-instellingen en test je op zowel de laagste als de hoogste niveaus. Voor details, zie Grafische kwaliteitsniveaus.
  • Textuurstreaming: Texturen streamen en schalen automatisch om aan geheugenbudgetten en schermgrootte te voldoen.
  • Occlusie-culling: De engine slaat automatisch tekenopdrachten over voor onderdelen, meshes en terrein die achter andere objecten verborgen zijn. Het structureren van niveaus met muren en andere zichtblokkades stelt je in staat om de scènecomplexiteit te beheren. Eenvoudige verborgen blokonderdelen binnen muren maken occlusietests goedkoper dan vertrouwen op gedetailleerde meshes. Voor meer manieren om tekenopdrachten te verminderen, zie Rendering.
  • Scripting: Luau is snel genoeg voor complexe, dynamische gameplaycode. Je hoeft geen garbage collection te vermijden of objecten te poolen, en het creëren van instanties tijdens runtime is snel.
  • Verlichting: Scènes kunnen veel lichten gebruiken. Roblox schaalt de verlichtingkwaliteit automatisch op basis van het apparaat en valt terug op een goedkopere verlichtingsroute in complexe scènes.

Voor tools om problemen te meten en op te lossen, zie Prestatieoptimalisatie.

Tools en AI

  • Externe editors: Gebruik VS Code of een andere editor met Script Sync of Rojo. Voeg de Luau Language Server en de selene linter toe voor typecontrole en linting. Voor teamopstellingen, zie Vergelijk bestand-gebaseerde workflows.
  • Studio MCP-server: De meeste professionele ontwikkelaars willen hun eigen AI-tools en agent-harnassen gebruiken, zoals een coderingsagent in een terminal of editor. De Studio MCP-server verbindt die tools met Studio, zodat ze direct in je open sessie kunnen bouwen en testen.
  • Assistent: Assistent is de ingebouwde AI-hulp van Studio voor het schrijven van code en bouwen, voor wanneer je AI-hulp wilt zonder je eigen tools op te zetten.
©2026 Roblox Corporation. Roblox, het Roblox-logo en Powering Imagination behoren tot onze geregistreerde en niet-geregistreerde handelsmerken in de VS en andere landen.