체크포인트로 작업 남기고 되돌리기

체크포인트는 프로젝트의 지금 상태를 이름을 붙여 남겨 두는 기능입니다. 나중에 일이 틀어지면 그 시점으로 되돌릴 수 있습니다. AI에게 큰 요청을 보내기 전, 잘 동작하는 게임을 손보기 전에 하나씩 남겨 두면 안전장치가 됩니다.

시작하기 전에

• 체크포인트는 프로젝트 단위입니다. 체크포인트 상세에는 "체크포인트는 씬·프로젝트 설정·에셋을 담습니다(복원하면 에셋 파일도 그대로 돌아갑니다)"라고 나옵니다.
• OasisW에서는 저장 버튼을 누르지 않아도 바꾼 내용이 바로 저장됩니다. 체크포인트는 그 위에 "돌아갈 지점"을 따로 남기는 것입니다. 저장과는 별개입니다.

이 작업은 손으로만 합니다. AI에게 체크포인트를 남기거나 되돌리라고 시키는 방법은 확인하지 않았습니다.

버전 관리 창 열기

다음 가운데 하나로 엽니다.

• 맨 위 줄의 브랜치 표시(main)를 누릅니다. VERSION CONTROL 창이 바로 열립니다.
• 왼쪽 도구 줄 Publish / Download로 프로젝트 창을 연 뒤 왼쪽 목록에서 Version control을 누릅니다.

VERSION CONTROL 창의 구성은 다음과 같습니다.

체크포인트 남기기

1. Changes 탭 아래의 Describe this checkpoint... 칸에 무엇을 남기는지 적습니다. 예: 별 모으기 완성, AI로 목숨 규칙 넣기 전.
2. Create Checkpoint를 누릅니다. Cmd+Enter(Windows는 Ctrl+Enter)로도 만들어집니다.
3. Creating checkpoint — This may take a few seconds.가 잠깐 뜬 뒤 사라집니다.
4. History 탭에서 방금 적은 설명, 만든 사람, 시각, 7자리 ID(예: a2fe05e)가 붙은 줄을 확인합니다.

바뀐 것 보기

Changes 탭을 열고 Compute를 누르면 마지막 체크포인트 이후 바뀐 것이 나옵니다. 실측에서 엔티티 하나의 Position X를 3에서 5로 바꾸자 다음처럼 보였습니다(1회).

• 탭 이름이 Changes · 1로 바뀌고, 바뀐 씬 이름 옆에 MODIFIED가 붙습니다.
• 오른쪽에 1 change since your last checkpoint와, 바뀐 엔티티의 계층(Root › Gameplay › Star10)이 나옵니다.
• 바뀌기 전 값은 빨간 줄(− Position X 3), 바뀐 값은 초록 줄(+ Position X 5)로 나옵니다.

오른쪽 위 Open Full Diff는 전체 차이를 크게 보고, Discard All…은 마지막 체크포인트 이후 바뀐 것을 모두 버립니다.

Discard All로 버리기

1. Changes 탭에서 Discard All…을 누릅니다.
2. Discard all changes? 창이 뜹니다. Discards all 2 changes since 8df1541.처럼 버릴 변경 수와 기준 체크포인트가 나오고, Take a checkpoint of the current state first가 처음부터 체크돼 있습니다.
3. Discard All을 누릅니다. Changes discarded · Refreshing browser가 뜨고 에디터가 새로 고쳐집니다.

2026-10-29 실측(2회)에서 지운 씬이 Discard All로 돌아왔습니다. 체크 칸을 켜 둔 채 버리면, 버리기 직전 상태가 Checkpoint before discarding changes since "7d1e2f8" 같은 이름의 체크포인트로 먼저 남습니다.

지금 열려 있는 씬이 버리는 과정에서 없어지면, 새로 고친 뒤 에디터 대신 프로젝트 목록이 열렸습니다(1회). 목록에서 프로젝트를 다시 엽니다.

AI 작업이 끝난 뒤 Compute를 누르면 AI가 무엇을 바꿨는지 엔티티와 값 단위로 볼 수 있습니다. 작성 대기 AI 작업 뒤 Changes 화면 실측

되돌리기(Restore)

1. History 탭에서 돌아갈 체크포인트를 누릅니다. 오른쪽에 상세와 Restore, New Branch, Hard Reset…이 나옵니다.
2. Restore를 누릅니다. Restore checkpoint? 확인 창이 뜹니다.
3. Take a checkpoint of the current state first가 켜져 있는지 봅니다. 기본으로 켜져 있습니다. 켜 두면 되돌리기 전의 지금 상태도 체크포인트로 남아, 되돌린 것을 다시 되돌릴 수 있습니다.
4. 확인 창의 Restore를 누릅니다. 에디터가 다시 불러와집니다.

실측에서는 Position X가 5에서 3으로 돌아왔고, History에 Checkpoint before restoring "…"라는 백업 체크포인트가 새로 생겼습니다(1회). 되돌린 뒤 오른쪽 패널이 오른쪽 끝의 세로 탭으로 접혀 있었는데, 탭을 누르면 다시 펼쳐졌습니다.

2026-10-29에는 AI 작업 뒤에 Restore를 했습니다. AI가 고친 스크립트 파일(spin.js의 default 45)이 체크포인트 시점의 90으로 돌아왔고, 씬도 그 시점으로 돌아왔습니다(1회).

Hard Reset과 Restore의 차이

Hard Reset…도 고른 체크포인트로 돌아가지만, 그 뒤의 체크포인트를 모두 지웁니다. 확인 창에는 Deletes ALL checkpoints and changes after <ID>. This cannot be undone.이 나오고, 체크포인트 ID 앞 7자리를 직접 입력해야 실행됩니다.

실측(2026-10-29, 1회): 체크포인트 CP1·CP2와 Restore 백업이 있는 상태에서 씬 이름을 MainHR로 바꾼 뒤 CP1로 Hard Reset했습니다. History에는 CP1만 남았고, 씬 이름은 Main으로 돌아갔습니다.

AI 작업 전에 남기기

AI가 씬에 한 변경은 Undo로 되돌아가지만, AI가 고친 스크립트 파일은 Undo로 되돌아가지 않습니다(AI 작업 되돌리기). 체크포인트 Restore는 둘 다 되돌립니다. 그래서 다음 순서를 권합니다.

1. 게임이 지금 원하는 대로 동작하면, AI에게 요청을 보내기 전에 체크포인트를 남깁니다.
2. AI 작업이 끝나면 ▶ Launch로 확인합니다.
3. 결과가 마음에 들지 않으면 1번 체크포인트로 Restore합니다.

체크포인트 상세의 변경 목록에는 그 사이 바뀐 씬과 에셋이 Main MODIFIED, spin.js MODIFIED처럼 나옵니다. AI가 어떤 스크립트를 고쳤는지 찾을 때도 씁니다.

다음으로

• 브랜치
• 팀원 초대와 권한
• AI 작업 되돌리기