Intégration pour les développeurs

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Cette page couvre les fondamentaux de Roblox que les ingénieurs venant d'autres moteurs ont le plus souvent besoin de connaître dans leurs premières semaines. Chaque section explique l'idée principale et renvoie au guide détaillé.

Termes courants

  • Jeu : Une collection de lieux que les joueurs rejoignent via le lieu de départ du jeu. Les magasins de données, secrets, analyses et achats en jeu sont tous liés au jeu, que vous pourriez également voir appelé une expérience ou un univers.
  • Lieu : Une scène ou une zone au sein d'un jeu, avec son propre modèle de données. Chaque serveur exécute un lieu, et déplacer des joueurs entre des lieux nécessite un téléport.
  • Instance : Un nœud dans le modèle de données, avec des propriétés, méthodes et événements. Parts et Models sont les instances les plus courantes pour construire des objets physiques.
  • Actif : Contenu téléchargé avec un ID d'actif unique au niveau mondial, tel qu'une image, un maillage, un son ou une animation. Certains types d'actifs, comme les modèles et les animations, peuvent être mis à jour sur place, tandis que d'autres, comme les images et les sons, nécessitent le téléchargement d'un nouvel actif.
  • Script : Code stocké en tant qu'instance dans le modèle de données. Copier un script crée une copie complète et indépendante, pas une référence à un fichier source.

Pour en savoir plus sur la relation entre les jeux et les lieux, consultez Jeux et lieux.

Structure du modèle de données

Le modèle de données est l'arbre d'instances qui compose un lieu. Ses services de niveau supérieur ont chacun un but spécifique et un comportement de réplication :

ServiceCe qui y appartient
WorkspaceLe monde 3D unique du lieu. Lorsque vous l'éditez dans Studio, vous éditez la vue du serveur sur le monde, et une partie de celui-ci se réplique à chaque client.
ReplicatedStorageModules, code client, effets et autres instances dont le client et le serveur ont besoin en permanence.
ReplicatedFirstContenu qui se réplique aux clients avant tout autre, généralement des écrans de chargement.
ServerStorageInstances réservées au serveur auxquelles les clients n'ont pas besoin d'accès constant, comme des cartes que vous échangez dans l'espace de travail.
ServerScriptServiceScripts et modules réservés au serveur.
StarterGuiScreenGuis et autres UI qui se copient à chaque joueur.
StarterPlayerScripts et paramètres pour les joueurs et les personnages, bien que les projets plus importants conservent généralement le code dans ReplicatedStorage à la place.
Le modèle de données d'édition à côté du modèle de données d'exécution, montrant comment StarterGui, StarterPack, StarterCharacterScripts et StarterPlayerScripts se copient dans chaque joueur et personnage à l'exécution.

La hiérarchie dans l'Explorateur est principalement organisationnelle :

  • Les pièces utilisent des transformations dans l'espace du monde, pas des transformations relatives à leur parent. Pour attacher des pièces les unes aux autres, utilisez des contraintes, le plus souvent une WeldConstraint. Pour plus de détails, voir Contraintes mécaniques.
  • Attachments sont une exception, car elles se positionnent par rapport à leur pièce parente.
  • Models utilisent leur PrimaryPart comme point de référence pour déplacer et pivoter l'ensemble du modèle.

Modèle de scripting

Dans la plupart des cas, vous n'avez besoin que de deux types de scripts :

  • Un Script avec son RunContext défini sur Server ou Client.
  • Un ModuleScript, qui renvoie une valeur que d'autres scripts chargent avec require(). Utilisez des modules pour des bibliothèques partagées, des fonctions et des données.

Évitez le contexte d'exécution Legacy et LocalScripts. Leur comportement dépend de l'endroit où ils sont placés, ce qui rend le code plus difficile à organiser. Pour les emplacements recommandés, voir Types de scripts et emplacements.

Les scripts serveur ne se répliquent jamais aux clients. Les modules se répliquent aux clients lorsqu'ils se trouvent dans un conteneur auquel les clients peuvent accéder, comme ReplicatedStorage. Gardez les modules réservés au serveur dans ServerScriptService ou ServerStorage.

Réseautage et réplication

Roblox utilise un modèle client-serveur :

  • Les modifications que le serveur apporte aux instances, y compris les propriétés, attributs et balises, se répliquent automatiquement aux clients.
  • Les modifications qu'un client effectue ne se répliquent pas au serveur, avec quelques exceptions. Les principales exceptions sont la physique pour les pièces que le client possède, comme son propre personnage, et les entrées du système d'action d'entrée.
  • Le moteur distribue la simulation physique entre le serveur et les clients. Les clients simulent les pièces qu'ils possèdent et envoient les positions et vitesses au serveur.

Pour communiquer entre le client et le serveur, utilisez événements distants et rappels :

  • RemoteEvent et RemoteFunction sont fiables et ordonnés.
  • UnreliableRemoteEvent est peu fiable et non ordonné, pour des mises à jour fréquentes où un message perdu n'a pas d'importance.
  • Les distants ne sont pas sécurisés par défaut. Validez toujours les données que le serveur reçoit des clients.
Un diagramme d'un client communiquant avec le serveur.

Autorité du serveur

Pour les jeux compétitifs, l'autorité du serveur rend le serveur autoritaire sur la physique et le gameplay, tandis que les clients prédisent leurs propres personnages et objets physiques à proximité. Lorsqu'un client prédit mal, il revient en arrière et resimule.

Entrée

Gérez l'entrée avec le système d'action d'entrée. Vous définissez des actions, comme sauter ou sprinter, dans des instances InputContext et les liez à des touches, boutons et contrôles tactiles avec des instances InputBinding. Lorsque vous utilisez l'autorité du serveur, chaque InputContext doit être un descendant d'un Player afin que le moteur sache quel joueur le possède. Une approche consiste à garder vos contextes dans ReplicatedStorage et à les cloner pour chaque joueur à partir d'un script serveur. Pour plus de détails, voir Actions d'entrée.

Une instance InputContext nommée PlayContext à l'intérieur de ReplicatedStorage.

Streaming

Le streaming d'instances charge des parties de l'espace de travail sur chaque client à mesure que les joueurs se déplacent dans le monde, ce qui maintient les temps de chargement et la mémoire bas sur tous les appareils.

  • Les instances dans ReplicatedStorage se répliquent entièrement lorsqu'un joueur rejoint, avant que les scripts ne s'exécutent, donc elles sont sûres à accéder immédiatement.
  • Les instances dans l'espace de travail se streament et se déstreament. Le code client doit gérer les instances qui ne sont pas encore chargées.
  • Les instances connectées par des contraintes se streament ensemble pour maintenir la stabilité de la physique.

Chaque Model a un ModelStreamingMode qui contrôle comment il se stream :

ModeComportementBon pour
DefaultLes pièces se streament individuellement, donc un modèle peut être partiellement chargé.Pièces d'environnement statiques
AtomicLe modèle entier se stream en une fois lorsque l'une de ses pièces est nécessaire.Personnages, véhicules et autres objets discrets et dynamiques
PersistentToujours streamé, et jamais déstreamé.Lobbies, menus et points de repère qui doivent toujours être visibles
PersistentPerPlayerPersistant pour les joueurs que vous ajoutez avec Model:AddPersistentPlayer(), et atomique pour tous les autres.Contenu dont seuls certains joueurs ont besoin en permanence

Les actifs comme les textures, maillages et audio se streament également à l'exécution. Les images se chargent d'abord à basse résolution puis s'améliorent en fonction de l'appareil et de leur taille à l'écran.

Persistance des données

DataStoreService sauvegarde les données des joueurs entre les sessions. Ses API sont de bas niveau, donc lisez Magasins de données et Données des joueurs et achats avant de concevoir votre système de sauvegarde. Ces guides couvrent les pièges courants comme les limites de taux, le verrouillage de session et la gestion des achats en toute sécurité.

Les magasins de données sont liés au jeu. Pour garder les données de test hors de la production, utilisez un jeu séparé pour le développement. Pour plus de détails, voir Environnements.

Résoudre des tâches courantes

Réutiliser le comportement à travers les instances

Parce que les scripts copiés sont des copies indépendantes, évitez de mettre une copie du même script dans chaque instance qui en a besoin. Au lieu de cela, taguez les instances avec CollectionService et écrivez un script, soutenu par un ModuleScript, qui attache le comportement à chaque instance taguée.

Utiliser un personnage personnalisé

Les personnages peuvent utiliser l'avatar de la plateforme, le rig de la plateforme avec un look personnalisé, ou un rig entièrement personnalisé. Pour garder le système de spawn par défaut mais remplacer le personnage, placez un modèle nommé StarterCharacter dans StarterPlayer.

Remplacer les scripts de contrôle par défaut

Roblox ajoute des scripts de caméra et de contrôle par défaut à chaque joueur. Pour les remplacer :

  1. Activez Workspace.PlayerScriptsUseInputActionSystem, ce qui déplace les scripts de joueur par défaut sous StarterPlayer.
  2. Définissez StarterPlayer.CreateDefaultPlayerModule sur false afin que les scripts de caméra et de contrôle par défaut ne soient pas ajoutés.
  3. Ajoutez vos propres scripts de caméra et de contrôle.

Créer des effets similaires à des shaders

Roblox ne prend pas en charge les shaders personnalisés. Au lieu de cela :

Performance

La performance sur Roblox dépend principalement du contenu que vous ajoutez et du temps que vos scripts prennent à chaque image. Testez régulièrement sur votre matériel cible, et fixez des budgets tôt pour la complexité de la scène (triangles, appels de dessin et lumières dynamiques), la physique, la réplication et le temps de script par image. La plupart des problèmes de performance proviennent de contenu mal configuré, et les corriger tard signifie souvent retravailler des actifs.

  • Qualité automatique : La plupart des joueurs utilisent la qualité graphique automatique, qui a 10 niveaux. À mesure que le niveau diminue pour maintenir des taux de trame élevés, le moteur réduit la distance de rendu, la qualité de la géométrie telle que le niveau de détail et SLIM, la qualité d'ombrage, la qualité d'éclairage, les ombres, l'émission de particules et le rayon de streaming. La distance de dessin ne descend jamais en dessous de 500 studs, les ombres s'éteignent en dessous du niveau 4, et l'eau de terrain et les faisceaux ont le même aspect à chaque niveau. Roblox ajuste continuellement ces valeurs, donc ne concevez pas autour de chiffres exacts. Pour prévisualiser, changez le Niveau de qualité de l'éditeur dans les paramètres de Studio, et testez aux niveaux les plus bas et les plus élevés. Pour plus de détails, voir Niveaux de qualité graphique.
  • Streaming de textures : Les textures se streament et se mettent à l'échelle automatiquement pour s'adapter aux budgets mémoire et à la taille à l'écran.
  • Occlusion culling : Le moteur saute automatiquement les appels de dessin pour les pièces, maillages et terrains cachés derrière d'autres objets. Structurer les niveaux avec des murs et d'autres bloqueurs de vue vous permet de gérer la complexité de la scène. Des pièces cachées simples à l'intérieur des murs rendent les tests d'occlusion moins coûteux que de s'appuyer sur des maillages détaillés. Pour plus de moyens de réduire les appels de dessin, voir Rendu.
  • Scripting : Luau est suffisamment rapide pour un code de gameplay complexe et dynamique. Vous n'avez pas besoin d'éviter la collecte des ordures ou de regrouper des objets, et créer des instances à l'exécution est rapide.
  • Éclairage : Les scènes peuvent utiliser de nombreuses lumières. Roblox ajuste automatiquement la qualité de l'éclairage en fonction de l'appareil et revient à un chemin d'éclairage moins coûteux dans des scènes complexes.

Pour des outils pour mesurer et résoudre des problèmes, voir Optimisation des performances.

Outils et IA

  • Éditeurs externes : Utilisez VS Code ou un autre éditeur avec Script Sync ou Rojo. Ajoutez le serveur de langage Luau et le linter selene pour la vérification de type et le linting. Pour les configurations d'équipe, voir Comparer les flux de travail basés sur des fichiers.
  • Serveur MCP Studio : La plupart des développeurs professionnels voudront utiliser leurs propres outils d'IA et harnais d'agent, comme un agent de codage dans un terminal ou un éditeur. Le serveur MCP Studio connecte ces outils à Studio afin qu'ils puissent construire et tester directement dans votre session ouverte.
  • Assistant : Assistant est l'assistant IA intégré de Studio pour écrire du code et construire, pour quand vous voulez de l'aide IA sans configurer vos propres outils.
©2026 Société Roblox. Roblox, le logo Roblox et Powering Imagination font partie de nos marques déposées aux États-Unis et dans d'autres pays.