{"id":50438672,"url":"https://github.com/developeracademy-postech/2025-c4-m11-nlp","last_synced_at":"2026-05-31T18:03:27.531Z","repository":{"id":303346924,"uuid":"1015103244","full_name":"DeveloperAcademy-POSTECH/2025-C4-M11-NLP","owner":"DeveloperAcademy-POSTECH","description":"Team NLP(Naturally Living People)","archived":false,"fork":false,"pushed_at":"2025-07-28T13:22:09.000Z","size":101489,"stargazers_count":6,"open_issues_count":7,"forks_count":0,"subscribers_count":0,"default_branch":"dev","last_synced_at":"2025-07-28T13:26:09.607Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DeveloperAcademy-POSTECH.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-07T02:31:35.000Z","updated_at":"2025-07-28T11:38:47.000Z","dependencies_parsed_at":"2025-07-07T06:32:29.281Z","dependency_job_id":"7ace65ae-77ee-44f6-93f2-dfc7764032f7","html_url":"https://github.com/DeveloperAcademy-POSTECH/2025-C4-M11-NLP","commit_stats":null,"previous_names":["developeracademy-postech/2025-c4-m11-nlp"],"tags_count":0,"template":false,"template_full_name":"DeveloperAcademy-POSTECH/TEAM_TEMPLATE","purl":"pkg:github/DeveloperAcademy-POSTECH/2025-C4-M11-NLP","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeveloperAcademy-POSTECH%2F2025-C4-M11-NLP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeveloperAcademy-POSTECH%2F2025-C4-M11-NLP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeveloperAcademy-POSTECH%2F2025-C4-M11-NLP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeveloperAcademy-POSTECH%2F2025-C4-M11-NLP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DeveloperAcademy-POSTECH","download_url":"https://codeload.github.com/DeveloperAcademy-POSTECH/2025-C4-M11-NLP/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeveloperAcademy-POSTECH%2F2025-C4-M11-NLP/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33742186,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-31T18:03:05.064Z","updated_at":"2026-05-31T18:03:27.517Z","avatar_url":"https://github.com/DeveloperAcademy-POSTECH.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌌 NLP (Natural Language Project)\n![iOS](https://img.shields.io/badge/iOS-17.0+-blue.svg)\n![Swift](https://img.shields.io/badge/Swift-5.9-orange.svg)\n![Xcode](https://img.shields.io/badge/Xcode-15.0+-blue.svg)\n![SpriteKit](https://img.shields.io/badge/SpriteKit-2D%20Game%20Engine-green.svg)\n![SwiftUI](https://img.shields.io/badge/SwiftUI-UI%20Framework-red.svg)\n\n\u003e **우주정거장에서 펼쳐지는 AI와 인간의 탈출일지**  \n\u003e SwiftUI와 SpriteKit으로 구현된 iOS 어드벤처 게임\n\n---\n\n## 📋 목차\n- [🎮 게임 소개](#-게임-소개)\n- [🚀 주요 기능](#-주요-기능)\n- [🛠 기술 스택](#-기술-스택)\n- [📱 게임 플레이](#-게임-플레이)\n- [🏗 프로젝트 구조](#-프로젝트-구조)\n- [🎯 개발 과정](#-개발-과정)\n- [🔧 설치 및 실행](#-설치-및-실행)\n- [📖 게임 가이드](#-게임-가이드)\n- [🤝 기여하기](#-기여하기)\n- [📄 라이선스](#-라이선스)\n\n---\n\n## 🎮 게임 소개\n\n**NLP**는 우주정거장을 배경으로 한 스토리 중심의 어드벤처 게임입니다. 플레이어는 정체불명의 사고로 인해 우주정거장에 고립된 상황에서, AI 로봇들과의 대화를 통해 진실을 파헤치게 됩니다.\n\n### 🌟 핵심 특징\n- **스토리텔링**: AI와 인간의 대화를 중심으로 한 깊이 있는 스토리\n- **다중 엔딩**: 플레이어의 선택에 따라 달라지는 다양한 엔딩\n- **실시간 대화 시스템**: Foundation Model을 활용한 자연스러운 AI 대화\n- **몰입감 있는 환경**: 우주정거장을 재현한 2D 게임 환경\n\n---\n\n## 🚀 주요 기능\n\n### 🎯 핵심 게임플레이\n- **스테이지별 진행**: 4개의 주요 스테이지를 통한 점진적 스토리 전개\n- **물리 기반 상호작용**: SpriteKit을 활용한 정교한 충돌 감지 및 상호작용\n- **다이얼로그 시스템**: 다양한 캐릭터와의 자연스러운 대화\n- **아이템 수집**: 게임 내 아이템을 통한 스토리 진행\n\n### 🎵 사운드 \u0026 음악\n- **동적 BGM 시스템**: 상황에 따른 자동 음악 전환\n- **효과음**: 버튼 클릭, 충돌, 대화 등 다양한 상황별 효과음\n- **햅틱 피드백**: iOS 디바이스의 진동을 활용한 몰입감 증대\n\n### 🎨 시각적 효과\n- **페이드 전환**: 부드러운 장면 전환 효과\n- **스트리밍 텍스트**: 타이핑 효과를 통한 자연스러운 텍스트 표시\n- **반응형 UI**: 다양한 iOS 디바이스에 최적화된 인터페이스\n\n---\n\n## 🛠 기술 스택\n\n### 📱 프레임워크 \u0026 라이브러리\n- **SwiftUI**: UI 개발\n- **SpriteKit**: 2D 게임 엔진 및 물리 시스템\n- **Foundation**: 애플에서 제공하는 LLM 모델\n\n### 🏗 아키텍처\n- **MVVM**: Model-View-ViewModel 패턴\n- **Coordinator Pattern**: 화면 전환 관리\n\n---\n\n## 📱 게임 플레이\n\n### 🎮 스테이지 구성\n1. **Stage One**: 우주정거장 도킹 및 초기 탐험\n2. **Stage Two**: AI 로봇과의 첫 만남과 대화\n3. **Stage Three**: 핀(Finn) 캐릭터와의 만남\n4. **Stage Four**: 최종 선택과 엔딩\n\n### 🎯 주요 상호작용\n- **대화 시스템**: 로봇, 컴퓨터, 산소발생기 등과의 대화\n- **아이템 수집**: 수첩, PDA 등 스토리 관련 아이템\n- **퍼즐 해결**: 비밀번호 입력, 기계 조작 등\n- **선택지**: 스토리 진행에 영향을 주는 중요한 선택\n\n### 🎵 음악 시스템\n- **bgm_1~5**: 스테이지별 배경음악\n- **bgm_oxygen**: 산소 부족 상황\n- **bgm_ending**: 엔딩 전용 음악\n\n---\n\n## 🏗 프로젝트 구조\n\n```\n📦NLP\n┣ 📂NLP\n┃ ┣ 📂Sources\n┃ ┃ ┣ 📂App\n┃ ┃ ┃ ┣ 📜AppDelegate.swift\n┃ ┃ ┃ ┣ 📜Coordinator.swift\n┃ ┃ ┃ ┗ 📜CoordinatorPath.swift\n┃ ┃ ┣ 📂Common\n┃ ┃ ┃ ┣ 📂CustomKeyboard\n┃ ┃ ┃ ┣ 📂DesignSystem\n┃ ┃ ┃ ┗ 📜MusicManager.swift\n┃ ┃ ┣ 📂Dialog\n┃ ┃ ┃ ┣ 📜DialogManager.swift\n┃ ┃ ┃ ┗ 📂Tool\n┃ ┃ ┣ 📂Entity\n┃ ┃ ┃ ┣ 📜Dialog.swift\n┃ ┃ ┃ ┗ 📜MonologueAction.swift\n┃ ┃ ┣ 📂Enum\n┃ ┃ ┃ ┣ 📜DialogPartnerType.swift\n┃ ┃ ┃ ┣ 📜DialogSender.swift\n┃ ┃ ┃ ┗ 📜LightMode.swift\n┃ ┃ ┣ 📂Game\n┃ ┃ ┃ ┣ 📂Enum\n┃ ┃ ┃ ┣ 📂GameScene\n┃ ┃ ┃ ┣ 📂Shapes\n┃ ┃ ┃ ┣ 📂Sprites\n┃ ┃ ┃ ┗ 📂Stage*GameScene\n┃ ┃ ┣ 📂Presentation\n┃ ┃ ┃ ┣ 📂RootScene\n┃ ┃ ┃ ┣ 📂Stage*Scene\n┃ ┃ ┃ ┣ 📂MiddleStoryScene\n┃ ┃ ┃ ┗ 📂StartGameScene\n┃ ┃ ┗ 📂Utils\n┃ ┃   ┣ 📂Constants\n┃ ┃   ┗ 📂Extensions\n┃ ┣ 📂Resources\n┃ ┃ ┣ 📂Assets.xcassets\n┃ ┃ ┣ 📂Fonts\n┃ ┃ ┗ 📂Audio\n┃ ┗ 📂Tests\n┗ 📜README.md\n```\n\n### 📁 주요 디렉토리 설명\n- **App**: 앱의 진입점과 네비게이션 관리\n- **Common**: 공통 컴포넌트와 유틸리티\n- **Dialog**: AI 대화 시스템\n- **Game**: SpriteKit 게임 로직\n- **Presentation**: SwiftUI 뷰와 뷰모델\n- **Utils**: 상수, 확장 등 유틸리티\n\n---\n\n## 🎯 개발 과정\n\n### 📅 개발 타임라인\n- **2025.06.23**: 프로젝트 기획 및 설계\n- **2025.07.04**: 개발 시작\n- **2025.07.28**: 개발 완료\n- **2025.08.01**: 프로젝트 마무리\n\n### 🔄 개발 단계\n1. **기획 단계**: 스토리 구성 및 게임플레이 설계\n2. **프로토타입**: 핵심 메커니즘 구현\n3. **개발 단계**: 스테이지별 기능 구현\n4. **통합 단계**: 전체 시스템 통합 및 최적화\n5. **테스트 단계**: 버그 수정 및 사용성 개선\n\n### 🎨 디자인 철학\n- **사용자 중심**: 직관적이고 접근하기 쉬운 인터페이스\n- **몰입감**: 스토리와 게임플레이의 자연스러운 융합\n- **성능**: 부드러운 게임플레이 보장\n\n---\n\n\n## 📖 게임 가이드\n\n### 🎮 기본 조작\n- **터치**: 아이템 선택 및 상호작용\n- **스와이프**: 캐릭터 이동 (일부 스테이지)\n- **텍스트 입력**: 대화 및 비밀번호 입력\n\n### 🎯 게임 팁\n1. **대화 활용**: AI와의 대화를 통해 힌트를 얻으세요\n2. **아이템 수집**: 아이템을 수집하여 스토리를 완성하세요\n3. **선택의 중요성**: 각 선택이 엔딩에 영향을 줍니다\n4. **환경 탐험**: 우주정거장의 모든 구역을 탐험해보세요\n\n### 🎵 음악 가이드\n- 각 스테이지마다 고유한 배경음악이 있습니다\n- 상황에 따라 음악이 자동으로 변경됩니다\n- 엔딩에서는 특별한 음악이 재생됩니다\n\n---\n\n## 🤝 기여하기\n\n### 🐛 버그 리포트\n버그를 발견하셨다면 [Issues](https://github.com/your-username/NLP/issues)에 등록해주세요.\n\n---\n\n\n## 👥 Team NLP\n\n\u003cdiv align=\"center\"\u003e\n\n| \u003cimg src=\"https://github.com/yangsijun.png\" width=\"100\"/\u003e\u003cbr/\u003e**Air**\u003cbr/\u003e[@yangsijun](https://github.com/yangsijun)\u003cbr/\u003eiOS Developer | \u003cimg src=\"https://github.com/Gojaehyun.png\" width=\"100\"/\u003e\u003cbr/\u003e**Go**\u003cbr/\u003e[@Gojaehyeon](https://github.com/Gojaehyeon)\u003cbr/\u003eiOS Developer | \u003cimg src=\"https://github.com/keon22han.png\" width=\"100\"/\u003e\u003cbr/\u003e**Ted**\u003cbr/\u003e[@keon22han](https://github.com/keon22han)\u003cbr/\u003eiOS Developer |\n|:---:|:---:|:---:|\n| \u003cimg src=\"https://github.com/mingky1017.png\" width=\"100\"/\u003e\u003cbr/\u003e**Mingky**\u003cbr/\u003e[@mingky1017](https://github.com/mingky1017)\u003cbr/\u003eiOS Developer | \u003cimg src=\"https://github.com/chawj1234.png\" width=\"100\"/\u003e\u003cbr/\u003e**Wonjun**\u003cbr/\u003e[@chawj1234](https://github.com/chawj1234)\u003cbr/\u003eiOS Developer | \u003cimg src=\"https://github.com/freedobby77.png\" width=\"100\"/\u003e\u003cbr/\u003e**Nyx**\u003cbr/\u003e[@freedobby77](https://github.com/freedobby77)\u003cbr/\u003eiOS Developer |\n\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**⭐ 이 프로젝트가 도움이 되었다면 스타를 눌러주세요!**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeveloperacademy-postech%2F2025-c4-m11-nlp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeveloperacademy-postech%2F2025-c4-m11-nlp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeveloperacademy-postech%2F2025-c4-m11-nlp/lists"}