Все инструменты ИИ (Tool Reference)
Gamedev AI имеет 34 встроенных инструмента, которые ИИ может вызывать автономно во время разговора. Эти инструменты являются «механической рукой», позволяющей ИИ напрямую взаимодействовать с движком Godot, и каждый из них описан ниже, сгруппированный по категориям.
🔧 Скрипты (Создание и редактирование кода)
create_script
Создает новый файл GDScript (.gd) в указанном пути с заданным содержанием. ИИ использует этот инструмент для генерации скриптов с нуля.
- Параметры:
path(res://...),content(полный код GDScript)
edit_script
Заменяет все содержимое существующего скрипта новой версией. ИИ сначала читает файл, чтобы убедиться, что у него самая последняя версия.
- Параметры:
path,content - ⚠️ Устарело в пользу
patch_scriptдля небольших локальных исправлений.
patch_script
Точечное редактирование (Surgical Edit): ищет точный блок кода внутри скрипта и заменяет только эту часть новым содержимым, не переписывая весь файл. Идеально для небольших исправлений.
- Параметры:
path,search_content(точный блок для поиска),replace_content(новый блок)
replace_selection
Заменяет текущий выделенный текст в редакторе скриптов Godot. Работает в тандеме с кнопками быстрого действия (Refactor, Fix, Explain).
- Параметры:
text(новый код для замены выделения)
view_file_outline
Возвращает структуру скрипта без полного кода: class_name, extends, функции, сигналы, экспорты, перечисления (Enums), внутренние классы и константы с номерами строк.
- Параметры:
path
🌳 Узлы (Работа с деревом сцены)
add_node
Добавляет новый узел в открытую в данный момент сцену в редакторе. Может создавать любой тип узлов Godot (Node2D, CharacterBody3D, Label, Button и т.д.).
- Параметры:
parent_path(используйте.для корня),type(класс узла),name,script_path(опционально)
remove_node
Удаляет узел из текущего дерева сцены. Требует подтверждения пользователя, так как это деструктивное действие.
- Параметры:
node_path
set_property
Устанавливает свойство (Property) узла сцены (Position, Size, Text, Color и т.д.). Принимает числа, векторы (Vectors), цвета и текст.
- Параметры:
node_path,property,value
set_theme_override
Устанавливает переопределение темы (Theme Override) в узле управления Control (размер шрифта, цвет шрифта, стиль).
- Параметры:
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
Выводит содержимое директории проекта.
- Параметры:
path
find_file
Ищет файл проекта по имени (частичное совпадение).
- Параметры:
pattern
remove_file
Удаляет файл или директорию из проекта. Требует подтверждения.
- Параметры:
path
move_files_batch
Перемещает несколько файлов/директорий или переименовывает их за одну пакетную операцию. Автоматически обновляет все внутренние ссылки Godot (.tscn, .tres).
- Параметры:
moves(словарь, связывающий старые пути с новыми)
create_scene
Создает новый файл сцены (.tscn) и открывает его в редакторе.
- Параметры:
path,root_type,root_name
instance_scene
Создает экземпляр (Instantiate) существующей сцены .tscn как дочерний узел другого узла в текущей сцене.
- Параметры:
parent_path,scene_path,name
create_resource
Создает новый файл ресурса (.tres). Полезно для таких ассетов, как предметы, статы или пользовательские конфигурации.
- Параметры:
path,type,properties(опционально)
🔍 Поиск и анализ
grep_search
Ищет текст внутри файлов проекта. Возвращает найденные строки вместе с путем и номером строки.
- Параметры:
query,include(фильтр расширений, опционально),max_results(по умолчанию: 20)
search_in_files
Ищет переменные, функции или конкретную логику через Regex во всех файлах .gd в проекте.
- Параметры:
pattern(регулярное выражение)
get_class_info
Возвращает подробную информацию о классе Godot (движка или пользовательском): базовый класс, свойства, методы и сигналы.
- Параметры:
class_name
capture_editor_screenshot
Делает скриншот всего окна редактора Godot и автоматически прикрепляет его к следующему запросу для визуального анализа.
🧠 Память и знания
save_memory
Сохраняет постоянный факт в памяти проекта, который будет доступен во всех будущих сессиях чата.
- Параметры:
category(architecture/convention/preference/bug_fix/project_info),content
list_memories
Выводит список всех сохраненных постоянных фактов для этого проекта.
delete_memory
Удаляет конкретный факт памяти по его идентификатору (ID).
- Параметры:
id
read_skill
Читает файл документа навыка из внутренней библиотеки ИИ, чтобы изучить лучшие практики перед программированием.
- Параметры:
skill_name
🗄️ Векторная база данных (RAG)
index_codebase
Индексирует весь проект (.gd) в локальную векторную базу данных для семантического поиска. Должно быть выполнено перед использованием semantic_search.
semantic_search
Выполняет семантический векторный поиск по проиндексированной кодовой базе, ища релевантные фрагменты кода на основе смысла, а не просто точного совпадения текста.
- Параметры:
query
🧪 Тесты (Tests)
run_tests
Выполняет тестовый скрипт или команду. Полезно для проверки изменений с помощью GUT, GdUnit4 или пользовательских тестовых скриптов.
- Параметры:
test_script_path(необязательно)
🛡️ Аудит (Auditing)
audit_scene
Выполняет архитектурный аудит текущей открытой сцены, ища потерянные узлы, отсутствующие скрипты или предупреждения о производительности.
audit_script
Выполняет статический анализ конкретного файла GDScript для выявления плохих практик, потенциальных ошибок или предупреждений синтаксиса.
- Параметры:
path