CrownStudio Roblox TS Template

Template Roblox TypeScript avec Flamework, Rojo et une sélection de bibliothèques prêtes à importer. Les versions exactes sont dans package.json, pnpm-lock.yaml, rokit.toml et mise.toml. Pour un agent, ces fichiers et les statuts ci-dessous sont la source de vérité : une référence dans ce README ne signifie pas qu'une fonction de jeu est déjà implémentée.

Démarrage

Prérequis : Roblox Studio, mise et Rokit. Sous Windows, rouvrir le terminal après leur installation pour actualiser PATH.

mise install
rokit install
pnpm install --frozen-lockfile
pnpm check
pnpm build
pnpm serve

mise épingle Node.js 24.16.0, pnpm 11.21.0 et uv 0.13.0. rokit installe Rojo 7.7.1, Asphalt 2.0.2, darklua 0.19.0 et Mantle 0.11.18. pnpm build compile le TypeScript et crée game.rbxl avec Rojo. Ouvrir ce fichier dans Studio, ou utiliser pnpm start pour le flux rbxts-build. pnpm watch lance la compilation et le serveur Rojo en continu. Le projet Rojo est default.project.json et les entrées client/serveur sont sous src.

Autres commandes : pnpm lint, pnpm format:check et pnpm format. Husky installe un hook local pre-commit qui exécute pnpm lint. Renovate lit renovate.json une fois son application activée sur le dépôt distant.

Bibliothèques installées

Chaque paquet de cette section est une dépendance directe. Les liens mènent à la documentation du projet ou à son README actuel ; les versions exécutables sont épinglées dans le lockfile. Les paquets ne sont pas automatiquement utilisés par le code de démarrage.

• @flamework/core (documentation) — services, contrôleurs et injection ; le service de démarrage en donne un exemple.
• @flamework/components (documentation) — composants d'instances.
• @flamework/networking (documentation) — réseau typé.
• @rbxts/react (documentation React Lua, liaison roblox-ts) — interface React.
• @rbxts/react-roblox (documentation ReactRoblox, liaison roblox-ts) — rendu React dans Roblox.
• @rbxts/reflex (documentation) — état applicatif.
• @rbxts/ripple (README et API) — animations.
• @rbxts/services (README) — accès typé aux services Roblox.
• @rbxts/lapis (documentation) — persistance de données.
• @rbxts/trove (README et API) — nettoyage des ressources.
• @rbxts/log (README) — journalisation.
• @rbxts/sift (documentation) — collections immuables
• @rbxts/t (README et API) — validation de valeurs à l'exécution.
• @rbxts/cmdr (documentation, types roblox-ts) — commandes de développement.
• @rbxts/gamejoy (README) — contrôles de jeu.
• @rbxts/tween (README et API) — interpolations.
• @rbxts/timer (README) — temporisation.
• @rbxts/ui-labs (documentation) — prévisualisation d'interface.
• @rbxts/sound-manager (documentation du projet) — gestion des sons
• @rbxts/object-cache (documentation amont) — cache de pièces/objets
• @rbxts/net (README) — contient ExperienceBroadcastEvent pour les messages entre serveurs.
• @rbxts-js/roblox-lua-promise (README) — implémentation de promesses

Pour choisir une approche lors d'une nouvelle fonctionnalité, le skill local roblox-feature-docs compare les bibliothèques pertinentes, leurs documentations et les API réellement disponibles dans les versions verrouillées.

Outils initialisés

• roblox-ts : roblox-ts, @rbxts/types, @rbxts/compiler-types et le transformer Flamework sont configurés dans tsconfig.json.
• Rojo : manifeste default.project.json, pnpm build et pnpm serve.
• rbxts-build : commandes pnpm start, pnpm watch, pnpm open, pnpm stop et construction game.rbxl.
• Asphalt : binaire épinglé avec Rokit ; aucun asset à synchroniser dans ce template vierge.
• darklua : binaire épinglé avec Rokit ; aucune transformation de Lua requise pour le démarrage.
• Mantle : binaire épinglé avec Rokit ; le déploiement exige une expérience Roblox et des identifiants propres au projet. Son dépôt indique qu'il n'est plus maintenu.
• mise et pnpm : versions du runtime et gestion reproductible des dépendances.
• ESLint : configuration flat dans eslint.config.mjs, avec typescript-eslint et Prettier.
• Husky : vérification Git locale.
• Renovate : règles de mise à jour des dépendances ; l'activation du bot sur l'hébergeur reste à faire.

MCP : Codex, Claude, Cursor et Antigravity

Les deux serveurs sont définis dans les fichiers de projet suivants. Chaque client lit son propre fichier, et les processus sont lancés à la demande :

Client	Configuration dans ce dépôt	Référence du client
Codex	.codex/config.toml	MCP Codex
Claude Code	.mcp.json	MCP Claude Code
Cursor	.cursor/mcp.json	MCP Cursor
Antigravity	.agents/mcp_config.json	MCP Antigravity

• Roblox Studio MCP (documentation officielle) : les configurations lancent %LOCALAPPDATA%\Roblox\mcp.bat via cmd.exe. Ce lanceur est fourni par Studio sous Windows. Démarrer Studio, activer son serveur MCP dans les paramètres Assistant/MCP, puis redémarrer le client d'agent si nécessaire. Le fichier mcp.bat est présent sur la machine d'initialisation ; une connexion à une session Studio ouverte reste à vérifier.
• Blender MCP (documentation officielle) : les configurations lancent blender-mcp depuis le dépôt officiel Blender Lab, épinglé sur v1.0.3, au moyen de uvx. Blender 5.1+ et l'extension MCP doivent être installés et actifs. Sur la machine d'initialisation, Blender 5.2.2 LTS et l'extension 1.0.3 ont été installés ; le serveur se lance et le pont de l'extension a été vu à l'écoute sur localhost:9876. Un appel MCP complet depuis un client reste à vérifier. Rouvrir les clients après installation de uvx pour qu'ils héritent du nouveau PATH.

Le serveur Blender peut exécuter du code Python dans Blender : utiliser uniquement des projets de confiance. Les configurations n'incluent aucun secret.

L'API Cloud Creator Store est une API Roblox distincte des serveurs MCP ci-dessus. Elle n'est pas activée ici : son usage nécessite une clé et un cas d'utilisation précis.

Vérification du template

Sur Windows, l'installation verrouillée, pnpm check, pnpm format:check, pnpm build et pnpm start -- --no-watch ont réussi. pnpm build produit game.rbxl et pnpm start a lancé Roblox Studio. codex mcp list reconnaît les deux serveurs. Un test de jeu dans Studio et un appel MCP complet restent à effectuer.