shenleiandClaude Opus 5.5
22d534c5eb
VulkanWindow's 3000-line TU becomes sdl_window.cpp (window, events, cursor, screenshot BMP), vk_device.cpp (device, swapchain, MSAA, framebuffers), vk_pipelines.cpp (render passes, pipelines), vk_resources.cpp (buffers, render targets, geometry), vk_textures.cpp (textures, samplers, descriptors), vk_frame.cpp (render) and ui_batches.cpp; vulkan_window.cpp keeps construction and timing stats. Function bodies move verbatim. render() now reads fence/acquire -> prepare_draws -> prepare_ui -> write_draw_states -> record_passes -> record_readbacks -> submit -> finish_readbacks -> present, with FrameDraws / Readback carrying the locals that used to live across 500 lines. Verified: login-screen screenshot byte-identical to HEAD; game-world draw/vertex/index/UI counts identical; ctest, port_gate macos+android, Android build pass. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
83 lines
4.9 KiB
Markdown
83 lines
4.9 KiB
Markdown
# Project map
|
|
|
|
## Reference client (40250)
|
|
|
|
- Root: `MT_40250_SOURCE`, else `reference_root` in `audit/manifest.json` — on this machine
|
|
`../40250/Server Client TMP4/ClientVS22/source` relative to the repo (quote it: the path has spaces).
|
|
- Active sources: the `ClCompile`/`ClInclude` items in `../vs_files/*/*.vcxproj`; files not listed
|
|
there are not product code.
|
|
- Many `UserInterface/` files contain CP949 bytes in comments: use `grep -a` / `grep -arn`, or plain
|
|
grep silently reports no match.
|
|
- Python UI and game scripts: `../../Client/Eternexus/root/*.py` relative to the reference root
|
|
(90 files; identical to the shipped `Client/pack/root.epk`), window layouts in
|
|
`../../Client/Eternexus/uiscript/uiscript/`, locale data in `../../Client/Eternexus/locale_*/`.
|
|
**`assets/root` in this repo is a different (m2dev) version** with material differences
|
|
(e.g. `uitarget.py` button table); never use it as the 40250 reference.
|
|
- Server source (for protocol questions only, not client behavior): `../40250/Server Client TMP4/Server/metin2`.
|
|
|
|
| Library | Lines | Content |
|
|
| --- | ---: | --- |
|
|
| `UserInterface` | 64.7k | network stream + phases, `CPythonPlayer`, `CInstanceBase`, managers, Python modules |
|
|
| `EterLib` | 48.7k | device/render state, camera, input/IME, net stream, resources, collision primitives |
|
|
| `GameLib` | 30.7k | `CActorInstance` (motion, battle, attach, events), flying objects, map/terrain, race data |
|
|
| `EterBase` | 6.3k | utilities, timer, CRC, file |
|
|
| `EffectLib` | 6.1k | effect/particle instances |
|
|
| `EterGrnLib` | 5.9k | Granny models, motion, LOD |
|
|
| `EterPack` | 3.4k | pack format |
|
|
| `MilesLib` | 2.3k | audio |
|
|
| `EterLocale` | 1.1k | codepages, locale strings |
|
|
| `PRTerrainLib` | 1.0k | terrain texture/height data |
|
|
|
|
## Current client
|
|
|
|
- `src/port/<Lib>/<File>.{h,cpp}` — mirror of each 40250 `logic`/`python` unit (see SKILL.md "Code layout").
|
|
- `src/platform/` — implementations of the mirrored 40250 platform classes (D3D8 recorder, Granny,
|
|
Miles, SpeedTree stand-in, window/input, ScriptLib boot).
|
|
- `src/host/` — SDL3 + Vulkan host (`main.cpp` entry, `live_client.cpp` loop, `vulkan_window.h` renderer split across `vulkan_window.cpp`/`vk_*.cpp`/`sdl_window.cpp`/`ui_batches.cpp`); `src/gr2/` — Granny reader; `src/codepage/` — code pages.
|
|
- `third_party/` — vendored cpython 2.7.18, cryptopp, freetype, minilzo.
|
|
- `tests/port/` — port tests and the fake login server; `tests/gr2/` — Granny reader tests.
|
|
- `android/` — SDLActivity shell, `android/build.sh`, `android/push-client.sh`.
|
|
- `scripts/` — gates and build helpers; `tools/` — standalone dev tools (Granny oracle, perf, server).
|
|
- The GDScript runtime and `extension/src/net` below are gone (2026-09-23 … 09-29); the table records
|
|
where logic came from.
|
|
|
|
- The files in the table below are **migration sources**: when a unit is ported, its logic moves out
|
|
of them into the mirror file.
|
|
|
|
### Legacy counterparts (migration sources)
|
|
|
|
| 40250 | Current |
|
|
| --- | --- |
|
|
| `CPythonNetworkStream*` phases, `CAccountConnector` | `extension/src/net/classic/classic_session.cpp`, `classic_stream.cpp`, `classic_parser.cpp` |
|
|
| packet structs / `CMainPacketHeaderMap` | `extension/src/net/classic/wire_classic.h` |
|
|
| `EterLib/NetStream.cpp` sequence + cipher | `extension/src/net/classic/sequence_table.h`, `classic_cipher.cpp` |
|
|
| `CPythonCharacterManager`, `CInstanceBase` state from packets | `extension/src/net/entity_store.cpp`, `project/net_world.gd` |
|
|
| `CPythonPlayer` input/move (`PythonPlayerInput*.cpp`), main `CInstanceBase` movement | `project/player_controller.gd` |
|
|
| `PythonPlayerEventHandler.cpp` (OnMove/OnMoving/OnWaiting/OnStop -> `SendCharacterStatePacket`) | `project/net_play.gd` |
|
|
| `CPythonPlayer` skill use | `project/player_skill.gd` |
|
|
| `CFlyingObject*` | `project/fly_object.gd` |
|
|
| `EterLib/Camera.cpp` + `PythonApplicationCamera` | `project/game_camera.gd` |
|
|
| `ui*.py` windows | `project/ui/*_ui.gd` (ported from the wrong `assets/root`; replaced by the python layer) |
|
|
|
|
### Removed non-counterparts
|
|
|
|
The 106 `project/*_system.gd` files that only their own `test_*_parity.gd` loaded were deleted on
|
|
2026-09-22 (commit `a989b8f1`). Do not recreate them; port the real 40250 code path instead.
|
|
|
|
## Existing evidence (historical)
|
|
|
|
- `docs/CLIENT-GAP.md`, `docs/CLIENT-PARITY-AUDIT-AND-FIX-GUIDE.md`, `docs/archive/CLIENT-40250-PORT.md`,
|
|
`docs/PARITY-GAP.md`: background only; trust the port-map, not their status text.
|
|
- `tools/granny-oracle/run-diff-suite.sh`: Granny numerical comparison suite.
|
|
|
|
## Verification commands
|
|
|
|
```bash
|
|
cmake -S . -B build/native -DCMAKE_BUILD_TYPE=Release -DMT_BUILD_NATIVE_RENDER=ON -DCMAKE_PREFIX_PATH=/opt/homebrew
|
|
cmake --build build/native -j8 && ctest --test-dir build/native --output-on-failure -j4
|
|
./scripts/port_gate.sh macos android # build/port-gate
|
|
./android/build.sh Release --install # build/android + APK
|
|
```
|
|
|
|
All build trees live under `build/` (gitignored). Always finish with `git diff --check`.
|