CPoW World — 3D 창조 시뮬레이터

⚠️ test1 미러입니다. 정식 개발 저장소 → https://github.com/weed97/cpow_world
이 파일·cpow_* 폴더는 export 소스. CPOW_CANONICAL.md 참고.

게임이 아닙니다. 유저 창조 데이터가 물리 법칙이 되는 CPoW (Creativity-Proof of Work) 자율 시뮬레이션입니다.

Eldoria (fantasy_simulator)와 완전 분리된 독립 프로젝트입니다.

정식 저장소 (여기서 작업)

https://github.com/weed97/cpow_world

git clone https://github.com/weed97/cpow_world.git
cd cpow_world
pip install -r requirements-api.txt
bash scripts/verify.sh

test1에 아직 코드가 남아 있으면 → docs/SPLIT_REPO.md
모바일에서 push: → docs/MOBILE_PUSH_CPOW.md

구조

cpow_engine/          # Python 시뮬 엔진 (물리·CPoW·에리어·거버넌스)
cpow_api/             # FastAPI 서버 (/v1/areas/*, /v1/world/*, /v1/auth/*)
cpow_client/unity/    # **Unity 2022.3+** 3D 클라이언트 (청크 스트리밍)
cpow_client/godot/    # 레거시 Godot 프로토타입
docs/                 # CPOW 설계 문서
tests/                # API 통합 스모크 테스트

빠른 실행

# API 의존성
pip install -r requirements-api.txt

# 엔진 데모
python3 -m cpow_engine.demo --areas

# API 서버 (Eldoria 불필요)
uvicorn cpow_api.server:app --host 127.0.0.1 --port 8765

# 테스트
bash scripts/verify_cpow.sh

Unity 3D 클라이언트 (권장)

1. 위 API 서버 실행
2. Unity Hub → 2022.3 LTS+ → cpow_client/unity/CPoWWorld 열기
3. Assets/CPoW/Scenes/Boot.unity → Play

청크 스트리밍·메모리 풀: cpow_client/unity/docs/CLIENT_ARCHITECTURE.md

환경 변수:

변수	기본값	설명
CPOW_API_URL	http://127.0.0.1:8765	API 베이스 URL
CPOW_CREATOR_ID	cpow_player	creator_id

Godot (레거시)

cpow_client/godot/ — 초기 프로토타입만 유지. 신규 3D 작업은 Unity 사용.

Eldoria와의 차이

	Eldoria (fantasy_simulator)	CPoW World
클라이언트	2D Godot + XR 슬라이스	3D Unity cpow_client/unity
API	/v1/turn, /v1/session	/v1/areas/* 전용 cpow_api
엔진	고정 RPG 규칙	속성 기반 창조 물리

별도 저장소로 분리

→ docs/SPLIT_REPO.md

문서

• CPOW_ARCHITECTURE.md
• CPOW_ROADMAP.md
• TODO_REMAINING.md
• cpow_client/unity/docs/CLIENT_ARCHITECTURE.md

개발

python3 -m unittest discover -s cpow_engine/tests -v
python3 -m unittest tests.test_cpow_api_flow -v
python3 -m compileall -q cpow_engine cpow_api