Repository navigation
Releases
HydroThunderHurricane-Recompiled-v2.2.0
2.2.0 - Faster rendering
Faster
The GPU does about a quarter less work per frame in a race: 6.9 ms became 5.3 ms on the development PC (RTX 3050 laptop), on top of 2.1.0's gains. Since the start of this optimization work, GPU time per frame has roughly halved, from 10 ms. This matters most where the GPU is the limit, as on handhelds like the ROG Ally.
- Textures the game renders to are loaded straight into the texture. Shadow maps, depth and other render-to-texture results used to be converted into a buffer, then copied into the texture. A new shader writes the texture directly.
- Resolves read the render target directly. Copying a render target to memory used to go through a full copy of it into the emulated EDRAM first. For the formats this game resolves most, the copy now reads the render target itself.
- Resolved textures don't get reloaded. When a resolve rewrites a whole texture, it now writes that texture too, so it isn't reloaded from memory right after.
Every change was checked by comparing frames with it on and off, and the image is identical down to the pixel.
If anything ever looks wrong, each change can be switched off in hydrothunder.toml: ht_direct_texture_load, ht_direct_resolve and ht_resolve_to_texture (all true by default). Please report it with a screenshot if you need to.
Performance
On the development PC, races went from 65 to 115 fps. The worst frame dropped from 36 ms to 20 ms, and the visible stutters (frames slower than 25 ms) went from about a hundred a minute to none. Part of that was a debug leftover that was slow mainly on that PC. The rest applies everywhere: GPU time per frame fell from 10 ms to 7 ms, which matters most on handhelds like the ROG Ally, where the GPU is the limit.
- Clears no longer copy whole render targets. The game clears its shadow and depth buffers through a 4x MSAA view of memory it then draws into at 1x, and every clear made the renderer copy the whole buffer twice. Those clears are now drawn at 1x over the same memory. The output is pixel-identical.
- Clears are measured at their real size instead of being assumed to cover the whole screen.
- A leftover debug file write on every GPU memory fault is gone.
- Less CPU work per draw. The game's memory copy runs natively, and GPU registers and shader constants are copied in bulk instead of one at a time.
Also new
- The frame rate cap actually caps. "Capped" in F5 > Display now holds the game at the rate you set, even with tearing allowed. 30 and 40 are new presets. On a handheld, capping at a rate the game can always reach (60, or 40) is the smoothest choice.
- Player name. F5 > Game > Player name sets the name the game calls you by, instead of "User".
- The F6 overlay shows the game's real frame rate. It used to show how often the overlay itself redrew. With
ht_gpu_perf = trueinhydrothunder.tomlit also shows GPU time per frame. Please include that when reporting performance.
Thanks to HydroThunderPORT, whose measurements and 4x-clear idea pointed the way.
Note that HydroThunderPORT is itself built on top of this project's 1.0 code: its own provenance.json lists this repository (github.com/visibou/htrecomp, commit ecae518) as the app it starts from. Its README does not credit this project anywhere. The recompilation, the game fixes and the features it inherited were done here first.
HydroThunderHurricane-Recompiled-v2.0.0
2.0.0 - DLC + Initial mod support
Mods
Add content to the game without replacing any of it. Drop a mod's folder into mods/ next to the executable and start the game.
- New boats with their own handling, built on any existing boat's model: top speed, thrust, mass, hull, air control and the boat-menu bars.
- New skins for the game's boats or a mod's own, painted as a 1024x1024 PNG.
- Nothing is replaced. Mod content sits next to the originals, mods cannot collide with each other, and removing a mod leaves your save working.
- Mod content is unlocked from the start.
- F5 > Mods lists installed mods, shows why one did not load, turns mods on and off, and exports each boat's skin as a template to paint over.
See MODDING.md in the download for how to make one, and examples/mods/speedvector/ for a working example.
Also new
- Tempest Pack DLC: the three extra tracks, Whiplash, Psyclone, the six X boats and the extra skins, installed from your own copy.
- Field of view for the race camera (F5 > Game).
- Keyboard and mouse bindings in F5 > Input.
- Save editing with
tools/ht_save_edit.py, which fixes the checksum the game checks.
Fixed
- The boat menu looped before reaching boats added after an existing boat's extra skins, which hid the Tempest Pack's X boats and skins.
- With the DLC installed, pressing Start no longer crashes the game.
Changed
- The window is titled "Hydro Thunder Hurricane Recompiled".
- The engine's developer overlays (F3, F4 and the console) are no longer in the release build.
Known Limitations
- Mods add boats and skins only, for now. New models, tracks and music are not supported yet.
- Changes to mods take effect on the next launch.
HydroThunderHurricane-Recompiled-v1.0.0
1.0.0
Initial release.
Known Limitations
- DLC is not supported yet, but planned. Installing it makes the
game crash on startup most of the time, so the option is switched off rather
than shipped broken. The base game is unaffected.