erik/acdream
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Modern open-source C# .NET 10 Asheron's Call client. Faithful port of retail client behaviour to Silk.NET with a plugin API.
201 commits 3 branches 0 tags 61 MiB
Find a file
Erik eeee4c5733 chore(scenery): audit SceneryGenerator against decompiled acclient.exe — all MATCH 
Performed a side-by-side comparison of every LCG formula in SceneryGenerator.cs
against the decompiled retail acclient.exe (Ghidra output):

  Scene-selection hash  chunk_00530000.c:1144   — MATCH (0x2a7f2b89·x+0x6c1ac587)·y - 0x421be3bd·x + 0x7f8cda01
  Per-object frequency  chunk_00530000.c:1168-74 — MATCH accumulator pattern cellMat2*(0x5b67+j)
  X displacement        chunk_005A0000.c:4858-66  — MATCH offset 0xb2cd=45773
  Y displacement        chunk_005A0000.c:4871-78  — MATCH offset 0x11c0f=72719
  Quadrant rotation     chunk_005A0000.c:4880-4902 — MATCH constants 0x6f7bd965/0x421be3bd/-0x17fcedfd
  Object rotation hash  chunk_005A0000.c:4924-26  — MATCH offset 0xf697=63127
  Scale hash            ACViewer ObjectDesc.cs     — MATCH offset 0x7f51=32593 (chunk not dumped)

Key finding: the decompiled client normalises signed-int LCG values with
"if (val < 0) val += 2^32" before dividing by 2^32. Our unchecked((uint)(...))
is exactly equivalent. ACViewer's reference omits this cast for some formulas
(displacement, rotation) and is subtly wrong for those; our implementation
already had the correct uint cast throughout.

Added inline decompiled-source citations to all five algorithm sites plus
an updated class-level doc comment noting the audit status and implementation note.

No behaviour change — comments only.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-13 13:50:04 +02:00
docs docs: development workflow + phase-by-phase audit 2026-04-13 13:27:08 +02:00
src chore(scenery): audit SceneryGenerator against decompiled acclient.exe — all MATCH 2026-04-13 13:50:04 +02:00
tests fix(anim): remove frame swap — cursor now traverses all frames in reverse 2026-04-13 13:15:27 +02:00
tools feat(core): port decompiled AC client physics — CollisionPrimitives + PhysicsBody 2026-04-12 23:54:51 +02:00
.gitignore chore: phase 0 — skeleton + dat asset inventory 2026-04-10 09:02:56 +02:00
AcDream.slnx feat(net): AcDream.Core.Net scaffold + ISAAC keystream (Phase 4.1) 2026-04-11 14:14:28 +02:00
CLAUDE.md docs: development workflow + phase-by-phase audit 2026-04-13 13:27:08 +02:00
README.md chore: phase 0 — skeleton + dat asset inventory 2026-04-10 09:02:56 +02:00

README.md

acdream

Experimental modern open-source Asheron's Call client in C# / .NET 10.

Status: pre-alpha, not playable. Phase 0 only — dat file asset inventory.

Stack: .NET 10, Chorizite.DatReaderWriter for dat parsing. Silk.NET + Avalonia planned for rendering/UI (not yet wired up).

Requires: A retail Asheron's Call install (Turbine/Microsoft property — supply your own). Set ACDREAM_DAT_DIR environment variable to the directory containing client_portal.dat, client_cell_1.dat, client_highres.dat, and client_local_English.dat, or pass it as the first CLI argument.

Layout

  • src/AcDream.Cli/ — console app that dumps asset counts from a dat directory
  • references/ — local read-only reference material (ACE, ACViewer, WorldBuilder, DatReaderWriter, holtburger, retail AC install). Gitignored.

Run

dotnet run --project src/AcDream.Cli -- "C:\path\to\Asheron's Call"

Or set ACDREAM_DAT_DIR and run without args.