# Athelas 1.8.2

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept.

## New

- **Launcher**: a **Mods** tab for every game, with the texture packs; the **About** tab is shorter (the licences and
  the launcher's own options are behind buttons).
- **Launcher**: **What's new** shows every release's notes (#51), and an **Exit** button is on the front screen.
- **Launcher**: with a controller, Down on a page's last setting goes to Save (or Library); the Xbox games' tabs are in
  the PC game's order, with Renderer at the top of Graphics.
- **ROTKPlus mod 1.4.0** by brig-dev (#69), still off by default.

## Fixed

- **The Two Towers**: the title screen no longer shakes with FSR (#54).
- **The Two Towers**: Breached Wall plays at 30 fps whatever your frame rate, so the catapults work (#68).
- **The Two Towers**: "No" on the save prompt no longer counts as "Yes" (#56).
- **The Third Age**: characters no longer vanish in the menus; Smooth leaf edges is removed from the Xbox games (#66).
- **Steam Deck / SteamOS / Linux**: the Xbox games find the controller under Proton and Wine (#65). Started from
  Steam with Steam Input, the game uses Steam's controller (your Steam Input layout works) and the Deck's own controls
  aren't read a second time, so one Deck is one player; without Steam the Deck's controls and a Steam Controller are
  read directly. Tip: add Athelas.exe to Steam as a non-Steam game, set it to run with Proton, and leave Steam Input on.
- **Return of the King (PC)**: in borderless mode the game minimizes when the Start menu or taskbar takes the focus (#60).
- **Return of the King (PC)**: softer subtitle outlines (#61); the Perfect Mode ring keeps its shape (#57).
- **Return of the King (PC)**: a controller another player already has is no longer taken (#67, by brig-dev).


# Athelas 1.8.1

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept.

## New

- **ROTKPlus mod** for The Return of the King (PC), by brig-dev: co-op for 3 and 4 players, a Versus mode for up to
  4, and a name and statistics for each player. It is **off by default**: turn it on in the launcher's **Mods** tab.
  Questions and bugs about ROTKPlus go to https://github.com/brig-dev/ROTKPlus (#29, #63).

## Fixed

- **Launcher**: cleaning up old builds no longer follows folder links (junctions), so it can't touch a folder outside
  Athelas.
- **Launcher**: a save backup now stops with a clear message if a folder can't be read, instead of saying it worked
  while leaving files out.
- Each mod's licence is now included in the download (ROTKFix\licenses).


# Athelas 1.8.0

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept.

## New

- **The Third Age: Battle speed** (Gameplay tab, and the in-game menu): 2x, 3x or 4x during battles only;
  exploring, menus and movies stay at normal speed. It is off by default while we make sure every battle is spotted;
  try it and tell us if a battle doesn't speed up or stays fast afterwards. The sound is off while it's sped up.
- **Fast forward on/off** (all four Xbox games): a new Gameplay setting makes F9 turn fast forward on with one press
  and off with the next, instead of holding it. With a controller, **Back + click the right stick** turns it on or
  off. While the game is sped up, ">> 3x" (or the speed you set) shows in the top-right corner.

## Fixed

- **The Return of the King (PC)**: 30 fps is offered on the PC page again, marked "if an event won't trigger", for
  a scripted moment that doesn't happen at higher frame rates (#49).


# Athelas 1.7.9

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept.

## Fixed (from #49, thanks for the detailed report!)

### The Return of the King (PC)

- **Opening logos**: with "Skip opening logos" on they now skip almost at once (the game insisted on showing the EA
  logo for a moment first), without the voice running over the menu.
- **Skipping movies**: one key press or click skips one movie (a click could skip all of them at once). Space and
  WASD skip a movie too.
- **The Windows key works in the game**, and so do screenshot and recording shortcuts (Win+Shift+S, Game Bar,
  ShareX): the game no longer takes the keyboard for itself alone.
- **No flash after minimizing** (Ctrl+Alt+Del): the game stops drawing while it's minimized.
- **Subtitles stay on**: the launcher no longer switches the game's Subtitles option off every time it starts the
  game (and "on" now means on in every language).
- With "Unlock all" on, Helm's Deep only offers the heroes the game itself allows there.

### The launcher

- **Box art** is shown whole, never cropped, and sharper.
- **The Return of the King (PC)** gets a box made from the PC game's own art (there is no PC box art to download).
- The hint for adding a game sits under the Play button.
- **Music**: when none of your games has front-screen music (it comes from The Two Towers, Fellowship and The Third
  Age), the button says so.


# Athelas 1.7.8

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept.

## Fixed

### The Return of the King (PC)

- **Video options flickering, and settings that wouldn't stick** (#45, likely #44): ROTK Fix changed the game's own
  record of its screen settings to "windowed", so the game thought it was in a window: each change in Video options
  made it resize the window (the flicker), and every choice came out as 1024x768 in 16-bit colour. ROTK Fix now
  leaves the game's settings alone, and a change that doesn't change the screen no longer resets it.
- **The resolution list showed 1920x1080 as 1920x1440** (#45): it now shows the real height.
- **"Skip opening logos" didn't skip them** (#48): the game marks its opening logos as never skippable. With the
  setting on, the logos (only) can now be skipped, and are.
- **The spinning blue "busy" cursor while loading** (#46): the game's own cursor is kept while it loads.
- **Jagged edges on the loading ring** (#46): the game switched anti-aliasing off on its first screens; with
  ROTK Fix's anti-aliasing on, it now stays on.
- **Texture packs stuttering** (#47): your own replacement textures are now prepared while the level loads instead of
  when they first appear, they're kept between levels, and DDS files (DXT1, DXT3, DXT5, A8R8G8B8, with mipmaps) are
  used next to or instead of PNGs: they load in a millisecond or two.

### The Xbox games

- **Linux / Wine** (#42): the games start without DirectX 12 and use Vulkan instead, rather than failing to start.
- **Another version of the game** (another region or printing): the launcher now says so in plain words, in your
  language, instead of showing the game's technical log line.
- **Controllers on the Steam Deck**: the launcher lets go of the controllers while a game is running, so it can't
  keep them from the game.


# Athelas 1.7.7

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept.

## Fixed

- **The Third Age: a crash after some minutes of play** (#40): a streamed sound's next block could arrive just after
  the game had stopped that stream (a scene change or a cutscene), and the game read through the emptied slot. Such a
  block is now dropped (the same crash as #43, "random crash in Moria"). If The Third Age still crashes on its
  file-reading thread, its log now names the exact callback, so we can fix that too.
- **The Third Age: the HUD stretched sideways with widescreen on** (#37): the battle HUD keeps its own 4:3 shape in
  the middle of the screen (with "HUD at the screen edges" off). Menus still widen with the screen, and pieces that
  run across the whole screen keep its width. On ultrawide screens the HUD is now 4:3 too (it was 16:9).
- **The Return of the King (Xbox) at 30 fps: a steady 30.** It ran at about 34, with uneven frames, because a wait
  for the screen's refresh only slept a fixed time. Game speed was always right; now the pacing is too.
- **"The port didn't answer"** (#42, seen under Wine): the launcher gives a port longer to answer the first time,
  says plainly why one didn't (timed out, a missing file, a crash), and writes `port-query.log` in that game's
  folder; problem reports include it.

## New

- **One download for every PC**: Windows on ARM no longer has a zip of its own. `Athelas-1.7.7.zip` carries both the
  x64 and the ARM64 builds of the Xbox ports, and each PC runs the right one. (`Athelas-1.7.7-arm64.zip` is the same
  file, for older launchers on ARM PCs.)
- **Fast forward** (#41): hold **F9** in any of the four Xbox games to speed it up, 3x by default (Gameplay > Fast
  forward speed, 2x to 8x). Sound is muted while F9 is held. Pausing while holding it is fine.
- **Vulkan: smoother HUD and text, and texture packs**: Vulkan now has the "Smooth 2D" setting and texture packs,
  texture dumping and the games' own replacement pictures (button pictures, sharper text), as DirectX 12 has.
- **Launcher front screen**: only the games you've added are on the carousel, and it says how to add one (drag
  its folder or disc image onto the window).
- **Texture dumps name the HUD and text pictures** in The Return of the King too, for texture-pack makers.

## Under the hood

- The four Xbox ports now share one copy of the engine code, and the launcher's code was split up and cleaned up
  (unused code removed, stricter checks, a few small launcher bugs fixed, such as a rare crash reading game art).


# Athelas 1.7.6

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept.

## Fixed

- **European, Japanese and other copies of the Xbox games** (#36): the game's page no longer refuses them. It
  warns that the version is untested and unsupported (a European or Japanese copy is expected not to start yet: the
  games are built from the US discs' code). Two buttons, **It worked** and **It didn't work**, open a GitHub page
  with the copy's details to send us. A version built from the other regions' discs is planned.
- **The Return of the King (PC): PlayStation buttons as white discs in the combo list and the upgrade shop** (#34):
  the check for button pictures in a line of text never fired; it now compares against where the font's letters end
  (thanks to brig-dev's analysis).
- **Vulkan: textures dropping out in The Third Age** (it ran out of room for the game's ~13,600 draws a frame and skipped
  the rest).
- **The Return of the King (Xbox): black bars flashing at the sides on ultrawide screens** (#38) in Southern
  Gate and the Minas Tirith Courtyard: a full-screen effect in those levels was taken for a menu picture.
- **The Third Age: a short stutter every few seconds with Sharper text on** (#37): when the game changed a few
  words, the whole page of text was redrawn (about 40 ms); now only the part that changed is.
- **The Third Age: characters bursting into spikes with widescreen on** (#37), in cutscenes and sometimes in play.

## New

- **The Third Age on ultrawide screens** (#35): the game fills the whole width (3440x1440 and wider); the text and
  the HUD stay 16:9 in the middle, as in the other three games.
- **Ultrawide menus** (#35): the menus of The Two Towers, The Return of the King and The Third Age widen with the
  screen up to 21:9 (black beyond that, on 32:9), instead of staying 16:9; play and in-game cutscenes fill the
  whole width.
- **Movies never wider than 21:9**: on a 32:9 screen the intro and story films get bars at the sides instead of
  being zoomed (The Third Age's lost their top and bottom) or stretched.
- **The Third Age: Button pictures** (Graphics): PlayStation, Nintendo or keyboard keys in place of the Xbox buttons,
  as in the other three games. For now the A button; more to come.


# Athelas 1.7.5

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept.

## Fixed

- **"Athelas couldn't read this copy of the game. Is it the US release?"** The Xbox games no longer build
  themselves on your PC: they come ready to play again, as before 1.7.3. Nothing to wait for the first time you
  press Play. (In 1.7.4 the build stopped for many players, The Return of the King in particular; your copy of the
  game was fine.) The build files 1.7.4 left in your Athelas folder (the `kits` and `tools` folders, and a
  `build` folder in each Xbox game's folder, several hundred MB) are removed the first time the new launcher starts.

## New

- **Other releases of the games can be played:** a European, Japanese or other copy (or another US revision) is no
  longer refused. The game's page says it's an untested version that may work but may have problems. If it plays
  well, press **This version works**: Athelas stops asking for that copy, and a GitHub page opens with its details,
  so you can tell us and we can add it as known to work.

- **Sharper button pictures:** the PlayStation and Nintendo buttons in The Two Towers and The Return of the King are
  drawn at 4x the game's size.
- **AMD FSR frame generation (experimental):** Graphics, Frame generation, with the AMD FSR upscaler. Shows a
  made-up frame between each two the game draws, so 3D scenes move more smoothly, on any graphics card. The HUD
  can smear a little while the camera moves for now. Takes effect at the next start.
- **FSR updated** to AMD's FSR SDK 2.4.
- **Settings labels:** SMAA is marked *recommended*; AMD FSR, NVIDIA DLSS and frame generation are marked
  *experimental* (FSR can shimmer in The Third Age); Vulkan is marked *experimental* in The Third Age.


# Athelas 1.7.4

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept. Each Xbox game builds itself again the first time you press Play (about 30 seconds).

## New in the launcher

- **The Third Age's menu music** plays when its box is in front, read from your own copy of the game, and it is in
  the Minstrel on the Journey page.
- **New backgrounds:** every game's page and box now rotate The Two Towers' gallery (film stills and concept art)
  and The Fellowship of the Ring's loading-screen sketches, from whichever of the two you have. The Xbox Return of the
  King only has four small menu pictures, which looked blurry on a large screen.
- **The Third Age saves a still of each film you watch** (in `TA-Xbox\art`), for its backgrounds later on.

## Fixed

- **The Return of the King (PC): button pictures still white in the combo list and the upgrade shop** (#34). Those
  screens draw text at double brightness, which washed the pictures out; they now keep their colours.
- **The Return of the King (PC): the special ability in Options** (#34) shows the controller's two buttons, like the
  rest of the controller column, instead of "Buttons 7 + 8".
- **The Third Age:** stutter in screens that rewrite their text every frame (the sharper text redrew it each time);
  and a possible crash when closing the game.
- **Settings:** the Vulkan renderer's description now says plainly that it is untested and has no anti-aliasing,
  HDR or upscalers yet.

## Coming soon

- **The Third Age in other languages:** translation subtitles in German, French, Spanish, Italian, Portuguese,
  Polish, Dutch, Swedish and Russian, as the other three Xbox games have them.


# Athelas 1.7.3: The Third Age arrives

## ⚔️ New game: The Lord of the Rings: The Third Age

**The Third Age joins Athelas as the fourth game**: the 2004 Xbox RPG, recompiled to run natively on your PC, and built on your PC like the other three.

- **Achievements** for each of its nine areas, from Eregion to the Pelennor Fields, plus the kill deeds and Fate's
  deeds every game shares.
- **On the Journey page:** its areas on the map (with Eregion), level records, quests and Virtues.
- **Widescreen, unlocked frame rate, field of view, draw distance, sharper 4x text** (the title too), smooth leaf
  edges, the HUD at the screen edges, movie zoom, and gameplay and cheat options as in the other games.
- **Drawing on a second core** (on by default): a large jump in frame rate. Turn it off in the Graphics tab if
  characters ever show a ghost image.

> # ⚠️ This update installs differently from every release before it
>
> **Until now, each game came as a ready-made program inside the download. From 1.7.3 on, Athelas builds each
> game's program on your own PC, from your own copy of the game.** No game code is in the download any more,
> only a build kit for each game and the tools to use it.
>
> **What happens when you update:**
>
> 1. Press **Update** in the launcher (or unzip the new release over your Athelas folder). Your **settings,
>    saves, achievements and Journey progress are kept**: none of them are in the download, so nothing touches
>    them.
> 2. Open a game's page. Athelas sees that game needs building and **starts on its own**: a progress bar shows
>    "Building ... for your PC" and how long is left.
> 3. Wait for **"... is ready to play."** This takes **under a minute per game on most PCs (longer on older
>    ones), once**. After that the game starts as fast as before. Each game builds the first time you open its
>    page; you don't have to build all four.
> 4. Play.
>
> **If something goes wrong:**
>
> - **Your antivirus blocks or deletes the new program:** Athelas has just made a new program on your PC, which
>   some antivirus software is wary of. Allow your Athelas folder in your antivirus, then press **Try again**.
> - **The build stops with a message:** press **Try again**. If it fails again, press **Play the previous version
>   for now**: the program you were playing before is kept until the new one builds, so you can keep playing.
>   Athelas tries the update again the next time it starts. Then please open an issue on GitHub with the
>   build log (the **Show the log** button) so we can fix it.
> - **It seems stuck:** the first build of a game is the slow part, and on an older PC it can take longer. The
>   time left is shown under the progress bar.
> - **The download is larger than before:** it carries the build tools. It's a one-time cost.
> - **Left over from earlier versions:** once a game has built, Athelas removes the files the old version left
>   beside it that nothing uses any more. Nothing of yours is touched.
>
> The Return of the King (PC) is not affected: ROTK Fix works as it always has.

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept.

## New: SMAA (all four Xbox games)

- **SMAA** (Graphics tab, **off by default**): smooths jagged edges after the picture is drawn, including leaves
  and grass that anti-aliasing misses. Works with anti-aliasing on or off and costs very little.

## New: the Journey

A new page from the front screen (the **Journey** button, or **J**), in the spirit of The Lord of the Rings
Online. Everything on it that changes how a game plays is **off by default**.

- **Deeds and titles:** every game's deeds in one place, with progress bars. All four Xbox games now count the
  enemies you defeat (deeds at 100, 250, 500, 1,000 and 5,000). Any deed you've earned can be your title, shown
  under Athelas on the front screen.
- **Quests:** three a day and two a week ("Defeat 60 enemies at Helm's Deep"), with titles for 10, 25 and 50
  completed.
- **Map:** the road of the games across Middle-earth, on a parchment of our own with The Two Towers' own
  map of Rohan and the Misty Mountains drawn in from your copy. Places light up as you complete their levels, and
  the road you've walked is marked in red.
- **Records:** each level you complete, with how long it took and how many enemies you defeated, and your bests.
- **Virtues (opt-in):** five virtues ranked by your deeds, three slotted for their full bonus, as in LOTRO. They
  make your hits a little stronger or the damage you take a little lighter (at most 30%), in every game.
- **Fate (opt-in):** a harder road: enemies hit 50% harder and take 25% more to bring down, every enemy counts
  twice towards the kill deeds, and two deeds of its own.
- **Fellowship (opt-in):** in The Return of the King's co-op, while both players are fighting, both hit 10%
  harder.
- **Lore:** a short page for each level, opened by completing it.
- **Minstrel:** play The Fellowship of the Ring's music by name, and The Two Towers' menu theme, from your copies.

## New: graphics

- **Recommended for this PC** (Graphics tab): looks at your graphics card, its memory, your screen and
  processor, and picks a preset and frame rate. **Undo** puts your own settings back.
- **DLSS and FSR:** the HUD, subtitles and menus stay sharp and no longer smear or ghost when upscaling.

## Fixed

- **The Third Age:** the picture no longer changes shape for a few seconds after a movie; leaves, branches and
  fences are no longer blocky, and no longer have a ghostly shadow around them with anti-aliasing on.

- **Renderers:** steadier start-up and plain error messages when the graphics driver stops responding; the
  game no longer picks a software adapter over your graphics card; minimising and resizing are handled.
- **The Return of the King (PC):** when the Vulkan renderer can't start, it now falls back to Direct3D 8 at
  the right resolution.


# Athelas 1.7.2

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept.

## Fixed

- **The Two Towers: HUD pieces coming apart on wide screens** (#33). With "HUD at the screen edges" on, part of
  the health bar or the special meter could be left behind towards the middle of the screen, most often once
  you had lost some health. The pieces now stay together at the edge.
- **The Return of the King (PC): button pictures shown as plain white shapes** (#34) in the pause menu's combo
  list, the in-game hints and the upgrade shop. They now show in colour, as in the Options screen.
- **The Return of the King (PC): the special ability's buttons** (#34) now show the real buttons with a
  controller in the shop and the Options screen, instead of "Button 7" / "Button 8" / "Buttons 7+8".
- **The Return of the King (PC): Vulkan check** - the Vulkan renderer needs a Vulkan 1.4 graphics driver. A PC
  with an older (Vulkan 1.3) driver used to get a black screen; it now falls back to Direct3D 8 and runs.
- **Linux / Steam Deck (Proton):** the settings Athelas makes for ROTK Fix are now checked and written to
  `ROTKFix\wine-overrides.txt` for reports, and Remove ROTK Fix puts back any settings you had before.


# Athelas 1.7.1

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept.

## Fixed

- **The Fellowship of the Ring: sounds going quiet** (#30). After breaking enough things (for example in Bag End),
  new sound effects stopped playing. The game's sound clock was stuck, so finished sounds were never let go and the
  game ran out of sound voices. Sounds now keep playing however much you smash.
- **Launcher: restarts itself after an update** from the home screen (it only did from the old details page). This
  takes effect from your next update after 1.7.1.


# Athelas 1.7.0

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept. This release is about the launcher: it can now do what my other launcher, COGBox, does.

## New in the launcher

- **Athelas in 11 languages**: English, Spanish, French, German, Italian, Portuguese (Brazil), Polish, Russian,
  Japanese, Chinese (Simplified) and Korean. It asks on first start; change it under **This window** on any game's
  About tab. The Xbox ports' settings are translated too. The translations are in the `lang` folder, and
  corrections are welcome.
- **Back up and restore your saves** on each game's About tab. A backup is a zip on your desktop. Restoring one first
  zips the saves you have now ("before restore"), so nothing is lost.
- **A log folder for every play** (Open logs): the log, how the game closed and what that means, and any crash report.
  The newest 15 are kept.
- **Clear shaders** for the Xbox ports, if a game ever looks wrong after a driver update. The saved shaders are set
  aside, not deleted.
- **Play time for The Return of the King (PC)** too. Athelas now waits in the background while it plays, and it says
  so if the game crashes.
- **Desktop shortcuts for each game**: they open Athelas and start that game with its settings.
- **The window grows with you**: resize or maximise it and everything scales. **F11, or LT + RT together**, switches
  fullscreen from any screen. A **borderless** option hides the title bar. On a Steam Deck-sized screen it starts
  maximised and borderless.
- **Controller on the carousel, as in COGBox**: LB / RB light Play or Settings, A presses the lit one. The hints at
  the bottom now show the fullscreen shortcut too.
- **Made by Shagg** and the version (v1.7.0) in the top right corner; the box art no longer has a black outline.
- **The Shire theme** plays on The Fellowship of the Ring's box, from your own copy of the game.
- **Mods from a .zip** (The Return of the King, PC): "Add a mod (.zip)" on the Mods tab. Data mods each get their own
  folder, with a tick, **Up / Down** to set which one wins when two change the same file, and Remove. A mod that is a
  program (a .dll) is only added after a warning.

## Fixes

- **The Two Towers' menu music didn't play** when a European copy was added before the US one. A box now plays (and
  takes its music from) the US copy first.
- ROTK Fix's log now says when a code mod has no `ModInit` (it was reported as started).

The three Xbox ports are the same as in 1.6.1.


# Athelas 1.6.1

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept. Everything in [1.6.0](../../releases/tag/1.6.0) is in this release too.

## Fixes

- **The Return of the King (PC) closed straight after starting on a PC with no Vulkan driver**
  ([#27](../../issues/27)), such as a virtual machine. Without Vulkan, the Vulkan renderer (DXVK) ended the game
  instead of letting ROTK Fix fall back. ROTK Fix now checks for a Vulkan graphics device before it loads DXVK and
  uses Windows' own Direct3D 8 without one, with the reason in `ROTKFix.log`. This also works when `rotk.exe` is
  started directly.
- **The launcher no longer resets `Renderer = native`** in `ROTKFix.ini` to `dxvk` when it loads the PC game's
  settings, so a renderer set by hand is kept.
- **Valar Boons: the first boon was on from the start, with no time limit** (a setting left over from testing). Every
  boon now starts off and lasts its own duration when you call it.
- **"Last played" after a game that didn't start**: a game that couldn't start no longer shows as played, and
  The Return of the King (PC) is marked played only once it has actually started.

## Fixes in all three Xbox ports

From an independent review of the code, each finding checked against the games before it was changed:

- **A rare wrong result in a math instruction** (`PMADDWD`) that The Return of the King and The Fellowship of the
  Ring use: for one combination of values the recompiled code's result was undefined.
- **Copies between two rendered pictures kept at different scales** read the source at the wrong scale; they are now
  drawn across at the right size.
- **Safer handling of unusual requests from the game**: memory released past its block is refused, a damaged game file
  is turned down with a message instead of being read past its end, a folder listing no longer skips a file when the
  game's buffer is small, the file position is updated safely when two threads share a file, a cancelled background
  task no longer runs, an oversized drawing call is skipped and logged, and `nan` in `settings.toml` is ignored.

Thanks to dqunbp for the detailed report on #27, and to the reviewer who went through the code.


# Athelas 1.6.0

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept.

## A new Athelas: your games on a carousel

- **Athelas opens on your games as boxes on a carousel.** The one in front is large; the others stand smaller and
  turned away at the sides. Turn it with the arrow keys, the D-pad or stick, the mouse wheel, or a click on a box.
  Behind it, art from the game in front (from your own copy of the game), changing as you turn. **Play** starts it,
  **Settings** zooms into its page, and **Library** on the page zooms back out.
- **Box art:** **Get box art** downloads the original Xbox covers of the three games from RetroArch's collection
  (libretro thumbnails). Or use your own scans: put `fotr.png`, `tt.png` or `rotk.png` (or .jpg) in the `covers`
  folder beside Athelas. Without either, each box gets a cover made from the game's own art.
- **The Return of the King is one box** for both versions. With both, Play and Settings ask PC or Xbox, and can
  remember your choice ("Ask which version" under the box undoes it).
- Games you haven't added show as faded boxes with the buttons to add them.
- With a controller: A plays, X opens Settings, Y gets box art; Y on a page goes back to the carousel.
- The settings pages are centred, and the game is chosen on the carousel instead of from menus.
- Disc images named `.xiso` are listed when you add a game, as well as `.iso`.

## New in the games

- **The Fellowship of the Ring: chapter select** (Gameplay, "New game starts at"). The game has no level select,
  so this starts a new game at the beginning of any chapter: the Shire (the game's own start), the Old Forest,
  Bree, Weathertop, Rivendell, Moria, Lothlórien or the River Anduin, with that chapter's hero (Aragorn at
  Weathertop and the Anduin, Gandalf in Moria, Frodo elsewhere). Items and quest steps from the chapters you skip
  aren't given: it's for replaying a chapter. Saved games aren't affected.
- **The Fellowship of the Ring: Combat Test** (Gameplay). The developers left three test arenas in the game but
  never switched them on. With this on, Bilbo's room in Rivendell offers a choice of Frodo, Aragorn or Gandalf, and
  each one takes you to an arena with its own enemies. Its exit leads back to Bilbo's room.
- **The Two Towers: Sharper text** (Graphics), as the other two have it: the game's letters are redrawn at four times
  their size from its own fonts, so menus, hints and the between-level screens stay crisp at high resolutions.
- **Movie display: Zoom** (all three Xbox ports, Graphics, Movies). Like Fit, and movies made for a square 4:3
  screen fill a widescreen too, with their top and bottom cut off: Fellowship's logos and 4:3 movies, The Two
  Towers' full-frame ones, ROTK's trailer. The films look the same as with Fit.
- Also new: drag a game folder or disc image onto Athelas to add it; play time and the day last played under each
  box; the games' own menu music on the carousel (The Two Towers and Fellowship; Music on/off); each page opens with
  its game's box.
- **Steam Deck and Linux**: the readme now has the steps for playing through Proton ([#23](../../issues/23)).

## Mods for The Return of the King (PC)

**Contributed by Rodrigo Vieira** ([#26](../../pull/26)): the mod system and Valar Boons are his work. Thank you, Rodrigo!

- **ROTK Fix loads code mods**: a mod's `.dll` and `.ini` in the game's `ROTKFix\mods` folder. Mods can change hits
  in combat, run every frame, draw over the picture, add hotkeys and show notes on screen. A mod can also replace one
  of the game's data files by putting a file with the same `Data\...` path in `ROTKFix\mods`.
- **A Mods tab** on The Return of the King (PC) page lists the installed mods with their details; tick or untick one
  to turn it on or off.
- **Valar Boons**, an example mod that comes with Athelas, **off until you turn it on**: call on the blessings of
  Manwë, Varda or Aulë with the number keys (more damage, a shield that strikes back, or blows that can't hit hard),
  each with its own glow around the screen and a cooldown. Everything is set in `ValarBoons.ini`.

## Fixes

- **The Fellowship of the Ring: crash at a scene change** ([#21](../../issues/21), [#25](../../issues/25)). Besides
  its main thread the game has a timer thread. On the Xbox both shared one processor; on a PC they ran at the same
  time, and the most likely cause of the crash is the timer writing into an object the main thread had just
  freed. They now take turns, as on the console: the timer runs whenever the main thread waits, reads a file or shows a frame. 1.5.1's guard stays too.

## Contributing from now on

From 1.6.0, the releases are published as downloads only: the code on GitHub stays at 1.5 for now. Everything else
works as before: the launcher's **Update** button, the issues, and pull requests.

- **Found a bug or have an idea?** Open an issue. It's the quickest way to get it into the next release.
- **Want to contribute code?** Open an issue first to describe the change, then a pull request against the code on
  GitHub. Accepted changes are brought into the next release by hand, so small, focused changes are easiest to take.
- **Every contribution that ships is credited** in that release's notes by name, as Rodrigo's mod system is here.
- **Mod makers:** ask in an issue for the notes on ROTK Fix's mod interface and a starter mod.


# Athelas 1.5.1

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept.

## The same settings in all three Xbox ports

- **The Return of the King (Xbox) has its own settings page**, laid out like The Two Towers' and Fellowship's: the
  quality presets (Original, Balanced, High, Ultra), the button layout on the Controls tab, and every option of its
  own as a setting (damage, unlock all, Éowyn, the cheats, translation subtitles, second controller), with a Network
  tab for co-op. Up to 1.5 it shared the PC version's ROTKFix.ini; the first time Athelas opens the new page, your
  choices and button layout are brought over from it. (ROTK Fix's Special button and layouts using Back, Start or
  the D-pad have no counterpart in the new layout and go back to the game's own.)
- **Button pictures** in The Two Towers and Fellowship (Controls tab), as ROTK already had: the game's hints and
  menus show Xbox, PlayStation or Nintendo buttons, or the keyboard's keys. Auto follows what you play with.
- **Fellowship: Sharper text** (Graphics tab), as ROTK has: the game's text (menus, hints, dialogue, the quest
  journal) is drawn at three times its size, so it stays sharp at high resolutions.
- **The Two Towers:** **Unlock all levels and characters** (every level, Isildur and the extras from the start, as
  once the game is beaten; your saved progress isn't changed) and **Smooth leaf edges** (with anti-aliasing on).
- **The Return of the King (Xbox):** **Skip opening logos** (once you have a save, the game opens with the EA and
  New Line logos; this goes straight past them).
- **Movie subtitles** (all three, Graphics tab, Movies): the games have no subtitles for their film clips, so the
  ports now show them from subtitle files: put an .srt file named as the movie (`fmv_2.srt`, `HELMFMV1.srt`,
  `mont.srt`; the log names each movie as it starts) in the game's `subtitles` folder (Open folder on the same tab).
- **F1 hides the HUD** in The Return of the King and Fellowship too (for screenshots), as it did in The Two Towers.
- The damage settings run from 10% to 500% in all three.
- Some of ROTK's options aren't in the other two because there they would change nothing: draw distance (neither
  game ever cuts off distant scenery), the TV-safe border (both fill the screen already), Skip any video in
  Fellowship (all its movies skip already), and HUD at the screen edges in Fellowship (its own widescreen mode puts
  the HUD there).

## Fixes

- **DLSS didn't upscale** in the Xbox ports since 1.5: NVIDIA's Streamline turned down each frame, so the game showed
  its render resolution stretched instead (and wrote an error to the log at every frame). DLSS now runs; if an
  upscaler ever turns a frame down, the log says so.
- **With DLSS on, closing the game could end in "the game closed unexpectedly"**: NVIDIA's DLSS files crashed in
  their own clean-up after the game had already closed. The game now ends without running it.
- **The Two Towers, keyboard: Enter didn't press Start on the title screen** ([#8](../../issues/8)), since 1.5's
  fix for #17. Enter presses Start on the title and main menu again; the Yes/No pop-ups between levels still work.
- **Xbox 360 controllers (wireless receiver) not working** in the Xbox ports ([#18](../../issues/18)): Xbox
  controllers go through XInput again (other controllers still through Windows.Gaming.Input).
- **The Fellowship of the Ring: crash entering Bywater** ([#21](../../issues/21)) while the game cleaned up after
  the scene change: an object's data had been written over. The clean-up now checks it and leaves damaged parts
  out instead of closing.


# Athelas 1.5

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept.

## New: FSR and DLSS upscaling (all three Xbox ports)

- **Upscaler** on the Graphics page (and the in-game menu, F10): **AMD FSR** (FSR 4.1 on the newest Radeon cards,
  FSR 3.1 on every other card, NVIDIA and Intel included) or **NVIDIA DLSS 4.5** (any GeForce RTX card). The game is
  drawn smaller and rebuilt sharp and smooth from several frames: faster, and it smooths jagged edges better than
  anti-aliasing. **Upscaler quality**: Native (full size, smoothing only: DLAA with DLSS), Quality, Balanced,
  Performance, Ultra performance.
- These 2002-2003 games never told the graphics card how things move, which both upscalers need: the ports now work
  it out for every object, every frame. A few effects (some particles, CPU-animated characters) rely on the
  upscalers' own detection.
- DLSS takes effect the next time you start the game. Not on Windows on ARM (AMD's and NVIDIA's files are x64 only).
  The files are in Athelas' new `upscalers` folder, under AMD's and NVIDIA's own licences.

## New in The Fellowship of the Ring (Xbox)

- **Invert camera** ([#14](../../issues/14)): two settings on the Controls page and in the in-game menu (F10),
  *Invert camera up/down* and *Invert camera left/right*, for the controller's right stick. Off by default.
- **ARM64 build:** Windows on ARM PCs (Snapdragon laptops) now run Fellowship natively, as The Two Towers and The
  Return of the King already did. The launcher picks it on its own.

## All three Xbox ports

- **Invert mouse up/down** (Controls page and F10 menu): reverses up and down for mouse aiming. Off by default.
- **Texture packs, compare as you play:** **F8** switches texture packs off and on. A note in the corner says when
  they are off; screenshots never show it. **F7** saves a matched pair of screenshots, one with your packs and the
  very next frame without, to the Screenshots folder (`..._pack.png` and `..._original.png`).

## Performance

- **Less stutter the first time you play** (all three Xbox ports): the first time the game met a new effect, it
  paused to prepare its shader. 1.5 ships the shaders of every level, recorded beforehand, and prepares them in the
  background when you first start a game (while you're in the menus). Later starts are as before.
- **The Two Towers uses far less processor time** at 30 and 60 fps: while waiting for the next frame, the game asked
  for a zero-length pause about two million times a second, keeping a whole processor core busy for nothing. It now
  sleeps until the screen's next refresh and wakes at the same moment as before. About 90% less processor time at
  the same frame rate, so less heat, fan noise and battery drain on laptops and the Steam Deck.
- **Frame rate caps above 60 fps** (all three Xbox ports) hold their rate with Windows' high-resolution timer instead
  of spinning for the last 2 ms of each frame: at 240 fps, about 2% of a core instead of about 30%.
- **The Fellowship of the Ring:** the drawing commands the game records ahead of time are read in larger pieces,
  about twice as fast (they were the largest part of the port's own work per frame).
- **All three Xbox ports:** the renderer reuses the previous draw's texture views when they are the same, which
  they are for more than half the draws.
- **The game's own code runs faster** (all three Xbox ports): the translated game code now keeps the console's
  floating point math (positions, angles, animation) in fast local storage instead of going through memory for
  every step, and clears memory in one go instead of one element at a time. In The Fellowship of the Ring that is
  about 12% less processor time for the game itself per frame; it helps most on slower processors (Windows on ARM
  laptops, handhelds).

## Mac

- **Playing on a Mac through CrossOver:** a new Mac section in the README with the steps. Athelas and the Xbox ports
  were tested in a Wine setup like CrossOver's (DirectX 12 translated); real Mac reports are very welcome. Logs now
  say when a game runs under Wine, and on which system ("on macOS"), so Mac reports explain themselves.

## Fixes

- **The Two Towers, keyboard: Yes/No pop-ups between levels closed at once** ([#17](../../issues/17)). Saving and
  buying upgrades work with the keyboard again. Enter (and the left mouse button) presses Start only on the title
  screen now, where "Press Start" needs it.
- **The Fellowship of the Ring: crash leaving Bilbo's room, Galadriel's mirror and the Lothlórien forest.** At these
  scene changes the game frees textures and buffers that are still set; the port read them anyway and the game could
  close. It no longer reads them. Found while recording the shader seeds.
- **ROTK on PC: no control in game with the keyboard** ([#15](../../issues/15)). With controller support on, player
  1 always got the controller layout, which has no keyboard controls for play, so without a working controller
  nothing moved. Now player 1 gets the controller layout only when a controller is connected as you press Play, and
  the game's own keyboard and mouse controls otherwise. A missing SDL3.dll in the game folder is put back, and
  turning controller support off gives the keyboard back as well.

- **Under Wine and CrossOver: the Xbox ports could close at their second start** while saving achievements.


# Athelas 1.4

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept. One version number for everything: Athelas, ROTK Fix and the three Xbox ports are all 1.4.

## New: The Fellowship of the Ring (Xbox)

A third Xbox game. **The Fellowship of the Ring** (US Xbox release, 2002) now plays on PC through its own native port,
`FOTRXbox.exe`, in the new `FOTR-Xbox` folder, with its own page in Athelas. Point the launcher at your own disc dump
(an `.iso` or the extracted folder), as for the other Xbox games.

This is its **first version**. Every level starts and runs in testing, but it hasn't been played much yet, so please
use **Make a problem report** on the About tab if anything goes wrong. Fixes from your reports go into 1.5.

- **As on the Xbox by default:** 30 fps and the console's 4:3.
- **Higher frame rates,** up to 240. The game times itself by the clock, so it keeps its normal speed.
- **Widescreen:** the game's own 16:9 mode, with a wider view and its HUD laid out for it.
- **Ultrawide, 21:9 and 32:9:** the world reaches the sides of the screen, while the HUD and menus keep their shape in
  the middle 16:9.
- **Field of view:** 70 to 150% of the game's own, for the camera while you play (cutscenes keep theirs).
- **Picture:** render resolution, anti-aliasing, texture filtering, sharpening, HDR, and the Original / Balanced /
  High / Ultra presets.
- **Cutscenes:** sharper and upscaled, as in the other Xbox ports. The story films can fill a widescreen monitor, and
  the logos keep their 4:3 shape.
- **Skip the opening logos**, straight to the title screen.
- **Game text in nine languages:** German, French, Spanish, Italian, Brazilian Portuguese, Polish, Dutch, Swedish and
  Russian (our own translations). Menus, hints, items, the quest journal and dialogue text replace the English inside
  the game's own menus and text boxes. The voices stay English. Polish and Russian use free open fonts for the letters
  the game's own fonts lack.
- **Difficulty:** the damage you take and the damage your hits do, each from 25 to 300% of the game's own.
- **Achievements:** eight, one for each part of the journey (the Shire, the Old Forest, Bree, Weathertop, Rivendell,
  Moria, Lothlórien) and one for the whole story. A save further along earns what it has passed.
- **Cheats as switches:** the game's own secret codes for infinite health, spirit, ammunition and Ring.
- **Controls tab:** the controller's buttons, named after the game's own moves.
- **The launcher page** shows the game's own art, taken from your game files: the loading-screen sketches.
- **Not yet:** an ARM64 build (on Windows on ARM it runs through Windows' translation).

## New in The Two Towers (Xbox)

- **Play as Gandalf or Boromir.** In the Gates of Moria and Balin's Tomb, the hero screen now has Gandalf and Boromir
  after Aragorn, each shown in his own clothes. Each plays with his own model, walk, run and stance. Gandalf carries
  his staff, and his ranged attack is a blast of light. Boromir has his sword and shield.
- **Translation subtitles in nine languages** (Gameplay tab, Language): the game's menus, prompts and descriptions
  translated at the bottom of the screen. The game's own text and voices stay English.

## New in The Return of the King (Xbox)

- **Éowyn instead of Faramir** (Gameplay tab). Éowyn takes his place on the character select, on the HUD and in
  every level he plays, with his moves, combos, bow and upgrades. She is built from her own model in your game files
  when the game starts. She has no voice of her own, so she fights quietly.
- **Translation subtitles in nine languages** (Gameplay tab, Language): the menus, prompts and spoken lines
  translated at the bottom of the screen.

## Fixes

- **The Two Towers: crash a moment after starting** ([#5](../../issues/5), [#9](../../issues/9),
  [#10](../../issues/10)). On some PCs, the Steam Deck among them, the game asked for a line of its text before the
  text was loaded, and closed with 0xC0000005. It now carries on, and the text shows once it is loaded.
- **The Two Towers: the keyboard and Show Moves** ([#11](../../issues/11)). Opening Show Moves from the pause menu
  with the keyboard left the left mouse button pausing the game; it attacks again.
- **The Two Towers: the Invulnerable cheat** now works on the player.
- **Stutters on a slow drive** ([#12](../../issues/12)), both Xbox ports. Disc images are now read in larger pieces,
  with the next piece read ahead.
- **ROTK on PC: stutters while loading** ([#12](../../issues/12)). ROTK Fix now reads the game's data files through
  Windows' file cache. The stutter lines in `ROTKFix.log` show the time spent reading.
- **All three Xbox ports share an improved engine,** built for The Fellowship of the Ring. It now draws the game's
  queued graphics commands in the order the game sent them, allocates the room the game asks for, and guards against
  running out of memory. The Two Towers (13 levels) and The Return of the King (17 levels) were tested against the
  previous engine, with the same results.

## Launcher

- The Fellowship of the Ring's page, with its own settings, presets, art and achievements.
- A **Language** section on the Gameplay tab for the Xbox ports. The launcher's font now has Polish and Cyrillic
  letters.
- The Original preset's description names each game's own Xbox year.

## Docs

- README: The Fellowship of the Ring section, Gandalf and Boromir, Éowyn, translation subtitles, and the new
  ROTKFix.ini settings (`[Gameplay] Eowyn`, `[Language] Subtitles`, `[System] OneCore`).


# Athelas 1.1.3

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept. One version number for everything now: Athelas, ROTK Fix and both Xbox ports are all 1.1.3.

## New

- **Make a problem report** (About tab, and after a crash). One click puts the logs, the settings, the newest crash
  dump of each Xbox port and a description of your PC (Windows, processor, graphics card and driver, screens,
  controllers) into one zip in the `Reports` folder, and opens a new bug report on GitHub with those details filled
  in. Write what happened and drag the zip in. Athelas sends nothing itself, and your Windows user name is taken out
  of the files.
- **The launcher works fully with a controller** (Steam Deck, TV). The D-pad moves through every page and setting,
  LB / RB change tabs, Menu (Start) plays and View (Back) saves from anywhere, B closes dialogs, and a setting's
  explanation shows when the cursor is on it. A line under the summary names the shortcuts in your controller's own
  button names.
- **Stutter lines say more** (both Xbox ports). Each slow frame in `tt.log` / `rotkx.log` is now followed by what
  the game spent that frame on: reading files, waiting, sleeping, and the slowest file read. If you report stutter,
  please make a problem report: this is what we need to fix it.

## Fixes

- **The Two Towers: the lake at the Gates of Moria.** Wading through the water left ripples that grew into big
  bright stripes across the lake and never went away. The lake's ripple simulation is now read the way the game
  expects, so ripples spread and fade as on the Xbox.
- **The Two Towers: "Press Start" with the keyboard** ([#8](../../issues/8)). The title screen takes only Start, and
  in the menus the keyboard's Esc goes back, so nothing on the keyboard got past it. Enter (the A key) now presses
  Start as well in the front end, so it goes on from the title screen and works in the menus as before.
- **Blocky textures at high resolutions** ([#1](../../issues/1)) (both Xbox ports). Some textures the game enlarges
  without smoothing (moss, reeds, grass and other cut-out plants, and a few others) now enlarge smoothly at higher
  resolutions instead of showing big square pixels. At the Xbox's own resolution nothing changes.
- **Save times in your own time zone** (both Xbox ports). Saved games showed the time in UTC; they now use your PC's
  time zone and daylight saving.
- **The Two Towers: the save screen's layout on wide screens.** Its animated map counted as gameplay, so the
  screen's pictures and text were spread to the edges as the HUD is; they now stay where the game puts them.
- **Windows on ARM: its own complete download.** `Athelas-1.1.3-arm64.zip` has everything the usual zip has plus the
  native ARM64 builds of the Xbox ports, and updates on an ARM PC fetch it. If the ARM64 builds in the folder are
  from another version, the launcher uses the usual ones and offers to install the right ones.
- **The About tab checks the ROTK Fix files.** It shows their version and warns if the game folder, or Athelas's
  own copy, has an older one.
- **Remove ROTK Fix keeps your achievements and texture packs.** It deleted the whole `ROTKFix` folder, with the
  achievements earned and any texture packs in it; those now stay.
- **Windows on ARM: "One processor core" for ROTK Xbox is saved.** The launcher didn't write the setting, so ticking it
  did nothing.
- **Games on a drive that isn't plugged in stay in the launcher's list.** A game on a USB drive or network share that
  was offline when the launcher started was dropped from the list for good; it now comes back when the drive does.
- **The launcher and a controller:** pressing Start or Back to stop setting buttons no longer also starts the game or
  saves, and a controller only works the launcher while its window is in front.
- The launcher works from a folder whose name has letters outside Windows' language setting (a Cyrillic user name on
  English Windows, say), and a crash dump too big for a problem report is left out instead of cut in two.
- The Two Towers' unused Network setting is gone from its settings (the game has no network play).

## Docs

- README: how to make a problem report, the launcher with a controller, and stricter Windows on ARM emulation for
  ROTK on PC if it crashes at random on an ARM PC.


# Athelas 1.1.2

Press **Update** in the launcher, or unzip it over your Athelas folder: your settings, saves and achievements are
kept.

## New

- **Less stutter in places you've played before** (both Xbox ports). The port now remembers every graphics setup
  it has built, and when the game starts it builds them again in the background, before you reach them. The first
  visit to an area can still hitch once; later visits shouldn't.
- **Stutter is now recorded in the log.** A frame that takes 50 ms or more is written to `tt.log` / `rotkx.log`
  with what it waited on (shaders, graphics setups, textures). If you report stutter, please attach the log.

- **Original texture softness** (Graphics tab, both Xbox ports) ([#6](../../issues/6)). At high resolutions the
  games' textures show their full, raw detail, so lava, rock and water look grainier than they did on a TV. With
  this on, textures are drawn at the detail the Xbox used at its own resolution: softer, as you remember them. Menus
  and the HUD are not changed. Off by default; the Original preset turns it on.

- **The Two Towers: kill points** (Gameplay tab). A killing blow now shows the points it earned after its rating
  ("Good +26"), in the game's own font, as The Return of the King does. Off by default.

- **All heroes in completed levels** (Gameplay tab, all three games). In a level you've already completed, the
  game's own character select offers every hero, as it does once you've beaten the game: Aragorn, Legolas, Gimli
  and Isildur in The Two Towers; all nine heroes in The Return of the King. A level you haven't completed yet is
  played as the game has it, so the story is the game's the first time through. Levels built around one hero are
  left alone: the Prologue and Weathertop in The Two Towers, and Helm's Deep (Gandalf's) in The Return of the
  King. In The Return of the King (PC and Xbox), Unlock all levels and characters offers every hero everywhere.
  Off by default.

- **Cheats** (Gameplay tab, both Xbox ports). The games' own secret codes as switches, without entering them on
  the pause screen: Invulnerable, Always Devastating, Infinite Missiles and Slow Motion in The Two Towers;
  Invulnerable, Infinite Missiles, Always Devastating and Perfect Mode in The Return of the King. Off by default.
- **Mouse aiming and mouse in the menus** (Controls tab, both Xbox ports). Hold the ranged attack and move the mouse
  to aim. In the game's menus the wheel moves up and down and a right click goes back.
- **Controller in the background** (both Xbox ports). Turn it off so controllers only reach the game while its
  window is in front. On by default, as before.

## Fixes

- **The Two Towers: the game's clock no longer drifts or stops in long sessions.** The game adds up its time in a
  number that loses precision over hours; at high frame rates it ran a few percent off after about two hours in
  one level, and it could stop after days. It now keeps exact time.
- **The Two Towers: Slow Motion is the same speed at any frame rate.** The game's own code slowed time by a fixed
  amount a frame, so above 30 fps it ran faster, not slower.
- Keys held while switching windows (Alt-Tab) are ignored until let go.

- **Smooth menus and HUD: blocky menu text at 4K** ([#1](../../issues/1)). The menu fonts are smoothed and then
  given a crisp edge, so letters have clean curves at high resolutions instead of soft stair steps. Menu pictures
  and the HUD are smoothed as before.
- **The Two Towers: levels played as Legolas, Gimli or Isildur now count.** Completing a level as one of them
  didn't earn its achievement, and the port didn't notice it was in a level (so Esc behaved as in the menus).
- The README now notes that The Two Towers has been reported working on a real Steam Deck.

## Windows on ARM

The ARM test build is updated to this version (see the `arm-test` pre-release).

## Checksum

`Athelas-1.1.2.zip` SHA-256: `a7d2160406e64d303dd4421719b3bc418670e292fa825e3b3341cdd303afd577`

# Athelas 1.1.1

Unzip it over your Athelas folder: your settings, saves and achievements are kept.

## New

- **Update from the launcher.** When a new version is out, an **Update** button appears at the top right of the
  launcher. It downloads the new version from GitHub, checks it, installs it over your folder and starts the
  launcher again. Your settings, saves and achievements are kept. Nothing is downloaded until you press it. From
  this version on, you won't need to download updates by hand.

## Fixes

- **The Two Towers: the rare crash a second or two after starting** is fixed at its cause. Two of the game's
  threads could use its built-in frame timer at the same moment, which the original Xbox (one processor core)
  never did. 1.0.1's guard stays as a backstop.
- **The Two Towers: an incomplete copy of the game** (a missing level sound file) now says which file is missing
  instead of crashing.
- **ROTK on PC:** after updating Athelas, the game folder now gets the new ROTK Fix files when you press Play.
  Before, it kept the version it was first set up with.

## Checksum

`Athelas-1.1.1.zip` SHA-256: `7f9ae20e5cc2537ee4b6bcf05d243df0fff8219a3f65114ac275d928e38d3cd7`

# Athelas 1.1

Unzip it over your Athelas folder: your settings, saves and achievements are kept.

## New

- **Athelas tells you when a newer version is out.** When it starts, the launcher asks GitHub for the newest
  release's number and shows a note under the settings and on the About tab. Nothing about you or your games is
  sent and nothing is downloaded. Turn it off on the About tab ("Look for new versions").
- **Easier problem reports.** When a game crashes, the message now has **Open log folder** and
  **Report a problem** buttons. The second opens a bug report here with the game, versions and error filled in.
- **Windows on ARM:** the launcher is ready for native ARM64 builds of the Xbox ports (being tested in the
  [1.1-arm-test](https://github.com/Shagg88/Athelas/releases/tag/1.1-arm-test) pre-release) and starts them by
  itself on an ARM PC. On those PCs a **One processor core** setting appears for the Xbox ports, in case of random
  crashes there. The About tab says which build of each port is running.

## Fixes

- **Where ROTK's settings are** ([#4](https://github.com/Shagg88/Athelas/issues/4)): both versions of The Return
  of the King share `ROTKFix.ini`. The `settings.toml` in ROTK-Xbox now says so at its top, with the file's
  location; the launcher's ROTK Xbox About tab shows it with a **Show in folder** button; and the README has a
  "Where your settings are" section.

## Checksum

`Athelas-1.1.zip` SHA-256: `41536a89122359dcd5dfdf04888907115eab74674f6c7477e2ff9bb6f587db4a`

# Athelas 1.0.1

A bug-fix update. Unzip it over your Athelas folder: your settings, saves and achievements are kept.

## Fixes

- **The Two Towers: the crash in Balin's Tomb** when the cave troll is hit by an arrow
  ([#2](../../issues/2)). The game's script engine recovers from an error there, as it did on the Xbox; the port
  now does the same instead of closing.
- **The Two Towers: a rare crash at startup**, in the game's own frame timing, is prevented.
- **Copies of the Xbox games that were turned away** ([#3](../../issues/3)):
  - A copy whose game code and data are the same as the US release's, and that differs only in its certificate or
    signature (another printing or dump), is now recognised as the US release and starts normally.
  - A genuinely different release can now be started from the launcher: it asks whether to start it anyway, as the
    ports do on their own. These copies aren't tested and may crash.
  - The log names each copy's version and build date, which helps when you report a problem with one.
- **Starting a port's exe directly** (without the launcher) now uses the launcher's settings, saves and achievements:
  ROTKXbox.exe reads the same ROTKFix.ini the launcher writes, and both ports use the `saves` folder and
  achievements file beside them ([#3](../../issues/3)).
- **Launcher:** the achievement list sits under one Achievements heading.

## Notes

- At 4K, turn on **Smooth menus and HUD** (Graphics tab) for The Two Towers: its menus were drawn for a 640x480 TV,
  and the Original look keeps their hard pixels on purpose.
- Windows on ARM (Snapdragon laptops) runs Athelas through Windows' own translation layer, which costs a lot of speed
  in the Xbox ports. A native ARM build is planned.

## Checksum

`Athelas-1.0.1.zip` SHA-256: `7c41eadf83477bdd0e1bec16b6fddd45d33934da5043e5503b987dc9274e961f`

# Athelas 1.0

Athelas is a free, unofficial launcher for three Lord of the Rings games, so you can play your own copies on a modern
Windows PC from one place:

- **The Return of the King (PC, 2003)**, through ROTK Fix
- **The Return of the King (Xbox)**, through a native PC port
- **The Two Towers (Xbox)**, through a native PC port

No game files are included. You need your own copy of each game: the PC game installed, or your own Xbox disc as an
`.iso` or extracted files (US releases). ROTK Fix doesn't change or bypass the PC game's copy
protection. The Xbox ports skip the console's check for an original Xbox disc, which a PC can't answer as it has no
Xbox drive. The games' own files are never decrypted or changed.

## What's new

This is the first public release.

**The Return of the King (PC), with ROTK Fix**
- Any resolution and refresh rate, borderless or fullscreen, widescreen with the right field of view
- Smooth frame rates up to 240 fps with the game's timing fixed to match
- Sharper picture: render scaling, anti-aliasing, texture filtering, sharpening and colour looks (Vulkan through DXVK)
- The game's 3D sound and EAX reverb restored
- Modern Xbox, PlayStation and Switch controllers, with remapping and matching button pictures
- Two-player co-op with two controllers, and online by streaming it with Parsec (or Steam Remote Play Together)
- Gameplay options: damage taken, enemy damage, and every level and character unlocked (all off by default)

**The Return of the King (Xbox) 1.0.1**
- Runs natively on PC, up to 240 fps, widescreen and ultrawide
- Sharp text and menus, using the PC version's larger fonts and pictures when you have it installed
- Two-player co-op on one screen, and online by streaming it with Parsec (or Steam Remote Play Together)
- The same gameplay options as the PC version: damage taken, enemy damage, unlock everything
- Fixes for slowdowns and for enemies vanishing instead of fading at high frame rates
- Keyboard and mouse play, with the PC version's keys and key pictures in the game's hints

**The Two Towers (Xbox) 1.0.1**
- Runs natively on PC: widescreen up to 32:9, up to 240 fps, higher resolutions, HDR
- Controller remapping and adjustable difficulty
- Keyboard and mouse play, with the PC version of The Return of the King's keys
- Plays as on the Xbox by default; every enhancement is a setting

**Both Xbox ports**
- An in-game settings menu: F10, or both stick clicks together; the game pauses behind it
- Pause or mute while the game is in the background (off by default)
- A frame rate counter

**Achievements, in all three games**
- The Two Towers 14, The Return of the King 29 (PC and Xbox alike): every level, every hero, co-op, enemies defeated
- Earned as you play, and from what your saves already hold
- A note in the corner when you earn one (can be turned off), and the list on the launcher's Gameplay tab and the
  in-game menu
- Kept only on your PC, in each game's achievements.txt

**Athelas, the launcher**
- All three games' settings in one place, with presets; every key and button can be changed
- Background art taken from your own game files, rotating, or your own pictures
- Sets ROTK Fix up in your PC game folder and removes it cleanly
- Desktop and Start menu shortcuts, on request (About tab)

## Requirements

- Windows 10 or 11, 64-bit
- ROTK (PC): a graphics card with a Vulkan 1.3 driver is recommended
- ROTK (PC) 3D sound: Microsoft's Visual C++ Redistributable (x86), which most PCs already have; without it the game
  plays its original sound
- The Xbox games: a DirectX 12 graphics card. A controller, or the keyboard and mouse.
- Tested on Windows 11 with an NVIDIA GeForce RTX 3080 Ti. Windows 10 and AMD and Intel graphics are expected to
  work but haven't been tested yet; reports are welcome.
- Steam Deck and Linux: through Proton (add Athelas.exe as a non-Steam game). Tested in a Deck-like setup, not yet on a
  real Deck.

## Install

Unzip into a folder of its own (for example `C:\Games\Athelas`), run `Athelas.exe`, and show it where your games are.
The README in the zip has the details.

## Known issues

- Only the US releases are supported. Others warn before starting and will most likely not work.
- ROTK (Xbox) looks darker than the PC version. That's faithful to the console; Brightness 1.2 to 1.3 matches the PC.
- The files aren't code-signed, so Windows SmartScreen may say "unrecognised app": choose "More info", then
  "Run anyway".

## Checksum

`Athelas-1.0.zip` SHA-256: `162f9cec8c28458d2b3f9e7aa679adab2eeb49d160dd6c4a218dfd91ba7cd150`

## Credits

Made by Shagg, with Claude (Anthropic).

Built on DXVK, SDL3, Dear ImGui, DSOAL and OpenAL Soft, and XboxXBE-Recomp (MIT, © 2026 TGP482). Full licences are
in the `licenses` folder.

Not affiliated with or endorsed by Electronic Arts, New Line Cinema, Warner Bros. or the Tolkien Estate.

