Dépannage

Guide étape par étape pour isoler les problèmes de connexion, de permissions, de Sync et de validation.

Le plugin ne se connecte pas

Symptôme : “Connection failed” ou le plugin apparaît déconnecté dans Roblox Studio.

1. Confirmez que le serveur MCP tourne : npx -y @weppy/roblox-mcp@latest.
2. Dans Roblox Studio, onglet Plugins → WEPPY → cliquez sur Connect.
3. Vérifiez qu’aucun pare-feu, antivirus ou VPN ne bloque localhost:3002.
4. Redémarrez Roblox Studio et le serveur MCP.

Le client IA ne reconnaît pas le serveur MCP

1. Vérifiez que la commande configurée est npx -y @weppy/roblox-mcp@latest.
2. Confirmez que Node.js 18 ou supérieur est installé : node --version.
3. Sous Windows, si une erreur de droits apparaît, relancez le terminal comme administrateur.
4. Consultez le guide d’installation pour votre application IA.

Avis “Pro feature required”

Quand une action réservée à Pro est demandée avec Basic, WEPPY tente un contournement si possible. Ce flux consomme toutefois plus de tokens et ne produit pas toujours un résultat identique.

Certaines fonctions Pro n’ont aucun contournement possible. Si cet avis apparaît souvent, envisagez Pro.

Sync ne fonctionne pas

1. Demandez à l’IA d’exécuter manage_sync status.
2. Confirmez que le plugin est connecté avant de démarrer Sync.
3. Si le sync inverse fichier → Studio échoue, vérifiez que Pro est actif.
4. Confirmez que le dossier local de Sync existe et est inscriptible.

Voir Synchronisation bidirectionnelle pour la configuration détaillée.

Clients IA compatibles

Commande serveur : npx -y @weppy/roblox-mcp@latest

Prérequis système

Comparaison Basic vs Pro

Basic couvre le flux de codage IA essentiel : instances, propriétés, scripts, sélection, caméra, logs, Sync Studio → Local et historique. Pro ajoute Sync bidirectionnel, opérations en lot et outils avancés pour terrain, éclairage, physique, audio et animations.