Daybreak

Custom launcher for Guild Wars.

Download

• Go to Releases
• Download daybreakv[VERSION].zip, where [VERSION] is the version of the release

Features

Please check the wiki for project description and features.

---

Architecture Overview

Daybreak is a cross-platform application built with .NET 10 and Photino.Blazor. The launcher provides a native UI on each platform while sharing the majority of business logic through a common core library.

Project Structure

graph TB
    subgraph "Platform Executables"
        WIN[Daybreak.Windows<br/><i>win-x64</i>]
        LNX[Daybreak.Linux<br/><i>linux-x64</i>]
    end

    subgraph "Shared Libraries"
        CORE[Daybreak.Core<br/><i>net10.0 / net10.0-windows</i>]
        SHARED[Daybreak.Shared<br/><i>net10.0</i>]
    end

    subgraph "Native AOT Subprojects (Windows)"
        INJ[Daybreak.Injector<br/><i>win-x86, NativeAOT</i>]
        API[Daybreak.API<br/><i>win-x86, NativeAOT</i>]
        INST[Daybreak.Installer<br/><i>win-x64, NativeAOT</i>]
    end

    subgraph "Other"
        TESTS[Daybreak.Tests]
        PLUGINS[Example Plugins]
    end

    WIN --> CORE
    LNX --> CORE
    CORE --> SHARED
    INJ --> SHARED
    API --> SHARED
    TESTS --> CORE
    PLUGINS -.-> SHARED

Loading

Component Descriptions

Project	Description
Daybreak.Windows	Windows executable with WebView2, MSAL authentication, shortcuts, and native screen management
Daybreak.Linux	Linux executable using GTK/WebKit via Photino, with Wine-based game injection
Daybreak.Core	Shared Blazor UI, services, and configuration (multi-targeted for Windows-specific features)
Daybreak.Shared	Common models, utilities, and interfaces used across all projects
Daybreak.Injector	NativeAOT x86 executable that injects DLLs into the Guild Wars process
Daybreak.API	NativeAOT x86 library injected into Guild Wars, exposes game data via WebSocket/REST
Daybreak.Installer	Standalone installer/updater executable

---

Build Requirements

Windows

• .NET 10 SDK
• ASP.NET Core Runtime
• WebView2 Runtime (https://go.microsoft.com/fwlink/p/?LinkId=2124703)

Linux

Arch

sudo pacman -S dotnet-sdk aspnet-runtime

Ubuntu/Debian

# Add Microsoft package repository
wget https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb \
  -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

# Install .NET SDK and ASP.NET Core runtime
sudo apt update
sudo apt install -y dotnet-sdk-10.0 aspnetcore-runtime-10.0

Fedora

sudo dnf install dotnet-sdk-10.0 aspnetcore-runtime-10.0

Verify Installation

dotnet --list-sdks
dotnet --list-runtimes

Linux Runtime Requirements

In addition to .NET, the following are required to run Daybreak on Linux:

• GTK 3 and WebKitGTK (for Photino)
• Wine (for running the Windows-based injector and Guild Wars)

---

Wine Integration (Linux)

On Linux, Daybreak uses Wine to run the Windows-based Daybreak.Injector.exe and Guild Wars itself. This section documents the architecture and implementation plan.

Architecture

graph LR
    subgraph "Linux (Native)"
        UI[Daybreak.Linux<br/><i>Photino/GTK</i>]
        INJ_L[DaybreakInjector<br/><i>Linux impl</i>]
        WPM[WinePrefixManager]
    end

    subgraph "Wine Prefix"
        WINE[wine]
        INJ_W[Daybreak.Injector.exe<br/><i>x86</i>]
        GW[Gw.exe]
        API[Daybreak.API.dll]
    end

    UI --> INJ_L
    INJ_L --> WPM
    WPM --> WINE
    WINE --> INJ_W
    INJ_W -->|launches suspended| GW
    INJ_W -->|injects| API

Loading

Wine Prefix Management

Daybreak manages a single dedicated Wine prefix for all Wine operations. This is handled by IWinePrefixManager:

public interface IWinePrefixManager
{
    /// <summary>
    /// Checks if Wine is installed and available on the system.
    /// </summary>
    bool IsAvailable();

    /// <summary>
    /// Initializes the Wine prefix if it doesn't exist (wineboot --init).
    /// </summary>
    Task Install(CancellationToken cancellationToken);

    /// <summary>
    /// Returns the path to Daybreak's Wine prefix directory.
    /// </summary>
    string GetWinePrefixPath();

    /// <summary>
    /// Launches a Windows executable through Wine with the managed prefix.
    /// </summary>
    Task<(string? Output, string? Error, int ExitCode)> LaunchProcess(
        string exePath, 
        string workingDirectory, 
        string[] arguments,
        CancellationToken cancellationToken);
}

Path Translation

Wine exposes the Linux filesystem through the Z: drive. The PathUtils class provides a method to convert native Linux paths to Wine-compatible paths:

Linux Path	Wine Path
/mnt/games/Guild Wars/Gw.exe	Z:/mnt/games/Guild Wars/Gw.exe
/home/user/.daybreak/Injector/Daybreak.Injector.exe	Z:/home/user/.daybreak/Injector/Daybreak.Injector.exe

// PathUtils.cs
public static string ToWinePath(string linuxPath)
{
    // Convert /path/to/file to Z:/path/to/file
    return $"Z:{linuxPath.Replace('/', '\\')}";
}

---

Credits

• Daybreak project is distributed under MIT license
• Tango icons - LordBiro
  • Icons Daybreak/wwwroot/img/tango are distributed under GFDL license