4thfever/cultivation-world-simulator

어떤 프로젝트인가요?

핵심 기능

• 01각 NPC는 고유한 성격, 기억, 관계를 지닌 독립적인 LLM 기반 에이전트입니다.
• 02영근, 수련 경지, 공법, 종문, 수명을 다루는 규칙 체계가 AI의 행동을 제한합니다.
• 03종문 간 대립, 경매와 무술 대회 같은 대규모 이벤트에서 이야기가 자연스럽게 만들어집니다.
• 04플레이어는 천도가 되어 천겁을 내리거나 수련자의 심경을 바꾸는 방식으로 개입할 수 있습니다.
• 05Docker 배포와 데스크톱 빌드를 지원하며, DeepSeek, MiniMax, Ollama 같은 모델 프리셋을 설정해 소스 기반으로 개발할 수 있습니다.
• 06외부 에이전트가 세계를 관찰하고 영향을 줄 수 있도록 조회 및 명령 HTTP API를 제공합니다.

활용 사례

• 미리 짜인 이야기가 아닌, 플레이할 때마다 이야기가 생성되는 샌드박스 수련 게임을 즐길 때.
• 제약된 규칙 세계에서 다중 에이전트 LLM의 행동을 연구할 때.
• API를 통해 시뮬레이션 세계를 관찰하고 개입하는 외부 에이전트를 구축할 때.
• 내러티브 게임용 LLM 기반 NPC 시스템을 프로토타이핑할 때.

빠른 시작

1. 1

   백엔드 종속 항목을 설치합니다

   pip install -r requirements.txt
2. 2

   프런트엔드 종속 항목을 설치합니다(Node.js 필요)

   cd web && npm install && cd ..
3. 3

   프런트엔드를 개발 모드로 실행해 서버를 시작한 다음, 설정 페이지에서 모델 프리셋을 구성합니다

   python src/server/main.py --dev
4. 4

   시작 로그에 표시된 프런트엔드 주소를 엽니다(일반적으로 http://localhost:5173)

사용 전 알아둘 점

• !플레이하려면 DeepSeek, MiniMax 또는 Ollama와 같은 정상 작동하는 LLM 모델 서비스가 필요합니다.
• !README에는 Docker 배포가 테스트되지 않았다고 명시되어 있습니다.
• !모바일 UI는 아직 완전히 최적화되지 않았습니다.

토픽

자주 묻는 질문

cultivation-world-simulator은(는) 무엇인가요?

모든 수련자가 규칙 기반 세계에서 행동하는 LLM 에이전트인 AI 기반 선협 수련 세계 시뮬레이터입니다. Cultivation World Simulator는 플레이어가 "천도"가 되어 저절로 변화하는 선협 세계를 지켜보는 텍스트·지도 기반 게임입니다. 각 수련자는 고유한 성격, 기억, 관계, 목표를 지닌 독립적인 LLM 기반 에이전트이며, 영근, 경지, 공법, 종문, 단약, 무기, 경매, 수명 등을 아우르는 규칙 체계에 따라 세계가 움직입니다.

cultivation-world-simulator은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

cultivation-world-simulator은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

cultivation-world-simulator은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. cultivation-world-simulator의 마지막 커밋은 2026년 8월 16일입니다.

cultivation-world-simulator은(는) 어디에 사용할 수 있나요?

미리 짜인 이야기가 아닌, 플레이할 때마다 이야기가 생성되는 샌드박스 수련 게임을 즐길 때. 제약된 규칙 세계에서 다중 에이전트 LLM의 행동을 연구할 때. API를 통해 시뮬레이션 세계를 관찰하고 개입하는 외부 에이전트를 구축할 때. 내러티브 게임용 LLM 기반 NPC 시스템을 프로토타이핑할 때.

cultivation-world-simulator는 어떻게 설치하나요?

백엔드 종속 항목을 설치합니다: pip install -r requirements.txt 프런트엔드 종속 항목을 설치합니다(Node.js 필요): cd web && npm install && cd .. 프런트엔드를 개발 모드로 실행해 서버를 시작한 다음, 설정 페이지에서 모델 프리셋을 구성합니다: python src/server/main.py --dev 시작 로그에 표시된 프런트엔드 주소를 엽니다(일반적으로 http://localhost:5173)

cultivation-world-simulator은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/4thfever/cultivation-world-simulator