Skip to Content
문서개발자 연동 가이드전체 예제Unity 예제 · BoatAttack

Unity 예제 · BoatAttack

Unity 공식 BoatAttack의 커밋 91886a3ef1ac963aa10578fcaf1d59e9b6961ab3를 사용합니다. 원본은 6000.2.0b8이며 이 예제는 Unity 6.3 LTS 6000.3.25f1, Apple Silicon ARM64에 맞췄습니다. 보트, 운전자, Island, 물, 물리, AI, C# 로직을 유지합니다.

가져오기와 적용

Git LFS를 설치하고 새 폴더에 clone해 큰 에셋을 받습니다. 두 git apply 명령 전에 적용 패키지를 루트에 압축 해제하세요. 패치는 한 번만 적용합니다.

git clone https://github.com/Unity-Technologies/BoatAttack.git BoatAttack cd BoatAttack git checkout 91886a3ef1ac963aa10578fcaf1d59e9b6961ab3 git lfs pull git lfs fsck git apply --check tracked-project-changes.patch git apply tracked-project-changes.patch

이미 적용한 프로젝트에는 반복하지 마세요. 패키지는 호환성·버전 변경, 문서, 라이선스를 포함하며 큰 원본 에셋, Library, dist, Combos 플러그인은 없습니다. 자신의 게임에는 일반 Unity 가이드를 사용하세요.

내보내기 및 레이스

main_menu.unity에서 Play로 메뉴·싱글플레이 설정을 확인하고 중지합니다. 씬은 main_menu.unity (0), level_Island.unity (1). Default, Gzip + fallback, Player Build 시 Addressables를 설정하고 dist로 출력합니다.

Unity 에디터의 원본 BoatAttack 메뉴.

Unity 에디터의 원본 BoatAttack 메뉴.

싱글플레이 설정: Island를 선택하고 보트 구성.

싱글플레이 설정: Island를 선택하고 보트 구성.

기록된 Build는 18:21:57–18:26:03, 246초. 27개 파일, Addressables bundle 5개, 합계 127.36 MiB, 최대 파일 94.58 MiB, ZIP 124.88 MiB였습니다. 용량 제한을 만족하고 ZIP 루트에 index.html이 있었습니다.

python3 -m http.server 8001 --bind 127.0.0.1 --directory dist

http://127.0.0.1:8001/ 에서 RACE → SINGLEPLAYER → ISLAND (1랩) → NEXT → 보트 구성 → RACE로 진행합니다. 연출·카운트다운 후 캔버스를 클릭해 키보드 포커스를 얻으세요. W/↑/스페이스 가속, A/D 조향, R 초기화, F 일시 정지/재개입니다.

게시 및 검증 결과

실제 레이스 화면을 cover.png로 만들고 --platform pc --screen-orientation landscape로 생성합니다. 자신의 기존 연결이 있을 때만 update를 사용하세요. 큰 업로드에는 --timeout 10m을 사용할 수 있습니다.

기록에서는 같은 Post를 revision 2로 업데이트해 게시했으며 submission_is_current=true였습니다. BoatAttack 플레이 , 코드 08759. 로컬 서버를 끈 뒤 독립 브라우저 세션 2개로 공개 페이지·링크에서 레이스에 들어가 가속, 조향, 일시 정지/재개를, 한 세션에서는 R도 확인했습니다. 음소거 상태였고 핵심 파일과 bundle 5개는 공개 배포에서 로드되었으며 게임 실행 오류는 관측되지 않았습니다.

Combos에서 레이스를 진행하는 네이티브 Default 빌드.

Combos에서 레이스를 진행하는 네이티브 Default 빌드.

검증 범위는 PC 가로 화면 싱글플레이 로딩과 운전입니다. 전체 레이스 승리, 모바일 터치, 실제 휴대폰은 검증하지 않았습니다. loader·엔진 경고는 남아 있으며 외부 페이지의 비로그인 profile 401은 게임 로딩과 별도로 기록했습니다.

변경 내용

원본 코드·에셋과 기존 물의 WebGL 분기를 유지합니다. Default 페이지는 Unity가 만들고 loader는 다시 쓰지 않았습니다. 씬, 압축, Addressables는 기본 UI에 저장했습니다. 패치는 에디터/Input System/URP 버전과 직렬화를 조정하며 UIPanelFade.shader에 최신 uGUI용 _MainTex를 추가합니다.

[PerRendererData] _MainTex("Sprite Texture", 2D) = "white" {}

이전 전용 Editor 빌드 스크립트, Combos 템플릿, com.unity.pipeline은 제거했습니다. 고정 커밋 대비 추적 파일 31개의 패치이며 README-migration.md, WEBGL-MIGRATION.md, LOCAL_SETUP.md, 라이선스가 포함됩니다. 모든 Unity 게임용 범용 패치가 아닙니다.

BoatAttack 적용 패키지 다운로드.


출처: Combos 개발자 연동 가이드 . 원문 확인일: 2026-10-08, CLI v1.14.2. 예제 결과는 원문에 기록된 실행 결과입니다.

Last updated on