Releases: Eukaryot/sonic3air
Test build v25.01.12.0 (Windows only)
Bug fixes
- Fixed a regression in the last test build that unlocks were not properly saved
- Additional checks to prevent the "type is not convertible to string" error when e.g. the active-mods.json is malformed
Modding
- Support for mods to use up to four players (see "UsesFeatures" section in Modding.pdf)
- A few more windows and features in dev mode UI
- Now saving dev mode window UI scale and which windows are open
- Added "System.isDevModeActive" script function to check whether dev mode is enabled
- Removed the hard limit for number of sprites
Download for Windows: sonic3air_game.zip
Test build v24.12.05.0 (for Windows, Mac, Linux)
New features and improvements
- Save data is now stored across multiple files in "storage" inside your save data folder, making it easier to delete or backup individual files if needed
Bug fixes
- Fixed a crash and errors when a modded font was loaded from a zip file or a path with non-ASCII characters
Modding
- Experimental new dev mode menu system (toggle by pressing F1 when dev mode is enabled)
- Support for custom palettes in sprite rendering via new SpriteHandle functions "setPalette", "setPrimaryPalette", "setSecondaryPalette"
- Reworked persistent data functions, so you can store data in individual files and optionally in a local folder for your mod
- Added convenience script functions "getScreenCenterX" and "getScreenCenterY"
- "Log" and "LogDec" can now also be used with float, double, and string values
This build includes the fix for a security issue that affected previous test builds, and the stable update v24.02.02.0 (but it's also fixed in the stable update patch v24.02.02.1).
Download for Windows: sonic3air_game.zip
Download for Mac: sonic3air_mac_240205.dmg
Download for Linux: sonic3air_game.tar.gz
Test build v24.07.10.0 (Windows only)
Bug fixes
- Fixes for server communication issues that could randomly break both Ghost Sync and the Update Check
- Fix for a regression in LBZ 1 that leads to a dead end in the normal route
- Fixed software renderer bugs
Modding
- Revised random number generation and added new script functions "System.randomFloat" and "System.randRange" variants
Download for Windows: sonic3air_game.zip
Test build v24.07.04.0 (Windows only)
Bug fixes
- Fix for a general regression in how viewports get handled, which broke Competition Mode
- Fixed software renderer's handling of viewports when drawing texts, rects and custom planes
- Fixed a layering issue inside certain graphics, like Tails' run sprites
- Fixed that selecting HPZ in Act Select started the Lava Reef 2 boss fight
- Fix for a glitch when going back to the main menu immediately after entering Data Select (namely while still fading in)
- Performance optimizations for software renderer, specifically for rotated / scaled sprites display
Modding
- Oxygen Handbook now includes a documentation for how to use automatic font effects like outlines and shadows
Download for Windows: sonic3air_game.zip
Test build v24.06.21.0 (Windows only)
Bug fix release for previous test build v24.06.18.0
- Fixed a new regression in FBZ 1 that made the main route impossible to complete
- Fix for a memory leak related to text rendering
- Fixed a glitch in Act Select when starting a game during a transition of the zone preview slideshow
- Fixed that software renderer did not properly process the SEGA logo animation in S&K title screen
Download for Windows: sonic3air_game.zip
Test build v24.06.18.0 (Windows only)
Bug fixes
- Fix for emulated S3A versions of mini-boss music and Knuckles theme
- Fixed a bug that could lead to incorrect sprite rendering in mods
- Fixed that pressing Numpad-9 leads to a broken rewind and game freeze if dev mode is disabled
- Fix for the lever palette in first MHZ 2 cutscene
- Using proper animation for Tails carrying Sonic when exhausted underwater
- Fixed a regression that made one squirrel from each FBZ capsule look broken
- Fix for visible palette change in level tiles after Knuckles' LBZ 1 boss
- Corrected render priority for the Egg Mobile after SOZ 2 boss fight
- Fix for first Sonic outro win pose sprite position and rotation
- Fixed that ground did not fade to white after finishing a stage in Blue Sphere game mode
- More precise ground collision check for spilled rings
Modding
- Act Select is now implemented in scripts and thus fully moddable
- Added "makeCallable" function to get a u32 address for script functions to be used in calls
- Added "System.removePersistentData"
- Added alternative script function variants of "SpriteHandle:setRotation", "SpriteHandle:setScale", "SpriteHandle:setTintColor", "SpriteHandle:setAddedColor"
- Added BlendMode constants to cpp_core_functions.lemon
Download for Windows: sonic3air_game.zip
Stable Update v24.02.02.1
Sonic 3 A.I.R. v24.02.02.1 is fixing a security issue with v24.02.02.0.
If you still use the old version, it's strongly recommended to download the new version.
Combines all changes since the last stable release v22.09.10.0.
Full changelog
Highlights include:
- Controller rumble support
- Ghost Sync online mode, where you see other players online at the same time
- Improvements to the Mods and Options menus, incl. faster navigation, and warnings if mods are in the wrong order (if supported by the mod)
- Many in-game bug fixes and touch-ups
- Much smaller download size by leaving out the remastered soundtrack, you can download it from the Options menu
- Quality enhancements for the OpenGL software renderer
- Better performance for ZIP mod loading and script execution
- New modding features and script language extensions
Please note: The remastered soundtrack is not included any more. If you want to use it, it can be downloaded from within the game's Options menu (on Windows, Mac, Linux, Android) or by exiting the game first (Web). This only needs to be done once and is not needed if you've downloaded the soundtrack in the latest preview or one of 2023's test builds.
If you encounter problems with the internal downloader, you can manually download the remastered soundtrack from https://sonic3air.org/download/audioremaster.bin, create a "data" folder inside your save data, and place the audioremaster.bin in there.
Downloads:
Test build v24.01.07.0 (Windows only)
Bug fixes and improvements
- Fixed navigation issues in Mods Options for very large mods
- Fixed that SSZ Cutscene Knuckles resting on the button could become partially invisible
- Fix for the "LargestInt out of Int range" error at startup that could be caused by certain mods
- Re-enabled the HCZ 2 glitchy abyss again unless glitch fixes are set to "all"
- Reworked L / R icons for touch controls
Modding
- Added a few more math functions: "Math.lerp", "Math.invlerp", "Math.sqr", "Math.frac"
- Added color operation functions: "Color.lerp", "Color.fromHSV", "Color.HSV.getHue", "Color.HSV.getSaturation", "Color.HSV.getValue"
- Lemonscript: Allowing for whitespace / indentation before includes
- Added backquote key ´ as an alternative to F11 for script reloading (especially for Macs)
- Increased the limit of render items (sprites etc.) and made the limit exceed warning less obtrusive
- Added "SoundTestVisibility" ("visible", "hidden", "devmode") property in audio definitions
- Fixed that BUTTON_L and BUTTON_R constants definitions were swapped
Download for Windows: sonic3air_game.zip
Preview Update v23.11.18.0
Preview Update combining all of the test builds since the previous Stable Update (v22.09.10.0).
The remastered soundtrack is not included in the download any more. It's optional anyways for the game. If you want to use it, please go the the game's Options -> Audio section to download it from there. This only needs to be done once, keeping future game updates smaller.
If you encounter problems with the remastered soundtrack, you can also download it here and manually place it inside the "data" folder of the game's save data (see the Manual.pdf for where to find that).
Downloads:
New features and improvements
- Added controller rumble support (needs to be enabled in the Options and might not work with all controllers)
- Added an in-game downloader for the remastered soundtrack, so the game download can be noticably smaller
- Experimental Ghost Sync mode is now available directly in the Options menu
- Added an option for how to draw other players in Ghost Sync, e.g. with full opacity
- Added a more Mania-accurate rotation implementation to "Character Rotation" in the options
- Added an option for different visual styles for gamepad button icons
- Made glitch fix setting for speedrunning more accessible, and split it into three options
- In mod options, you can now expand / collapse each mod
- Added faster navigation in Options and Mods menus by holding X (D on keyboard)
- Changed the background of the mod details window to a dark one, for better readability
- You can now dropdash in MGZ spin wheel triggers to activate them
- Knuckles' AIZ intro now uses the correct critters for AIZ
- With infinite lives option active, 1-up bubbles in bonus stages are replaced with rings now
- FBZ 2 mid-boss laser can now be destroyed
- Added missing badniks to Knuckles' path in CNZ 1 for the Sonic 3 level layout
- Added sound for CNZ cannon shooting
- Improved software rendering blur effect to the same quality as OpenGL hardware
- Performance improvements for ZIP mod loading and script execution
Bug fixes
- Added a whole bunch of game fixes contributed by community members
- Fixed a rendering problem with OpenGL Hardware setting on latest AMD graphics card drivers on Windows
- Fix for an issue in frame timing that could lead to a random stuttering frame rate
- Fix for various rendering issues (with both OpenGL and software)
- Stability fixes for networking
- Fix for a crush bug that can occur when walking on ceilings
- Fixed glitch when dropdashing or bubble bouncing onto the HCZ hand launcher
- Set a proper level floor height for HCZ 2, so you can't fall into the glitchy abyss there any more
- Fix for camera / capsule position after HCZ 2 boss
- Fix for a possible softlock with the MGZ spinning tops
- Fixed a bug that occurred if dying at the end of ICZ 1 without touching any checkpoint before
- Fixed a possible softlock with LBZ 1's first cup elevator
- Removed unnecessary springs in the floor in FBZ 1
- Fixed sand dust position in SOZ 1 boss
- Removed duplicate rings in LRZ 2
- Fixed chunk tiling in HPZ
- Fixed that the "Keep Shield after Zone" option could give you a shield again after restarting at the last checkpoint
- Fixed that after level results tally, score numbers just disappeared instead of quickly moving out of the screen
- Fixed an original game bug that caused you to lose two lives if drowning and be killed by a pirhana at the same time
- Fix for wrong background colored pixels in Continue sprites for Sonic and Tails
- Fix for wrong final time in Time Attack if the game got paused in the run
- Fixes for competition mode items
- Competition Mode now uses the original game's viewport sizes, instead of having a too small lower viewport
- Fix for wrong positioning of the competition mode background
- Several fixes when playing in 4:3 (using dev mode or the classic mode sample mod)
- Added a security check if scripts cause an internal script stack overflow
- Additional minor fixes and touch-ups
Modding features & improvements
- Replaced "Debug.drawRect" with "Renderer.drawRect", introducing a few more parameters like render queue
- Using the same reset behavior for "Renderer.drawText" and "Renderer.drawRect" as for sprites, so they don't disappear during fades any more
- Added a new way of rendering sprites in script ("Renderer.addSpriteHandle" and the various SpriteHandle methods)
- Also for sprite rendering, added several blend modes and more flexible support for tint & added colors
- Support for L + R shoulder buttons, if the mod.json unlocks it
- Support for defining required mods and recommended order of mods (see "doc/Modding.pdf" for details)
- Added "UniqueID" mod.json property
- Lemonscript now supports types "float" and "double" for floating point numbers
- Extended the standard library of functions usable by scripts with more math and string functions
- Added function "getStringFromCharacter"
- Support for adding string + number (requires script feature level 2)
- Added script function "addressof" to query the address inside a memory access (like a define) or the address hook of a function
- Added support for alias names for script functions
- Experimental rewind using Numpad-9 (requires dev mode)
- Added support for changing the "DATA SELECT" text by adding a sprite with the key "dataselect_text"
- Including a lot of base game script improvements by Vinegar
Test build v23.11.12.1 (Windows & Mac only)
Includes all new features of the very recent v23.11.10.0, plus the following:
New features and improvements
- Added faster navigation in Mods menu by holding X (D on keyboard)
Bug fixes
- Fix for "left" icon in the Switch gamepad input sprites
- Fix for missing Knuckles' glide skidding dust effect
- Fix for OpenGL graphics issues when rendering certain combinations of rects/texts and sprites
- Fix for debug draw rects and texts not visible when using world space
Hotfix v23.11.12.1 addresses the error "Invalid sprite cache key" when changing mods.
Download for Windows: sonic3air_game.zip
Download for macOS sonic3air_mac.dmg