Aleph One

This release is not network compatible with the previous release, and films saved with this release cannot be played back with older releases. Highlights: + Native Steam Linux support + Audio improvements + Additional sprite rendering option for 3D perspective + Replay films for saved games Changes: + Numerous audio improvements: + Pauses/resumes in-game audio when the game is paused/resumed + Intro music now continues to play in preferences dialogs + Shield/O2 charger now fully loop to prevent pops + Adds 3D spatialization for stereo sources + HRTF no longer affects music, streaming sources and 2D sounds + Fades in ambient sounds when they start playing + Sound obstruction adjustments + Allow HRTF settings only when stereo + 3D sounds are enabled + Adds a sensitivity/deadzone preference for each controller aim axis (#525) + Adds a few cheats to Cheats.lua + Adds support for Steam Linux including workshop upload + Films are now recorded when starting from saved games + Allows viewing terminals when the overhead map is active (#549) + Adds a new setting to tilt sprites parallel to the camera when 3D perspective is on + Shell casings are now interpolated at 60+ fps + (Lua) Adds Game.player accessor for Tag/KTMWTB/Rugby Other fixes: + Fixes players sprites when gathering a network game (#527) + Fixes stats board displayed twice before the epilogue in coop net games + Fixes hotkey issues with dead players and ball carriers (#516) + Fixes aim issues with aim getting stuck when both mouse and joystick are plugged in (#513) + Fixes an issue with DPDI and alien weapon ammo (#509) + Fixes network-only items not spawning on the first level (#517) + Fixes teleporting (local) effects when transiting to another level in coop net games + Fixes an issue where players can't respawn in net games on some broken maps (#457) + Stability improvements to dedicated servers + Improvements to native file dialogs (#550) + Fixes window focus loss when replaying a `film` selected with native file dialog (#401) + Fixes an assertion failure with some Marathon 1 maps (#533) Behind the scenes: + Uses libmatroska, libvpx, libyuv and pl_mpeg instead of FFmpeg + Uses ASIO for networking instead of SDL_net + Build fix for new versions of Boost (#556)

Please help test this beta release. It is not network compatible with the previous release, and films cannot be played back with older releases. Highlights: + Native Steam Linux support. To test the native Linux beta on Steam, you will need beta keys. Post in [this thread](https://steamcommunity.com/app/2398450/discussions/0/598534283538470240/) and we will send keys by PM. + Audio improvements + Additional sprite rendering option for 3D perspective + Replay films for saved games Changes: + Numerous audio improvements: + Pauses/resumes in-game audio when the game is paused/resumed + Intro music now continues to play in preferences dialogs + Shield/O2 charger now fully loop to prevent pops + Adds 3D spatialization for stereo sources + HRTF no longer affects music, streaming sources and 2D sounds + Fades in ambient sounds when they start playing + Sound obstruction adjustments + Allow HRTF settings only when stereo + 3D sounds are enabled + Adds a sensitivity/deadzone preference for each controller aim axis (#525) + Adds a few cheats to Cheats.lua + Adds support for Steam Linux including workshop upload + Films are now recorded when starting from saved games + Allows viewing terminals when the overhead map is active (#549) + Adds a new setting to tilt sprites parallel to the camera when 3D perspective is on + Shell casings are now interpolated at 60+ fps + Adds Game.player accessor for Tag/KTMWTB/Rugby Other fixes: + Fixes players sprites when gathering a network game (#527) + Fixes stats board displayed twice before the epilogue in coop net games + Fixes hotkey issues with dead players and ball carriers (#516) + Fixes aim issues with aim getting stuck when both mouse and joystick are plugged in (#513) + Fixes an issue with DPDI and alien weapon ammo (#509) + Fixes network-only items not spawning on the first level (#517) + Fixes teleporting (local) effects when transiting to another level in coop net games + Fixes an issue where players can't respawn in net games on some broken maps (#457) + Stability improvements to dedicated servers + Improvements to native file dialogs (#550) + Fixes window focus loss when replaying a film selected with native file dialog (#401) Behind the scenes: + Uses libmatroska, libvpx, libyuv and pl_mpeg instead of FFmpeg + Uses ASIO for networking instead of SDL_net

This is a bug fix release. Highlights: * Uses HUD filtering preference for Lua HUD images * Physics file is no longer mandatory for gathering using dedicated servers * It is now possible to mix workshop scenarios and local scenarios in the Steam version of Classic Marathon Infinity * Fixes an issue interpolating ephemera

Along with support for Classic Marathon Infinity on Steam and an uploader for the Steam Workshop, this release also includes a new scenario chooser. To use the scenario chooser, place the Aleph One executable in a folder containing scenario folders, or add a "Scenarios" folder to one of the original trilogy folders. The scenario chooser is not included with all-in-one Mac apps; use the standalone Aleph One app instead.

This is a major release featuring support for [Classic Marathon 2 on Steam](https://store.steampowered.com/app/2398490/Classic_Marathon_2/), dedicated servers, ping times for metaserver net games, a pregame network loading screen, automatic demos, and more authentic gameplay options. Aleph One 1.9 is not backwards compatible with Aleph One 1.8 net games. Changes: * Classic Marathon 2 with achievements on Steam * Dedicated servers It is now possible to gather multiplayer or co-op games without any router configuration. The netgame setup process is the same, but selecting the Use Dedicated Server checkbox will cause Aleph One to coordinate with the lhowon.org metaserver to find the nearest available dedicated server to do the actual gathering using the settings you've chosen. Dedicated servers are also a good option to ensure smooth gameplay for joiners when you are gathering on WiFi or a congested connection. * Adds an invert vertical aim preference for controllers * It is now possible to implement Classic Marathon music plugins * Restores the automatic demo playback feature to Classic Marathon 2 and Classic Marathon Infinity. You will need to update your data files to get the new demos. * Allows selecting original Marathon 2 or Marathon Infinity film profiles for solo games Choosing the film profiles under Solo Gameplay setting allows you to begin a game with the strict original gameplay from Marathon 2 or Marathon Infinity, without Aleph One's fixes. Films will technically be compatible with the originals (if you don't use hotkeys), with a few modifications using a hex editor. * Adds support for sphere-mapped landscapes (OpenGL only) * Adds a new preference for disabling filtering on the HUD / Terminals (thanks to Celeste) * Shows ping to the game gatherers (or their dedicated servers) in the find internet game lobby * Shows a pregame network loading screen Other fixes: * Fixes issue gathering some old Classic Marathon net maps that have the same checksum as the main map * Other fixes for old Classic Marathon net maps * Uses search path in Music.valid; fixes #485 * Returns the key name for w_key labels, instead of the scancode; fixes #491 * Uses OpenGL routines to measure text width for DisplayTextCursor when OpenGL is active; fixes #473 * Returns Lua HUD FOV in degrees rather than internal units; fixes #496 * Initializes player_terminal.state to _no_terminal_state; fixes #498 * Fallback to default game files if the ones in preferences can't be located (fixes #477) * Adds item and scenery visibility accessors and teleport functions; fixes #454 * Adds Triggers.calculate_level_completion_state * Adds Triggers.monster_kamikazed; fixes #493 * M2 theme buttons now resemble the main menu (thanks to Blastfrog) * Fixes to the M2 main menu rects

This is mostly a Steam bug fix release, but it does have a couple useful updates for Classic Marathon: * Fix a crash with some older Marathon net maps like Villa Banzai and Rancid Cafe * Fix an issue with the default and basic HUDs displaying error messages in net games with a kill limit

The major new feature of this release is support for [Steam](https://store.steampowered.com/app/2398450/Classic_Marathon/) and achievements: Standalone builds see a few changes and bug fixes: * Various sound and music fixes * Some fixes to sprite visibility * Add an option for weapon bob without camera bob * Classic Marathon indexes levels starting at 0 now in the level select dialog * Various controller navigation fixes * Fix an issue with multiple level specific plugins * Lua: fix Players.print and player.overlays in Triggers.init() * Basic M1 HUD and Basic HUD are now included with the data files. You can change which HUD Aleph One uses in graphics preferences * Add more minimum range to the mouse/joystick sliders * Fix plugins re-enabling/re-disabling when Aleph One location changes

## Changes + The name of the application has been changed to Classic Marathon, to differentiate it from the upcoming Bungie game + Added support for quad, 5.1, 7.1 surround sound + Numerous bug fixes See also the [Aleph One 1.7 Release notes](https://github.com/Aleph-One-Marathon/alephone/releases/tag/release-20231125).

This version of Aleph One is incompatible with previous versions in net games. All net game players should update to 1.7. New features: + Optional 3D positional audio and HRTF headphone support using OpenAL soft + Support for map-specific resources plugins. See https://simplici7y.com/items/m2se-music-plugin/ for an example + HUD plugins are now selectable from graphics preferences as well as plugins, for more discoverability + Adds a Vidmaster-Oath-incompatible setting for making the run/swim key a toggle + Updated SDL library to 2.28.2 for better controller support For mappers: + New music API for Lua which allows multiple tracks and crossfades + New transfer modes for reverse horizontal / vertical slide + New transfer modes for 2x / 4x tile transfer + New MML for larger tiling for replacement textures + Additional fog options in MML/Lua Bug fixes: + Improved M1 authenticity + Sprite visibility and texture Z-fighting fixes + Fixes to built-in HUD in Linux

This is a beta release to help test a few new features for end users coming in 1.7: + Optional 3D positional audio using OpenAL soft, including HRTF + Support for map-specific resources plugins. See https://simplici7y.com/items/m2se-music-plugin/ for an example + HUD plugins are now selectable from graphics preferences as well as plugins, for more discoverability As well as these features for mappers: + New music API for Lua which allows multiple tracks and crossfades + New transfer modes for reverse horizontal / vertical slide + New transfer modes for 2x / 4x tile transfer + New MML for larger tiling for replacement textures + Additional fog options in MML/Lua

This is a bug fix release, with a change to theme and plugins button location to help new players switch HUDs. Changes: + Uses the system 7 theme for Marathon rather than the old theme with nonobvious buttons + Moves the Plugins button up to the main Preferences menu + Makes transparent liquids a disabled plugin by default, to match classic Marathon 2 and Infinity experience Bug Fixes: + Fixes a crash in software mode + Fixes tostring for some Lua enums + Only plays breathing sounds and O2 warnings for the current player + Partial fix for destroyable scenery showing the wrong frame See the [1.6 release notes](https://github.com/Aleph-One-Marathon/alephone/releases/tag/release-20221126)

This is a bugfix release: + Be less aggressive with mega honk fix + Fixes Linux builds without ffmpeg + Fixes a crash when a Lua script adds a side and interpolation is enabled (#321) + Fixes the classic aim limits checkbox + Adds support for FLAC playback (MML music only) + Fix cinematic fade in when the transition period is low + Works around a change in the latest SDL behavior on Macs (#398) + Changes the flatpak identifier to match the existing macOS bundle identifier See the [1.6 release notes](https://github.com/Aleph-One-Marathon/alephone/releases/tag/release-20221126)

This is a maintenance release, with mostly bug fixes and library and build system updates. We have also added Linux Flatpaks to make installing the games easier in Linux. Deprecations: + `` debug MML is deprecated and will be removed in a future release + The network microphone is deprecated and will be removed in a future release. The net mic key will be repurposed as a Lua trigger. Changes: + Updated to SDL 2.24 for improved controller support + Aleph One now requires a C++17 compiler + (Lua) Allow passing `nil` to Monster:attack (#331) + (Lua) Add Platform.tag accessor (#373) + Remove classic aim limits from modern mouse feel; add a checkbox for classic aim limits + Lower default mouse sensitivity + Disable 3D perspective by default + Rename "Interface Button Sounds" checkbox to "In Game F-Key Sounds" (#255) + Disable transparent liquids by default in _Marathon 2_ and _Marathon Infinity_; they can be enabled by going to Environment -> Plugins and enabling the Transparent Liquids plugin + (Lua) added Game.replay for detecting whether a game is film replay Fixes: + Fix teleporting in weapon effect on 60fps + (#308) + Fix the enhanced HUD with software renderer (#334) + Fix HUD not resizing when changing resolution `(#309) + Fix blank frame on map overlay transition in OpenGL mode (#265) + Restore screen flash for Marathon 1 when teleporting in (#336) + Fix UPnP checkbox not working in resume net game dialog (#337) + Fix platform textures when exporting a level + Fix assert thrown on network game when teleporting to another level with disconnected player (#66) + Fix controller feel analog/d-pad when saving prefs (#160) + Fix intro video not rendering when no audio stream; fixes EVIL's opening movie (#346) + Fix missing initialization in Lua damage_player (#348) + Fix the MegaHonk. RIP MegaHonk. (#339) + Add suport for ffmpeg 5 (#349) + Fix a Linux segfault at shutdown (#340) + Allow binding mouse buttons to forward/backward/sidestep (#333) + Remove the Vidmaster Oath from Marathon 1 (#355) + Fix MML plugin replacement font erased on first level load (#364) + Use GL_MIRRORED_REPEAT instead of GL_MIRRORED_REPEAT_ARB; fixes solid colored landscape on some OpenGL drivers + Implement transparency in the static shader; compilers now fade out as in software + Fix use of caps lock as run key (#294) + Suppress weapon flare when Lua cameras are in use (#316) + Fix default preference plugins disabling in Windows + Fix animated 3D models + Fix reloading physics model if not loaded from embedded map (#317)

Changes: + Numerous bug fixes + Additional Lua functionality (see Lua.html) + Support for Apple Silicon + Improved UPnP router configuration support (now using miniupnp) + Adds an FOV override slider and warning + Adds a checkbox for native file dialogs (mac OS and Windows only) + Unbundles high-res plugins. See [High-Res Replacements](https://github.com/Aleph-One-Marathon/alephone/wiki/Hi-Res-Replacements) for separate download links.

Changes: + Bug fixes + Additional Lua functionality (see Lua.html) + macOS: support for Apple Silicon + Updated UPnP router configuration support (now using miniupnp) + Add an FOV override slider and warning + macOS and Windows: added a checkbox for native file dialogs + Removed high-res plugins from all-in-one downloads. There are many more options now than there were when we started bundling them, so this will give users more flexibility. Links to the old textures and a guide to hi-res textures will be provided soon; in the meantime the data files with hi-res plugins can be found in the 1.4 release.

Note: This release is not network compatible with Aleph One 1.3 and earlier. Changes: + Adds support for Lua ephemera: optional scripted effects like precipitation or gore, that can be turned on and off without affecting saved games, films, and net games + Adds a new "Editor" mode that integrates better with Weland for seamless visual mode editing + Adds new high frame rate interpolation. Choose 30 fps for authentic classic play, 60 fps or 120 fps capped, or unlimited fps + Adds many new Lua API functions. See Lua.html for details + Adds support for weapon hot keys. Hot keys 1-9 switch weapons, but can be overridden by Lua scripts; hot keys 10-12 are reserved for Lua scripts + Restores some retro/nostalgia features in the software renderer: every-other-line mode, and 8-bit color + MML/Lua can now set the maximum inventory on a per-difficulty level. This should add versatility for balancing difficulty in new scenarios

Changes since 1.4pre2: - add support for weapon hotkeys; hotkeys 1-9 switch weapons, but can be overridden by Lua; and another 3 hotkeys are available for Lua - restore some retro/nostalgia features in the software renderer: every-other-lines mode, and 8-bit mode - MML/Lua can now set the maximum inventory on a per-difficulty level - numerous new Lua API additions - bug fixes Note: Aleph One 1.4rc1 is not network compatible with previous versions, due to the addition of hotkeys

Changes: - High frame rate interpolation; choose 30 fps for authentic classic play, 60 fps or 120 fps capped, or unlimited fps - New Lua API functions - Bug fixes

This is a preview release, with support for ephemera (optional scripted render effects like precipitation or extra gore) and a new "editor" mode that integrates better with Weland 1.4.5

Changes: + Fixes an issue saving/playing back Aleph One films using the original Marathon data files + Fixes wobble transfer mode glow maps

Major Changes: + Uses SDL 2 for much-improved compatibility with new operating systems + Better support for game controllers + Better performance for the software renderer + Improved mouse control options, with settings for Classic and Modern mouse control + Better support for high-dpi displays + New controls dialog, which allows simultaneous key, mouse, and controller bindings + More authentic static effect when using OpenGL + Adds a stash for sharing info between Lua states + Better support for Unicode characters in Windows (should fix Rubicon X) + Better support for original Marathon scenarios including Trojan, which now works fully + A separate 64-bit Windows build is available + Better master volume and music volume controls + Video export bitrate depends on the video resolution, which leads to much improved export at 1080p with default settings + Mac apps are now notarized by Apple + Original games now default to more authentic settings on first install; high res plugins are still included but are not enabled by default

# Aleph One 1.3a1 This is a pre-release to allow community members to assist in testing some internal code changes. Please see the [Pfhorums thread](http://pfhorums.com/viewtopic.php?f=22&t=39075) if you would like to help. The latest stable release is: **[Aleph One 1.2.1](https://github.com/Aleph-One-Marathon/alephone/releases/tag/release-20150620)**

# Aleph One 1.2.1 The 1.2.1 release fixes a crashing bug when carnage message MML is used. Otherwise it is identical to the 1.2 release. # Aleph One 1.2 The Aleph One 1.2 release features online leaderboards and game statistics, a streamlined saved-game system, and full multiplayer support for the original _Marathon_ game. This release also includes a number of other new features and bug fixes. If you do not use the bundled downloads, we recommend that you update your scenario files. Each game includes a new plugin for the online leaderboards, and the _Marathon_ scenario includes an important compatibility fix. Aleph One 1.2 is **not** network compatible with the previous stable release. ## Online features Aleph One now integrates with the online leaderboards and player stats at [lhowon.org](https://lhowon.org/). Sign up within Aleph One to send your _Marathon_, _Marathon 2_, and _Marathon Infinity_ game results to lhowon.org, where you can see your overall win percentage, kill totals, and more. From the new "Internet" preferences section, you can register your chat name, opt in to player stats, and configure other options relating to online play. ## Saved games Saving your game no longer stops the action until you type in a name. Each time you use a pattern buffer, a new saved game is created. The "Continue Saved Game" dialog shows you the in-game location, date, and game time for every save. Use the "Load Other" button to open a saved game from an earlier version of Aleph One. ## _Marathon_ compatibility - Cooperative play is now supported in the original _Marathon_ scenario - Net games no longer use incorrect physics models - Goal checking in repair levels now matches the original game - Grenade trajectory in low-gravity levels now matches the original game - Certain terminals and rechargers could be activated when they shouldn't have been. You must use the 1.2 scenario data files to get this update. - If you have an existing saved game on an "exploration" level, you may need to re-explore the level before you can exit. We apologize for the inconvenience. ## Lua - Additions to the Lua API: - `Triggers.projectile_created()` - `Game.dead_players_drop_items` - `Level.index` - `Level.map_checksum` - `Line.visible_on_automap` - `Polygon.visible_on_automap` - Additions to the Lua HUD API: - `Level.name` - `Level.index` - `Level.map_checksum` - Custom fields on projectiles, monsters, etc. are cleared when the object is destroyed - Lua error messages contain more diagnostic info - `Player:find_action_key_target()` no longer triggers side effects ## Other changes - New preferences: - Camera Bobbing (Graphics) — if disabled, the camera and weapon will remain steady, to reduce motion sickness - Join Pregame Lobby by Default (Internet -> Pregame Lobby) — if checked, when you choose "Join Network Game", Aleph One automatically presses "Find Internet Game" on the next screen. Hold down the Alt (Option) key to join a local game. - Use Netscript in Films, Netscript File (Environment) — use these preferences to play back films of games recorded with netscripts. Solo Lua scripts are no longer loaded during playback of net game films. - Logging in to the pregame lobby uses HTTPS to protect your password - The editing cursor in text fields can be moved with the arrow keys or the mouse - Command history in the Lua/chat console can be accessed with the up and down arrow keys - Team color selection in the Join dialog is disabled when the game does not support teams - Plugin API changes: - Scenario compatibility, to create plugins that load only for specific scenarios - More combinations of items are allowed within a single plugin - The Plugins dialog (Preferences > Environment > Plugins) lists the components of each plugin - Lua HUD support is available by plugin only - A custom port can be used when gathering net games. The port number can only be changed by editing the XML preferences file. ## Crashes fixed - Maps with invalid light indexes in OpenGL (Shader) renderer - 3D models lacking texture coordinates - `#STATIC` command in terminals (SF #580) - Joining a net game after a "map not found" film playback error (SF #504) ## Graphical fixes - 3D models display even when their center point is behind player - Repair chip inventory is shown in _Marathon_ Enhanced HUD plugin - Carnage messages during film replay are shown for the currently viewed player - Static, pulsate, and wobble transfer modes improved in OpenGL (Shader) renderer - `` MML setting respected in OpenGL (Shader) renderer - Motion sensor on magnetic levels works properly when frame rate lags (SF #372) - Styled chat names display properly in pregame lobby game info dialog ## Platform-specific fixes - Linux: - A new configure script now succeeds when optional dependencies are missing. The script also summarizes which features are enabled. Packagers should review the configure options, which have changed. - Aleph One builds and runs with more versions of FFmpeg / libav (SF #576, #578, #582) - Web links no longer cause Aleph One to become unresponsive on some systems - Mac OS X: - Drag-and-drop now works in 10.10 (Yosemite) - Updated third-party libraries - Windows: - The `.save level` console command successfully overwrites existing files - Updated third-party libraries ## Other fixes - MML from solo Lua plugins is no longer loaded after all other plugins - Plugins ignore references to non-existent files - Popping is reduced in certain ambient sounds - Various MML settings are correctly reset when changing levels - Some common but unhelpful messages are no longer written to the log file - File-overwrite dialogs respect the "Hide file extensions" preference - The first save in a cooperative game is less likely to fail - Saving a game creates fewer temporary files - Solo Lua is loaded when continuing a saved game even when the map file is missing - Joystick/mouse buttons mapped to map or volume controls are no longer ignored - UPnP configuration now works with more routers