gwnative

KO | EN

gitlite — search

#github #agent #react #graphql #deep-learning #dotnet #artificial-intelligence #chatgpt #nlp #pytorch

(★ 9)

A native macOS host for the Guild Wars WebAssembly client. No Electron, no Chromium, no Node — one Rust binary driving AppKit and WKWebView directly.

File Explorer

ZIP Download

- config.toml
- - certify.yml
  - ci.yml
  - macos-27-canary.yml
  - release.yml
- actionlint.yaml
- CODEOWNERS
- builds.json
- builds.json.sig
- public-key.txt
- - app-icon.png
  - first-run.png
  - game-login.jpg
- architecture.md
- certification.md
- client-compatibility.md
- development.md
- game-api-capabilities.md
- performance.md
- profiles.md
- releasing.md
- rendering-diagnostics.md
- user-guide.md
- GPL-3.0-only.txt
- LicenseRef-ArenaNet-Proprietary.txt
- LicenseRef-Sparkle-2.9.4.txt
- - AppleDeveloperIDCA.cer
  - AppleDeveloperIDG2CA.cer
  - README.md
- - generate_keys
  - LICENSE
  - public-key.txt
  - README.md
  - sign_update
- AppIcon.icns
- debug.entitlements
- icon.png
- Info.plist
- appcast
- benchmark
- benchmarklib.py
- bundle
- certificate-sign
- check-distribution
- check-docs
- check-release-artifacts
- check-scripts
- check-support-matrix
- check-trust-policy
- check-workflow-policy
- client-certify
- icon
- publish
- release
- release-manifest
- sbom
- sign-identity
- signed-run
- webkit-runtime-probe.swift
- - files.rs
  - fixture.rs
  - gate.rs
  - mod.rs
  - prefetch.rs
- - lib.rs
- - mod.rs
  - request.rs
  - response.rs
- - actions.rs
  - mod.rs
- - api.rs
  - content.rs
  - mod.rs
- - certificate.rs
  - codec.rs
  - mod.rs
  - rewrite.rs
- - mod.rs
  - state.rs
- activation_cover.rs
- alert.rs
- app.rs
- boot-chunks.json
- cache.rs
- cli.rs
- commands.rs
- cursor_visibility.rs
- diagnostics.rs
- disk.rs
- dock.rs
- error.rs
- game_api.rs
- generation.rs
- generation_state.rs
- instance.rs
- keychain.rs
- layout.rs
- log.rs
- main.rs
- manifest.rs
- net.rs
- notify.rs
- patch.rs
- paths.rs
- profile.rs
- proxy.rs
- qos.rs
- relaunch.rs
- release.rs
- renderer.rs
- report.rs
- scratch.rs
- settings.rs
- shell.rs
- sockets.rs
- transport.rs
- updater.rs
- webview.rs
- ws.rs
- benchmark_test.py
- web.rs
- audio.js
- audio.test.js
- client-runtime.js
- client-runtime.test.js
- commands.js
- companion-snapshot.js
- companion-snapshot.test.js
- compatibility.js
- compatibility.test.js
- diagnostics.js
- enhancement-cursor.js
- enhancement-cursor.test.js
- enhancement-readout.js
- enhancement-readout.test.js
- enhancements.js
- enhancements.test.js
- filesystem.js
- frame-audit.js
- frame-audit.test.js
- game-api.js
- game-api.test.js
- game-data.js
- graphics.js
- graphics.test.js
- guide.js
- guide.test.js
- harness.js
- image.js
- index.html
- input.js
- launcher.js
- launcher.test.js
- loading.js
- loading.test.js
- memory.js
- memory.test.js
- page.test.js
- passive-observer.js
- platform-capabilities.js
- presentation-barrier.js
- presentation-barrier.test.js
- probe.html
- settings-panel.js
- settings-panel.test.js
- settings.js
- settings.test.js
- sockets.js
- sockets.test.js
- template-save.js
- webkit-absent-apis.test.js
.gitattributes
.gitignore
build.rs
Cargo.lock
Cargo.toml
CONTRIBUTING.md
deny.toml
LICENSE
NOTICE.md
README.md
REUSE.toml
rust-toolchain.toml
support-matrix.json
THIRD-PARTY-NOTICES.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">gwnative</h1>

A lightweight native macOS host for Guild Wars Reforged on Apple Silicon.

Apple Silicon · macOS 15.2 or newer

gwnative runs the official Guild Wars Reforged WebAssembly client in one native
Rust application. AppKit and WKWebView provide the platform directly, without
an embedded browser distribution, Windows, Wine, or a virtual machine.

gwnative is an independent interoperability project. It is not affiliated with,
endorsed, sponsored, or approved by ArenaNet or NCSOFT. See the
[legal notice](NOTICE.md) for ownership, trademark, and game-material details.

gwnative was made possible by
[gw_in_browser](https://github.com/gwdevhub/gw_in_browser), created by
[Marc Henderkes](https://github.com/henderkes). The renderer harness traces
back to that work. The native macOS direction was later inspired by
[gwonmac](https://github.com/Mat4m0/gwonmac); the host itself is an independent
Rust implementation.

## Requirements

- Apple Silicon
- macOS 15.2 or newer

Both are hard requirements. The application ships only an `arm64` binary. The
app tests JSPI inside its own WKWebView and falls back to ArenaNet's official
Asyncify client when the system WebKit does not support it. Installing Safari
Technology Preview does not replace the system WebKit used by WKWebView.

The Asyncify path is verified end to end on macOS 26.6, and the JSPI path on
macOS 27 beta. macOS 15.2–15.x meet the known WebKit requirements but have not
yet had the same end-to-end run; 15.2 is the deployment floor, not a claim of
verified gameplay on every later point release.

## What works

gwnative is playable. It:

- fetches and verifies the current official client artifacts;
- streams the 4.2 GB game image on demand or downloads it in full;
- bridges the client's HTTP and game sockets through a restricted native
  network layer;
- stores the saved login in the macOS Keychain;
- supports Retina rendering, high-refresh displays, macOS keyboard layouts,
  double-click translation, pointer lock, and native window state;
- repairs build-template operations on client builds that have been explicitly
  certified;
- keeps unknown or failed compatibility transforms out of the gameplay path by
  running ArenaNet's original JSPI or Asyncify module;
- offers an optional native game cursor and target-distance readout;
- records structured diagnostics and can produce a redacted problem report;
- rolls back a newly downloaded client that never reaches a first frame; and
- checks for updates, with signed automatic installation in packaged builds.

## Install

1. [Download the latest disk image](https://github.com/jean-humann/gwnative/releases/latest).
2. Open it and drag **Guild Wars** to **Applications**.
3. Open **Guild Wars** and choose how to store the game image.

The first launch downloads the small client artifacts and asks how to handle the
game image:

- **Quick Start** streams areas when first needed and keeps them.
- **Full Game** downloads and verifies missing chunks in the background. You can
  wait for it to finish or start playing while it continues.

<details>
<summary>See the first-launch storage choice</summary>

</details>

See the [user guide](docs/user-guide.md) for settings, storage, updates, and
troubleshooting.

## Build from source

The pinned toolchain declares both required Rust targets. On an Apple Silicon
Mac with Xcode Command Line Tools and `rustup` installed:

```sh
cargo run
```

The first run downloads missing client artifacts. A stable signing identity is
recommended because macOS associates Keychain access with the executable's code
signature; development runs still work without one.

Useful commands:

| Command | Purpose |
| --- | --- |
| `cargo run` | Open the game window |
| `cargo run -- sync` | Refresh the client artifacts and exit |
| `cargo run -- serve` | Run the loopback origin without a window |
| `cargo test` | Run the Rust and dependency-free JavaScript tests |
| `scripts/bundle` | Build `dist/Guild Wars.app` |

The complete setup, environment variables, quality checks, and repository map
are in the [development guide](docs/development.md).

## Documentation

| Document | Audience and scope |
| --- | --- |
| [User guide](docs/user-guide.md) | Installation, settings, data, updates, and recovery |
| [Architecture](docs/architecture.md) | Trust boundaries, boot flow, storage, networking, WebAssembly transforms, and module map |
| [Game API capabilities](docs/game-api-capabilities.md) | Per-domain certification, demand scheduling, API boundaries, and merge train |
| [Development](docs/development.md) | Toolchain, commands, tests, debugging, and environment variables |
| [Client compatibility mechanism](docs/client-compatibility.md) | Update transaction, runtime fallback, certification trust, graphs, and audit checklist |
| [Client certification](docs/certification.md) | Dual-runtime certificates, automation, signing, and rollback |
| [Performance](docs/performance.md) | Reproducible measurements, baselines, and measured design decisions |
| [Release guide](docs/releasing.md) | Bundling, signing, notarization, Sparkle, CI, and publication |
| [Contributing](CONTRIBUTING.md) | Change workflow and documentation expectations |
| [Legal notice](NOTICE.md) | Unofficial-project disclosure, game-material ownership, and trademarks |
| [Third-party notices](THIRD-PARTY-NOTICES.md) | Upstream provenance, modified-source paths, and bundled dependency notices |

The application also ships an offline user guide under **Help → Guild Wars
Guide**. It describes the exact build currently running; this repository's user
guide adds developer-facing paths and recovery details.

## Licence

gwnative's source code and original project material are distributed under
GPL-3.0-only. That licence does not cover Guild Wars names, client code, game
data, artwork, audio, logos, or other proprietary material. See
[LICENSE](LICENSE), the [legal notice](NOTICE.md), and the
[third-party notices](THIRD-PARTY-NOTICES.md).

gwnative

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

gwnative

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README