FM4 Online - Xenia build for Forza Motorsport 4 online
=======================================================

This is the Xenia Canary build we use to play Forza Motorsport 4 on the FM4 Online server
(https://forza-motorsport-4.duckdns.org/). It is already set up for the server.

What is inside
--------------
- xenia_canary_netplay.exe
    Xenia Canary, netplay branch by AdrianCassar, with our additions for FM4:
    the Xbox LIVE Marketplace (DLC list, Microsoft Points, car tokens), "lazy" readback of
    render-to-texture results (much faster than "full", with correct car liveries and photos),
    an audio stutter fix and an FPS counter.
- xenia-canary-netplay.config.toml
    A preset with only the settings FM4 Online needs. On its first start Xenia adds every other
    setting with its default value.
- portable.txt
    Keeps Xenia's settings, profiles, saves and cache in this folder.
- patches    Two FM4 patch files, one for each version of the game. Xenia uses the one that matches yours:
      "4D530910 - Forza Motorsport 4.patch.toml"            the original 2011 discs (v0.0.0.8)
      "4D530910 - Forza Motorsport 4 (v0.0.0.15).patch.toml" the 2012 re-release (v0.0.0.15)
    Each patch is off until you change its is_enabled = false to is_enabled = true:
      FPS-independent home screen camera (FM4 Online), Skip intro and Disable hash checks (Doliman100).
- LICENSE.txt
    Xenia's license.

What you need
-------------
- Windows 10 or 11 (64-bit) and a graphics card with Direct3D 12.
- The Microsoft Visual C++ Redistributable 2015-2022 (x64) from Microsoft's website.
- Your own copy of Forza Motorsport 4 (disc image or extracted game). DLC you own can be
  installed into Xenia (File menu, install content).

How to start
------------
1. Unzip this folder anywhere you can write to (not into Program Files).
2. Start xenia_canary_netplay.exe. Windows may warn about an unknown app: "More info", then "Run anyway".
3. Create a Xenia profile and sign in with it. Its gamertag is your name on the leaderboards and the website.
4. Open your FM4 disc image or default.xex with File > Open.
5. Play. FM4 connects to the FM4 Online server by itself when you go online.

The website
-----------
On https://forza-motorsport-4.duckdns.org/ you see the leaderboards, Rivals, clans and the news.
To sign in, type your gamertag: the site sends a verification code to your in-game Message Center.

Check your download
-------------------
SHA-256 of xenia_canary_netplay.exe:
3aeb341149965fbed5d840cccd46984c78a0abb0542afd5b3fb7f96214eedf7b

Notes
-----
- The build also contains our developer tools (for example a render debug window). They stay off unless
  you start them.
- Xenia is open source under the BSD license (LICENSE.txt). Upstream: github.com/xenia-canary/xenia-canary,
  netplay branch: github.com/AdrianCassar/xenia-canary.
