Kookmin University Capstone 2026  ·  +82 Crew

안녕 from Korea

외국인을 위한 한국 생활 가이드 게임

Interactive cultural guide game that teaches foreigners how to navigate everyday life in Korea — through branching dialogue, real Korean vocabulary, and AI-powered assistance.

GitHub 보기 🎮 게임 플레이
scroll
프로젝트 소개 · About

한국 생활,
게임으로 배우다

안녕 from Korea는 한국에 온 외국인들이 공항, 지하철, 병원, 은행 등 일상생활에서 겪는 상황을 RPG 스타일 대화 게임으로 체험하며 배울 수 있는 인터랙티브 문화 가이드입니다.

실제 한국어 어휘와 문화적 맥락을 브랜칭 대화 시스템으로 익히며, Claude AI 기반 챗봇 도우미가 게임 중 언제든지 질문에 답해드립니다.

단기 방문객(7미션)과 장기 거주자(12미션) 두 가지 모드를 제공하여, 각자의 목적에 맞는 필수 생활 정보를 단계별로 익힐 수 있습니다.

12
실전 미션
(공항 → 쇼핑)
2
방문 모드
(단기 / 장기)
AI
Claude 챗봇
도우미 내장
0
설치 불필요
브라우저에서 바로
안녕 from Korea
+82 Crew · Kookmin University · 2026
데모 영상 · Demo Video

게임 플레이 영상

실제 게임 화면과 AI 챗봇 도우미를 직접 확인해보세요

주요 기능 · Key Features

진짜 한국 생활을
게임으로 경험하다

실제 상황을 바탕으로 설계된 6가지 핵심 기능

💬
브랜칭 대화 시스템
선택지에 따라 흐름이 달라지는 분기 대화로, 실제 상황에서의 올바른 대응 방법을 자연스럽게 익힐 수 있습니다.
📚
어휘 플래시카드
각 미션 시작 전 핵심 한국어 단어를 로마자 발음과 함께 플래시카드로 예습합니다. 게임 중 단어를 탭하면 번역도 확인할 수 있습니다.
🤖
AI 챗봇 도우미
Claude AI 기반 챗봇이 미션별 맥락을 이해하고, 게임 중 모르는 것이 있으면 언제든지 한국어·영어로 답해드립니다.
📈
진행 현황 추적
완료 미션은 자동 저장되어 언제든지 이어서 플레이할 수 있으며, 메인 화면에서 전체 진행률을 한눈에 확인할 수 있습니다.
✈️
단기 / 장기 방문 모드
관광객을 위한 단기 방문 모드(7미션)와 거주자를 위한 장기 거주 모드(12미션)를 탭 하나로 전환할 수 있습니다.
📱
모바일 최적화
세로 모드 스마트폰에서도 배경 이미지의 주요 인물이 잘리지 않도록 이미지별 최적 크롭 위치를 설정한 완전한 모바일 경험을 제공합니다.
미션 목록 · Missions

12가지 실전 미션

공항 도착부터 부동산·병원·쇼핑까지 — 한국 생활의 모든 상황을 커버합니다

Step 01
공항 환전
Airport Currency Exchange
단기 + 장기
Step 02
공항 분실물 센터
Airport Lost & Found
단기 + 장기
Step 03
편의점
Convenience Store
단기 + 장기
Step 04
지하철 타기
Seoul Subway
단기 + 장기
Step 05
통신사 유심 개통
SIM Card / Telecom
장기 거주
Step 06
출입국관리사무소
Immigration Office (ARC)
장기 거주
Step 07
은행 통장 개설
Bank Account Opening
장기 거주
Step 08
부동산 — 집 구하기
Finding an Apartment
장기 거주
Step 09
쓰레기 봉투 구매
Garbage Bag Purchase
장기 거주
Step 10
병원 진료 받기
Hospital Visit
단기 + 장기
Step 11
약국에서 약 구매
Pharmacy
단기 + 장기
Step 12
옷 가게 환불/교환
Clothing Store Refund
단기 + 장기
기술 스택 · Tech Stack

사용된 기술

프레임워크 없이, 빌드 없이 — 순수 웹 기술과 클라우드 데이터베이스로 구현한 게임

🌐
Frontend
HTML5 · CSS3 · Vanilla JavaScript
  • ✓프레임워크 없음 · 빌드 없음 · npm 없음
  • ✓타자기 대화 엔진 (Typewriter engine)
  • ✓씬 기반 · 스텝 기반 미션 형식 2종
  • ✓GitHub Actions — 자동 배포 (GitHub Pages)
  • ✓인게임 단어 툴팁 시스템
🤖
AI 챗봇
Claude API · Anthropic
  • ✓claude-haiku-4-5-20251001 모델
  • ✓미션별 맥락 인식 시스템 프롬프트
  • ✓브라우저 직접 API 연동
  • ✓한국어 · 영어 동시 지원
  • ✓대화 이력 최대 20개 유지
🔥
Database & Analytics
Firebase Firestore · Chart.js
  • ✓사용자 프로필 저장 — 국적 · 나이 · 거주지 · 입국 예정일 · 방문 목적
  • ✓15가지 행동 이벤트 자동 수집 (미션 시작/완료/포기, 단어 클릭, 챗봇 질문 등)
  • ✓기기 간 프로필 동기화 (이메일 로그인)
  • ✓실시간 Analytics 대시보드 (Chart.js)
  • ✓입국 예정 시기 · 방문 목적 시각화
🎨
Design & UX
Google Fonts · Custom CSS
  • ✓Inter — UI · 영문 텍스트
  • ✓Noto Sans KR — 한국어 텍스트
  • ✓세로 모바일 최적 크롭 시스템
  • ✓다크 비주얼 노벨 테마
  • ✓미션 완료 시 색종이 애니메이션
팀원 소개 · Meet the Team

+82 Crew

국민대학교 2026 캡스톤 디자인 팀

👤
울란
팀장 · 기획 · QA
프로젝트 아이디어 기획
시뮬레이션 개발 · 이미지 · 포스터 제작
전체 테스트 · 버그 확인
ulanjnw@gmail.com @jinwoobc
개발자 1
바호디르
개발자 1
게임 엔진 · UI 디자인
AI 챗봇 · Firebase · 데이터 분석
yovvbosarovv@gmail.com @bakhodir_ai
👤
만다흐자야
개발자 2 · UI 디자인
로고 디자인 · UI 디자인
앱 전체 기능 테스트
mandakh0402@gmail.com @themndkh