Common Game System

입문자를 위한 릴리스 — CGS를 처음 보는 사람이 몇 분 안에 생산적으로 쓸 수 있도록 문서와 패키징을 다시 만들었습니다. 모든 런타임 폴더와 레퍼런스 문서가 이제 쉬운 영어 이름을 씁니다(Bootstrap, SaveLoad, Tween, …) — 폴더와 파일 이름에서 옛 내부 번호 접두사가 사라졌습니다. 눈에 보이는 데모 씬이 Assets/CommonGameSystem.Core/Demo/MotionLab.unity에 들어갑니다 — 열고 Play만 누르면 되고, 설정이 필요 없습니다. 트윈 이징 갤러리, 트윈 시퀀스 쇼케이스, 스케줄러 타이머, 그리고 게임플레이는 얼리면서 UI 시계는 계속 돌게 하는 Time Scale 슬라이더를 보여 주며, 내장 uGUI 패키지만 있으면 됩니다. Welcome 창은 "60초 안에 데모 체험"을 중심으로 다시 만들었습니다: 패키지 버전마다 한 번 자동으로 열리고, Tools > Common Game System > Welcome과 Window > Common Game System > Welcome 양쪽에서 열 수 있으며, 샘플 원클릭 임포트, 퀵 링크(PDF 매뉴얼 / 문서 / 체인지로그 / 모듈 레퍼런스), 접힌 환경 점검을 제공합니다. 샘플은 이제 6개입니다 — UI Panel Stack, Save/Load + Seeded Random, Command Console은 실행 가능한 씬이고, Scene Flow, Localization, RPG Starter는 단계별 스크립트 템플릿입니다. (Motion Lab은 샘플에서 항상 보이는 데모로 승격되었습니다.) 목차와 주석 달린 스크린샷을 갖춘 페이지형 PDF 매뉴얼이 Documentation/CGS-Manual.pdf로 배포되고, AI 어시스턴트 파일은 Documentation/AI/로 옮겼습니다. 자동화된 테스트 2,600개 이상은 여전히 패키지 안에 들어 있지만 이제 숨겨진 채로 배포됩니다 — Welcome 창에서 클릭 한 번으로 임포트하기 전에는 구매자 프로젝트에 컴파일되지 않습니다. 서비스는 여전히 23개, 서드파티 의존성은 여전히 0개입니다.

어셈블리 일곱 개로 나눈 릴리스입니다. 하나였던 CommonGameSystem.Core 런타임 어셈블리가 일곱 개로 나뉘어 — Core(패키지 의존성 0개인 서비스 18종 + 순수 UI 계약), Input, UI, Localization, Assets, AddressableScene, Bootstrap — 실제로 쓰는 것만 골라 참조하면 됩니다. Breaking은 자체 asmdef를 쓰는 프로젝트에만, 그것도 references 목록에만 해당합니다. 소스 변경은 없고, 네임스페이스는 전부 CommonGameSystem.Core 그대로이며, Assembly-CSharp 프로젝트는 영향을 받지 않습니다. 안 쓰는 UPM 패키지(Addressables / Input System / UGUI)를 제거하는 것도 이제 지원됩니다. 의존 어셈블리는 — 함께 배포되는 테스트·샘플 어셈블리까지 포함해 — defineConstraints로 스스로 빠지고, Bootstrap은 해당 등록을 건너뜁니다(UI Panel Stack은 NullPanelStack으로 폴백). 세 패키지 모두 기본으로는 여전히 자동 설치됩니다. link.xml은 이제 모듈 단위라, 옵션 어셈블리의 IL2CPP 보존 항목은 그 어셈블리와 함께 빠집니다. 씬 로드 취소는 정직한 계약으로 바뀌었습니다(동작 breaking). 기존의 "활성화를 막아 두고, 새 씬의 OnEnable은 절대 실행되지 않는다"는 약속은 애초에 구현이 불가능했습니다 — Unity는 활성화되지 않은 로드 뒤로 AsyncOperation 큐 전체를 세워 두기 때문에, 취소 한 번이 프로세스가 살아 있는 내내 이후의 모든 씬 로드를 얼려 버렸습니다. 이제 백엔드 로드가 발행되기 전의 취소는 진짜 취소이고, 그 이후의 취소는 씬 전환이 완료되되 SceneLoadCanceled가 활성화 전에 — 떠나는 씬의 구독자들이 아직 살아 있을 때 — 발행됩니다. 수정 사항: 에디터 플레이 종료 시 정리가 조용히 no-op으로 끝나던 문제를 고쳤습니다(레지스트리가 LIFO Dispose 체인보다 먼저 비워져 업적 디스크 플러시와 에셋 핸들 해제까지 건너뛰었습니다). 오디오는 실제 시간으로 재생되는데 SFX 자동 반환은 스케일된 게임 시간으로 돌던 문제도 고쳤습니다(이제 unscaled 기준이고 피치도 반영합니다). TimeServiceTicker는 이제 [DefaultExecutionOrder(-100)]을 선언해, 여러분의 스크립트가 그 프레임의 delta를 두고 경합하지 않습니다. IConfiguration.Set<T>는 여러분의 인스턴스를 제자리에서 클램프하는 대신 내부 복사본을 저장합니다. 추가 사항: InputServiceOptions.AlwaysEnabledMaps(컨텍스트 전환에도 UI/Debug 액션 맵을 계속 켜 둡니다), IPanelVisual(옵트인 패널 페이드 전환에 더해, 옵션이 늘 약속해 온 모달 백드롭), GraphicsSettingsApplier(품질 / 해상도 / 전체 화면 / vSync / 프레임 상한이 이제 정말 Unity에 적용됩니다), ISaveStorageBackend(세이브 저장 매체를 주입할 수 있습니다 — 암호화 세이브, 커스텀 경로, Steam Cloud, 새 Steam 레시피 문서 포함), FileLogger(재실행 후에도 남는 옵트인 로테이팅 파일 로그), 그리고 지연(Deferred) 저장 설정이 이제 포커스를 잃을 때도 플러시됩니다. 서비스는 여전히 23개, 서드파티 의존성은 여전히 0개이며, 자동화된 EditMode 테스트는 2,665개입니다.

최초로 공개된 릴리스입니다. 공개되지 않은 1.14.0 빌드 이후 Core 서비스 3개가 추가되어 20개에서 23개가 되었고, 등록은 여전히 Bootstrap.Run() 한 줄이 전부입니다. 추가된 서비스는 Addressable Scene(IAddressableSceneService — Addressables 카탈로그에서 비동기 additive 씬 로드/언로드, 키별 참조 카운트, 런타임 데이터에는 예외를 던지지 않음), Deferred Event Queue(IDeferredBus — 지금 이벤트를 캡처해 두고 원하는 Flush() 시점에 발행), Command Registry(ICommandRegistry — 등록 / 토큰화 / 실행에 히스토리와 접두사 자동완성을 더한 런타임 커맨드 코어. 인게임 콘솔 UI는 직접 만드는 구조입니다) 세 가지입니다. 샘플은 임포트 가능한 7개로 늘었고, 그중 4개는 그대로 실행되는 완성된 씬입니다. Motion Lab(이징 8종 트윈 갤러리, 웨이포인트 시퀀싱, 그리고 Clock 분리를 눈으로 확인하는 장면 — 게임플레이 TimeScale을 0으로 두면 갤러리는 멈추지만 UI 스피너는 계속 돕니다), Save/Load + Seeded Random(Load 직후 뽑은 시드 기반 난수 3개가 Save 시점에 예고해 둔 값과 정확히 일치합니다), M25 Command Console(히스토리와 자동완성이 실제로 동작하는 인게임 개발자 콘솔), 그리고 RPG Starter 코드 템플릿입니다. Tools ▸ Common Game System 아래에는 에디터 도구가 새로 들어갔습니다. Welcome / Quick Start 창(환경 점검, 샘플 원클릭 임포트)과 런타임 Service Debugger(서비스 레지스트리 실시간 조회, Clock별 타임스케일, 활성 tween/FSM/audio/command 통계)입니다. 수정 사항: 저장해 둔 오디오 설정이 부팅 시점에 제대로 적용되도록 고쳤고(믹서 초기화 경합), UI 샘플의 볼륨/음소거 컨트롤이 즉시 반응하도록 바꾸면서 효과를 귀로 확인할 수 있게 캐논 D장조 BGM 루프를 함께 넣었습니다(곡은 퍼블릭 도메인, 녹음은 퍼블리셔 자체 제작). 그 밖에 패널 내비게이션 NullReferenceException, "No cameras rendering" 워터마크, 플레이 종료 시 정리 과정에서 나던 예외를 해결했습니다. 서드파티 의존성은 여전히 0개이고, IL2CPP 대응 · 렌더 파이프라인 비의존 · 자동화된 EditMode 테스트 2,550개도 그대로입니다.

심사를 신청했지만 공개되지 않은 빌드입니다. 2026년 6월 15일 Unity Asset Store에 제출했으나 심사가 진행되지 않아 누구에게도 전달된 적이 없습니다. 설치할 수 있었던 버전이 아니라 개발 기록의 일부로 남겨 둡니다. Bootstrap.Run() 한 줄로 등록되는 프로덕션 서비스 20개 — Service Locator, Logger, Event Bus, Save/Load, Configuration, Input, Time, Object Pool, Audio, UI Panel Stack, Scene Flow (+additive), Localization, Achievements/Stats, Scheduler, Tween, Asset Provider, Random, FSM, Pushdown Stack, Tween Sequencing. 서드파티 의존성 0개, IL2CPP 대응, 렌더 파이프라인 비의존, AI 대응(AGENT.md + 태스크 스킬 5개). 1.14.0 이전 버전은 전부 내부 개발 마일스톤이었습니다.