सभी एआई टूल (Tool Reference)
Gamedev AI में 34 बिल्ट-इन टूल्स हैं जिन्हें AI बातचीत के दौरान स्वायत्त रूप से कॉल कर सकता है। ये टूल्स "मैकेनिकल आर्म" हैं जो AI को सीधे Godot इंजन के साथ बातचीत करने की अनुमति देते हैं, और प्रत्येक को श्रेणियों द्वारा समूहबद्ध किया गया है।
🔧 स्क्रिप्ट्स (कोड निर्माण और संपादन)
create_script
दिए गए पथ पर प्रदान की गई सामग्री के साथ एक नई GDScript फ़ाइल (.gd) बनाता है। एआई इस टूल का उपयोग स्क्रैच से स्क्रिप्ट बनाने के लिए करता है।
- पैरामीटर्स:
path(res://...),content(पूर्ण GDScript कोड)
edit_script
एक मौजूदा स्क्रिप्ट की पूरी सामग्री को नए संस्करण के साथ बदल देता है। एआई पहले फ़ाइल पढ़ता है ताकि यह सुनिश्चित हो सके कि उसके पास नवीनतम संस्करण है।
- पैरामीटर्स:
path,content - ⚠️ विशिष्ट छोटे सुधारों के लिए
patch_scriptके पक्ष में अप्रचलित (Deprecated).
patch_script
विशिष्ट संशोधन (Surgical Edit): स्क्रिप्ट में एक सटीक कोड ब्लॉक खोजता है और पूरी फ़ाइल को फिर से लिखे बिना केवल उस हिस्से को नई सामग्री से बदल देता है। छोटे सुधारों के लिए आदर्श।
- पैरामीटर्स:
path,search_content(खोजने के लिए सटीक ब्लॉक),replace_content(नया ब्लॉक)
replace_selection
Godot स्क्रिप्ट एडिटर में वर्तमान में चयनित टेक्स्ट को बदल देता है। त्वरित कार्रवाई बटनों (Refactor, Fix, Explain) के साथ काम करता है।
- पैरामीटर्स:
text(चयन को बदलने के लिए नया कोड)
view_file_outline
पूर्ण कोड के बिना स्क्रिप्ट की संरचना लौटाता है: class_name, extends, फ़ंक्शंस, सिग्नल, एक्सपोर्ट्स, एनम्स, इनर क्लासेस और लाइन नंबरों के साथ स्थिरांक (Constants)।
- पैरामीटर्स:
path
🌳 नोड्स (सीन ट्री हेरफेर)
add_node
एडिटर में खुले दृश्य (Scene) में एक नया नोड जोड़ता है। किसी भी Godot नोड प्रकार (Node2D, CharacterBody3D, Label, Button आदि) को बना सकता है।
- पैरामीटर्स:
parent_path(रूट के लिए.उपयोग करें),type(नोड क्लास),name,script_path(वैकल्पिक)
remove_node
वर्तमान सीन ट्री से नोड हटा देता है। उपयोगकर्ता से पुष्टि की आवश्यकता होती है क्योंकि यह एक विनाशकारी कार्रवाई है।
- पैरामीटर्स:
node_path
set_property
सीन नोड पर एक प्रॉपर्टी (Position, Size, Text, Color आदि) सेट करता है। संख्याओं, वैक्टर, रंगों और स्ट्रिंग्स को स्वीकार करता है।
- पैरामीटर्स:
node_path,property,value
set_theme_override
कंट्रोल नोड पर थीम ओवरराइड (फ़ॉन्ट आकार, फ़ॉन्ट रंग, स्टाइल) सेट करता है।
- पैरामीटर्स:
node_path,override_type(color/constant/font/font_size/stylebox),name,value
connect_signal
वर्तमान दृश्य में भेजने वाले नोड के सिग्नल को प्राप्त करने वाले नोड के मेथड से जोड़ता है।
- पैरामीटर्स:
source_path,signal_name,target_path,method_name,binds(वैकल्पिक),flags(वैकल्पिक)
disconnect_signal
दो नोड्स के बीच पहले से जुड़े सिग्नल को डिस्कनेक्ट करता है।
- पैरामीटर्स:
source_path,signal_name,target_path,method_name
attach_script
दृश्य में किसी नोड के साथ मौजूदा GDScript संलग्न करता है।
- पैरामीटर्स:
node_path,script_path
analyze_node_children
संपादित दृश्य में एक विशिष्ट नोड के सब-ट्री का विस्तृत डंप लौटाता है। गहरी पदानुक्रमों की खोज के लिए उपयोगी।
- पैरामीटर्स:
node_path,max_depth(डिफ़ॉल्ट: 5)
📂 फ़ाइलें और प्रोजेक्ट
read_file
किसी भी प्रोजेक्ट फ़ाइल की पूरी सामग्री पढ़ता है।
- पैरामीटर्स:
path
list_dir
प्रोजेक्ट निर्देशिका (Project Directory) की सामग्री सूचीबद्ध करता है।
- पैरामीटर्स:
path
find_file
नाम (Partial Match) के आधार पर प्रोजेक्ट फ़ाइल खोजता है।
- पैरामीटर्स:
pattern
remove_file
प्रोजेक्ट से कोई फ़ाइल या निर्देशिका हटा देता है। पुष्टि आवश्यक है।
- पैरामीटर्स:
path
move_files_batch
एक ही बैच ऑपरेशन में कई फ़ाइलों/निर्देशिकाओं को स्थानांतरित या नाम बदल देता है। सभी आंतरिक Godot संदर्भों (.tscn, .tres) को स्वचालित रूप से अपडेट करता है।
- पैरामीटर्स:
moves(डिक्शनरी जो पुराने पथों को नए पथों पर मैप करती है)
create_scene
एक नई दृश्य फ़ाइल (.tscn) बनाता है और उसे एडिटर में खोलता है।
- पैरामीटर्स:
path,root_type,root_name
instance_scene
वर्तमान दृश्य में किसी अन्य नोड के बच्चे के रूप में मौजूदा .tscn दृश्य को इंस्टेंटियेट (Instantiate) करता है।
- पैरामीटर्स:
parent_path,scene_path,name
create_resource
एक नई रिसोर्स फ़ाइल (.tres) बनाता है। आइटम, आँकड़े या कस्टम कॉन्फ़िगरेशन जैसे एसेट्स के लिए उपयोगी।
- पैरामीटर्स:
path,type,properties(वैकल्पिक)
🔍 खोज और विश्लेषण
grep_search
प्रोजेक्ट फ़ाइलों के भीतर टेक्स्ट खोजता है। पथ और लाइन नंबर के साथ मिली हुई पंक्तियाँ लौटाता है।
- पैरामीटर्स:
query,include(एक्सटेंशन फ़िल्टर, वैकल्पिक),max_results(डिफ़ॉल्ट: 20)
search_in_files
वेरिएबल्स, फ़ंक्शंस या विशिष्ट लॉजिक के लिए सभी प्रोजेक्ट .gd फ़ाइलों में Regex द्वारा खोजता है।
- पैरामीटर्स:
pattern(नियमित अभिव्यक्ति)
get_class_info
Godot क्लास (Engine या Custom) के बारे में विस्तृत जानकारी लौटाता है: बेस क्लास, प्रॉपर्टीज़, मेथड्स और सिग्नल।
- पैरामीटर्स:
class_name
capture_editor_screenshot
संपूर्ण Godot एडिटर विंडो का स्क्रीनशॉट लेता है और दृश्य विश्लेषण के लिए उसे अगले प्रॉम्प्ट के साथ स्वचालित रूप से जोड़ देता है।
🧠 मेमोरी और ज्ञान
save_memory
प्रोजेक्ट मेमोरी में एक स्थायी तथ्य सहेजता है, जो भविष्य के सभी चैट सत्रों में उपलब्ध होगा।
- पैरामीटर्स:
category(architecture/convention/preference/bug_fix/project_info),content
list_memories
इस प्रोजेक्ट के लिए सहेजे गए सभी स्थायी तथ्यों को सूचीबद्ध करता है।
delete_memory
अपनी आईडी के आधार पर एक विशिष्ट मेमोरी तथ्य को हटा देता है।
- पैरामीटर्स:
id
read_skill
प्रोग्रामिंग से पहले सर्वोत्तम प्रथाओं को सीखने के लिए एआई के आंतरिक पुस्तकालय से एक कौशल दस्तावेज़ फ़ाइल पढ़ता है।
- पैरामीटर्स:
skill_name
🗄️ वेक्टर डेटाबेस (RAG)
index_codebase
सिमेंटिक खोज के लिए संपूर्ण प्रोजेक्ट (.gd) को स्थानीय वेक्टर डेटाबेस में अनुक्रमित (Index) करता है। semantic_search का उपयोग करने से पहले इसे निष्पादित किया जाना चाहिए।
semantic_search
सटीक टेक्स्ट मिलान के बजाय अर्थ के आधार पर अत्यधिक प्रासंगिक कोड स्निपेट खोजने के लिए अनुक्रमित कोडबेस पर सिमेंटिक वेक्टर खोज करता है।
- पैरामीटर्स:
query
🧪 टेस्ट
run_tests
एक परीक्षण स्क्रिप्ट या कमांड निष्पादित करता है। GUT, GdUnit4 या कस्टम परीक्षण स्क्रिप्ट के साथ परिवर्तनों की जाँच के लिए उपयोगी।
- पैरामीटर्स:
test_script_path(वैकल्पिक)
🛡️ ऑडिटिंग (Auditing)
audit_scene
वर्तमान में खुली हुई सीन पर एक आर्किटेक्चरल ऑडिट करता है, जिसमें अनाथ नोड्स, गायब स्क्रिप्ट या प्रदर्शन चेतावनियों की तलाश की जाती है।
audit_script
खराब प्रथाओं, संभावित बग या सिंटैक्स चेतावनियों को पकड़ने के लिए एक विशिष्ट GDScript फ़ाइल पर एक स्थिर विश्लेषण ऑडिट करता है।
- पैरामीटर्स:
path