التوثيق

توثيق RoCode

كيف تُعدّ RoCode.app وتستخدمه، وهو وكيل ذكاء اصطناعي لـ Roblox Studio: ما الذي تحتاجه، وكيف تسجّل الدخول، وكيف تثبّت الإضافة وتربطها، وكيف يعمل وضعا Build وAsk، وكيف تجري الفحوص والتراجع، وأي النماذج في كل خطة، وكيف تُحسب الأرصدة، وما الذي لا يفعله RoCode، وما الذي تراه الإضافة، وماذا تفعل إذا لم يتصل Studio. القائمة الكاملة للأدوات وكل التفاصيل في التوثيق الإنجليزي.

آخر تحديث ٢٠ نوفمبر ٢٠٢٦القراءة في 18 دبقلم

باختصار

RoCode وكيل ذكاء اصطناعي لـ Roblox Studio. تصف التغيير في دردشة الويب على rocode.app/chat، وتنفّذ إضافة RoCode المجانية خطوات الوكيل في المكان المفتوح عندك. للبدء سجّل الدخول إلى rocode.app بكود يصلك على البريد أو عبر Google أو Roblox أو Discord، وثبّت الإضافة من Roblox Creator Store، واسمح بما يطلبه Studio، وافتح مكانًا، وأبقِ rocode.app/chat مفتوحًا. إذا كان Studio مسجّلًا بحساب Roblox نفسه المستخدم في RoCode فسيتصل تلقائيًا. وإلا فأدخل في الدردشة كود الاقتران المؤلف من 8 أحرف من لوحة RoCode، ثم اضغط Connect في اللوحة للتأكيد.

  • تحتاج إلى Roblox Studio محدّث على Windows أو Mac ومتصفح على الحاسوب. الهواتف غير مدعومة، وفي Brave يجب تعطيل Shields لموقع rocode.app.
  • تتصل مرة واحدة. يتصل Studio تلقائيًا مع حساب Roblox نفسه (الإضافة 3.9.13 أو أحدث)؛ وإلا فتُدخل كودًا صالحًا 15 دقيقة ويعمل مرة واحدة. بعد ذلك تعيد الإضافة الاتصال تلقائيًا.
  • للدردشة وضعان. Build يجري تغييرات في Studio. وAsk يجيب عن أسئلة حول اللعبة بأدوات للقراءة فقط ولا يغيّر شيئًا.
  • خطة Starter مجانية: رصيد واحد يوميًا، على GPT-6 Luna، دون بطاقة. والخطط المدفوعة تبدأ من $9.99 شهريًا مقابل 150 رصيدًا.
في هذه الصفحة
  1. ما هو RoCode
  2. المتطلبات
  3. التثبيت
  4. التشغيل الأول
  5. Build وAsk
  6. الفحوص والتراجع
  7. النماذج والأرصدة
  8. القيود
  9. الأمان
  10. حل المشكلات
  11. الخطط
  12. الأسئلة الشائعة
  13. المصادر والقراءات

ما هو RoCode

RoCode (RoCode.app) وكيل ذكاء اصطناعي لـ Roblox Studio. تصف الميزة في دردشة الويب على rocode.app. ثم تنفّذ إضافة RoCode المجانية من Roblox Creator Store خطوات الوكيل في المكان المفتوح عندك: تقرأ الكائنات والسكربتات اللازمة للخطوة، وتكتب Luau، وتنشئ أو تعدّل Script وLocalScript وModuleScript وغيرها من الكائنات، وتفحص سكربتاتها بحثًا عن أخطاء الترجمة في Studio قبل أن تنتهي.

ثلاثة أجزاء ومكانك
الجزءماذا يفعل
دردشة الويب
rocode.app/chat
تحفظ المحادثة واختيار النموذج والسجل خطوة بخطوة لكل تشغيل. تُفتح في متصفح على الحاسوب.
Relay
relay.rocode.app
خادم RoCode بين الدردشة والإضافة والنموذج. يرسل طلبك عبر OpenRouter إلى النموذج المختار أو إلى بديله، أو في حالة رسالة فيها صور إلى نموذج يقرؤها، وينقل خطوات النموذج إلى الإضافة.
إضافة Studio
RoCode من Creator Store
تنفّذ خطوات الوكيل داخل Studio بـ 27 أداة تقرأ وتنشئ وتعدّل وتفحص وتختبر. تحافظ على اتصال WebSocket مع relay، وrelay هو الخادم الوحيد الذي تتحدث إليه.
مكانكالمكان المفتوح في نافذة Studio المتصلة. كل تشغيل يبدأ بموضع الكاميرا وما يصل إلى 8 كائنات محددة، لذا قد تعني «هذا» ما حددته. وما عدا ذلك لا يُرسل إلا عندما تطلبه خطوة، أو عند فحص المظهر (الإضافة 3.9.14 أو أحدث)، أو عندما تكتب / في الدردشة. لا يُرفع ملف المكان، ولا توجد مزامنة في الخلفية.

GPT-6 Luna وGLM 5.3 Flash وClaude Sonnet 5.5 وClaude Opus 5.5 وGPT-6 Astra نماذج من جهات خارجية يشغّلها RoCode عبر OpenRouter بتعليماته الخاصة وأدوات Studio. ليست لدى RoCode نماذج خاصة به.

ما الذي تحتاجه

ما الذي تحتاجه قبل الاتصال
المطلوبالتفاصيل
Roblox Studioعلى Windows أو Mac، ومحدّث. تحافظ الإضافة على اتصال حي مع RoCode عبر دعم WebSocket في Studio، والنسخة القديمة من Studio التي لا تدعمه لا تستطيع الاتصال.
إضافة RoCodeمجانية، من Roblox Creator Store.
متصفح على الحاسوبمن أجل rocode.app/chat. الهواتف غير مدعومة: على الهاتف تعرض الدردشة رسالة بأنها للحاسوب فقط. في Brave تحجب Shields الاتصال بـ Studio، لذا عطّل Shields لموقع rocode.app أو استخدم Chrome أو Edge.
شبكة ترى relayيجب أن يصل Studio إلى relay.rocode.app عبر WebSocket. شبكات المدارس والعمل التي تحجب ذلك لن تسمح بالاتصال.
حساب RoCodeمجاني. الدخول إلى rocode.app بكود على البريد أو عبر Google أو Roblox أو Discord. لا حاجة إلى بطاقة. يجب أن يكون عمرك أكثر من 13 عامًا، وتحت 18 عامًا تحتاج إلى إذن أحد الوالدين أو الوصي.

لا تحتاج إلى: تطبيق سطح مكتب، ولا سطر الأوامر، ولا ملفات إعداد، ولا خادم MCP، ولا كلمة مرور Roblox. لا يطلب RoCode كلمة مرور Roblox أبدًا.

تثبيت الإضافة وربطها بالدردشة

التثبيت والاتصال خطوة بخطوة

  1. أنشئ حسابًا مجانيًا. سجّل الدخول إلى rocode.app بكود على البريد أو عبر Google أو Roblox أو Discord.
  2. ثبّت الإضافة. افتح إضافة RoCode في Creator Store وثبّتها. تظهر الإضافات المثبّتة في تبويب Plugins في Studio. وفي مدير الإضافات يحمل RoCode اسم RoCode AI.
  3. امنح الأذونات. عندما يسألك Studio، اسمح بطلبات HTTP إلى relay.rocode.app وبـ Script Injection.
  4. افتح مكانًا في Roblox Studio: اللعبة التي تعمل عليها أو Baseplate جديدة.
  5. افتح الدردشة. افتح rocode.app/chat في متصفح على الحاسوب. إذا كان Studio مسجّلًا بحساب Roblox نفسه الذي دخلت به إلى RoCode أو ربطته به فسيتصل تلقائيًا (الإضافة 3.9.13 أو أحدث). وإذا أظهرت الدردشة Connect Studio فاضغط هذا الزر.
  6. أو استخدم كود الاقتران. إذا لم يتصل Studio تلقائيًا، تعرض لوحة RoCode كودًا من 8 أحرف؛ وإن لم تره فاضغط Use a pairing code. في بطاقة الدردشة Connect to Roblox Studio أدخل الكود واضغط Connect.
  7. أكّد في Studio. بعد الكود تعرض لوحة RoCode سطر تأكيد بحسابك. اضغط هناك Connect (أو Allow). ينتظر السطر حتى دقيقتين، ثم يعرض كودًا جديدًا.
عرض توضيحيمسار كود الاقتران في 18 ثانية (الشاشات بالإنجليزية): احصل على الإضافة، وانسخ الكود في Studio، والصقه في الدردشة، واضغط Connect. بعد ذلك يطلب Studio تأكيد الحساب؛ وهذه الخطوة لا تظهر في المقطع.

تسجيل الدخول

  • كود على البريد: يرسل RoCode كود دخول يُستخدم مرة واحدة. لا توجد كلمة مرور.
  • Google وDiscord: الدخول عبر الحساب المعني.
  • Roblox: الدخول عبر حساب Roblox، ولا يطلب RoCode كلمة مرور Roblox أبدًا. الدخول عبر Roblox لا يرتبط بحساب RoCode موجود مسبقًا، لذا إن كنت تستخدم RoCode أصلًا فادخل كالمعتاد لتحتفظ بخطتك ومحادثاتك. ويمكنك لاحقًا إضافة بريد إن أردت: فهو لازم للإيصالات وللدخول دون Roblox.

أذونات Studio التي تطلبها الإضافة

الأذونات والإعدادات
الإذنلماذا تحتاجه الإضافةإذا رفضته
طلبات HTTP إلى relay.rocode.appخادم RoCode والمضيف الوحيد الذي تتحدث إليه الإضافة. تفحصه الإضافة عند التحميل ومرة أخرى إذا فشل الاتصال، وتحذّر في Output إذا كان محجوبًا.اسمح به في Plugins > Manage Plugins > RoCode AI.
Script Injectionيتيح لـ RoCode إنشاء السكربتات وتعديلها.مع الإضافة 3.9.2 أو أحدث لا يشغّل RoCode وضع Build ما دام هذا الإذن معطّلًا؛ أما Ask فيعمل. فعّله لـ RoCode AI في Plugins > Manage Plugins (رمز القلم). تعيد الإضافة الفحص كل 30 ثانية؛ وإذا ظلت تقول إن الإذن غير موجود فأعد تشغيل Studio.

إعداد واحد في Studio اختياري ويبقى قراره لك: Enable Studio Access to API Services. تحتاج إليه لاختبار الحفظ في DataStore داخل Studio، ولا يستطيع RoCode تغييره. في Studio افتح File > Experience Settings > Security، وفعّله، واضغط Save. يجب نشر المكان أولًا. عندها يستخدم Studio مخازن البيانات نفسها التي تستخدمها اللعبة الحية، لذا تنصح Roblox بتفعيله في نسخة اختبار منفصلة فقط.

كيف يعمل الاقتران

ربط Studio بكود من 8 أحرف أو دونه
البندكيف يعمل
دون كودمع الإضافة 3.9.13 أو أحدث يتصل Studio تلقائيًا إذا كان مسجّلًا بحساب Roblox نفسه الذي دخلت به إلى RoCode أو ربطته به، وكان rocode.app/chat مفتوحًا. الكود أدناه لكل الحالات الأخرى.
الكود8 أحرف في لوحة RoCode، بصيغة ABCD-EFGH. لا يحتوي أبدًا على الرموز I وL وO و0 و1.
مدة الصلاحيةالكود نفسه 15 دقيقة.
كم مرةمرة واحدة. يُنسى الكود فور استخدامه.
في المرة القادمةتحفظ الإضافة مفتاح الاتصال في إعدادات إضافات Studio وتعيد الاتصال تلقائيًا. لا حاجة إلى كود.
أي الأماكنبعد الاقتران تعيد الإضافة الاتصال في أي مكان تفتحه على هذا الحاسوب. لإيقاف ذلك عطّل RoCode AI في Plugins > Manage Plugins.
عدة نوافذ Studioنافذة Studio واحدة فقط تكون متصلة. إذا فتحت مكانًا في نافذة ثانية انتقل الاتصال إليها.
شبكات مختلفةإذا كان Studio والمتصفح على شبكتين عامتين مختلفتين، كأن يكون أحدهما خلف VPN أو iCloud Private Relay، تعرض الدردشة Connect anyway. اضغطه وأدخل كودًا جديدًا من لوحة RoCode.

التشغيل الأول

لن ترسل الدردشة رسالة ما دام Studio غير متصل: زر الإرسال معطّل، وعند تمرير المؤشر عليه يظهر Connect the plugin first. عندما يتصل Studio صِف تغييرًا واحدًا.

طلب أول جيد

  • ميزة واحدة في كل مرة. هكذا تكون النتيجة أفضل من لعبة كاملة في رسالة واحدة.
  • قل ما يجب أن يحدث بكلمات عادية، ويمكنك ذلك بالعربية. لا تحتاج إلى معرفة أسماء الفئات ولا أين توضع السكربتات.
  • أشر إلى ما يهم. اكتب / في حقل الرسالة لترفق المسار الدقيق لكائن في Studio، مثل السكربت الذي يجب تغييره. وبزر + يمكنك إرفاق ما يصل إلى 12 ملفًا نصيًا (20,000 حرف إجمالًا) وما يصل إلى 4 صور في الرسالة، على أي نموذج.
  • مجرد سؤال؟ حوّل حقل الإدخال إلى وضع Ask، ولن يتغير شيء في المكان.
  • أو أملِ طلبك. زر الميكروفون يسجّل الطلب؛ ويظهر النص المفرّغ في حقل الرسالة حيث يمكنك تصحيحه وإرساله.
ما تكتبه

أضف ركضًا على Shift الأيسر يستهلك شريط التحمل أسفل الشاشة ويعيد ملأه عندما يتوقف اللاعب عن الركض.

ما يفعله RoCode
  • قد يستعرض المكان أولًا بأدوات مثل Search Game وRead Script ليبني حول ما هو موجود
  • ينشئ السكربتات عبر Create Script، وكائنات واجهة الشريط عبر Create Instance، كلٌّ في الخدمة التي هي مكانه الافتراضي
  • يفحص السكربتات التي كتبها عبر Check Script قبل أن ينتهي
  • يرسل التغييرات إلى Studio على دفعات، وكل دفعة نقطة تراجع في Studio

كتبنا مثال الطلب بأنفسنا. أسماء الأدوات حقيقية، لكن ما سيفعله التشغيل يعتمد على مكانك.

أين يضع RoCode الأشياء

المواضع الافتراضية. إذا كانت في المكان مجلدات خاصة بك فالتعليمات تطلب من RoCode استخدامها.
تطلبينشئأين
منطق الخادم: العملات، الضرر، الحفظ، الجولاتScriptServerScriptService
الإدخال والكاميرا وسلوك الواجهةLocalScriptStarterPlayer > StarterPlayerScripts
الشاشات والقوائمScreenGuiStarterGui
القطع والنماذج والمنشآتPart, ModelWorkspace

ما الذي تراه أثناء العمل

  • سجل خطوة بخطوة. تعرض الدردشة كل خطوة باسم الأداة. وتظهر كل قراءة وكل حذف مع المسار.
  • كم يستغرق ذلك. يعتمد على المهمة وحجم المكان والنموذج. قد يستمر التشغيل الواحد حتى 80 دورًا للنموذج أو 5 ساعات. وتعرض الدردشة عدد الأرصدة التي يستهلكها التشغيل.
  • يمكن للطلب التالي أن ينتظر في الطابور. أثناء التشغيل يمكنك وضع الطلب التالي في الطابور. ويمكن أن تعمل حتى 3 تشغيلات في الوقت نفسه.
  • لا تعديلات أثناء اختبار اللعب. إذا كان اختبار لعب جاريًا عند الحاجة إلى تغيير، يوقف RoCode الاختبار أولًا، بما في ذلك الاختبار الذي شغّلته أنت. وإذا ظل Studio في Play بعد 20 ثانية فلا يغيّر شيئًا ويطلب منك ضغط Stop.

Stop وContinue

يمكنك إيقاف التشغيل في أي لحظة. إذا توقف في المنتصف بسبب خطأ أو حد، تبقى التغييرات التي أُجريت، ويتابع Continue من المكان نفسه. التشغيل الذي توقفه أنت يُحتسب حتى نقطة التوقف. وإذا فشل التشغيل بسبب مشكلة من جهتنا تُعاد الأرصدة تلقائيًا.

وضعا Build وAsk

كل رسالة تُنفَّذ في أحد وضعين. Build مفعّل افتراضيًا ويغيّر المكان. وAsk، الذي أُضيف في 9 أكتوبر 2026، يجيب عن أسئلة حول اللعبة ولا يغيّر شيئًا.

الوضعان في حقل الإدخال
الوضعماذا يفعللأي غرض
Buildيجري تغييرات في Studio. يستطيع الوكيل استخدام الأدوات الـ 27 كلها: يقرأ المكان، وينشئ السكربتات والكائنات ويعدّلها، ويفحص السكربتات، ومع الإضافة 3.9 أو أحدث يستطيع تشغيل اختبار لعب قصير.إضافة ميزة، أو إصلاح خطأ، أو بناء شاشة أو منشأة.
Askيجيب عن أسئلة حول اللعبة دون تغيير أي شيء. لا يستطيع استخدام إلا 10 أدوات للقراءة؛ وأي أداة أخرى تُرفض ولا تصل إلى Studio، ولا يُشغَّل اختبار اللعب أبدًا. تُعلَّم الإجابة بـ Answer.فهم طريقة عمل سكربت، أو إيجاد مكان شيء ما، أو السؤال عن خطأ، أو التخطيط لتغيير مسبقًا.

لتبديل الوضع اضغط على شريحة الوضع في الشريط أسفل حقل الرسالة (على اليسار، بجانب زر + وحالة الإضافة) واختر Ask أو Build. يُحفظ اختيارك في هذا المتصفح، لذا تحقق من الشريحة قبل إرسال تغيير. يحتاج Ask أيضًا إلى Studio متصل، لأنه يقرأ المكان. والطلب الموجود في الطابور أو المكرر أو المتابَع يُنفَّذ في الوضع الذي أُرسل به.

أدوات Ask، وكلها للقراءة فقط: List Children وGet Descendants وFind Child وSearch Game وSearch Scripts وGet Properties وInspect Model وRead Script وCheck Output وCheck Script. أداة Check Script تترجم السكربت فقط ولا تشغّله أبدًا. الأدوات الـ 27 كلها، و12 منشأة جاهزة، و7 تخطيطات واجهة مذكورة في التوثيق الإنجليزي.

الفحوص وOutput والتراجع

ما الذي يفحصه Check Script

يمرّر Check Script السكربت عبر مترجم Luau داخل Studio. ويعود خطأ الترجمة مع رقم السطر والعمود. ويحذّر أيضًا من wait() وspawn() وdelay() (الأفضل task.wait() وtask.spawn() وtask.delay())، ومن loadstring، ومن require لا يشير إلى ModuleScript، ومن ModuleScript دون قيمة معادة، ومن اسم غير موجود في GetService. لا يفحص الأنواع، ولا يجري lint، ولا يشغّل الكود، لذا يلتقط أخطاء الترجمة وبعض الأنماط الخطرة، لا أخطاء المنطق. بعد كل Create Script أو Edit Script تطلب التعليمات من الوكيل فحص ذلك السكربت؛ وإذا فشل الفحص فلا يستطيع RoCode الانتهاء حتى ينجح فحص لاحق. وبعد محاولتين يمكنه الانتهاء ويقول إن الفحص ما زال يفشل.

أخطاء من اختبارات لعبك

  1. اضغط Play في Studio وكرّر المشكلة.
  2. أخبر RoCode بما تعطّل. يمكنك ضغط Stop أولًا: تُحفظ أسطر Server وClient من آخر اختبار لعب.
  3. يقرأ Check Output نافذة Output، ثم يقرأ RoCode السكربت حول سطر الخطأ ويصلحه.
  4. العب مرة أخرى لتتحقق من الإصلاح.

اختبار لعب قصير وروبوت الاختبار

مع الإضافة 3.9 أو أحدث يستطيع التشغيل في وضع Build ضغط Play لاختبار يصل إلى 30 ثانية، وجمع أخطاء الخادم والعميل وتحذيراتهما، وإيقاف الاختبار. وإذا لم يتوقف Studio خلال 20 ثانية يطلب منك ضغط Stop. لا يزيد ذلك عن مرتين في التشغيل، إضافة إلى مرة أخرى للتحقق من إصلاحه؛ وAsk لا يشغّل اختبار لعب أبدًا. الوكيل هو من يقرر متى يختبر، لذا لا يحصل كل بناء على اختبار. مع الإضافة 3.9.11 أو أحدث تمشي شخصية الاختبار وتقفز وتدوس القطع، ومع 3.9.15 أو أحدث تضغط أيضًا المفاتيح وتنقر الأزرار على الشاشة وتكتب. ثم يتحقق من أن كل شيء حدث (الضرر، والقيم، والقطع)، ويعلّم كل فحص بأنه نجح أو لم ينجح. لا يلتقط الاختبار لقطات شاشة ولا يفحص إلا ما اختاره الوكيل، لذا لن يخبرك هل اللعبة ممتعة.

فحص المظهر

مع الإضافة 3.9.14 أو أحدث، التشغيل في وضع Build الذي بنى أو غيّر شيئًا مرئيًا يلتقط لقطات شاشة في Studio قبل الانتهاء، مرة واحدة على الأكثر في التشغيل: عادة لقطتان من زاويتين متقابلتين، إضافة إلى لقطة لواجهة الشاشة إذا بُنيت واجهة. تُلتقط في وضع التحرير، ولا تُلتقط أبدًا أثناء اختبار اللعب، ثم تعيد الإضافة الكاميرا والتحديد. يرسلها RoCode عبر OpenRouter إلى GLM 5.3 Flash، مع DeepSeek V4.1 Flash بديلًا، في أي خطة. يسرد النموذج المشكلات الواضحة، مثل قطع معلّقة في الهواء أو غائصة في الأرض، أو فجوات أو مقياس خاطئ، ويصلح الوكيل المشكلات الحقيقية. لا تعرض الدردشة لقطات الشاشة، ولا يحفظها RoCode.

التراجع على دفعات

يضع RoCode نقطة تراجع في Studio قبل كل دفعة تغييرات وبعدها، لذا يلغي Ctrl+Z (⌘Z على Mac) عمله دفعة بعد دفعة ما دام Studio مفتوحًا. يتكون التشغيل عادة من عدة دفعات، لذا يُلغى التشغيل الطويل بعدة ضغطات. وزر Revert في الدردشة يعيد المحادثة فقط، لا Studio.

الحذف

منذ 9 أكتوبر 2026 لا يحذف RoCode كائنًا أو يفك تجميعه إلا إذا كان هو من أنشأه في وقت سابق من المحادثة نفسها، أو إذا طلبت رسالتك حذف الكائن أو إعادة بنائه (باسمه، أو باسم ما يحتويه، أو بكلمة «كل شيء»، أو وهو محدد في Studio)، أو إذا سألك RoCode هل يحذفه وأجبت بنعم. وإلا يُرفض الحذف قبل أن يصل إلى Studio، وتطلب التعليمات من RoCode أن يسألك. مع الإضافة 3.8.5 أو أحدث لا يُدمَّر الكائن المحذوف: تنقله الإضافة إلى مجلد RoCodeTrash في ServerStorage مع تسجيل مكانه الأصلي، وتتوقف السكربتات في هذا المجلد عن العمل. يُحفظ المجلد مع المكان ويحتفظ بعمليات حذف آخر 30 تشغيلًا (حتى 25,000 كائن)؛ أما الأقدم وكل ما يُحذف من داخل سلة المهملات فيختفي نهائيًا.

النماذج والأرصدة

النماذج التي يمكنك اختيارها
النموذجالخططما يجب معرفته
GPT-6 Lunaأي خطةمن OpenAI. النموذج المجاني. يقرأ الصور بنفسه.
GLM 5.3 FlashPro وما فوقهامن Z.ai. النموذج الافتراضي بعد الانتقال إلى خطة مدفوعة، وأقل معدل استهلاك بين النماذج المدفوعة.
Claude Sonnet 5.5Pro وما فوقهانموذج أقوى من Anthropic. عند اختياره أول مرة يطلب RoCode التأكيد.
Claude Opus 5.5Studio وما فوقهاأقوى نموذج من Anthropic. عند اختياره أول مرة يطلب RoCode التأكيد.
GPT-6 AstraUltraأقوى نموذج من OpenAI، ويستهلك الأرصدة أسرع من الجميع. عند اختياره أول مرة يطلب RoCode التأكيد.
نموذجك الخاصأي خطة مدفوعةمعرّف النموذج ID على OpenRouter. يجب أن يدعم استدعاء الأدوات، وحتى الآن لا يُنهي كل نموذج التشغيلات بأدوات RoCode. والدفع من رصيد OpenRouter.

الرصيد يقيس تكلفة الحوسبة للتشغيل. النماذج القوية والتشغيلات الطويلة تستهلك أكثر. بالمعدلات الحالية تستهلك المهمة المعقدة نحو 4 أرصدة، والمهمة العادية (GPT-6 Luna) نحو 0.4. أي نحو 35 مهمة معقدة أو 350 مهمة عادية شهريًا في Pro، ونحو 80 أو 750 في Studio، ونحو 125 أو 1,190 في Ultra. على النموذج المجاني يكفي رصيد واحد لمهمة أو مهمتين صغيرتين. تحصل خطة Starter على رصيد مجاني واحد يوميًا على GPT-6 Luna؛ وتحصل الخطط المدفوعة على رصيدين يوميًا، وتُستهلك أرصدة الخطة بعدهما.

الحدود والتجديد
البندStarter (مجانًا)الخطط المدفوعة
الحدرصيد واحد يوميًا150 أو 320 أو 500 رصيد شهريًا. دون حد يومي.
التجديدكل يوم في 00:00 UTCالخطط الشهرية: كل شهر عند نجاح الدفع. السنوية: كل 30 يومًا.
الأرصدة غير المستخدمةلا تُرحَّلأرصدة الخطة لا تُرحَّل. وأرصدة الحزم لا تنتهي صلاحيتها.
عند نفادهاانتظر 00:00 UTC، أو اشترِ حزمة أرصدة، أو انتقل إلى خطة مدفوعة.اشترِ حزمة، أو انتقل إلى خطة أعلى، أو استخدم مفتاحك الخاص، أو انتظر التجديد.

مفتاح OpenRouter الخاص بك متاح في الخطط المدفوعة فقط: آخر بطاقة في اختيار النموذج، والمفتاح (sk-or-v1-...) ومعرّف النموذج ID. يصدر OpenRouter الفاتورة، ولا تُستهلك أرصدة RoCode. لا يمكن ربط اشتراكات Claude وClaude Code وChatGPT. ويُحفظ المفتاح مشفّرًا.

حزم الأرصدة في أي خطة، من صفحة الحساب: 50 رصيدًا بسعر $4.99، و220 بسعر $19.99، و580 بسعر $49.99، و1,200 بسعر $99.99 (بالدولار الأمريكي دون الضرائب). تُستهلك بعد الأرصدة الشهرية ولا تنتهي صلاحيتها. في Starter تُستهلك الحزم بعد الأرصدة المجانية وتعمل على GPT-6 Luna. المزيد عن الحزم في التوثيق الإنجليزي.

القيود

حدود من المفيد معرفتها
الحدالقيمة
التشغيلات في الوقت نفسهحتى 3 لكل حساب
تشغيل واحدحتى 80 دورًا للنموذج، وكل دور قد يستخدم عدة أدوات، أو 5 ساعات
الأرصدة في تشغيل واحديتوقف التشغيل بعد عدد معين من الأرصدة ويسألك هل يتابع. الحد يعتمد على النموذج وقد يكون أقل في الخطط الأصغر.
اختبار اللعبحتى 30 ثانية، ولا أكثر من 2 في التشغيل إضافة إلى 1 للتحقق من الإصلاح، في وضع Build مع الإضافة 3.9 أو أحدث
Search Scriptsحتى 300 سكربت من مكان بدء البحث
نص السكربت في القراءة الواحدة12,000 حرف؛ والسكربتات الطويلة تُقرأ على نطاقات من الأسطر
الصورPNG أو JPG أو WebP، أقل من 10 MB لكل صورة، حتى 4 في الرسالة، على أي نموذج
الإدخال الصوتيحتى 4 دقائق للتسجيل

ما الذي لا يفعله RoCode اليوم

  • لا يقيّم هل اللعبة ممتعة، ولا يلعب بدلًا منك خارج اختبارات اللعب القصيرة.
  • لا يلتقط لقطات شاشة أثناء تشغيل اللعبة. فحص المظهر يلتقط ما بُني فقط، في وضع التحرير. ويمكنك إرفاق لقطات شاشتك على أي نموذج.
  • لا ينحت التضاريس ولا يلوّنها يدويًا. يستطيع بناء Terrain (تلال وجبال وبحيرات وأنهار وجزر وشواطئ) بسكربت مولَّد؛ أما اللمسات اليدوية فتبقى لك.
  • لا يولّد شبكات mesh ولا خامات ولا رسومًا متحركة من الصفر. بدلًا من ذلك تضع Insert Model نماذج موجودة أصلًا في Creator Store: يجدها بكلماتك، أو نموذجًا أو decal أو mesh بمعرّف الأصل ID أو برابط أعطيته.
  • لا ينشر المكان ولا يحفظه، ولا يغيّر إعدادات التجربة على موقع Roblox. يستطيع تغيير خصائص المكان، مثل الجاذبية، كأي تعديل في Studio.
  • لا يصنع لعبة جاهزة ومتوازنة من جملة واحدة.
  • لا يعمل على الهاتف.

وليست لديه أيضًا أدوات لـ game passes ولا منتجات المطورين ولا رفع الأصول ولا تفعيل API Services. القائمة الكاملة للحدود في التوثيق الإنجليزي.

الأمان: ما الذي يراه RoCode وكيف تتراجع عن كل شيء

لا يطلب RoCode كلمة مرور Roblox أبدًا ولا يرفع ملف المكان أبدًا. ترسل الإضافة نتائج الخطوات التي يطلبها التشغيل (ومنها النص الكامل للسكربتات)، وموضع الكاميرا وما يصل إلى 8 كائنات محددة في بداية التشغيل، ولقطات شاشة فحص المظهر (الإضافة 3.9.14 أو أحدث)، واسم المكان ومعرّفه id عند الاتصال. اتصال الشبكة الخاص بالإضافة الحالية يذهب فقط إلى خادم RoCode وهو relay.rocode.app، عبر قناة مشفّرة. أما Studio نفسه فيتصل بـ Roblox ليحمّل نماذج Creator Store من أجل Insert Model، ومع الإضافة 3.9.13 أو أحدث ليعرف اسم Roblox الذي سُجّل الدخول به.

  • لا نشر ولا إنفاق. لا يوجد في الإضافة كود لنشر المكان أو حفظه أو رفع الأصول أو إنفاق Robux. تضع Insert Model أصولًا موجودة أصلًا في Creator Store فقط، يجدها بكلماتك أو بمعرّف الأصل ID أو برابط أعطيته، وتزيل السكربتات داخل النموذج.
  • نافذة Studio واحدة. نافذة Studio واحدة فقط متصلة بالحساب. وعندما تطلب خطوة ذلك، يستطيع RoCode قراءة أي كائن أو سكربت في المكان المفتوح هناك.
  • تعديلاتك على السكربتات. لن تستبدل Edit Script بالكامل سكربتًا تغيّر بعد آخر قراءة له من RoCode، والتعديلات الصغيرة تُطبَّق على النص الحالي، لذا تبقى تغييراتك.
  • الخروج. يحذف Sign out في لوحة RoCode مفتاح الاتصال المحفوظ في هذا Studio. ويفصل Disconnect Studio في الدردشة كل نوافذ Studio في حسابك.
  • الدفع. يتم الدفع في صفحة دفع Paddle، لذا تُدخل بطاقتك لدى Paddle لا في نموذج من RoCode. لا يحفظ RoCode بيانات البطاقات.

من يصنع RoCode: تاجر فرد (sole trader) في المملكة المتحدة باسم RoCode (انظر الشروط)؛ والبريد support@rocode.app. تطلب تعليمات RoCode من الوكيل أن يعامل النص داخل مكانك كبيانات لا كتعليمات، وأن يرفض الثغرات والأبواب الخلفية والسكربتات التي تؤذي اللاعبين أو تسرق البيانات. ما الذي يُحفظ ومن يعالج الطلب موصوف في قسم الخصوصية (بالإنجليزية).

حل المشكلات

معظم مشكلات الإعداد واحدة من الحالات أدناه. وإن لم تكن كذلك فاسأل في Discord الخاص بـ RoCode، فالدعم هناك.

لا يتصل Studio، أو تقول الإضافة إن WebSocket غير متاح

حدّث Roblox Studio. تحافظ الإضافة على الاتصال عبر دعم WebSocket في Studio، والنسخ القديمة لا تدعمه. ويجب أن تسمح الشبكة أيضًا باتصالات WebSocket إلى relay.rocode.app؛ وشبكات المدارس والعمل التي تحجب ذلك لن تسمح بالاتصال.

تقول الإضافة إنها لا تستطيع الوصول إلى relay.rocode.app

اسمح بطلبات HTTP إلى relay.rocode.app لـ RoCode AI في Plugins > Manage Plugins، ثم اضغط Reset في لوحة RoCode.

لا يستطيع RoCode إنشاء السكربتات أو تعديلها

على الأرجح رُفض Script Injection. فعّله لـ RoCode AI في Plugins > Manage Plugins (رمز القلم). وإذا ظلت الإضافة تقول إن الإذن غير موجود فأعد تشغيل Studio.

لا يتصل Studio تلقائيًا

لا يتصل تلقائيًا إلا إذا كان Studio مسجّلًا بحساب Roblox نفسه المستخدم في RoCode، مع الإضافة 3.9.13 أو أحدث وrocode.app/chat مفتوح. إذا أظهرت الدردشة Connect Studio فاضغطه. وإلا فاستخدم كود الاقتران من لوحة RoCode أو اضغط هناك Use a pairing code.

الكود لا يُقبل

الكود صالح 15 دقيقة ويعمل مرة واحدة، لذا أدخل الكود الذي تعرضه لوحة RoCode الآن. ولا يحتوي أبدًا على I وL وO و0 و1.

أدخلت الكود لكن Studio ما زال غير متصل

انظر إلى لوحة RoCode في Studio: هناك سطر تأكيد بحسابك، اضغط Connect (أو Allow). إذا لم يؤكد أحد خلال دقيقتين ستعرض اللوحة كودًا جديدًا.

دخلت عبر Roblox فاختفت خطتي أو محادثاتي

الدخول عبر Roblox لا يرتبط بحساب RoCode موجود، لذا فهو حساب منفصل. اخرج وادخل كالمعتاد، بكود على البريد أو عبر Google أو Discord.

أستخدم Brave ولا أستطيع الاتصال

تحجب Brave Shields الاتصال بـ Studio. عطّل Shields لموقع rocode.app أو استخدم Chrome أو Edge.

يظهر سكربت RoCodePermissionCheck باستمرار في ServerStorage

هذا متوقع. كل 30 ثانية تضيف الإضافة سكربتًا مؤقتًا هناك وتحذفه، لتفحص إذن Script Injection.

توقف التشغيل في المنتصف

تبقى التغييرات التي أُجريت. اضغط Continue للمتابعة. وإذا توقف عند حد الأرصدة للتشغيل الواحد فيمكنك ضغط Finish up.

الحفظ في DataStore لا يعمل في Studio

فعّل Enable Studio Access to API Services في File > Experience Settings > Security واضغط Save. يجب نشر المكان أولًا، ولا يستطيع RoCode تغيير هذا الإعداد. افعل ذلك في نسخة اختبار منفصلة.

كل الحالات في التوثيق الإنجليزي.

الخطط

الخطط بالدولار الأمريكي دون الضرائب
الخطةشهريًاسنويًاالأرصدةالنماذج
Starter (مجانًا)مجانًا، دون بطاقةلا1 يوميًا، يتجدد في 00:00 UTCGPT-6 Luna
Pro$9.99$83.99150 شهريًايضيف GLM 5.3 Flash وClaude Sonnet 5.5
Studio (نوصي بها)$19.99$167.99320 شهريًايضيف Claude Opus 5.5
Ultra$29.99$251.99500 شهريًايضيف GPT-6 Astra
  • في كل خطة كل الأدوات الـ 27. تضيف الخطط المدفوعة نماذج، ومفتاح OpenRouter الخاص بك، وغياب الحد اليومي، وتسبق تشغيلاتها في الطابور تشغيلات Starter.
  • لا تحتاج إلى Discord للأرصدة المجانية ولا للدفع.
  • الخطط السنوية أرخص بنسبة 30% من 12 شهرًا في الخطة الشهرية، وتُدفع مرة في السنة، والأرصدة نفسها وتتجدد كل 30 يومًا.
  • تتولى Paddle الدفع بصفتها البائع (merchant of record): تستلم الدفعة، وتحتسب الضريبة أو ضريبة القيمة المضافة، وتصدر الفاتورة.
  • إذا كان عمرك أقل من 18 عامًا فاسأل صاحب البطاقة قبل الشراء. يمكنك الإلغاء من صفحة الحساب؛ وتبقى الخطة حتى نهاية الفترة المدفوعة.
  • الاسترداد: كاملًا خلال 14 يومًا من أي دفعة، بما في ذلك التجديدات وحزم الأرصدة، لأي سبب وأينما كنت تعيش. يمكنك طلبه على paddle.net أو بالرد على إيصال Paddle. بعد الاسترداد تُعلَّق الخطط الجديدة والترقيات والحزم مدة 60 يومًا، وتُسحب الأرصدة التي اشتُريت بتلك الدفعة. بعد 14 يومًا لا تُسترد الدفعات، إلا حين يشترط القانون ذلك.

الترقية والتخفيض والمقارنة الكاملة في صفحة الأسعار (بالإنجليزية).

الأسئلة الشائعة

هل صنعت شركة Roblox برنامج RoCode؟

لا. RoCode منتج مستقل. لا يرتبط بشركة Roblox Corporation، ولا تعتمده ولا ترعاه، ولا علاقة له بـ Roblox Assistant.

هل يجب أن أتصل في كل مرة أفتح فيها Studio؟

لا. مع الإضافة 3.9.13 أو أحدث يتصل Studio تلقائيًا إذا كان مسجّلًا بحساب Roblox نفسه المستخدم في RoCode. وإلا فتُدخل كود الاقتران مرة واحدة: تحفظ الإضافة مفتاح الاتصال في إعدادات إضافات Studio وتعيد الاتصال تلقائيًا بعد ذلك، في أي مكان على هذا الحاسوب.

ما هو وضع Ask؟

الوضع الثاني في حقل إدخال RoCode، بجانب Build. يجيب Ask عن أسئلة حول اللعبة دون تغيير أي شيء: لا يستخدم إلا 10 أدوات للقراءة، مثل Read Script وSearch Scripts وCheck Output، وتُرفض أي أداة كانت ستغيّر المكان. ويحتاج هو أيضًا إلى Studio متصل.

هل يمكن تنزيل RoCode؟

لا يوجد تطبيق سطح مكتب. RoCode دردشة ويب على rocode.app مع إضافة مجانية من Roblox Creator Store.

هل يمكن الكتابة لـ RoCode بالعربية؟

نعم. الدردشة والإضافة والتوثيق الإنجليزي باللغة الإنجليزية، لكن يمكنك كتابة الطلبات بالعربية، وعادة يرد RoCode بها. وتبقى بعض الرسائل وكل الأزرار بالإنجليزية.

هل يضغط RoCode على Play أو ينشر اللعبة؟

في وضع Build مع الإضافة 3.9 أو أحدث يستطيع ضغط Play لاختبار لعب قصير، ومع 3.9.11 أو أحدث يتحكم في شخصية اختبار؛ وAsk لا يفعل ذلك أبدًا. ولا ينشر المكان ولا يحفظه أبدًا. أنت من ينشر.

هل يمكن استخدام مفتاح OpenRouter الخاص بي في الخطة المجانية؟

لا. مفتاح OpenRouter الخاص بك مشمول في كل خطة مدفوعة. وتستخدم Starter نموذج GPT-6 Luna مع رصيد واحد يوميًا.

أين أحصل على المساعدة؟

في Discord الخاص بـ RoCode. اكتب ما جربته وما تعرضه الدردشة أو لوحة الإضافة.

المصادر والقراءات

جرّب RoCode على لعبتك أنت.

رصيد مجاني كل يوم ودون بطاقة. ثبّت الإضافة، وصف الميزة، وراجع ما يظهر في Studio.