Unity MCP 는 Plan 부터

Unity MCP 로 장면을 만들 때는 Cursor 의 Plan 모드로 먼저 계획을 세우고, 읽어 본 뒤에 실행합니다. 말 한 줄에 AI 가 오브젝트 수십 개를 만들고 재질과 스크립트까지 한꺼번에 바꾸기 때문입니다. 무엇을 할지 미리 보고 고르는 것이 장면을 내 뜻대로 끌고 가는 가장 쉬운 길입니다.

연결과 되돌리기는 4회차 · Unity 다시 하기 에 있습니다. 이 글은 연결이 된 다음의 이야기입니다.

왜 Unity 에서 특히 중요한가

코드 파일은 Cursor 가 되돌려 줍니다. 그런데 Unity MCP 는 열려 있는 씬을 직접 고칩니다. 오브젝트를 만들고, 지우고, 옮긴 것은 Cursor 의 되돌리기(Restore)로 돌아오지 않습니다.

그래서 실행하기 전에 계획을 읽는 몇 분이 나중의 한 시간을 아껴 줍니다. 계획은 글 한 장이라 몇 번이고 고칠 수 있고, 고치는 동안 씬은 그대로 있습니다.

한 바퀴

1. 씬을 저장합니다. Ctrl+S(Mac 은 Cmd+S). 계획이 빗나가면 여기로 돌아옵니다.
2. Plan 모드로 바꿉니다. 채팅 입력칸에서 Shift+Tab 을 눌러 Plan 이 나올 때까지 돌립니다. 입력칸 아래의 모드 고르기에서 Plan 을 골라도 됩니다.
3. 만들고 싶은 장면을 결과로 말합니다. 어떤 도구를 쓸지는 말하지 않아도 됩니다. 보이는 것, 움직이는 것, 분위기를 적습니다.
4. AI 가 되묻는 것에 답합니다. 크기, 색, 몇 개인지처럼 정하지 않은 것을 물어봅니다. 모르면 「알아서 정하되 계획에 적어 줘」라고 답해도 됩니다.
5. 계획을 읽습니다. 아래 「계획에서 볼 것」을 봅니다. 마음에 안 드는 단계는 채팅으로 고쳐 달라고 하거나, 계획 문서를 직접 고칩니다.
6. 빌드합니다. 계획의 빌드(Build) 버튼을 누르면 그때부터 Unity 가 바뀝니다. 누르기 전까지는 아무것도 바뀌지 않습니다.
7. Unity 에서 확인하고 저장합니다. 뜻대로 됐으면 씬을 저장하고 다음 계획으로 갑니다.

이렇게 말하면 됩니다

시 한 편에서 출발한다면 이런 식입니다.

어두운 물 위에 작은 불빛 스무 개가 천천히 떠오르는 장면을 만들고 싶어. 불빛은 따뜻한 주황색이고, 위로 갈수록 흐려져. 카메라는 물 가까이에서 위를 올려다봐. 지금 씬에 있는 것은 그대로 두고 새로 더해 줘.

마지막 문장이 중요합니다. 지킬 것을 먼저 말해 두면 계획에서 무언가를 지우는 단계가 줄어듭니다.

계획에서 볼 것

• 지우거나 바꾸는 단계가 있는가. 이미 만들어 둔 오브젝트를 지우거나 덮어쓰는 줄이 있으면 정말 그래도 되는지 봅니다. 가장 먼저 볼 곳입니다.
• 무엇이 몇 개 생기는가. 오브젝트 이름과 개수가 적혀 있으면 빌드 뒤 Hierarchy 에서 그대로 찾을 수 있습니다.
• 스크립트를 새로 만드는가. 움직임은 대개 스크립트로 들어갑니다. 스크립트 이름을 알아 두면 나중에 「그 스크립트에서 속도만 느리게」처럼 짚어 말할 수 있습니다.
• 패키지를 설치하는가. 설치는 시간이 걸리고 프로젝트 설정이 바뀝니다. 꼭 필요한지 물어봅니다.
• 한 계획이 너무 길지 않은가. 단계가 열 개를 넘으면 둘로 나눕니다. 바닥과 물 먼저, 불빛은 다음 계획으로. 짧게 나눌수록 어디서 틀어졌는지 보입니다.

빗나갔을 때

빌드 결과가 생각과 다르면, 그 위에 고쳐 달라는 말을 계속 얹지 않습니다. 고침이 쌓이면 씬이 점점 엉키고 무엇 때문에 그렇게 됐는지 알 수 없게 됩니다.

대신 저장해 둔 씬으로 돌아가고, 계획을 고쳐서 다시 빌드합니다. 씬을 저장하지 않고 닫은 뒤 다시 열면 1번에서 저장한 상태로 돌아갑니다. 무엇이 틀렸는지는 이제 알고 있으니, 그것을 계획의 한 줄로 고쳐 넣으면 됩니다.

작은 것 하나만 어긋났다면 그때는 Agent 모드로 돌아가 한 줄로 고쳐도 괜찮습니다. 「불빛 크기만 절반으로」처럼 바꿀 것이 분명할 때입니다.

계획을 남겨 두기

계획은 기본으로 내 컴퓨터의 홈 폴더에 저장됩니다. 계획 위의 Save to workspace 를 누르면 프로젝트 폴더 안으로 옮겨집니다.

남겨 둔 계획은 작업 기록이 됩니다. 어떤 말로 무엇을 시켰고, 무엇을 고쳐서 다시 했는지가 순서대로 남습니다. 제작 계획서 의 제작 계획서를 채울 때나 12월 전시 뒤 작품을 글로 정리할 때 그대로 재료가 됩니다.

어디서 왔나

Unity MCP 를 쓸 때 Plan 모드부터 쓰자는 것은 배준형의 권고입니다. 4회차 수업을 참관하며 떠올린 것이고, 홍서연 작가가 수업에서 가르친 내용과는 따로입니다.

Plan 모드의 사용법은 Cursor 공식 문서 Planning↗ 을 따랐습니다. 빗나갔을 때 되돌리고 계획을 고치라는 것도 그 문서의 권고입니다.