Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

amnotyoung/odagame

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

207 Commits

Repository files navigation

KOICA 해외사무소장 시뮬레이터

텍스트 기반 선택형 게임 - 당신의 결정이 미래를 만듭니다

게임 소개

당신은 KOICA(한국국제협력단) 해외사무소장으로 새로 부임했습니다.

KOICA는 전 세계 48개국에 해외사무소를 운영하며, 각 사무소는 대한민국 공적개발원조(ODA) 사업의 최일선 현장 기지입니다. 사무소장은 해당 국가에서 KOICA를 대표하는 총괄 책임자로서 15년 이상 경력의 전문가이며, 외교관에 준하는 지위를 가집니다.

플레이타임: 30분 ~ 1시간

🏢 당신의 조직 (약 37명)

  • 사무소장: 1명 (당신)
  • 부소장: 4명 (분야별 책임자)
  • 코디네이터: 다수 (사업 실무 담당)
  • YP(영프로페셔널): 7명 (만 19-34세 청년인재, 5+5개월 계약)
  • 현지 직원: 17명 (4개 섹터 지원)

👔 사무소장의 6대 핵심 역할

앞으로 2년(8분기) 동안의 임기 동안, 당신은:

  1. 📋 사업 발굴 및 형성

    • 현지 수요조사 및 국별협력전략(CPS) 수립
    • 신규 사업 개요서(PCP) 접수 및 검토
    • 사업발굴 워크숍 개최
  2. 🎯 사업 이행 및 관리

    • 현지 프로젝트 총괄 (국별협력사업, DEEP, 민관협력 등)
    • 현장 모니터링 및 실시간 관리
    • 종료평가, 성과 측정, 사후관리
  3. 🎓 연수사업 지원

    • 연수생 선발 추천 및 출국 지원
    • 비자 발급, 출국 전 오리엔테이션
    • 귀국 후 평가 및 동창회 활동 지원
  4. 🌍 해외봉사단 지원

    • 봉사단원 현지 적응 훈련
    • 비자 및 신분증 발급/관리
    • 안전관리 및 활동 모니터링
  5. 🤝 협력 네트워크 구축

    • 협력국 정부와 정기 협의회 개최
    • 타 공여국(UN, 다자기구) 동향 파악
    • 재외공관(대사관)과 민관합동 회의 참여
    • 현지 NGO 간담회 및 네트워킹
  6. 📡 본부-협력국 간 중간 연결

    • 본부 정책을 협력국에 전달
    • 현지 상황 및 요구사항을 본부에 보고
    • 실시간 피드백 제공
    • 의사소통의 가교 역할

당신의 선택이 프로젝트의 성공, 직원들의 사기, 그리고 국제 협력의 미래를 결정합니다.

🎮 게임 모드

1. 클래식 모드 (기본)

  • 20개 이상의 사전 제작된 시나리오
  • 전통적인 선택형 게임플레이
  • 추가 패키지 설치 불필요

2. AI 모드 (NEW! 🤖)

Gemini API 연동으로 무한한 가능성을 경험하세요!

  • 동적 시나리오 생성: 당신의 플레이 스타일에 맞춘 맞춤형 시나리오
  • 🎯 적응형 난이도: 현재 스탯 상태를 분석하여 적절한 도전 제공
  • 💡 자유 입력 모드: 원하는 행동을 직접 입력하고 AI가 결과 판정
  • 📊 플레이어 분석: 당신의 선택 패턴과 성향 분석
  • 🏆 개인화된 엔딩: 당신만의 여정을 반영한 맞춤형 엔딩

게임 특징

다양한 선택과 결과

  • 클래식: 35개 이상의 현실적인 시나리오

    사업 관리:

    • 신규 사업 발굴 미팅 (TVET 프로젝트)
    • 프로젝트 중간 모니터링 및 평가
    • 국가협력전략(CPS) 수립 워크숍

    파트너십 구축:

    • UNDP 등 UN 기구와의 협력
    • 민간 기업과의 PPP(민관협력) 제안
    • 수원국 장관급 고위급 회담
    • 재외공관(대사관)과의 협력

    인력 관리:

    • YP(영프로페셔널) 프로그램 운영
    • 부소장과의 업무 갈등
    • 코디네이터 전문성 개발
    • 현지 직원 관리 및 역할 확대
    • 전문가 파견 인력 문제

    봉사단 지원:

    • 봉사단원 안전 사고 대응
    • 긴급 안전 사고 - 납치 미수 사건

    연수사업:

    • 연수생 선발 논란 (공정성 vs 외교적 관계)

    본부 소통:

    • 본부 정기 보고 및 48개국 사무소장 연례회의

    기타 딜레마:

    • 부정부패 대응, 문화적 갈등, 예산 위기, 정치적 불안 등
  • AI 모드: 무한한 동적 시나리오

  • 각 선택마다 다른 결과와 후속 스토리

  • 여러 엔딩 (성공, 실패, 특별 엔딩 등)

복합적인 게임 스탯

게임 진행 중 4가지 주요 지표를 관리해야 합니다:

  • 평판 (Reputation): 국제사회, 정부, 현지 주민과의 관계
  • 예산 (Budget): 프로젝트 운영에 필요한 재정
  • 직원 만족도 (Staff Morale): 팀원들의 사기와 동기부여
  • 프로젝트 성공도 (Project Success): 사업의 품질과 효과

현실적인 딜레마

  • 사업 관리: 신규 프로젝트 발굴, 예산 배분, 성과 모니터링
  • 파트너십: UN/국제기구 협력, 민간 기업 CSR 협력
  • 인력 관리: 봉사단원 안전 사고, 전문가 갈등, 현지 직원 이탈
  • 외교적 상황: 수원국 정부 요구, 장관급 회담, 정치적 불안
  • 전략적 결정: 국가협력전략 수립, 중장기 우선순위 선정
  • 윤리적 딜레마: 부정부패 대응, 문화적 갈등, 원칙과 현실의 균형
  • 위기 관리: 긴급 상황 대응, 예산 압박, 이해관계자 조율

설치 및 실행

🌐 웹 버전 (모바일 친화적) - 추천!

모바일, 태블릿, PC에서 모두 플레이 가능한 웹 버전이 준비되어 있습니다!

빠른 시작 (로컬)

# 1. 의존성 설치
pip install -r requirements.txt
# 2. Streamlit 앱 실행
streamlit run streamlit_app.py

브라우저가 자동으로 열리며, 모바일 기기에서도 접속 가능합니다.

온라인 배포

모바일에서 언제 어디서나 플레이하려면 무료 배포를 추천합니다:

  • Streamlit Cloud (가장 쉬움, 무료)
  • Render (무료)
  • 기타 클라우드 서비스

자세한 배포 방법은 DEPLOY.md 참조

💻 CLI 버전 (터미널)

요구사항

  • Python 3.6 이상
  • (선택) AI 모드 사용시: google-generativeai 패키지

설치

클래식 모드만 사용하는 경우

추가 설치 불필요 - Python만 있으면 됩니다!

AI 모드를 사용하는 경우
  1. 의존성 패키지 설치:
pip install google-generativeai
  1. Gemini API 키 발급:

  2. (선택) 환경변수 설정:

export GEMINI_API_KEY="your_api_key_here"

또는 .env 파일 생성:

cp .env.example .env
# .env 파일을 열어서 API 키 입력

실행 방법

python3 koica_game.py

또는 실행 권한을 부여한 후:

chmod +x koica_game.py
./koica_game.py

게임 시작시 모드를 선택할 수 있습니다:

  • 1번: 클래식 모드 (기본 시나리오)
  • 2번: AI 모드 (Gemini 연동)

게임 방법

🌐 웹 버전

  1. 브라우저에서 게임 접속
  2. 게임 모드 선택 (클래식 / AI)
  3. 초기 생활 설정 (자동차, 주거지, 여가, 식사)
  4. 각 시나리오에서 버튼을 클릭/터치하여 선택
  5. 상단의 스탯 바를 확인하며 진행
  6. 위험한 선택에는 경고 표시

웹 버전 특징:

  • 📱 모바일 최적화된 UI
  • 📊 시각적 스탯 표시 (프로그레스 바)
  • 🎨 깔끔한 디자인
  • 👆 터치 친화적 버튼

💻 CLI 버전

클래식 모드

  1. 각 상황에서 제시되는 선택지를 읽습니다
  2. 번호를 입력하여 선택합니다
  3. 선택의 결과를 확인하고 다음 상황으로 진행합니다
  4. 화면 상단의 스탯을 주시하며 균형을 유지합니다

AI 모드 (추가 기능)

  • 모든 클래식 모드 기능 포함
  • 자유 입력 옵션: 선택지 목록 하단에 "직접 행동 입력하기" 옵션 표시
    • 예: "현지 부족장들과 비공식 회의를 갖는다"
    • 예: "직원들과 팀 빌딩 활동을 제안한다"
  • 동적 시나리오: 당신의 선택 패턴을 분석하여 적절한 새 상황 생성
  • 개인화된 피드백: 각 선택에 대한 맞춤형 결과 메시지

게임 오버 조건

다음 상황에서 게임이 조기 종료됩니다:

  • 평판이 0 이하로 떨어질 때
  • 예산이 0 이하로 떨어질 때
  • 직원 만족도가 0 이하로 떨어질 때

2년을 무사히 마치면 최종 점수에 따라 엔딩이 결정됩니다.

엔딩 종류

성공 엔딩

  • 전설적인 소장: 모든 면에서 탁월한 성과 (점수 80 이상)
  • 성공적인 소장: 훌륭한 성과 달성 (점수 65-80)
  • 평범한 소장: 무난한 임기 완수 (점수 50-65)

어려움을 겪은 엔딩

  • 고전한 소장: 많은 어려움 경험 (점수 50 미만)

조기 종료 엔딩

  • 평판 실추로 소환
  • 예산 위기로 해임
  • 직원 반발로 사임

특별 엔딩

  • 현지 자문관의 길: 현지에 남아 계속 기여
  • 본부 기획자의 길: 본부로 복귀하여 정책 개선
  • 새로운 시작: 새로운 도전 추구

게임 팁

공통 팁

  1. 균형이 중요합니다: 한 스탯만 높이면 다른 스탯이 희생됩니다
  2. 장기적 관점: 단기적 이득보다 지속 가능성을 고려하세요
  3. 관계가 핵심: 사람들과의 관계가 프로젝트 성공의 열쇠입니다
  4. 원칙과 현실: 때로는 타협이, 때로는 원칙이 필요합니다
  5. 문화 이해: 현지 문화를 존중하는 것이 중요합니다

AI 모드 전용 팁

  1. 창의적으로 행동하세요: 자유 입력에서 독창적인 해결책 시도
  2. 일관성 유지: AI는 당신의 플레이 스타일을 학습합니다
  3. 세부적으로 입력: 명확하고 구체적인 행동 설명이 더 좋은 결과를 냅니다
  4. 실험해보세요: AI는 예상치 못한 행동에도 합리적으로 반응합니다

시나리오 확장

scenarios.json 파일을 수정하여 새로운 시나리오를 추가할 수 있습니다.

시나리오 구조

{
 "scenario_id": {
 "title": "시나리오 제목",
 "description": "상황 설명",
 "choices": [
 {
 "text": "선택지 텍스트",
 "result": {
 "message": "결과 메시지",
 "stats": {
 "reputation": 10,
 "budget": -5
 },
 "advance_time": true,
 "next": "다음_시나리오_id"
 }
 }
 ]
 }
}

제작 정보

  • 장르: 텍스트 어드벤처, 시뮬레이션
  • 플랫폼: CLI (Command Line Interface)
  • 언어: Python 3
  • 테마: 국제 개발 협력, 의사결정
  • AI 기술: Google Gemini 1.5 Pro (선택사항)

기술 스택

  • Python 3.6+: 기본 게임 엔진
  • google-generativeai: AI 기능 (선택)
  • JSON: 시나리오 데이터 저장

AI 모드 특징 상세

1. 동적 시나리오 생성

AI가 다음 요소를 고려하여 시나리오를 생성합니다:

  • 현재 스탯 상태 (특히 낮은 스탯)
  • 최근 방문한 시나리오
  • 플레이어의 선택 패턴
  • 게임 진행 상황 (년차, 분기)

2. 플레이어 스타일 분석

게임은 당신의 선택을 분석하여 성향을 파악합니다:

  • 평판 중시형: 관계와 명성을 우선
  • 예산 중시형: 재정 관리를 중시
  • 직원 중시형: 팀워크와 복지 우선
  • 프로젝트 중시형: 성과와 완성도 중심
  • 위험 감수형: 대담한 결정 선호
  • 안정 추구형: 신중하고 보수적

3. 자유 입력 모드

제시된 선택지 외에 원하는 행동을 직접 입력할 수 있습니다:

  • 창의적인 해결책 제안
  • 복합적인 행동 수행
  • 게임 내 제약 없이 실험

AI가 행동의 적절성을 판단하고 스탯 변화를 계산합니다.

4. 개인화된 엔딩

일반 엔딩 대신, AI가 당신의 2년간의 여정을 분석하여:

  • 주요 결정과 그 영향 요약
  • 당신만의 유산(legacy) 서술
  • 플레이 스타일에 맞는 미래 전망

문제 해결

AI 모드가 작동하지 않는 경우

  1. 패키지 설치 확인:
pip list | grep google-generativeai
  1. API 키 확인:
echo $GEMINI_API_KEY
  1. 재설치:
pip uninstall google-generativeai
pip install google-generativeai

API 키 관련 오류

  • API 키가 유효한지 확인
  • 인터넷 연결 확인
  • Gemini API 할당량 확인

클래식 모드로 폴백

AI 모드가 작동하지 않으면 자동으로 클래식 모드로 전환됩니다.

라이선스

이 게임은 교육 및 비상업적 목적으로 자유롭게 사용할 수 있습니다.


당신의 선택이 세상을 바꿉니다. 현명하게 선택하세요!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

Languages

AltStyle によって変換されたページ (->オリジナル) /