1. Godot Engine이란?
Godot(고도)는 완전 무료 오픈소스 게임 엔진으로 Unity나 Unreal Engine처럼 게임을 만드는 도구이다.
ㄴ🌐공식 사이트: https://godotengine.org/ko/
Godot과 다른 엔진의 차이점:
- 무료 : 로열티 없음 (수익의 몇 % 가져가지 않음)
- 가볍다 : 설치 파일이 100MB 내외
- GDScript : Python과 비슷한 자체 스크립트 언어라 배우기 쉬움
- 2D/3D 모두 지원
💬고도엔진은 인디게임 개발자들 사이에서 빠르게 인기를 얻고 있는 엔진으로
특히, 2D기반의 소규모 프로젝트나 1인 개발자가 사용하기에 적합하다.
2. Cursor 란?
Cursor는 AI가 내장된 코드 에디터(Code Editor)로 Visual Studio Code 기반으로 만들어져서 전반적인 구성은 비슷하지만,
사용자가 자연어를 통해 AI에게 코드 작성을 할 수 있다는 것이 핵심이다.
ㄴ🌐공식 사이트: https://cursor.com/
Cursor의 주요 기능:
- 코드 자동완성 : 사용자가 뭘 만들려는지 파악해서 코드를 먼저 제안해줌
- 채팅으로 코딩 : "플레이어가 점프하는 기능 만들어줘"라고 말하면 코드를 작성해줌
- 오류 자동 수정 : 에러가 나면 왜 났는지 설명하고 고쳐줌
💬모든 코드를 직접 코딩하면서 게임을 만드는 것이 아니라 AI랑 같이 대화하면서 게임개발을 할 수 있다.
3. Godot + Cursor를 연동해야 하는 이유
🤔Godot 에디터 자체에도 스크립트 편집창이 있는데, 왜 굳이 Cursor를 쓸까?
Godot 내장 에디터의 한계:
- AI 지원 없음
- 자동완성이 기본 수준
- 오류 설명 없음
Cursor와 연동하면:
- GDScript 코드를 AI가 실시간으로 도와줌
- "이 함수가 뭐 하는 건지 설명해줘"가 가능
- 초보자도 막히지 않고 개발 진행 가능
💬한마디로 "개발자를 24시간 옆에 두고 게임을 개발한다"라고 생각하면 이해가 쉽다.
4. 연동하는 방법
Step 1 : Cursor 설치
cursor.com/ 에서 다운로드 후 설치
Step 2 : Cursor에서 Godot 프로젝트 폴더 열기
Cursor 실행 → File → Open Folder → Godot 프로젝트 폴더 선택
Godot 프로젝트 폴더 전체(루트)를 열면 .gd 파일들을 확인할 수 있다.
Step 3 : .cursorrules 파일 설정
프로젝트 루트 폴더에 .cursorrules 파일을 만들자.
이게 "AI한테 Godot 전문가처럼 행동해"라고 지시하는 파일이다.
GitHub에서 이미 만들어진 Godot용 .cursorrules 파일을 받을 수 있으므로
👉 github.com/BlueBirdBack/godot-cursorrules 다운받아서 프로젝트 루트에 넣으면 된다.
Step 4 : Godot 에디터 설정
Godot에서 외부 에디터 설정:
Editor → Editor Settings → Text Editor → External
→ Use External Editor 체크
→ Exec Path에 Cursor 경로 입력
이제 Godot에서 스크립트 파일을 열면 자동으로 Cursor가 실행된다.
5. 실제 사용 팁
팁 1 : Cursor에게 Godot 버전을 항상 알려주자!
"Godot 4.6 기준으로 플레이어 점프 구현해줘" 처럼 사용하고 있는 고도의 버전을 명시하면 훨씬 정확한 코드가 나온다.
팁 2 : 에러 메시지 그대로 붙여넣기
오류가 나면 Godot 콘솔의 에러 메시지를 Cursor 채팅창에 그냥 붙여넣어. "이 에러 왜 나?" 하면 바로 설명해준다.
팁 3 : 한국어로 질문하자
Cursor AI는 한국어도 잘 이해하기 때문에 "적이 플레이어를 따라다니는 기능 만들어줘"라고 해도 GDScript로 작성해준다.
팁 4 : 자주 겪는 문제 및 해결 방법
| Cursor에서 .gd 파일이 안 열림 | Godot External Editor 설정 확인 |
| AI가 Godot 4.x 문법을 모름 | .cursorrules 파일 설정 확인, 질문에 버전 명시 |
| Godot 에디터와 Cursor가 동시에 열림 | 정상 동작으로 둘다 사용 가능 |
| AI 코드가 오류남 | 에러 메시지를 Cursor에 다시 붙여넣고 "고쳐줘" |