محرر السكربت في الاستوديو هو الأداة الرئيسية للبرمجة على Roblox. إنه بيئة تتحسن ذاتيًا يمكن أن تساعدك في كتابة كود ذو تأثير كبير، وتقليل وقت التطوير، والتكرار على ألعابك. يمكن أن يحسن تجربة البرمجة الخاصة بك من خلال:
- تنسيق وتظليل بناء الجملة في كودك.
- تقديم طرق لـ الإكمال التلقائي للعبارات في كودك أثناء الكتابة.
- مساعدتك في التنقل في الكود من خلال الانتقال إلى إعلانات المتغيرات والدوال.
- مساعدتك في البحث والاستبدال للكود في السكربتات المفتوحة أو جميع السكربتات.
- توفير ملاحظات فورية حول جودة الكود وأدائه.
يدعم محرر السكربت جميع أنواع السكربتات ويفتح تلقائيًا عند إنشاء سكربت جديد أو النقر المزدوج على سكربت موجود في نافذة المستكشف.
يمكنك تخصيص محرر السكربت ليتناسب مع تفضيلاتك وسير العمل الخاص بك، بما في ذلك عائلة/حجم الخط، سلوك التنسيق، والألوان لتظليل بناء الجملة. يمكنك أيضًا تبديل ميزات مثل الإكمال التلقائي وتحليل السكربت.
ميزات الإكمال التلقائي
تولد ميزات الإكمال التلقائي في محرر السكربت معلومات متعلقة بالكود يمكن أن تحسن من كفاءة البرمجة الخاصة بك، مثل:
اقتراحات مستنيرة حول كيفية إكمال العبارات أثناء كتابتها والتي تكون سياقية لنموذج بيانات اللعبة data model. على سبيل المثال، إذا كان لديك Model في Workspace يسمى RocketShip، فإن الإكمال التلقائي يقترح RocketShip عندما تكتب workspace.roc ويشير إلى أنه Model.
استخدم مفاتيح ↑ و↓ لتصفح الاقتراحات، ثم اضغط على Tab أو Enter لقبول اقتراح وإدراج العبارة الكاملة.
ملء تلقائي للأسماء للمتغيرات والدوال التي تعلنها، مما يساعدك على تجنب الأخطاء المزعجة.
نوافذ توثيق منبثقة مع عينات كود مشابهة لتلك الموجودة في مرجع API للمحرك، مما يمنحك سياقًا حول استخدام API.
تلميحات عند التحويم يمكنك تخصيصها مع توثيقك الخاص المحدد.
تشخيصات تحليل السكربت عند التحويم مع معلومات يمكنك استخدامها لاستكشاف الأخطاء وإصلاحها.
توقيعات الدوال عندما تكتب حجة، مما يوفر لك مرجعًا لوسائطها وقيم الإرجاع.
تنقل الكود
الانتقال إلى الإعلان
يمكنك الانتقال إلى إعلان دالة أو متغير من خلال الضغط على Ctrl على Windows أو ⌘ على Mac عند النقر على الاستدعاء، أو من خلال النقر بزر الماوس الأيمن على استدعائه والنقر على الانتقال إلى الإعلان.
فلتر دالة السكربت
يعرض فلتر دالة السكربت قائمة بجميع الدوال المعلنة في السكربت. لفتحه، اضغط على AltF على Windows أو ⌥F على Mac. مع فتح القائمة، يمكنك تصفح التوقيعات لكل دالة، والتصفية من خلالها حسب الاسم، والنقر المزدوج على واحدة للانتقال إلى إعلانها.
البحث والاستبدال
تتيح لك أداة البحث/الاستبدال العثور على كود واستبداله في سكربت مفتوح. تدعم الأداة مطابقة الحالة، ومطابقة الكلمة الكاملة، والبحث بواسطة التعبيرات العادية. لفتحها، اضغط على CtrlF على Windows أو ⌘F على Mac.
للبحث الأوسع، تتيح لك نافذة البحث عن الكل / استبدال الكل العثور على/استبدال الكود عبر سكربتات متعددة في اللعبة. لفتحها، اضغط على CtrlShiftF على Windows أو ⌘ShiftF على Mac.
ملاحظات فورية
تحليل السكربت
تقوم نافذة تحليل السكربت، التي يمكن الوصول إليها من خلال زر التحليل في شريط أدوات علامة السكربت في الاستوديو، بإجراء تحليل ثابت على سكربتاتك وتعرض الأخطاء والتحذيرات النشطة. لمزيد من المعلومات حول الأخطاء والتحذيرات، راجع توثيق تحليل Luau.
الإخراج
تعرض نافذة الإخراج الأخطاء الملتقطة من تشغيل السكربتات، والرسائل من محرك Roblox، والرسائل من الاستدعاءات إلى print()، والأخطاء من الاستدعاءات إلى warn().
مساعدة الكود
مساعدة الكود هي ميزة تقترح أسطرًا أو دوال كود أثناء الكتابة، مما يساعدك على البرمجة بشكل أكثر كفاءة والتركيز. بناءً على السياقات من تعليقك وكودك، سيتم تفعيل الاقتراحات بطريقتين:
- تلقائيًا عندما تتوقف على سطر لبضع ثوانٍ ولدى نموذج الذكاء الاصطناعي ما يكفي من السياق لاقتراح.
- يدويًا باستخدام الاختصار Alt∖ على Windows أو ⌥∖ على Mac.
اضغط على Tab لقبول اقتراح، أو تجاهله بالاستمرار في الكتابة. حاليًا، يحتاج سكربتك إلى احتواء على الأقل على بضع أسطر من الكود لتفعيل اقتراح.
تساعد مساعدة الكود في أتمتة المهام البرمجية الأساسية حتى تتمكن من التركيز على العمل الإبداعي، لكنها لا تقترح دائمًا كودًا مثاليًا (انظر القيود). لا يزال من مسؤوليتك مراجعة واختبار وتحديد ما إذا كان اقتراح الكود مناسبًا من الناحية السياقية.
تحسين الاقتراحات
للحصول على اقتراحات أكثر دقة وملاءمة، يُوصى بأن تتبع ممارسات البرمجة النظيفة، بغض النظر عن المساعدة، و:
- قسم كودك إلى دوال أصغر.
- استخدم أسماء سكربت وصفية تعكس النية العامة لما يفعله كل سكربت. على سبيل المثال، سمِّ سكربت SyncCustomSounds بدلاً من مجرد Sounds.
- عيّن أسماء وصفية للوسائط والدوال والسكربتات. على سبيل المثال، سمِّ جزءًا GreenSphere بدلاً من مجرد grs، أو سمِّ دالة generateSphere() بدلاً من gen(). يمكن أن تؤدي استخدام الدوال المسماة مقابل الدوال المجهولة أيضًا إلى إنتاج تلميحات أفضل.
- قم بتضمين تعليقات مكتوبة بشكل جيد comments تصف المهمة التي تقوم بتنفيذها وما يجب أن تكون المدخلات/المخرجات.
- ضع في اعتبارك تضمين بعض الاستدعاءات النموذجية مع النتائج المتوقعة في التعليقات.
- اقترح كيفية حل مشكلة، على سبيل المثال -- استخدم raycast.
- استخدم الاسم الدقيق للدالة أو المتغير الذي قمت بتعريفه، على سبيل المثال -- إنشاء 10 كائنات greenSphere بدلاً من -- إنشاء 10 كرات.
- إذا كنت مبرمجًا مبتدئًا، ابدأ بمشاريع أساسية مثل "اجعل اللاعب يقفز عندما يلمس الجزء" أو استخدم الأداة لتوليد مقتطفات كود صغيرة يمكنك توسيعها مع تقدم معرفتك.
القيود
تساعد الأداة في أتمتة المهام البرمجية الأساسية لكنها لا تقترح دائمًا كودًا مثاليًا. تشمل القيود المعروفة:
- لا يؤدي التفعيل اليدوي دائمًا إلى توليد اقتراح.
- يتم تعلم الاقتراحات بواسطة الآلة من مجموعة من الأكواد، وبالتالي يمكن أن تعكس بعض القيود للكود الذي تم تدريبها عليه. على سبيل المثال، قد لا تستخدم الاقتراحات واجهات برمجة التطبيقات الأحدث لصالح واجهات برمجة التطبيقات الأقدم، أو قد تستخدم Lua بدلاً من Luau.
- قد تولد الأداة معلومات غير صحيحة أو مضللة ليست مفيدة لغرضك.
- تحاول الفلاتر الداخلية حظر اللغة المسيئة، لكنها ليست شاملة تمامًا وهناك احتمال أن تولد الأداة معلومات مسيئة أو متحيزة.
- قد تكون الاقتراحات متشابهة أو مختلفة بين المستخدمين، حتى مع نفس المطالبات. ومع ذلك، لن يتم مشاركة كودك مع الآخرين.
- قد يكون الاقتراح غير مكتمل بسبب الطول المحدود للإخراج من نماذج التعلم.
- هناك حد يومي لعدد الاقتراحات، وبمجرد الوصول إلى الحد، لن تحصل على أي اقتراحات حتى اليوم التالي.
خصوصية الكود
حاليًا، لا تستخدم Roblox أي بيانات غير عامة لتدريب نماذج التعلم. تستخدم الأداة فقط مجموعة صغيرة من الأصول المجانية في السوق لضبط نماذج اللغة الكبيرة وقد اجتازت المجموعة فحوصات مختلفة لجودة وفلترة الأمان.
علاوة على ذلك، يتم توليد جميع الاقتراحات بواسطة نموذج الذكاء الاصطناعي ولا تنتقل من مستخدم إلى آخر. نظرًا لأن كودك لا يُستخدم لتدريب النموذج، فلن يتم اقتراحه لمستخدمين آخرين في مساعدة الكود، باستثناء حالة واحدة وهي الكود الذي يتم نشره في عناصر السوق المجانية.
المؤشر المتعدد
يدعم محرر السكربت استخدام مؤشرات متعددة لإجراء تعديلات في وقت واحد. يمكنك إضافة مؤشرات بناءً على احتياجاتك من خلال نقرة بالماوس أو اختصار لوحة المفاتيح. يُطلق على المؤشر الأول المؤشر الأساسي وتُسمى المؤشرات الإضافية المؤشرات الثانوية.
- التعديلات التي تقوم بها عند المؤشر الأساسي تُنسخ إلى المؤشرات الثانوية. كل تعديل يُحسب كإجراء واحد، لذا فإن التراجع/إعادة التراجع عن تعديل ينطبق على جميع المؤشرات.
- تظهر الأدوات مثل الإكمال التلقائي على المؤشر الأساسي ولكن ليس على المؤشرات الثانوية.
- تعمل جميع اختصارات لوحة المفاتيح القياسية لتحرير السكربت مع تحرير المؤشرات المتعددة، بما في ذلك تمييز الكود، وتبديل التعليقات، وحذف الأسطر.
تلخص الجدول التالي سير العمل الخاص بالمؤشرات المتعددة واختصاراتها.
| الأمر | Windows | Mac |
|---|---|---|
| إضافة/إزالة المؤشر في موقع الماوس | Alt + click | ⌥ + click |
| إزالة المؤشر الذي تم إضافته مؤخرًا | CtrlU | ⌘U |
| إضافة/تعديل المؤشر عند سحب الماوس | Alt + drag | ⌥ + drag |
| إضافة المؤشر فوق/تحت | CtrlAlt↑ / CtrlAlt↓ | ⌘⌥↑ / ⌘⌥↓ |
| إضافة المؤشر إلى التحديد المطابق التالي | CtrlD | ⌘D |
| إضافة المؤشر إلى كل تحديد مطابق | ShiftAltL | Shift⌥L |
| تحديد عمود/كتلة | ShiftAlt + drag | Shift⌥ + drag |
| تقسيم التحديدات إلى أسطر | ShiftAltI | Shift⌥I |
لإزالة جميع المؤشرات الثانوية، اخرج من تحرير المؤشرات المتعددة، وارجع إلى المؤشر الأساسي، اضغط على Esc.
إضافة مؤشرات
يمكنك إضافة مؤشرات باستخدام مجموعة من اختصارات لوحة المفاتيح وحركات الماوس. تندمج المؤشرات إذا كانت تشغل نفس المساحة، مثل إذا قمت بإضافة مؤشرات باستخدام مفاتيح الأسهم أو حذف جميع الأحرف بين المؤشرات.
في موقع الماوس
لإضافة مؤشر في موقع مؤشر الماوس:
اضغط على Alt على Windows أو ⌥ على Mac.
انقر حيث تريد إضافة المؤشر.
مع سحب الماوس
يمكنك سحب الماوس لإضافة مؤشر إلى تحديد، تقسيم تحديد متعدد الأسطر إلى أسطر، أو تحديد أعمدة وكتل من الكود/المسافات البيضاء.
لإضافة مؤشر إلى تحديد كود من خلال السحب:
اضغط على Alt على Windows أو ⌥ على Mac.
انقر واسحب الماوس فوق تحديد الكود.
فوق وتحت المؤشر الأساسي
لإضافة مؤشر مباشرة فوق أو تحت المؤشر الأساسي:
اضغط مع الاستمرار على CtrlAlt على Windows أو ⌘⌥ على Mac.
اضغط على الأسهم ↑ أو ↓.
إلى التحديدات المطابقة
يمكنك إضافة مؤشرات إلى جميع المطابقات لتحديد أو إلى المطابقة التالية/السابقة، ويمكنك أيضًا تبديل ما إذا كانت المطابقات حساسة لحالة الأحرف و/أو تطابق الكلمة الكاملة.
لإضافة مؤشر إلى جميع المطابقات لجزء محدد:
حدد الكود الذي تريد البحث عن مطابقتك له.
اضغط على ShiftAltL على Windows أو Shift⌥L على Mac.
إزالة المؤشرات
يمكنك إزالة المؤشرات باستخدام اختصارات لوحة المفاتيح التالية وحركات الماوس. بدلاً من ذلك، يمكنك الخروج من تحرير المؤشرات المتعددة بالضغط على Esc.
في موقع الماوس
لإزالة مؤشر:
اضغط مع الاستمرار على Alt على Windows أو ⌥ على Mac.
انقر على المؤشر الذي تريد إزالته.
الأكثر إضافة مؤخرًا
لإزالة المؤشر الذي تم إضافته مؤخرًا، اضغط على CtrlU على Windows أو ⌘U على Mac.
نسخ ولصق المؤشرات
يتضمن نسخ تحديد كود المؤشرات الموجودة فيه. يعتمد سلوك اللصق على عدد المؤشرات في المصدر وعدد المؤشرات في الوجهة:
- إذا كان عدد المؤشرات هو نفسه، فإن كل مؤشر تم نسخه يُلصق في كل مؤشر وجهة مطابق.
- إذا كان عدد المؤشرات مختلفًا، فإن كل مؤشر في الوجهة يتلقى اللصق بالكامل مع كل مؤشر تم نسخه كسطر جديد.
تنسيق عند الكتابة
سيؤدي الضغط على إدخال/عودة إلى إدخال كل مؤشر في السطر الجديد بالنسبة للسطر السابق. إذا بدأ السطر السابق بكتلة غير مكتملة، فسيحاول المنسق إكمالها.
إعدادات المحرر
تتوفر العديد من خيارات التخصيص عبر علامة محرر السكربت في إعدادات الاستوديو. تشمل الخيارات المعدلة بشكل شائع:
| الخيار | الوصف |
|---|---|
| الخط | نوع وحجم الخط للكود في المحرر. |
| عرض التبويب | عدد المسافات التي تمثل تباعد Tab. |
| استخدام المسافات للتباعد | إذا تم تمكينه، يتم إدراج مسافات تعادل عرض التبويب عند الضغط على Tab. |
| لف النص | إذا تم تمكينه، فإن الأسطر الأطول من الكود تلتف إلى السطر التالي. |
| إعداد لون محرر السكربت | إعداد لون لعناصر الكود، وألوان التحديد، والمزيد. بعد اختيار إعداد، يمكنك تعيين ألوان محددة لخيارات مثل لون التحديد ولون التعليق. |
اختصارات لوحة المفاتيح
يمتلك محرر السكربت الاختصارات التالية.
| الأمر | Windows | Mac |
|---|---|---|
| إغلاق السكربت | CtrlW | ⌘W |
| إعادة فتح آخر سكربت مغلق | CtrlShiftT | ⌘ShiftT |
| فتح سريع | CtrlP | ⌘P |
| عرض السكربت في المستكشف | CtrlAltK | ⌘⌥K |
| تكبير | Ctrl= | ⌘= |
| تصغير | Ctrl- | ⌘- |
| إعادة تعيين تكبير السكربت | Ctrl0 | ⌘0 |