개요

원본 World Conqueror 4 APK로부터 러시아어 빌드를 조립합니다: 게임을 디컴파일하고, 리소스를 복호화하고, 선택한 패치를 적용하고, APK를 재빌드하고 서명합니다. 결과물은 설치 준비가 완료된 build/wc4_wc4-aligned-debugSigned.apk입니다.

빌드

필요 사항: Java 11+, Python 3.12+ (pip install cryptography), CMake 4.3+ 및 Ninja. 기본 APK, apktool 및 uber-apk-signer는 자동으로 다운로드되며 SHA-256이 검증됩니다.

cmake --preset default            # 구성 + 기본 APK 다운로드
cmake --workflow --preset build   # → build/wc4_*.apk

자체 APK 사용: cmake --preset default -Dapk_input=/경로/wc4.apk.

암호화

scripts/wc4_crypt.py — 명령은 단 두 개뿐입니다:

python3 scripts/wc4_crypt.py decrypt <file> -o <out>   # 헤더 자동 감지
python3 scripts/wc4_crypt.py encrypt <file> -o <out>   # 항상 MD5_SIZE
python3 scripts/test_crypt.py                          # roundtrip 테스트

암호: AES-256-CBC, 암호화된 파일의 헤더는 MD5_SIZE (md5 + origsize + ct).

패치

모두 기본적으로 활성화됩니다. 하나를 비활성화하려면: -DWC4_PATCH_<이름>=OFF. 자체 조합 구성: -DWC4_PATCHES="ru_translation;extras".

패치	플레이어에게 제공하는 것
ru_translation	완전한 러시아어 번역: 모든 텍스트, 키릴 문자 폰트, 인트로 화면
extras	모든 것이 즉시 해금: 장군, 시나리오, 정복, 기술
expose_saves	세이브 파일이 공용 Documents 폴더에 저장됨 — 모든 파일 관리자에서 보이며, 복사하거나 다른 기기로 옮기기 쉬움
disable_gdpr	실행 시 GDPR 동의 창을 제거

MCP 서버

scripts/mcp_server/server.py — opencode 에이전트용 Python MCP (libmcp 포트, 디버거 없음, 순수 APK 덤프용). python3만 필요합니다: 첫 실행 시 gitignored-venv scripts/mcp_server/.venv를 자동 생성하고 의존성을 추가로 받아오며, 시스템 python3는 건드리지 않습니다:

python3 scripts/mcp_server/run.py

도구: wc4_decrypt_file, wc4_encrypt_bytes, json_query_file, project_tree, read_project_file, git_status, list_cmake_presets, cmake_configure, cmake_build, ctest, list_presets, toolchain_info.

세이브

폴더: /sdcard/Documents/EasyTechGame/WC4/<프로필-id>/. Waydroid에서는 호스트에서 접근 가능: ~/.local/share/waydroid/data/media/0/Documents/EasyTechGame/WC4/.

권한이 없으면 게임이 세이브를 인식하지 못합니다:

• Android 11+: 첫 실행 시 게임이 시스템 설정을 엽니다 — «모든 파일 접근»을 활성화하고 게임을 재시작하세요.
• Android 10 이하: 요청 시 저장소 접근을 허용하세요.