시작하기

Common Game System(CGS)은 Unity 6.3 LTS를 위한 C# 기반 프레임워크입니다. 저장, 오디오, 입력, 씬 로딩, 타이머, 트위닝 등 23개의 완성된 서비스가 Play를 누르는 순간 스스로 시작됩니다. 이 페이지는 빈 프로젝트에서 프레임워크가 실제로 돌아가는 상태까지 약 5분 만에 안내합니다. 아직 코드는 한 줄도 필요 없습니다.

1. 패키지 임포트

1. Unity 6.3 LTS 프로젝트를 엽니다(새로 만들어도 됩니다 — 어떤 템플릿이든 상관없습니다).
2. Window > Package Manager를 열고 왼쪽 상단 드롭다운에서 My Assets를 선택합니다.
3. Common Game System을 찾아 Download를 클릭한 뒤 Import를 클릭합니다.
4. 임포트 대화상자에서 모든 항목을 선택된 상태로 두고 Import를 클릭합니다. 첫 임포트에서 폴더 선택을 해제하면 프레임워크에 필요한 부분이 빠질 수 있습니다 — 샘플과 문서는 평범한 파일이므로 나중에 언제든 삭제할 수 있습니다.

Unity가 몇 초간 컴파일합니다. 임포트 후 Project 창에 대부분 스크립트와 문서만 보여도 걱정하지 마세요 — CGS는 프리팹 더미가 아니라 코드 프레임워크입니다. 씬에 무언가를 끌어다 놓을 일은 전혀 없습니다.

2. Welcome 창 만나기

컴파일이 끝나면 CGS Welcome 창이 저절로 열립니다. 데모, 여섯 가지 샘플, 매뉴얼, 프레임워크 테스트 — 모든 것으로 통하는 정문입니다.

Welcome 창: 상단의 데모, 원클릭 샘플 임포트, 퀵 링크, 환경 점검, 그리고 테스트/Service Debugger 푸터.

창이 나타나지 않았다면(일부 에디터 레이아웃은 임포트 중 팝업을 억제합니다) Tools > Common Game System > Welcome 또는 Window > Common Game System > Welcome에서 열 수 있습니다.

지금 해 둘 만한 점검 하나: 창에 입력 백엔드에 관한 노란 경고가 보이면 Enable the new Input System (restarts the editor) 버튼을 클릭하고 에디터가 재시작되도록 두세요. 이 과정 없이는 데모와 샘플이 마우스·키보드 입력을 전혀 받을 수 없습니다.

3. 데모 실행

1. Welcome 창 상단 섹션에서 Open Demo Scene을 클릭합니다. 프레임워크의 실행형 쇼케이스인 Motion Lab이 열립니다(Assets/CommonGameSystem.Core/Demo/MotionLab.unity).
2. Play를 누릅니다. 설정도, 구성도 필요 없습니다 — 씬은 임포트된 그대로 동작합니다.
3. 이징 갤러리가 움직이는 것을 지켜본 뒤 컨트롤을 만져 보세요: 이징 커브 갤러리(트윈 서비스), 체인으로 연결된 타임라인(트윈 시퀀스), 반복 카운터(스케줄러).

4. 프레임워크의 진가를 보여주는 순간

Time Scale 슬라이더를 0까지 끌어 보세요.

게임플레이 애니메이션은 얼어붙지만 — 작은 UI 시계 스피너는 계속 돕니다. 이것이 타임 서비스의 분리된 클럭이 하는 일입니다: 게임플레이, UI, 백그라운드가 각자 자기만의 시간 흐름 위에서 돌아갑니다. Unity의 전역 Time.timeScale을 건드리지 않고, 월드가 멈춘 동안에도 버튼이 계속 움직이는 일시정지 메뉴를 만드는 방법이 바로 이것입니다.

5. 꼭 읽어야 할 한 줄

슬라이더에서 손을 떼고 Console 창을 보세요. Play 세션 상단 근처에 다음 줄이 있습니다:

bootstrap complete (v2.1.0, 23 services)

Console의 부트 라인. 이 한 줄의 메시지가 씬이 실행되기 전에 23개 서비스가 모두 스스로 등록되었음을 확인해 줍니다.

설치 이야기는 이 한 줄이 전부입니다. 컴포넌트 하나 추가하지 않았는데도 모든 서비스가 첫 프레임 이전에 자동으로 시작되었고, CGS를 사용하는 모든 프로젝트가 정확히 같은 방식으로 시작됩니다. 코드에서는 그저 서비스를 요청해서 쓰면 됩니다:

var audio = ServiceLocator.Resolve<IAudioService>();
audio.PlaySfx(clickClip);

다음 단계

매뉴얼(패키지 안 Documentation/CGS-Manual.pdf로도 제공):

• 1. 무엇이 들어 있나 — 한눈에 보는 23개 서비스 전체와, CGS가 의도적으로 다루지 않는 것들.
• 2. 설치와 첫 5분 — 이 페이지의 자세한 버전. Motion Lab의 각 부분이 무엇을 보여주는지도 다룹니다.
• 3. Welcome 창과 샘플 — 여섯 가지 샘플(실행형 3종, 스크립트 템플릿 3종)과 숨겨진 2,600개 이상의 테스트 스위트.
• 4. 첫 번째 스크립트 — 저장, 이벤트, 타이머, 트위닝, 입력을 위한 복사-붙여넣기 스니펫.
• 5. 핵심 개념 — 모든 서비스 뒤에 있는 다섯 가지 아이디어.

서비스 레퍼런스 — 서비스별 한 페이지에 전체 API, 예제, 주의사항이 담겨 있습니다. 데모에서 방금 본 것부터 시작하세요: Time, Tween, Scheduler, Tween Sequencing — 또는 전체 색인을 둘러보세요.

막히셨나요? FAQ는 신규 사용자가 실제로 겪는 문제들을 다룹니다. "씬에 아무것도 나타나지 않아요"와 마우스·키보드 입력 먹통부터 시작합니다.