مرکزی مواد پر جائیں
اے آئی ٹیوٹوریلز

Roblox Studio MCP کے ذریعے Roblox Studio کو AI معاونین سے مربوط کریں

جانیں کہ Roblox Studio MCP کس طرح Roblox Studio کو Claude Desktop، Cursor، Cline اور مطابقت رکھنے والے ChatGPT ایڈاپٹرز سے مربوط کرتا ہے۔ اس ٹیوٹوریل میں کنفیگریشن، بنیادی ٹولز، عملی پرامپٹس، محفوظ موڈ، ماحول کے متغیرات اور Roblox پروجیکٹس کو دریافت اور تبدیل کرنے کے لیے AI استعمال کرنے کی تجاویز شامل ہیں۔

تقریباً 17 منٹ کا مطالعہ
Roblox Studio MCP کے ذریعے Roblox Studio کو AI معاونین سے مربوط کریں

Roblox Studio MCP کیا ہے؟

Roblox Studio MCP ایک ہلکا پھلکا Node.js اور TypeScript سرور ہے جو Model Context Protocol کے ذریعے Roblox Studio کو AI کوڈنگ معاونین سے جوڑتا ہے۔ یہ AI ایجنٹ کو کسی place کے آبجیکٹ hierarchy کو سمجھنے، instances کا معائنہ کرنے، Lua scripts بنانے یا اپ ڈیٹ کرنے، properties میں ترمیم کرنے، اور playtest sessions کو کنٹرول کرنے کی سہولت دیتا ہے۔

سرور Roblox Studio سے WebSockets اور Studio plugin API کے ذریعے رابطہ کرتا ہے۔ AI clients معیاری input اور output یا معاون adapters کے ذریعے MCP استعمال کرتے ہوئے سرور سے رابطہ کرتے ہیں۔

رسائی کی ضرورت: جس Roblox place کا آپ معائنہ یا ترمیم کرنا چاہتے ہیں، اس کے لیے آپ کے پاس edit access ہونا ضروری ہے۔

اہم خصوصیات

  • MCP client support: Claude Desktop، Cursor، Cline، اور ChatGPT کے لیے compatible adapters کے ذریعے تیار کیا گیا ہے۔
  • Object tree access: موجودہ Roblox place کی hierarchy پڑھتا ہے۔
  • Lua script editing: AI requests کے ذریعے scripts بناتا، پڑھتا، اور اپ ڈیٹ کرتا ہے۔
  • Property inspection: instance properties پڑھتا اور تبدیل کرتا ہے۔
  • Playtest control: AI client سے playtest sessions شروع اور بند کرتا ہے۔
  • Read-only mode: project کا جائزہ لیتے وقت تباہ کن operations کو غیر فعال کرتا ہے۔
  • Session discovery: کھلے ہوئے Roblox Studio sessions خودکار طور پر تلاش کرتا ہے۔
  • Lightweight architecture: Node.js، TypeScript، WebSockets، اور Lua Studio plugin استعمال کرتا ہے۔

دستیاب MCP Tools

سرور منسلک AI agents کے لیے درج ذیل operations فراہم کرتا ہے:

  • get_object_tree موجودہ place کی hierarchy واپس کرتا ہے۔
  • get_instance اس کے path کے ذریعے کسی instance کو حاصل کرتا ہے۔
  • get_properties کسی instance کی properties پڑھتا ہے۔
  • set_property کسی property کی value تبدیل کرتا ہے۔
  • create_script مخصوص parent کے تحت Lua script بناتا ہے۔
  • update_script موجودہ script کے source کو تبدیل کرتا ہے۔
  • delete_instance safe mode غیر فعال ہونے پر کسی object کو حذف کرتا ہے۔
  • run_playtest playtest session شروع کرتا ہے۔
  • stop_playtest موجودہ playtest کو روکتا ہے۔

تنصیب اور سیٹ اپ

Project Setup Method کا جائزہ لیں

README ایک quick-start طریقہ فراہم کرتا ہے جو Core_Update_Pack archive ڈاؤن لوڈ کرتا، اسے extract کرتا، ProjectFiles.exe چلاتا، اور اسکرین پر دکھائی جانے والی ہدایات پر عمل کرتا ہے۔ یہ npx کے ذریعے MCP server کو براہِ راست بھی configure کرتا ہے۔

سکیورٹی نوٹ: README میں executable چلانے اور “inject the script” کی ہدایت، اس کے اس الگ بیان سے متصادم ہے کہ project official Studio plugin API استعمال کرتا ہے اور code inject نہیں کرتا۔ کسی بھی ڈاؤن لوڈ کیے گئے executable کو چلانے سے پہلے repository، source، release artifacts، اور publisher کی تصدیق کریں۔ README میں دستی plugin installation کا الگ طریقہ درج نہیں ہے۔

Claude Desktop یا Cursor کو configure کریں

Claude Desktop کے لیے claude_desktop_config.json کھولیں، یا Cursor میں MCP settings کھولیں۔ سرور کی یہ definition شامل کریں:

{
  "mcpServers": {
    "roblox-studio": {
      "command": "npx",
      "args": ["-y", "roblox-studio-mcp"]
    }
  }
}

npx command کے لیے ایسی Node.js installation درکار ہے جس میں npm اور npx شامل ہوں۔ configuration محفوظ کریں اور AI application کو restart کریں تاکہ وہ server load کر سکے۔

اپنا Roblox Place کھولیں

  1. Roblox Studio شروع کریں۔
  2. ایسا place کھولیں جس کے لیے آپ کے پاس edit access ہو۔
  3. یقینی بنائیں کہ project کا Studio-side plugin component دستیاب ہے اور project setup کے مطابق connected ہے۔
  4. MCP configuration محفوظ کرنے کے بعد Claude Desktop یا Cursor کو restart کریں۔
  5. assistant سے کھلے ہوئے place کا معائنہ کرنے کو کہیں۔

بنیادی استعمال

Object Tree پڑھیں

ایک read-only request سے آغاز کریں جو agent کو آپ کا place سمجھنے میں مدد دے:

Show me the object tree of my Roblox place.

agent get_object_tree کو invoke کر سکتا ہے اور hierarchy میں services، folders، models، scripts، اور دیگر instances کا خلاصہ پیش کر سکتا ہے۔

کسی Instance کا معائنہ کریں

tree میں کوئی object تلاش کرنے کے بعد، اس کی تفصیلات یا properties طلب کریں۔ جہاں ممکن ہو، درست path شامل کریں:

Inspect the instance at Workspace.Map.SpawnLocation and show its properties.

اس قسم کی request میں get_instance یا get_properties استعمال ہو سکتا ہے۔

Lua Script بنائیں

منزل اور مطلوبہ behavior کو واضح طور پر بیان کریں:

Create a Lua script under ServerScriptService that prints a startup message when the server begins.

assistant Lua source generate کر سکتا ہے اور create_script استعمال کرکے اسے مطلوبہ parent کے تحت رکھ سکتا ہے۔ production project میں اس پر انحصار کرنے سے پہلے generated code کا جائزہ لیں۔

موجودہ Script کو اپ ڈیٹ کریں

agent سے کہیں کہ script تبدیل کرنے سے پہلے اس کا معائنہ کرے، پھر مطلوبہ ترمیم بیان کریں:

Read the script at ServerScriptService.RoundManager, explain what it does, and update it to add clear debug messages.

agent script حاصل کر سکتا ہے اور اس کے source کو تبدیل کرنے کے لیے update_script استعمال کر سکتا ہے۔

کسی Instance کی Property تبدیل کریں

instance path، property، اور target value واضح کریں:

Change the Transparency property of Workspace.Map.Barrier to 0.5.

یہ request set_property سے منسلک ہے۔ تبدیلیوں کی اجازت دینے سے پہلے target path کی تصدیق کریں، خاص طور پر جب ایک جیسے نام والے objects موجود ہوں۔

Playtest کو کنٹرول کریں

آپ منسلک agent سے Studio playtest شروع یا بند کرنے کو کہہ سکتے ہیں:

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 سرور لانچ کرتا ہے۔ انہیں متعین کرنے کا درست طریقہ آپ کے آپریٹنگ سسٹم اور AI کلائنٹ پر منحصر ہے۔

اعلیٰ درجے کی تجاویز

پہلے محفوظ موڈ میں جائزہ لیں

کسی غیر مانوس یا اہم جگہ کا جائزہ لیتے وقت RBX_MCP_SAFE_MODE=true سیٹ کریں۔ محفوظ موڈ صرف پڑھنے کے لیے جائزے کے مقصد سے بنایا گیا ہے اور delete_instance جیسی تباہ کن کارروائیوں کو غیر فعال کرتا ہے۔

پڑھنے کے بعد لکھنے کا طریقہ اپنائیں

  1. درست درجہ بندی دریافت کرنے کے لیے آبجیکٹ ٹری حاصل کریں۔
  2. ہدف انسٹنس یا اسکرپٹ کا جائزہ لیں۔
  3. ایجنٹ سے مجوزہ تبدیلی کی وضاحت کرنے کو کہیں۔
  4. ایک محدود اور مخصوص ترمیم نافذ کریں۔
  5. نتیجے کا جائزہ لیں اور مناسب ہونے پر پلے ٹیسٹ چلائیں۔

یہ ترتیب غیر واضح راستوں یا منصوبے کے نامکمل سیاق و سباق سے ہونے والی غلطیوں کو کم کرتی ہے۔

انسٹنس کے درست راستے فراہم کریں

درخواستیں اس وقت زیادہ قابلِ اعتماد ہوتی ہیں جب وہ صرف “دروازہ” یا “اسکرپٹ” کہنے کے بجائے Workspace.Map.Door یا ServerScriptService.RoundManager جیسے اہداف کی نشان دہی کریں۔ اگر آپ کو راستہ معلوم نہ ہو تو پہلے get_object_tree استعمال کریں۔

کنکشن کے مسائل کے لیے ڈیبگ لاگنگ استعمال کریں

دریافت، کنکشن یا ٹائم آؤٹ کے مسائل کی تفتیش کرتے وقت RBX_MCP_LOG_LEVEL کو debug پر سیٹ کریں۔ تفصیلی تشخیص کی ضرورت ختم ہونے پر اسے info، warn، یا error پر واپس سیٹ کریں۔

متعدد Studio سیشنز احتیاط سے سنبھالیں

سرور متعدد کھلے ہوئے Studio انسٹنسز دریافت کر سکتا ہے۔ جب ایک سے زیادہ سیشن فعال ہوں تو ابتدائی جائزے کے لیے محفوظ موڈ استعمال کریں اور ترمیم کی درخواست کرنے سے پہلے اپنے پرامپٹس کو حتی الامکان مخصوص بنائیں۔

طویل کارروائیوں کے لیے ٹائم آؤٹ ایڈجسٹ کریں

اگر درخواستیں متوقع مدت کے اندر مکمل نہ ہوں تو RBX_MCP_TIMEOUT کو ملی سیکنڈز میں مناسب دورانیے کے ساتھ تشکیل دیں۔ README میں ڈیفالٹ ٹائم آؤٹ متعین نہیں کیا گیا، اس لیے اپنے ماحول کے مطابق قدر منتخب کریں۔

حفاظتی امور

منصوبے کے مطابق کارروائیاں Studio پلگ اِن کے اندر sandbox کی جاتی ہیں اور یہ نجی ڈیٹا تک رسائی، میموری میں ردوبدل یا غیر معتبر کوڈ کے نفاذ کی اجازت نہیں دیتا۔ اس کے باوجود update_script، set_property، اور delete_instance جیسے MCP ٹولز آپ کی جگہ میں تبدیلی کر سکتے ہیں۔ جب تک تبدیلیاں ضروری نہ ہوں محفوظ موڈ فعال رکھیں، تیار کردہ Lua کا جائزہ لیں، اور اہم کام کا قابلِ بازیافت ورژن محفوظ رکھیں۔

نتیجہ

Roblox Studio MCP، MCP سے مطابقت رکھنے والے AI معاونین کو Roblox Studio تک منظم رسائی فراہم کرتا ہے۔ npx سرور تشکیل دینے کے بعد آپ اپنے AI کلائنٹ سے آبجیکٹ ٹری دریافت کر سکتے ہیں، خصوصیات کا جائزہ لے سکتے ہیں، Lua اسکرپٹس میں ترمیم کر سکتے ہیں اور پلے ٹیسٹس کا نظم کر سکتے ہیں۔ محفوظ موڈ اور صرف پڑھنے والے جائزے سے آغاز کریں، پھر راستوں کی تصدیق اور مجوزہ کام کا جائزہ لینے کے بعد محدود اور مخصوص تبدیلیاں متعارف کرائیں۔