واجهة سطر أوامر الاستوديو | المراجع

يدعم استوديو Roblox وسائط سطر الأوامر التي تتيح لك فتحه مع وظائف خاصة، مثل فتح مكان أو نص معين عند بدء تشغيل الاستوديو. عادةً ما يتم تثبيت الملف التنفيذي لاستوديو Roblox في المواقع التالية:

نظام التشغيل	الموقع
ويندوز	%localappdata%\Roblox\Versions\[version]\RobloxStudioBeta.exe
ماك	/Applications/RobloxStudio.app/Contents/MacOS/RobloxStudio

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

أي وسائط غير موثقة هنا هي للاستخدام الداخلي فقط وقابلة للتغيير دون إشعار مسبق.

فتح مكان

لفتح مكان منشور، قم بتحديد معرف المكان، ومعرف الكون، ومهمة.

الوسائط المطلوبة

الوسيط	الوصف
--placeId <معرف_المكان>	معرف المكان الرقمي لفتحه.
--universeId <معرف_الكون>	الكون الذي يمتلك المكان.
--task <اسم_المهمة>	يحدد كيفية فتح الاستوديو للمكان بناءً على المهمة المحددة. راجع جدول المهام المدعومة أدناه لمزيد من المعلومات.

المهام المدعومة

الوسيط	الوصف
EditPlace	يفتح النسخة المنشورة الأخيرة من المكان للتعديل.
EditPlaceRevision	يفتح نسخة سابقة معينة من المكان. يحتاج إلى --placeVersion <رقم_النسخة> لتحديد النسخة.

الوسائط الاختيارية

الوسيط	الوصف
--targetInstanceId <guid>	ينقل كاميرا الاستوديو للتركيز على المثيل بهذا GUID بعد تحميل المكان.
--annotationId <guid>	يفتح التوضيح بهذا GUID بعد تحميل المكان.

أمثلة


# فتح النسخة الأخيرة من مكان
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708

# فتح نسخة سابقة معينة
RobloxStudio.exe --task EditPlaceRevision --placeId 74265016723074 --universeId 7127583708 --placeVersion 2

فتح ملف محلي

لفتح مكان محلي، استخدم --task EditFile مع الوسيط التالي.

الوسيط	الوصف
--localPlaceFile <المسار>	المسار المطلق إلى ملف مكان محلي .rbxl أو .rbxlx لفتحه.

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

أمثلة


# فتح ملف مكان محلي
RobloxStudio.exe --task EditFile --localPlaceFile "Projects\MyGame.rbxl"

# اختصار
RobloxStudio.exe "Projects\MyGame.rbxl"

فتح نص

لفتح نص، حدد معرف المكان، ومعرف الكون، ومهمة كما هو موضح في قسم فتح مكان. ثم قدم أحد الوسائط التالية حسب الطريقة التي تريد فتح النص بها.

الوسيط	الوصف
--openScriptPath <المسار>	المسار إلى النص. يجب استخدام / كفواصل واتباع دلالات require-by-string المطلقة.
--openScriptFromId <معرف_فريد>	معرف النص الفريد لفتحه.

تمييز اختياري

اختياريًا، يمكنك تمييز خطوط محددة أو مدى من الحروف عند فتح النص.

الوسيط	الوصف
--startLine <n>	خط البداية من مدى التمييز. يعتمد على 1 ويشمل.
--endLine <n>	خط النهاية من مدى التمييز. يعتمد على 1 ويستثني.
--startCharacter <n>	موضع الحرف الأول داخل الخط. يعتمد على 1.
--endCharacter <n>	موضع الحرف الأخير داخل الخط. يعتمد على 1 ويستثني.

أمثلة


# فتح نص عن طريق المسار
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript

# فتح نص عن طريق المعرف
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptFromId 604a6aa2-04cc-c820-09b3-a1dc0000537f

# فتح نص وتمييز خطوط محددة
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 5

# فتح نص وتمييز مدى الحروف
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 1 --startCharacter 1 --endCharacter 6

تشغيل نص

استخدم --task RunScript لتنفيذ نص Luau بعد انتهاء تحميل المكان. تعمل النصوص بنفس مستوى إذن شريط الأوامر في الاستوديو. يمكنك دمج ذلك مع --placeId و --universeId لتشغيل النص في تجربة معينة، أو --localPlaceFile لتشغيل النص في ملف مكان محلي. إذا تم حذف تلك الوسائط، يفتح الاستوديو نموذج القاعدة الفارغ الافتراضي ويعمل النص هناك.

الوسائط المطلوبة

الوسيط	الوصف
--runScriptFile <المسار>	المسار المطلق إلى ملف .lua أو .luau للتنفيذ.

الوسائط الاختيارية

الوسيط	الوصف
--outputFile <المسار>	المسار إلى ملف يتم كتابة إخراج النص فيه.
--quitAfterExecution	إذا تم تقديمها، يغلق الاستوديو بعد انتهاء تنفيذ النص.

أمثلة


# تشغيل نص في تجربة معينة والخروج عند الانتهاء
RobloxStudio.exe --task RunScript --placeId 74265016723074 --universeId 7127583708 --runScriptFile smokeTest.luau --outputFile out.log --quitAfterExecution

# تشغيل نص في القاعدة الافتراضية
RobloxStudio.exe --task RunScript --runScriptFile smokeTest.luau

تجربة أصل

استخدم --task TryAsset لإدراج أصل معين في نموذج قاعدة وفتحه للتعديل.

الوسائط المطلوبة

الوسيط	الوصف
--assetId <id>	معرف الأصل للإدراج.

مثال


RobloxStudio.exe --task TryAsset --assetId 53326

تفريغ API

استخدم --api، --fullApi، أو --apiV2 لكتابة واجهة API الخاصة بـ Roblox إلى ملف والخروج.

الوسيط	الوصف
--api <المسار>	يكتب API البرمجة بلغة Luau كـ JSON إلى الملف المحدد.
--fullApi <المسار>	يكتب واجهة API الكاملة كـ JSON إلى الملف المحدد.
--apiV2 <المسار>	يكتب واجهة API الكاملة كـ JSON في صيغة مخطط V2 إلى الملف المحدد.

أمثلة


RobloxStudio.exe --api "Desktop/output.json"

RobloxStudio.exe --fullApi "Desktop/output.json"

RobloxStudio.exe --apiV2 "Desktop/output.json"