AVA2 cross-platform client
Independent AVA2 port, Android arm64 first with macOS arm64 for development. The host, login/selection transport, supported loading/game socket bridge and Python 2 bootstrap are implemented. It is not yet a playable client.
git submodule update --init --recursive # only when ../sdk is not checked out
cmake -S . -B build/dev -DCMAKE_BUILD_TYPE=Debug
cmake --build build/dev -j 8
ctest --test-dir build/dev --output-on-failure
python3 tools/verify_baseline.py
./build/dev/ava2_client --frames 60 --stdlib build/dev/python27.zip --python-root upstream/python-root
SDL3 development package is required for the window host. Use -DAVA2_BUILD_HOST=OFF for a build without a window, or -DAVA2_EMBED_PYTHON=OFF to disable Python. Python 3 only runs developer tools; gameplay retains Python 2.
build/dev/ava2_login AUTH_HOST AUTH_PORT GAME_HOST GAME_PORT ACCOUNT exercises the authentication transport and lists five character slots. Set AVA2_PASSWORD securely in the launching environment. No default server is configured. Real AVA2 server verification remains pending; use an isolated development server.
Android CMake builds require the NDK toolchain and an Android SDL3 SDK prefix. The main shared library compiles and links for arm64; APK packaging and device verification are pending. Original decoded assets remain in the sibling AVA2 directory; only immutable source/script references are copied into this repository.
See port status, mobile architecture, login implementation and verification, and active login profile.
Windows equivalence is tracked in the parity audit. Preview characters require --preview-data; game previews do not prove server gameplay. The static placeholder inventory is regenerated with python3 tools/audit_windows_parity.py.
The SDK is maintained in its own Git repository
(https://git.slcydia.fun/4v5u09Z5a4Yuc/metin2-SDK.git). By default CMake uses an SDK
checkout beside this repository (../sdk, i.e. chakan and sdk in the same parent
directory). Without it, the build falls back to the pinned sdk submodule: clone with
git clone --recurse-submodules or run the initialization command above. Any other
checkout can be selected with -DAVA2_SDK_ROOT=/absolute/path/to/sdk.
Keep build outputs in build/dev, build/release, or another named directory
under build/, rather than configuring directly into build/. Put diagnostic
screenshots, logs, and one-off probes under build/verification/; permanent tests
belong in tests/ and reusable tools in tools/. dist/ contains generated
release packages. Loose game resource directories are used by development and
packaging and should not be treated as disposable caches.