From 145c6fd08cac18810cb48c1cd9160c83befa5417 Mon Sep 17 00:00:00 2001 From: Michael Scire Date: Sun, 14 May 2023 03:15:43 -0700 Subject: [PATCH] docs: 1.5.4 changelog, zelda why the fuck --- docs/changelog.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/changelog.md b/docs/changelog.md index 2bf27f4b8..def500e49 100644 --- a/docs/changelog.md +++ b/docs/changelog.md @@ -1,4 +1,17 @@ # Changelog +## 1.5.4 ++ Experimental new functionality was implemented to prevent crashing when building romfs for certain games with obscene file counts. + + This includes both Fire Emblem: Engage (~190000 files), and The Legend of Zelda: Tears of the Kingdom (~300000) files. + + The solution involved adding functionality to ams.mitm/pm to dynamically steal memory from the application (and system) pool as needed when the games have romfs mods. + + No memory is taken, and there is no cost to this functionality when playing without mods (or with overrides disabled). + + The Legend of Zelda: Tears of the Kingdom is currently the absolute worst case game, requiring ~48 MB of memory to build a romfs image to play with mods. + + Right now, the memory is sourced as follows: 32 MB (base ams.mitm heap), 10 MB (stolen from application pool), 8 MB (dynamically stolen from system pool). + + This is 50 MB, which allows a little overhead in the worst case (prevents crashing due to exhausting the heap for other allocations in ams.mitm). + + Zelda is remarkably sensitive to memory being stolen from the application pool, tolerating no more than 16 MB on 1.0.0 and 12 MB on 1.1.0. I have chosen to steal 10 MB, to be safe, for now. + + This may break on a future game update, but I will fix it if and when that happens. There is no perfect solution; the game simply requires too much memory to support mods flawlessly, and I am forced to compromise. + + As usual, if you encounter a game that exhausts ams.mitm's memory (crashing it) when loading layeredfs mods, please contact `SciresM#0524`. + "I am jinxing myself by saying this, but it's really hard to imagine any game being worse than The Legend of Zelda: Tears of the Kingdom, but if it happens again I will drop everything to fix it as usual". ++ General system stability improvements to enhance the user's experience. ## 1.5.3 + Support was added for 16.0.3. + Atmosphère was updated to use GCC 13/newlib (latest devkitA64/devkitARM releases).