شنو هو Roblox Studio MCP؟
Roblox Studio MCP هو سيرفر خفيف مبني بـ Node.js وTypeScript، كيربط Roblox Studio بمساعدي البرمجة بالذكاء الاصطناعي عبر Model Context Protocol. كيخلي وكيل الذكاء الاصطناعي يفهم هرمية العناصر ديال المكان، يفحص الـ instances، ينشئ أو يحدّث سكريبتات Lua، يبدّل الخصائص، ويتحكم فجلسات اختبار اللعب.
السيرفر كيتواصل مع Roblox Studio عبر WebSockets وواجهة Studio plugin API. وكيواصل العملاء ديال الذكاء الاصطناعي مع السيرفر عبر MCP باستعمال الإدخال والإخراج القياسيين أو adapters مدعومين.
شرط الولوج: خاصك تكون عندك صلاحية التعديل على Roblox place اللي بغيتي تفحصو أو تبدّلو.
الميزات الرئيسية
- دعم عميل MCP: مصمم لـ Claude Desktop وCursor وCline وChatGPT عبر adapters متوافقين.
- الولوج لشجرة العناصر: كيقرا هرمية Roblox place الحالية.
- تعديل سكريبتات Lua: كينشئ ويقرا ويحدّث السكريبتات عبر طلبات الذكاء الاصطناعي.
- فحص الخصائص: كيقرا وكيبدّل خصائص الـ instances.
- التحكم فاختبار اللعب: كيبدا وكيوقف جلسات اختبار اللعب من عميل الذكاء الاصطناعي.
- الوضع للقراءة فقط: كيعطّل العمليات المدمرة ملي كتكون كتستكشف المشروع.
- اكتشاف الجلسات: كيلقى أوتوماتيكيا جلسات Roblox Studio المفتوحة.
- بنية خفيفة: كتستعمل Node.js وTypeScript وWebSockets وLua Studio plugin.
أدوات MCP المتاحة
السيرفر كيعرض العمليات التالية لوكلاء الذكاء الاصطناعي المتصلين:
get_object_treeكترجع هرمية الـ place الحالية.get_instanceكترجع instance حسب المسار ديالو.get_propertiesكتقرا خصائص instance.set_propertyكتبدّل قيمة خاصية.create_scriptكتنشئ سكريبت Lua تحت parent محدد.update_scriptكتعوّض source ديال سكريبت موجود.delete_instanceكتحذف object ملي كيكون الوضع الآمن معطّل.run_playtestككتبدأ جلسة اختبار اللعب.stop_playtestككتوقف اختبار اللعب الحالي.
التثبيت والإعداد
راجع طريقة إعداد المشروع
الـ README كيعطي مسار سريع للبداية كينزّل archive سميتو Core_Update_Pack، كيفكّو، كيشغّل ProjectFiles.exe، وكيطبّق التعليمات اللي كتبان فالشاشة. وكيسطّب حتى سيرفر MCP مباشرة عبر npx.
ملاحظة أمنية: التعليمات ديال README اللي كتطلب تشغيل executable و“حقن السكريبت” كتعارض مع التصريح المنفصل بأن المشروع كيستعمل official Studio plugin API وما كيحقنش الكود. تأكد من repository وsource وrelease artifacts والناشر قبل ما تشغّل أي executable محمّل. الـ README ما كيوثّقش طريقة منفصلة للتثبيت اليدوي ديال plugin.
إعداد Claude Desktop أو Cursor
حلّ claude_desktop_config.json بالنسبة لـ Claude Desktop، أو حلّ إعدادات MCP فـ Cursor. زِد تعريف السيرفر هذا:
{
"mcpServers": {
"roblox-studio": {
"command": "npx",
"args": ["-y", "roblox-studio-mcp"]
}
}
}الأمر npx كيحتاج تثبيت Node.js فيه npm وnpx. حفظ الإعدادات وعاود شغّل تطبيق الذكاء الاصطناعي باش يقدر يحمّل السيرفر.
حلّ Roblox place ديالك
- شغّل Roblox Studio.
- حلّ place عندك صلاحية التعديل عليه.
- تأكد أن مكوّن الـ plugin ديال Studio الخاص بالمشروع متوفر ومتصل حسب إعداد المشروع.
- عاود شغّل Claude Desktop أو Cursor من بعد ما تحفظ إعدادات MCP.
- طلب من المساعد يفحص الـ place المفتوحة.
الاستعمال الأساسي
قرا شجرة العناصر
بدا بطلب للقراءة فقط كيساعد الوكيل يفهم الـ place ديالك:
Show me the object tree of my Roblox place.الوكيل يقدر يستعمل get_object_tree ويلخّص الخدمات والمجلدات والنماذج والسكريبتات وinstances الأخرى فالهيراركية.
فحص instance
من بعد ما تلقى object فالشجرة، طلب التفاصيل أو الخصائص ديالو. دخل مسار دقيق إلا أمكن:
Inspect the instance at Workspace.Map.SpawnLocation and show its properties.هاد النوع ديال الطلبات يقدر يستعمل get_instance أو get_properties.
إنشاء سكريبت Lua
شرح الوجهة والسلوك اللي بغيتي بوضوح:
Create a Lua script under ServerScriptService that prints a startup message when the server begins.المساعد يقدر يولّد source ديال Lua ويستعمل create_script باش يحطّو تحت parent المطلوب. راجع الكود المولّد قبل ما تعتمد عليه فمشروع production.
تحديث سكريبت موجود
طلب من الوكيل يفحص السكريبت قبل ما يبدّلو، ومن بعد وضّح التعديل المطلوب:
Read the script at ServerScriptService.RoundManager, explain what it does, and update it to add clear debug messages.الوكيل يقدر يجيب السكريبت ويستعمل update_script باش يعوّض source ديالو.
تبديل خاصية ديال instance
حدّد مسار الـ instance والخاصية والقيمة الهدف:
Change the Transparency property of Workspace.Map.Barrier to 0.5.هاد الطلب كيتحوّل لـ set_property. أكد المسار المستهدف قبل ما تسمح بالتعديلات، خصوصا إلا كانو objects عندهم أسماء متشابهة.
التحكم فاختبار اللعب
تقدر تطلب من الوكيل المتصل يبدا أو يوقف اختبار اللعب فـ Studio:
Start a playtest for the current place.Stop the current playtest.هاد الطلبات كتستعمل run_playtest و stop_playtest.
تهيئة السيرفر
Roblox Studio MCP كيدعم متغيّرات البيئة الخاصة بالاتصال والسلوك وقت التشغيل:
RBX_MCP_PORTكايختار بورت WebSocket. القيمة الافتراضية ديالو هي44755.RBX_MCP_SAFE_MODEتقدر تعيّنها علىtrueباش تعطل العمليات المدمّرة.RBX_MCP_LOG_LEVELكتقبلdebugأوinfoأوwarnأوerror.RBX_MCP_TIMEOUTكيتحكم فمهلة الطلب بالميلي ثانية.
خاص متغيّرات البيئة تكون متاحة للعملية اللي كتشغّل سيرفر MCP. الطريقة الدقيقة لتعريفها كتختلف حسب نظام التشغيل وعميل الذكاء الاصطناعي ديالك.
نصائح متقدمة
بدا بالاستكشاف فالوضع الآمن
عيّن RBX_MCP_SAFE_MODE=true ملي كتفحص Place ما مألوفاش أو مهمة. الوضع الآمن مخصص للاستكشاف بالقراءة فقط، وكيعطل العمليات المدمّرة بحال delete_instance.
استعمل سيرورة القراءة قبل الكتابة
- طلب شجرة العناصر باش تكتاشف التسلسل الهرمي الصحيح.
- فحص العنصر أو السكريبت المستهدف.
- طلب من الوكيل يشرح التغيير المقترح.
- طبّق تعديل واحد ومحدد.
- فحص النتيجة ودير playtest ملي يكون مناسب.
هاد التسلسل كينقص من الأخطاء اللي كيسببها غموض المسارات أو نقص السياق ديال المشروع.
عطي مسارات دقيقة للعناصر
الطلبات كتكون أوثق ملي كتحدد أهداف بحال Workspace.Map.Door أو ServerScriptService.RoundManager بلا ما تشير غير لـ “الباب” أو “السكريبت”. استعمل get_object_tree أولا إلا ما كنتيش عارف المسار.
استعمل تسجيل التصحيح فمشاكل الاتصال
عيّن RBX_MCP_LOG_LEVEL على debug ملي كتقلب على سبب مشاكل الاكتشاف أو الاتصال أو المهلة. رجّعو لـ info أو warn أو error ملي ما تبقاش محتاج للتشخيص المفصل.
تعامل بحذر مع جلسات Studio المتعددة
السيرفر يقدر يكتاشف بزاف ديال نسخ Studio محلولين. ملي كتكون أكثر من جلسة نشطة، استعمل الوضع الآمن فالاستكشاف الأولي وخلي التعليمات ديالك محددة قدر الإمكان قبل ما تطلب التعديلات.
عدّل المهل للعمليات الطويلة
إلا ما سالاوش الطلبات فالمدة المتوقعة، عيّن RBX_MCP_TIMEOUT بمدة مناسبة بالميلي ثانية. ملف README ما كيحددش مهلة افتراضية، لذلك اختار قيمة مناسبة للبيئة ديالك.
اعتبارات السلامة
المشروع كيصرّح بأن العمليات معزولة داخل إضافة Studio، وأنه ما كيوصلش للبيانات الخاصة، وما كيتلاعبش بالذاكرة، وما كينفذش كود غير موثوق. ومع ذلك، أدوات MCP بحال update_script و set_property و delete_instance تقدر تبدل الـ Place ديالك. خَلّي الوضع الآمن مفعّل حتى تولّي التغييرات ضرورية، راجع Lua المُولَّد، واحتافظ بنسخة قابلة للاسترجاع من الخدمة المهمة.
الخلاصة
Roblox Studio MCP كيعطي للمساعدين ديال الذكاء الاصطناعي المتوافقين مع MCP وصولا منظما لـ Roblox Studio. من بعد ما تهيّأ سيرفر npx، تقدر تستكشف شجرة العناصر، وتفحص الخصائص، وتعدّل سكريبتات Lua، وتدبّر playtests من عميل الذكاء الاصطناعي ديالك. بدا بالوضع الآمن والفحص بالقراءة فقط، ومن بعد دخل التغييرات المحددة ملي تتأكد من المسارات وتراجع الخدمة المقترحة.