4v5u09Z5a4Yuc/mtgodot-poc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
75d2dd8545d2bc399897c78f15acfbbef9fdc555
mtgodot-poc/.agents/skills/metin2-40250-parity-audit/references/project-map.md
T
shenleiandClaude Opus 5.5 75d2dd8545 host: split src/host/main.cpp into translation units 
main.cpp (4.5k lines) -> main.cpp (entry, args, synthetic benchmark) plus
vulkan_window, live_client, frame_policy, native_audio, texture_decode,
render_state, input_keymap, host_util. Bodies are moved verbatim; multi-line
VulkanWindow / NativeAudioEngine / FrameRatePolicy members are defined out of
line; one-line accessors stay inline. Anonymous namespace -> mt_host.

No behavior change: ctest 15/15, port_gate macos+android PASS, desktop
--live-client login screen and synthetic --draws runs unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 19:30:44 +09:00

4.9 KiB
Raw Blame History

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.cpp renderer); 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

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.

Reference in New Issue View Git Blame Copy Permalink