{{ define "main" }}
{{ partial "page-heading.html" . }}
<div class="docs-layout wrap">
  <aside class="side-nav"><span class="eyebrow">On this page</span><nav aria-label="On this page"><a href="#game-data">01 / Game data</a><a href="#environment">02 / Build environment</a><a href="#source">03 / Source code</a><a href="#run">04 / Run Nanolathe</a><a href="#troubleshooting">Troubleshooting</a></nav><div class="aside-status"><span class="status-dot"></span> Development preview<p>Signed downloads are planned for a later release.</p></div></aside>
  <div class="article">
    <section id="game-data"><span class="eyebrow">Step 01</span><h2>Bring your game data.</h2><p>Nanolathe runs with the original Total Annihilation assets. Buy a copy from <a href="https://www.gog.com/en/game/total_annihilation_commander_pack">GOG</a> or <a href="https://store.steampowered.com/app/298030/Total_Annihilation/">Steam</a>, or use your original CDs to install the game. Copy the installed game folder to the machine running Nanolathe.</p><p>Point Nanolathe at that installed folder, containing the game’s HPI archives and any installed expansion data. A store installer or CD image is not an installed game directory. Keep the original archives together; you don’t need to unpack them.</p><p>The development reference installation includes the base game, Core Contingency, Battle Tactics, and the 3.1 patch. Compatibility with other combinations is still being established.</p><div class="inline-note">Nanolathe supplies the engine. Original game data is required separately and is not included.</div></section>
    <section id="environment"><span class="eyebrow">Step 02</span><h2>Prepare your build environment.</h2><p>Install <a href="https://go.dev/dl/">Go 1.25 or newer</a> and <a href="https://git-scm.com/downloads">Git</a>. The engine uses Ebitengine for its window, graphics, and audio. See the <a href="https://ebitengine.org/en/documents/install.html">Ebitengine installation guide</a> for platform details.</p>
      <details open><summary>macOS</summary><p>Install the Xcode Command Line Tools if you don’t already have a C compiler:</p><pre><code>xcode-select --install</code></pre></details>
      <details><summary>Linux</summary><p>On Debian or Ubuntu, run the dependency installer from the engine checkout after cloning it:</p><pre><code>bash .github/scripts/install-linux-deps.sh</code></pre><p>It installs the compiler and native graphics/audio development packages using <code>sudo apt-get</code>. Other distributions should follow Ebitengine’s installation guide. The interactive client needs a working graphical desktop.</p></details>
      <details><summary>Windows</summary><p>Install Go and Git, then use PowerShell for the commands below. Ebitengine does not require a separate C compiler on Windows. Replace the game-data path with your Windows installation path.</p><p>Platform support is still in development; these are source-build prerequisites, not a promise of release-level compatibility.</p></details>
    </section>
    <section id="source"><span class="eyebrow">Step 03</span><h2>Get the engine source.</h2><p>Clone the repository, then enter the checkout.</p><div class="command-panel"><div class="command-title">Terminal <button class="copy-button" data-copy="clone-command">Copy commands</button></div><pre><code id="clone-command">git clone {{ site.Params.engineRepo }}.git
cd nanolathe</code></pre></div><p>You can also download the source ZIP from the repository’s <strong>Code</strong> menu and open a terminal in the extracted folder.</p></section>
    <section id="run"><span class="eyebrow">Step 04</span><h2>Launch Nanolathe.</h2><p>Run this from the engine checkout. Replace the quoted path with your installed game folder; <code>go run</code> downloads Go dependencies and builds the program on the first launch.</p><div class="command-panel"><div class="command-title">Terminal <button class="copy-button" data-copy="start-command">Copy command</button></div><pre><code id="start-command">go run ./cmd/nanolathe --root "/path/to/TotalAnnihilation"</code></pre></div><p>For example, on Windows:</p><pre><code>go run ./cmd/nanolathe --root "C:\Games\TotalAnnihilation"</code></pre><p>Or set <code>NANOLATHE_TA_ROOT</code> in your environment and omit <code>--root</code>. Run <code>go run ./cmd/nanolathe --help</code> to see the current options.</p><div class="inline-note">This is an active development build. Expect unfinished behavior. In-battle save restoration is not yet supported.</div></section>
    <section id="troubleshooting"><h2>If something gets in the way.</h2><dl class="troubleshooting"><dt>GitHub returns 404 or cloning fails</dt><dd>Check the repository URL and your Git configuration.</dd><dt>The engine cannot find game content</dt><dd>Check that <code>--root</code> points to the installed game folder and that the original archives are present. Keep quotation marks around paths containing spaces.</dd><dt>Compilation fails on native libraries</dt><dd>Check the platform prerequisites above. On Linux, the engine’s dependency script installs the packages used by its CI build.</dd><dt>Something in the game behaves incorrectly</dt><dd>Check the <a href="{{ site.Params.engineRepo }}/blob/{{ site.Params.engineBranch }}/README.md">current engine status</a> and <a href="{{ site.Params.engineRepo }}/issues">report an issue</a> with your operating system, commit, command, and error output. Don’t attach retail game archives.</dd></dl></section>
  </div>
</div>
{{ end }}