Démarrage Rapide

Environ 614 motsEnviron 2 min

GuideQuick Start

2026-01-04

Exigence de l'environnement

Familiarité avec votre propre environnement de développement
Installer Roblox Studio

Il existe différente façons d'installer RbxPI en fonction de votre environnement de développement.

Gestionnaire d'Installation Roblox Recommandé

Le Gestionnaire d'Installation Roblox est un programme permettant d'installer et de mettre à jour RbxPI de manière la plus simple possible.

Il est impossible de mettre à jour RbxPI si votre installation n'a pas était faite via Rojo

Pour pouvoir installer rbxmanager veuillez suivre ces étapes:

Cloner le dépôt Git de rbxmanager

git clone https://github.com/rbxpi/rbxmanager

Aller dans le répertoire de rbxmanager
```
cd rbxmanager
```
Installer les dépendances nécessaire
```
pip install -r requirements.txt
```
Lancer le programme
```
python3 rbxmanager
```
Suivre les étapes d'installation de rbxmanager

Installer via Roblox Studio Recommandé pour les débutants

Si vous utilisez simplement Roblox Studio, vous pouvez installer le modèle depuis le marché des créateurs sur Roblox directement. Cela permet d'installer RbxPI de la façon la plus simple et sécurisé possible.

Note

Le modèle Roblox n'ajoute rien à RbxPI. Il est néanmoins déconseillé de modifier cette version.

Si vous souhaitez créer un fork de RbxPI, il est préférable de le faire via Rojo pour permettre un meilleur versionning.

Installer via Rojo & Github

Avertissement

Cette solution n'est pas compatible pour les systèmes d'exploitation qui ne sont pas prévu par Roblox. Si vous voulez savoir si votre machine est compatible veuillez vous référer à la documentation de Roblox.

Si vous voulez installer RbxPI ailleur que sur Roblox Studio vous devez tout d'abord avoir installé ces prérequis:

Visual Studio Code
Rojo v7 ou une version supérieur.
Une implémentation d'un serveur de langage pour le langage de programmation Luau.
La dernière version de Git

Installation Manuelle

Avertissement

Cette solution part du principe que vous avez déjà installé et configuré les outils qui vous ont était demandé dans votre projet.

Si vous voulez installer RbxPI manuellement veuillez suivrez ces étapes:

Créer le Répertoire de RbxPI

cd répertoire/de/votre/projet/
mkdir nom-du-dossier-replicatedstorage

Cloner le Dépôt

git clone https://github.com/rbxpi/rbxpi-core

Déplacer le Dossier Source de RbxPI

cd rbxpi-core/src/
cp RbxPI/ /répertoire/où/se/trouve/le/dossier/replicatedstorage/

Supprimer le Dépot

cd répertoire/de/votre/projet/
rmdir ./rbxpi-core/

Configurer le Script de Compilation
Ajoutez les éléments suivants à default.project.json dans l'élément "tree":
```
"ReplicatedStorage": {
  "$path": "répertoire/vers/le/dossier/replicatedstorage"
}
```
Lancer le Développement
```
rojo serve
```
Avertissement
Si un message d'erreur est affiché veuillez regénérer votre sourcemap.json
Installation Terminé

Structure du Répertoire

Pour les projets créés via l'outil rbxmanager, la structure de fichiers typique est la suivante :

.git

src# Répertoire du code source

replicatedstorage

RbxPI# Code source de RbxPI

Include# Répertoire des fichiers interne de RbxPI

Lib# Répertoire des paquets

__rhello__

site-packages

…

API.luau# API de RbxPI

LICENSE.luau

Version.txt

…

.gitignore

aftman.toml

default.project.json

README.md

selene.toml

sourcemap.json

Les projets créés manuellement peuvent également être organisés en utilisant cette structure comme référence.

Le dossier Lib est l'endroit où vous placerez les différents paquets que vous voulez importer, ils seront directement lue par RbxPI.

En Savoir Plus sur RbxPI

Maintenant que vous disposez d'un dépôt de paquet fonctionnel vous devriez consulter le guide suivant pour en savoir plus sur RbxPI et savoir comment importer un paquet.