Marie's Wonderland

An open-source server implementation for mobile game NieR Reincarnation.

Requirements

PC

• .NET 10 SDK
• Visual Studio 2026 or Rider
• Android Platform Tools (adb)

Phone

• An Android device or an Android Studio emulator (physical device not required)

Setup overview

1. Run the server

Open MariesWonderland.slnx and run the project.

The server listens on the standard HTTP and HTTPS ports on localhost:

• http://localhost (port 80) - used for HTTP asset serving
• https://localhost (port 443) - used for gRPC (HTTP/2)

2. Expose the server

The game communicates over gRPC (HTTP/2). You do not need ngrok or an external tunnel if your emulator or device can reach your machine directly.

• If running on an emulator: configure the emulator to reach the host (Android Studio emulators usually can reach the host).
• If running from a remote device or across a network: open ports 80 and 443 on your firewall/NAT and ensure those ports are forwarded to the machine running the server so the game can reach http(s)://<your-host>.

Ensure any network path supports HTTP/2 for gRPC traffic on port 443.

Configuration

Server settings live in src/appsettings.development.json:

{
  "Server": {
    "Paths": {
      "AssetDatabase": "<path to extracted asset revisions>",
      "MasterDatabase": "<path to extracted master data>",
      "ResourcesBaseUrl": "http://<your-host>/aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "Data": {
      "LatestMasterDataVersion": "1234567890",
      "UserDataPath": "Data/UserData"
    }
  }
}

• The ResourcesBaseUrl value must be exactly 43 characters long.
• If you change the length of that segment, you may also need to update the server-side minimal API that serves the short path (the /aaaaaaaa... handler) so its expected length matches your new value.

Project structure

src/                  .NET 10 gRPC + HTTP server
  proto/              protobuf service definitions
  Services/           gRPC service implementations
  Data/               in-memory data stores (master + user)
  Models/             entity and type definitions
  Extensions/         DI, HTTP, and gRPC helpers
  Configuration/      strongly-typed options
  Http/               HTTP API handlers (asset serving, etc.)
  Interceptors/       gRPC interceptors (diff, logging, auth)
  Helpers/            shared game logic helpers
tests/                xUnit test project
  Infrastructure/     shared test base classes and fixtures
  Interceptors/       interceptor unit tests

Disclaimer

See DISCLAIMER.md.

Special Thanks

• onepiecefreak3
• Walter-Sparrow