# ============================================================================ # pack-dist.ps1 - assemble a runnable Red Planet 4.12 package into dist\ # ============================================================================ # # Collects everything the game needs at run time: # - Release\rpl4opt.exe (+ .pdb for crash debugging) # - game data from assets\RP411 (AUDIO, GAUGE, VIDEO, INIs, RPL4.RES, # TEST.EGG) - but not the arcade launch scripts or the old 4.10 exe # - libsndfile-1.dll beside the exe; OpenAL32.dll copied from the system # when installed, with oalinst.exe included as the fallback installer # - a desktop environ.ini (PAD;KEYBOARD controls, on-screen plasma) # - start-windowed.bat and a README # # Usage: powershell -ExecutionPolicy Bypass -File pack-dist.ps1 [-Zip] # param( [switch]$Zip ) $ErrorActionPreference = 'Stop' $root = Split-Path -Parent $MyInvocation.MyCommand.Path $dist = Join-Path $root 'dist' $assets = Join-Path $root 'assets\RP411' $exe = Join-Path $root 'Release\rpl4opt.exe' if (-not (Test-Path $exe)) { throw "Release\rpl4opt.exe not found - build first (see BUILD.md 2)." } # Refuse to touch a dist the game is currently running from. $running = Get-Process rpl4opt -ErrorAction SilentlyContinue | Where-Object { $_.Path -like "$dist\*" } if ($running) { throw "rpl4opt.exe is running from $dist (PID $($running.Id)) - close the game first." } Write-Host "Packing into $dist" if (Test-Path $dist) { Remove-Item -Recurse -Force $dist } New-Item -ItemType Directory -Force "$dist\SPOOLS" | Out-Null # --- game binary ----------------------------------------------------------- Copy-Item $exe $dist $pdb = Join-Path $root 'Release\rpl4opt.pdb' if (Test-Path $pdb) { Copy-Item $pdb $dist } # steam_api.dll: the exe imports it (RP412_STEAM build). The Steam wire # only activates with RP412STEAM=1; plain desktop runs never touch it. Copy-Item (Join-Path $root 'extern\steamworks_sdk_164\sdk\redistributable_bin\steam_api.dll') $dist # steam_appid.txt: until RP412 has its own AppID, Steam testing runs # under Spacewar (480). Without this file SteamAPI_Init fails and the # game falls back to plain TCP - which is exactly the confusing symptom # testers hit when the file goes missing. Delete it once we ship under # our own AppID (the Steam client provides it then). Set-Content -Path "$dist\steam_appid.txt" -Encoding ascii -Value '480' # --- game data ------------------------------------------------------------- foreach ($dir in 'AUDIO', 'GAUGE', 'VIDEO') { Write-Host " copying $dir..." Copy-Item -Recurse (Join-Path $assets $dir) $dist } foreach ($file in 'RPDPL.INI', 'JOYSTICK.INI', 'RPL4.RES', 'TEST.EGG', 'libsndfile-1.dll', 'oalinst.exe') { Copy-Item (Join-Path $assets $file) $dist } # The controls map travels with the game (players get the diagrams # without needing the repo). Flattened to ASCII so it reads correctly # in Notepad - the markdown source keeps its typography. $controls = Get-Content (Join-Path $root 'docs\CONTROLS.md') -Raw -Encoding UTF8 foreach ($pair in @( @([char]0x2014, '-'), @([char]0x2013, '-'), @([char]0x2018, "'"), @([char]0x2019, "'"), @([char]0x201C, '"'), @([char]0x201D, '"'), @([char]0x00D7, 'x'), @([char]0x2192, '->'), @([char]0x2026, '...'))) { $controls = $controls.Replace([string]$pair[0], [string]$pair[1]) } Set-Content -Path "$dist\CONTROLS.txt" -Encoding ascii -Value $controls # The same map as a page, for anyone who would rather look at the # diagrams than read them. Its source is the published artifact, which is # a fragment - the publisher supplies the document shell - so wrap it to # stand alone: without a doctype the browser drops into quirks mode, and # without a charset the typography arrives as mojibake. Written without a # BOM so the charset declaration is the only thing speaking. $controlsPage = Get-Content (Join-Path $root 'docs\rp412-controls.html') -Raw -Encoding UTF8 $page = @" $controlsPage "@ [System.IO.File]::WriteAllText( "$dist\CONTROLS.html", $page, (New-Object System.Text.UTF8Encoding $false)) # --- OpenAL runtime -------------------------------------------------------- # The exe links OpenAL32.dll (32-bit). Prefer shipping the already-installed # runtime beside the exe; oalinst.exe covers machines where that misses. $openal = "$env:WINDIR\SysWOW64\OpenAL32.dll" if (-not (Test-Path $openal)) { $openal = "$env:WINDIR\System32\OpenAL32.dll" } if (Test-Path $openal) { Copy-Item $openal $dist $wrap = Join-Path (Split-Path $openal) 'wrap_oal.dll' if (Test-Path $wrap) { Copy-Item $wrap $dist } Write-Host " OpenAL runtime copied from $(Split-Path $openal)" } else { Write-Warning "OpenAL32.dll not found on this system - dist relies on oalinst.exe" } # --- desktop configuration ------------------------------------------------- Set-Content -Path "$dist\environ.ini" -Encoding ascii -Value @" # ============================================================================ # environ.ini - Red Planet 4.12 configuration # ============================================================================ # One KEY=VALUE per line, read at game start. Lines starting with # or ; # are comments; anything without an = is ignored. Delete a line (or # comment it out) to fall back to the built-in default. # # Input bindings live in bindings.txt beside the exe (written with the # full documented layout on first run; delete it to restore defaults). # ---- Core (the shipped configuration) -------------------------------------- # Control stack: tokens separated by ; or , processed left to right. # PAD the virtual RIO (XInput controller + keyboard, # rebindable via bindings.txt) # RIO real serial cockpit hardware on COM1 # RIO:COMn same, on another port (RIO:COM3, ...) # KEYBOARD the engine keyboard handler # MOUSE, JOYSTICK, FLIGHTSTICKPRO, THRUSTMASTER, DIJOYSTICK # legacy pointer/joystick drivers (untested here) # Unset falls back to KEYBOARD alone. L4CONTROLS=PAD;KEYBOARD # Renderer bring-up argument. Only its presence is checked (the DPL # resolution parsing it once fed is gone) and the game refuses to start # without it - any non-empty value works. Leave as shipped. DPLARG=1 # DPL (renderer/scene) configuration file, searched beside the exe. # Any notation file name; RPDPL.INI is the one that ships. L4DPLCFG=RPDPL.INI # Gauge (MFD/instrument) canvas. Must name a page of GAUGE\L4GAUGE.INI: # 640x480x8 | 640x480x16 | 800x600x16 # Unset disables the gauge renderer (and with it all MFDs). L4GAUGE=640x480x16 # Plasma display. # SCREEN render the pod's plasma glass in-window (currently # parked off-layout) # COM1, COM2... drive real plasma glass on that serial port # (9600 baud, N81) # Unset = no plasma display. L4PLASMA=SCREEN # 0 = classic separate gauge windows; 1 = the single-window glass # cockpit (all seven displays composed on a locked 1920x1080 canvas # around the viewscreen); 2 = exploded diagnostic view (each display # in its own native-resolution desktop window - MFDs 640x480, map # 480x640 - decoded exactly as the pod's VDB split them, no downscale). L4MFDSPLIT=1 # Size of the six secondary displays in the glass cockpit, as a # percentage of their pod size. The pod bolted them down at one size; # on a big panel there is room to trade viewscreen for instrument, so # turn these up if you want to actually read the other displays while # you fly. 100 = as the pod had them. Range 25-200 (out-of-range and # unreadable values fall back to the group setting, then to 100). # # The scaling is applied in canvas units, before the cockpit is fitted # to your window, so a given number looks the same on every monitor. # The layout stays legal whatever you ask for - the panes are clamped # against their actual neighbours, shrinking uniformly so a display # never comes out stretched. They do overlap the viewscreen, exactly # as the pod's bezels did, but never each other. # # L4MFDSCALE sets all five green MFDs at once. L4MFDSCALE=100 # ...and any single display can override it. Uncomment one to size it # on its own - useful if you only care about, say, the damage readout. # UL upper left UC upper center UR upper right # LL lower left LR lower right #L4MFDSCALE_UL=100 #L4MFDSCALE_UC=100 #L4MFDSCALE_UR=100 #L4MFDSCALE_LL=100 #L4MFDSCALE_LR=100 # The portrait radar/map, sized on its own (it already sits at 1.35x # the MFDs by default). It shares the canvas with whichever MFD is # above it, so at extreme settings one of the two gives way. L4RADARSCALE=100 # Where the radar sits: # CENTER bottom centre, under the viewscreen, as the pod had it # (default; BOTTOM and CENTRE mean the same) # LEFT bottom left corner (or BOTTOMLEFT) # RIGHT bottom right corner (or BOTTOMRIGHT) # MIDLEFT left edge, halfway up (or LEFTCENTER / LEFTCENTRE) # MIDRIGHT right edge, halfway up (or RIGHTCENTER / RIGHTCENTRE) # Anywhere but CENTER stops it blocking the middle of the road, which # is worth having on a wide screen. # # In a bottom corner it is one of three panes along the bottom, and the # lower MFD whose corner it takes slides inboard beside it. Halfway up # a side it leaves the bottom row entirely and sits between that side's # two MFDs - roomy on a tall radar, but if the MFDs on that side are # also scaled up, the radar is the one that gives way (it has to clear # both of them, and it grows from the middle in both directions). L4RADARPOS=CENTER # Simulation/render frame rate, integer frames/second. The desktop # default is 60; the arcade pods shipped at 25. TARGETFPS=60 # 1 = Steam networking (lobbies, FakeIP mesh). Needs the Steam client # running and steam_appid.txt beside the exe; without them the game # logs the reason and falls back to plain TCP. 0 = TCP only. RP412STEAM=1 # ---- Optional --------------------------------------------------------------- # RGB keyboard lamp mirror (Windows Dynamic Lighting): keys bound to # lamp buttons glow with the panel, flash modes and all. # Unset or nonzero = on (the default); 0 = off. #RP412KEYLIGHT=0 # Invert the stick on top of whatever bindings.txt produces: # X = invert X only, Y = invert Y only, XY = both (case-insensitive). #L4PADFLIP=XY # Anti-aliasing sample count, passed straight to Direct3D 9: # 0 = off, else 2..16 as the GPU supports (1 selects the driver's # "nonmaskable" mode; unsupported counts fail device creation). #MULTISAMPLE=0 # Particle budget, integer. Default 8192. #MAXPARTICLES=8192 # On-screen plasma glass (L4PLASMA=SCREEN only). SCALE = integer pixel # size 1..16, default 4 (out-of-range values are ignored). POS = window # top-left as X,Y screen coordinates; unset = auto, parked below the # main window. #L4PLASMASCALE=4 #L4PLASMAPOS=0,0 # Fixed random seed (repeatable runs): any unsigned integer. # Unset seeds from the clock. #RANDOM=12345 # ---- LAN play without Steam ------------------------------------------------- # Host a race over plain TCP: list the member pods' console channels # (members run: rpl4opt.exe -windowed -res 1920 1080 -net 1501). # RP412HOSTPODS comma-separated IP[:port] list, one entry per member # pod; port defaults to 1501 per entry # RP412HOSTPORT this machine's console port, integer > 0 # (default 1501) # RP412HOSTADDR this machine's LAN IP as members can reach it # (default 127.0.0.1) #RP412HOSTPODS=192.168.1.20:1501,192.168.1.21:1501 #RP412HOSTPORT=1501 #RP412HOSTADDR=192.168.1.10 # ---- Developer / testing ---------------------------------------------------- # Nonzero arms the debug keys: Alt+W wireframe, Alt+V predator vision, # Alt+F frame dump, Alt+/ perf stats, Alt+E event-queue dump. # 0 or unset = off. (Alt+Q, the mission abort, is always live.) #RP412DEVKEYS=1 # Console race-length override, integer seconds (short test races). # Values <= 0 are ignored. #L4CONSOLELEN=30 # Nonzero = Steam transport loopback self-test at boot (logs PASS/FAIL). #RP412STEAMSELFTEST=1 # ---- Arcade heritage (multi-monitor pods; not used on the desktop) ---------- # PRIMGAUGE / SECGAUGE / MFDGAUGE / MFDGAUGE2 pin a display to a monitor # by adapter index (0, 1, 2...). SPANDISABLE: 0 = let the MFDs span one # wide surface, nonzero = separate windows (setting MFDGAUGE2 alone also # forces spanning off). L4EYES = "x y z xrot yrot zrot [type]" floats # for a detached camera; a type starting with r offsets it relative to # the pod. L4INTERCOM enables the crew intercom - only its presence # matters (traditionally COM2). NOMODES skips the mode/lamp programming; # presence alone triggers it, even NOMODES=0. LOGSIZE > 0 sizes the # trace log in dev builds compiled with tracing. #PRIMGAUGE=1 #SECGAUGE=2 #MFDGAUGE=3 #MFDGAUGE2=4 #SPANDISABLE=1 #L4EYES=1 #L4INTERCOM=COM2 #NOMODES=1 #LOGSIZE=1000000 "@ Set-Content -Path "$dist\start-windowed.bat" -Encoding ascii -Value @" @echo off rem Red Planet 4.12 - desktop prototype. Boots into the game-setup rem front end. The cockpit fits itself to the window and keeps 16:9, rem so a wider screen letterboxes rather than stretching. -res sets the rem 3D render size - raise it to match a big screen for sharper pixels, rem e.g. -res 2560 1440. rem (Add -egg TEST.EGG to skip the menu and run the canned mission.) cd /d "%~dp0" start rpl4opt.exe -windowed -res 1920 1080 "@ Set-Content -Path "$dist\start-fullscreen.bat" -Encoding ascii -Value @" @echo off rem Red Planet 4.12 - borderless over the whole monitor. -fit sizes the rem window to the panel AND picks the render size to match the cockpit rem canvas it lands in, so no -res guessing: the 3D arrives 1:1 instead rem of being stretched. Pass -res yourself to override it. rem (Add -egg TEST.EGG to skip the menu and run the canned mission.) cd /d "%~dp0" start rpl4opt.exe -fit "@ Set-Content -Path "$dist\README.txt" -Encoding ascii -Value @" Red Planet 4.12.3 ================= Run start-fullscreen.bat for borderless over the whole monitor, or start-windowed.bat to keep a title bar. No cockpit hardware needed. If there is no sound, run oalinst.exe once. Controls (XInput controller and/or keyboard) - EVERY input is rebindable: edit bindings.txt beside the exe (written with the full documented default layout on first run; delete it to restore). Left stick / NumPad 8462 joystick (8=fwd 2=back 4=left 6=right) LT / RT or NumPad 7,9 left / right pedal Right stick Y throttle (holds position) Shift / Ctrl throttle up / down A / Space / NumPad 0 joystick trigger RB / Alt reverse thrust DPad / arrow keys joystick hat (look) 9 / 0 keys config buttons (pad Start/Back left free) Number+letter rows MFD bank buttons (as printed on the panel) F1-F12 secondary / screen columns Alt+Q abort the mission (score banked) The cockpit scales to whatever window you give it - maximise it and it grows, keeping its 16:9 shape (an ultrawide gets black bars rather than a stretched cockpit). The 3D itself renders at whatever -res says and is then stretched onto the cockpit's viewscreen, so a mismatched -res costs sharpness. -fit takes care of that for you: it measures the monitor, works out the canvas the cockpit will settle on, and asks for exactly that render size, so the picture arrives 1:1. rpl4opt.exe -fit borderless, res chosen for you rpl4opt.exe -fit -res 1280 720 same window, lighter render rpl4opt.exe -windowed -res 2560 1440 pick both yourself (-windowed-fullscreen is accepted as a long spelling of -fit.) The full pod cockpit comes up in a single window: three green MFDs across the top, the 3D viewscreen centered with the orange plasma glass at its left, and the lower MFDs flanking the portrait map. The red buttons around each MFD and the amber buttons beside the map are the pod's real button banks: click them with the mouse, and they light up as the game commands their lamps. environ.ini is self-documenting: every option ships in the file with a comment (Steam networking, keyboard lighting, stick inversion, LAN hosting, developer keys, display scaling and radar placement, and more). CONTROLS.html is the full controls map - open it in a browser for the pad, keyboard and pod-panel diagrams. CONTROLS.txt is the same thing as plain text. Known prototype notes: pods race untextured (the player1-8 skins come from the presets system, not shipped data), and text drawn on the plasma glass may appear rotated. Source: https://gitea.mysticmachines.com/VWE/RP412 "@ # --- summary / optional zip ------------------------------------------------ $size = (Get-ChildItem $dist -Recurse | Measure-Object Length -Sum).Sum Write-Host ("dist ready: {0:N1} MB" -f ($size / 1MB)) if ($Zip) { $zipPath = Join-Path $root 'RedPlanet-4.12.3.zip' Write-Host "zipping to $zipPath..." # Everything lives under a single RP412\ folder inside the zip, so # unpacking anywhere gives one self-contained game directory instead # of scattering files into the extraction folder. $stage = Join-Path ([System.IO.Path]::GetTempPath()) 'rp412-zipstage' if (Test-Path $stage) { Remove-Item -Recurse -Force $stage } New-Item -ItemType Directory -Force "$stage\RP412" | Out-Null Copy-Item "$dist\*" "$stage\RP412" -Recurse -Force Compress-Archive -Path "$stage\RP412" -DestinationPath $zipPath -Force Remove-Item -Recurse -Force $stage }