maj00r 170bb58487 feat(settings): the simulator's OpenAL Soft options in the sound category
A new "Sound device and effects" section sets the eu07.ini keys the simulator
reads for OpenAL Soft: sound.openal.renderer (device), sound.outputmode,
sound.hrtf, sound.hrtf.profile, sound.resampler, sound.limiter,
sound.frequency, sound.doppler, sound.efx.lowpass and
sound.efx.airabsorption.

The lists of devices, HRTF data sets and resamplers come from the OpenAL
library in the game folder (OpenAL32.dll / libopenal.so.1), read in the
background through NativeLibrary and function pointers (AllowUnsafeBlocks);
without it, or with an older library, the lists hold the file's value and the
library's choice. Names with spaces are written in quotes, an empty name takes
its line out, and a key the file lacks is written only when it differs from
the simulator's default, so saving with these left alone adds nothing.

sound.maxsources is left out: OpenAL Soft gives at least 256 sources
whatever is asked, so it would be a setting that does nothing; a line the
file has stays as it is. A device name code page 1250 cannot hold, the
encoding of eu07.ini, is not offered, as it would reach the simulator as
question marks. HRTF data sets and resamplers are offered only with ASCII
names, since the simulator looks those up by the library's own spelling. A
value a slider can't show, outside its range or between its ticks, is kept
by the page's shown-unlike bookkeeping until the slider is moved.

Strings in en and pl with descriptions, labels in cz, hu and ru.
2026-11-17 14:34:28 +01:00
2026-11-07 06:27:16 +01:00
2026-11-07 06:27:16 +01:00
2025-12-23 08:47:36 +01:00
2025-12-23 08:47:36 +01:00
2026-08-30 22:29:45 +02:00

StarterNG

Launcher for the MaSzyna train simulator, written in C# with Avalonia.

Building a native (NativeAOT) build

The project publishes as a self-contained NativeAOT binary — no .NET runtime is needed on the target machine. The commands below are the same ones CI runs, see .github/workflows/dotnet.yml.

Requirements:

  • .NET SDK 9
  • Linux: a native toolchain and zlib headers — sudo apt install clang zlib1g-dev (Debian/Ubuntu) or sudo dnf install clang zlib-devel (Fedora)
  • Windows: the Visual Studio C++ build tools (Desktop development with C++)

Restore for the target runtime first, then publish:

dotnet restore StarterNG/StarterNG.csproj -r linux-x64

dotnet publish StarterNG/StarterNG.csproj \
    -c Release -r linux-x64 --self-contained true --no-restore \
    -p:PublishAot=true -p:PublishTrimmed=true \
    -o publish/linux-x64

For a Windows build swap both linux-x64 occurrences for win-x64 (and the line continuations for PowerShell backticks). NativeAOT does not cross-compile, so the Windows package has to be built on Windows and the Linux one on Linux — that is why CI uses a windows-2022 and an ubuntu-22.04 runner.

The output directory is the whole distributable: the Starter executable, the Skia/HarfBuzz native libraries and startercfg/ with the translations and the default key bindings. The .dbg (or .pdb) file next to it is debug symbols and can be dropped from a release. Trim/AOT analysis warnings during the publish are expected and do not fail the build.

CI builds both runtimes on every push and pull request to main and staging, and on manual dispatch. Pushes additionally replace a rolling pre-release with the packaged artifacts — tagged latest for main and staging for staging.

Development build

dotnet build StarterNG/StarterNG.csproj
Description
No description provided
Readme MPL-2.0 4.5 MiB
Languages
C# 100%