phase(N.0): wire up WorldBuilder fork as submodule + project refs

Phase N.0 setup for the WorldBuilder migration. Replaces the local
read-only clone of Chorizite/WorldBuilder at references/WorldBuilder/
with a git submodule pointing at our fork
(github.com/eriknihlen/WorldBuilder.git, branch acdream).

Changes:
- .gitignore: exempt references/WorldBuilder from the references/
  ignore rule so the submodule can be tracked.
- .gitmodules (new): submodule entry tracking acdream branch on fork.
- src/AcDream.Core/AcDream.Core.csproj: add ProjectReference to
  WorldBuilder.Shared and Chorizite.OpenGLSDLBackend so we can call
  TerrainUtils, SceneryHelpers, etc. from our Core code.

Build green, all 93 scenery/terrain tests pass. The 8 pre-existing
DispatcherToMovement test failures are unrelated and exist on main.

Notes for users picking up this branch on main:
- After merge, the existing local clone at references/WorldBuilder
  may need to be removed before `git submodule update --init` will
  populate the submodule.
- Working on the fork happens via `cd references/WorldBuilder && git
  checkout acdream && <changes> && git push`. To pull upstream
  Chorizite/WorldBuilder fixes: `git remote add upstream
  https://github.com/Chorizite/WorldBuilder.git && git fetch upstream
  && git merge upstream/master`.

Next: Phase N.1 — replace SceneryGenerator algorithm calls with
WB's SceneryHelpers + TerrainUtils.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

.gitignore

@@ -18,7 +18,11 @@ packages/
 Thumbs.db
 
 # Reference repos and retail client (large, not our code, separate licenses)
-references/
+# WorldBuilder is exempt — it's a load-bearing dependency tracked as a git
+# submodule pointing at our fork (Phase N, see docs/architecture/worldbuilder-inventory.md).
+references/*
+!references/WorldBuilder
+!references/WorldBuilder/
 
 # Claude Code session state
 .claude/

.gitmodules

@@ -0,0 +1,4 @@
+[submodule "references/WorldBuilder"]
+	path = references/WorldBuilder
+	url = git@github.com:eriknihlen/WorldBuilder.git
+	branch = acdream

references/WorldBuilder

@@ -0,0 +1 @@
+Subproject commit 167788be6fce65f5ebe79eef07a0b7d28bd7aa81

src/AcDream.Core/AcDream.Core.csproj

@@ -18,5 +18,13 @@
   </ItemGroup>
   <ItemGroup>
     <ProjectReference Include="..\AcDream.Plugin.Abstractions\AcDream.Plugin.Abstractions.csproj" />
+    <!-- Phase N: WorldBuilder is acdream's rendering + dat-handling base.
+         See docs/architecture/worldbuilder-inventory.md for the inventory of
+         what we use from WB vs port from retail decomp ourselves.
+         WorldBuilder.Shared = stateless helpers (TerrainUtils, TerrainEntry, RegionInfo).
+         Chorizite.OpenGLSDLBackend = render managers + SceneryHelpers + ParticleEmitterRenderer
+         (full GL pipeline; we currently use only the stateless SceneryHelpers from it). -->
+    <ProjectReference Include="..\..\references\WorldBuilder\WorldBuilder.Shared\WorldBuilder.Shared.csproj" />
+    <ProjectReference Include="..\..\references\WorldBuilder\Chorizite.OpenGLSDLBackend\Chorizite.OpenGLSDLBackend.csproj" />
   </ItemGroup>
 </Project>