Every engine release, newest first. Downloads appear here once builds are public. Godfather, Agent-Toolkit and website changes have their own changelogs.
Weapon wheel, radio wheel, phone, sights and menus
The GTA V-style HUD is complete: a weapon wheel with weapon stats, a radio wheel, a phone with the time and day, sights for every kind of weapon (a zooming sniper scope among them), and gamemode menus and stat lines.
Added
Weapon wheel: hold ~ or N, point at a weapon and let go. Each slot shows its weapon and ammo, and a panel rates damage, fire rate, accuracy and range. Num1-Num9 pick weapons straight away, Num0 puts them away.
Radio wheel: hold X in a vehicle to pick a station or turn the radio off.
Phone: Num* shows the game time and the day of the week.
Sights: a dot, a cross, a shotgun ring, a sniper scope that zooms (mouse wheel changes the zoom), launcher brackets, a camera viewfinder and a throw arc. Gamemodes and plugins can give any weapon its own sight.
Gamemode menus in the top left (arrow keys, Enter, Backspace) and stat lines in the bottom right (Godfather v0.4).
Options > HUD: change the wheel, radio and phone keys, and turn the Num keys off.
Changed
While the Alt:SA HUD is on, the sights and the phone replace the classic crosshair and clock (unless you turn them off).
Technical notes
Godfather.dll v0.4.0. Assets/Scripts/UI/Hud/: HudKeys, WheelElement, WeaponWheelElement, RadioWheelElement, PhoneElement, SightsElement; GodfatherClient draws PanelState.Menu. PedSync.SwitchWeaponSlot is a server-checked command; AltSaHud.BlocksInput joins GameManager.CanPlayerReadInput. See Docs/hud.md.
The HUD gets a GPS route on the radar, timers, and wanted levels you can escape, and gamemodes can now drive all of it.
Added
GPS: right-click the map (or let the gamemode set a target) and the radar shows the route over the roads; it re-routes as you move and clears when you arrive.
Timers in the top left, counting down or up.
Wanted levels: the police search area shows on the radar, and six seconds outside it clears your stars (Godfather v0.3).
Gamemodes can set money, the strips under the radar, timers and the GPS target, and hide HUD pieces.
Self-test: Tools/run-autotest.sh huddemo.
Technical notes
Godfather.dll v0.3.0; Assets/Scripts/UI/Hud/ Gps, HudRemote, TimersElement; PathfindingManager.FindPath(..., vehicleRoads). See Docs/hud.md.
A new HUD in the Alt:SA look: a rectangular radar that turns with the camera and tilts into 3D while driving, money and wanted stars in the top right, and the area and vehicle in the bottom right. The classic HUD is one setting away.
Added
Radar: the map around you in a bottom-left rectangle, circles for other players and flashing police, a north marker, and health, armour and air strips underneath; it zooms out and tilts into 3D while driving.
Top right: money with a change flash, the weapon and its ammo, and wanted stars that flash while the police are searching.
Bottom right: the area you're in, and the vehicle's name and class when you get in.
Options > HUD: switch between the Alt:SA and classic HUD, panel opacity, HUD size, 3D radar, police on the radar, and every piece on or off.
Self-test: Tools/run-autotest.sh hud.
Changed
While the Alt:SA HUD is on, the classic weapon icon, ammo, health bar, round minimap and area label are hidden.
Technical notes
Assets/Scripts/UI/Hud/: AltSaHud (Screen Space Camera canvas, perspective HUD camera on layer 31), HudElement, HudSettings, HudTheme, RadarElement, TopRightElement, BottomRightElement. See Docs/hud.md.
Gamemodes can now run a real sign-in: player accounts in a database on the server, a camera fly-over behind the panel, a flight down to the spawn, and renaming players. NG-RP uses all of it.
Added
Godfather v0.2: accounts with salted, slow password hashes; camera fly-over, fly-to and follow; renaming players; spawning at a fixed point finds the ground.
Self-test: Tools/run-autotest.sh ngrp creates an account, rejects a wrong password, signs in, and checks the password is in no log and not in the database.
Changed
Gamemode storage is one SQLite database, data/godfather/godfather.db, using the SQLite built into Windows; v0.1 JSON files are imported once.
Technical notes
Assets/Plugins/Godfather/Godfather.dll v0.2.0; GodfatherClient drives the camera in LateUpdate (execution order 32000); Player.ServerSetName. See Docs/godfather.md.
Servers can run gamemodes written in C# against Godfather v0.1: they greet players with glass panels, decide when they spawn, show toasts and remember data between restarts.
Added
Gamemode DLLs in the dedicated server's plugins/ folder are found and the one named in server.json (gameMode) runs.
Glass panels and toasts drawn from the server's description, in the UI kit look; game input pauses while a panel is open.
Gamemodes can keep players out of the world until they choose, e.g. after signing in.
Storage for gamemodes in the server's data/godfather/ folder.
Self-test: Tools/run-autotest.sh godfather plays the Hello-Godfather example on a dedicated server.
Changed
The loading screen hands over straight away when a gamemode shows a panel before the player spawns.
Respawning no longer stops at the first player a gamemode keeps out of the world.
Technical notes
Assets/Plugins/Godfather/Godfather.dll (Godfather-API v0.1.0) and Assets/Scripts/Godfather/. See Docs/godfather.md.
Hooks in PluginManager, GameManager.CanPlayerReadInput, PauseMenu (cursor), SpawnManager.SpawnPlayers and AltSaLoadingScreen.
The game can be started straight into a server with a chosen player name and GTA folder, which is how the Alt:SA launcher starts it.
Added
Alt-SA.exe -connect host:port joins that server as soon as the game has started.
-name sets the player name for this run (it wins over the name saved in the options), and -gtaDir sets the GTA San Andreas folder for this run without saving it.
Self-test: Tools/run-autotest.sh launch starts a dedicated server and one client the way the launcher does.
Technical notes
New Assets/Scripts/Launcher/LaunchArgs.cs (BeforeSceneLoad); MiscSettings applies LaunchArgs.PlayerName when the local player starts. Without -connect the game opens its menu as before.
The engine builds a headless Windows server that runs from a server.json file and reports its status over HTTP for the launcher.
Added
Headless dedicated server build: Tools/build-server.sh produces Build/Alt-SA-Server/Alt-SA-Server.exe; start it with -batchmode -nographics -dedicated.
server.json: name, ports, max players, scene, gamemode, GTA folder, plugins and data folders, created with defaults on first start. Command-line arguments override it.
Status endpoint: GET http://host:7780/status returns name, gamemode, players, player names, readiness and uptime as JSON.
Plugins (gamemodes) also load from the server's plugins/ folder.
Self-test: Tools/run-autotest.sh dedicated starts the server and two clients that join it.
Changed
Hosting a game no longer registers it with the upstream project's public server list; the Alt:SA list comes with the launcher.
Default server name is Alt:SA Server, and the build version reads 0.7.0 instead of the upstream 4.0.
Technical notes
New code in Assets/Scripts/Server/ (DedicatedServer, ServerConfig, QueryServer). The query endpoint runs on its own thread and serves a snapshot the main thread publishes once a second.
Exit codes: 2 for a bad server.json, 3 when the game port cannot be opened, 4 when the GTA San Andreas folder is missing or not a classic PC install.
Loading now shows the approved San Andreas loading screen: three illustrated panels that drift together and dissolve into the next set, a thin loading bar, and short lines that say what the game is really doing.
Added
New loading screen with the owner's twenty illustrations in ten three-panel compositions, layered depth, soft dissolves and a subtle breathing light.
The loader shows the real task, a real counter where the game counts its work (archives, files, map tiles, path areas, streaming jobs) and what comes next. It reaches 100% only when your character is in the world and the area around it has loaded.
Loading errors appear on the loading screen with Retry, Main menu and Quit. Retry resumes from the step that failed; a failed connection can be retried with the same address.
Developer preview of the loading screen (Alt:SA menu, or -altsaLoadingPreview in development builds) with the reference's simulated 90-second load, play/pause, start over, 1x/2x/4x and motion controls.
Changed
The old splash and progress text are gone. Game data loading spreads its file-by-file steps over frames, so the screen keeps moving while it loads.
Menu windows hide while the loading screen is up.
Technical notes
Code in Assets/Scripts/UI/Loading (SanAndreasUnity.UI.Loading): LoadingView, LoadingArtwork, AltSaLoadingScreen (production adapter), LoadingPreview. Shaders in Assets/Resources/Shaders/AltSa. Art, Rajdhani fonts (OFL) and the V5 config in Assets/Resources/AltSa/LoadingScreen.
The view renders into a non-sRGB render target so its compositing matches the browser reference in sRGB, then decodes once on an overlay canvas.
Loader: per-step counters (LoadingStep.SetCount), measured step weights, a 33 ms per-frame budget for file-by-file steps (MaxStepTimePerFrameMs), coroutine factories so a retry re-runs the failed step, error accessors, ExternalViewActive. Cell.NumPendingAreaUpdates exposes the streaming queue.
Tools/run-autotest.sh loading runs the preview checks and captures 720p/1080p/1440p/4K; host and client runs check the real loading screen; ALTSA_ARGS="-altsaLoadingFailOnce STEP" tests error and retry.
Street lamps, neon signs and lit windows now light the ground and walls around them at night, your car's headlights light the road and cast shadows, and surfaces reflect the world around them instead of only the sky.
Added
Map lights: the nearest street lamps, neon signs and lit windows give off real light at night (Medium: 32 lights within 90 m; High and Very High: more and further). They fade out at dawn.
Your vehicle's head and tail lights switch on at night, and its headlights cast soft shadows (Medium and up).
Reflections of the surrounding world on cars, glass and wet-looking surfaces (Medium and up).
Ambient occlusion: soft contact shading in corners and under objects (Medium and up).
Changed
Sun shadows have a budget per graphics profile: Medium draws them to 100 m with two cascades, High to 200 m and Very High to 300 m with four. Low uses hard shadows to 60 m.
Technical notes
New AltSa.Rendering components GfxShadows, GfxLights and GfxReflections; ambient occlusion in GfxPostFx. Feature switches and budgets live in Gfx.
LightSource keeps a registry of active 2dfx lights (LightSource.Active). Vehicle.SetAllCarLights(withBlinkers: false) creates lights without the blinker placeholder capsules.
The game has a new rendering foundation and five graphics profiles. It is the first step of rebuilding the Proper Shaders mod's visuals in Alt:SA: sharper light and shadow by day, glowing lamps at dusk, and surfaces that respond to light according to what they are made of.
Added
Graphics profile in the options window (GRAPHICS tab): Off, Low, Medium, High and Very High. Medium is the default.
From Medium up: per-pixel deferred lighting, HDR with filmic tonemapping, bloom and SMAA anti-aliasing. Low uses FXAA only.
Surfaces use the roughness and shadow rules recovered from the Proper Shaders mod for 10,920 game textures.
Changed
Lighting is computed in linear colour space. Colours shift slightly everywhere, also with the profile set to Off.
The sun is stronger and shade is filled by sky light during the day; nights stay dark.
Technical notes
New code in Assets/Scripts/Rendering (AltSa.Rendering): Gfx, GfxManager, GfxPostFx, GfxTune, MaterialRules, ProperShadersData.
Adds com.unity.postprocessing 3.2.2. Project colour space is Linear; baked vertex lighting is converted in Shared.cginc.
Recovered Proper Shaders 09-26 data lives in Assets/Resources/ProperShaders with its original licence and third-party notices; rebuild it with Tools/proper-shaders/build_data.py.
Tools/run-autotest.sh gfx LABEL [POSES] captures fixed views and frame timing; ALTSA_GFX, ALTSA_TUNE and ALTSA_BUILD select profile, tuning overrides and build.
Status of every feature, measurements and comparisons: Docs/proper-shaders.
San Andreas: Battlefield is now Alt:SA, the engine of a San Andreas multiplayer platform. It lives in the Alt-SAMP GitHub organization, and its website will be altmp.app.
Added
Repo docs for people and agents: README, AGENTS.md, changelog, roadmap and architecture.
Changed
The game is called Alt:SA everywhere: window title, build files (Build/Alt-SA/Alt-SA.exe) and the editor menu.
The code moved from Knot-Vector/SA-BF to Alt-SAMP/Engine, with the full history.
Fixed
Self-test: the client keeps retrying to join until the host is up, and sign checks account for a camera pressed against the car.
Technical notes
Unity productName Alt-SA, companyName Knot Vector. PlayerPrefs and persistentDataPath move to the new names, so saved options reset once.
Editor helpers moved to Assets/Editor/AltSa (AltSa.EditorTools). Self-test arguments are now -altsaTest/-altsaExpectClient/-altsaTestOut, and log tags are [Alt-SA].
Tools/changelog.cjs and Tools/roadmap.cjs come from Knot-Vector/Agent-Toolkit.
Engine messages now float above the car in the world instead of on the screen, and the game can test itself.
Added
A sign above the car's roof for 4 seconds: START ENGINE when you sit in the driver seat with the engine off (and again if you try to drive), a reminder to turn it off after starting, and ENGINE LEFT RUNNING when you leave it on.
Automated play test: the game can drive itself through entering a car, starting the engine, driving, multiplayer passenger and driver swaps, and report the results with screenshots.
Changed
The screen-corner start prompt and reminder were replaced by the sign above the car. Passengers never see it.
Fixed
The sign was destroyed when the map loaded, which caused an error every frame and kept it from appearing.
Technical notes
VehicleEngineSign: world-space canvas, billboarded, placed from local mesh bounds, DontDestroyOnLoad and rebuilt if destroyed.
Results: single player 18/18, multiplayer host 23/23 and client 9/9.
Cars start with the engine off. Press I in the driver seat to start or stop it, with a new in-car HUD.
Added
Engine on/off: cars spawn with the engine off and won't drive until you press I. Steering and brakes still work. The engine keeps running when you get out.
In-car HUD in the bottom-right corner: vehicle name, speed in MPH and engine state, in thin type with a sandy-brown accent.
I is listed in the in-game Controls window.
Technical notes
Engine state is server-authoritative and synced with a SyncVar on VehicleController. Only the driver can toggle it, and NPC drivers start it automatically.