Packing one into every zip meant a tester who unzipped a new build over their folder got their configuration replaced. bindings.txt has never had that problem, because the exe carries the template and writes the file only when it is absent. environ.ini now works the same way, so a new build can land on an existing folder and every setting survives. The 245-line template moves out of pack-dist.ps1 and into RPL4ENVIRON.cpp as the exe's own literal, which also means the exe alone can produce a working install. It was lifted mechanically rather than retyped, and the file it writes is line-for-line identical to the one we have been shipping - only the line endings changed, from a mongrel 243 LF plus one stray CRLF that PowerShell's Set-Content left on the end, to the uniform LF the game already writes bindings.txt with. It cannot simply become optional. Without environ.ini, L4GAUGE is unset - which disables the gauge renderer and takes every MFD with it - and L4MFDSPLIT is unset, which is the packed-window arcade layout rather than the glass cockpit. The shipped values ARE the desktop game; the built-in getenv fallbacks are the 1995 pod. So the game writes the file rather than tolerating its absence. The cost of a file that is never overwritten is that a tester carrying one across many builds stops being offered new options. Nothing breaks - an option added later defaults to "behave as before" - but it goes unnoticed, and "the podium does not work" is a confusing bug report when the real answer is that their environ.ini predates RP412PODIUM. So the load names every template key the player's file has never mentioned, and says they are at built-in defaults and that deleting the file brings the documented one back. A stale seven-line file lists all 40. The file is read, never rewritten. The mention test is deliberately generous - a key counts as known if it appears in any form, commented or not - because the failure it guards against is worse than a missed notice: environ.ini is applied line by line, so a second copy of a key appearing later in the file would silently override the player's own. The version line also moves to the top of WinMain. It used to print after the environment was loaded, so the first thing in rpl4.log was a message about environ.ini rather than which build wrote it. Verified: the written file matches the old shipped one line for line; an edited file with a hand-added comment survives another run untouched; a seven-line file from an older build boots and names all 40 options it has never heard of; and a full mission on a self-written file brings up the glass cockpit at 125% with the virtual RIO active and nothing alarming in the log. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
45 lines
2.2 KiB
C
45 lines
2.2 KiB
C
//===========================================================================//
|
|
// File: rpl4environ.h //
|
|
// Project: MUNGA Brick: Red Planet LBE Application //
|
|
// Contents: environ.ini - written on first run, then the player's //
|
|
//---------------------------------------------------------------------------//
|
|
// Copyright (C) 1994-1995, Virtual World Entertainment, Inc. //
|
|
// PROPRIETARY AND CONFIDENTIAL //
|
|
//===========================================================================//
|
|
|
|
#pragma once
|
|
|
|
#include "..\munga\style.h"
|
|
|
|
//########################################################################
|
|
//
|
|
// environ.ini is the game's configuration: one KEY=VALUE per line, read
|
|
// once at startup and pushed into the environment, so every option the
|
|
// engine reads through getenv can be set from a file a player can open.
|
|
//
|
|
// The exe owns the template and writes it when the file is absent, the
|
|
// same way bindings.txt works, rather than the packaging script laying
|
|
// one down on every unzip. That is what lets a tester drop a new build
|
|
// over an old folder and keep their settings: the file is theirs from
|
|
// the moment it exists, and nothing overwrites it.
|
|
//
|
|
// It cannot simply be optional. Without it L4GAUGE is unset, which
|
|
// disables the gauge renderer and takes every MFD with it, and
|
|
// L4MFDSPLIT is unset, which is the packed-window arcade layout rather
|
|
// than the glass cockpit. The shipped values are the desktop game; the
|
|
// built-in getenv fallbacks are the 1995 pod.
|
|
//
|
|
// The cost of a file that is never overwritten is that a tester carrying
|
|
// one across many builds stops being offered new options. Options added
|
|
// later default to "behave as before", so nothing breaks - but it does
|
|
// go unnoticed, so the load names any template key the player's file
|
|
// does not mention. That line in rpl4.log is what turns "the podium does
|
|
// not work" into "your environ.ini predates RP412PODIUM".
|
|
//
|
|
//########################################################################
|
|
|
|
// Write environ.ini if it is not there, then read it into the
|
|
// environment. Call once, before anything reads a setting.
|
|
void
|
|
RPL4Environ_Load();
|