BTFrstrm: add Load File test ini files (FFA Coliseum + 4-team KotH CentralPark)

Fix MAIL_LOAD_AUTO_MISSION: move handler to sender==@conlobby@ block
Handler was inside 'if (sender == this)' but MAIL_LOAD_AUTO_MISSION is sent from ConLobby (sender != this), so it never fired. All game params (FriendlyFire, SplashDamage, UnlimitedAmmo, WeaponJam, AdvanceMode, ArmorMode, etc.) were silently ignored on every Load File click. Fix: move the ~70-line handler to the 'if (sender == @conlobby@)' block, alongside MAIL_SET_ROOKIE_MISSION and MAIL_PREVIOUS_MISSION — where all ConLobby-originated mails are handled. No rebuild required (script only).
2026-07-24 11:01:11 -05:00 · 2026-07-24 10:56:57 -05:00 · 2026-07-24 10:46:24 -05:00 · 2026-07-24 10:37:37 -05:00 · 2026-07-24 10:35:11 -05:00 · 2026-07-24 10:18:06 -05:00
196 changed files with 2825 additions and 446 deletions
@@ -0,0 +1,575 @@
 <!DOCTYPE html>
 <html lang="en">
 <head>
 <meta charset="UTF-8">
 <title>Automatic Config File Specification ? Firestorm Console Load File</title>
 <style>
  body { font-family: Calibri, Arial, sans-serif; font-size: 11pt; margin: 60px 72px; color: #1a1a1a; max-width: 900px; }
  h1 { font-size: 20pt; color: #1F3864; border-bottom: 3px solid #1F3864; padding-bottom: 8px; margin-top: 0; }
  h2 { font-size: 14pt; color: #1F3864; border-bottom: 1px solid #BDD7EE; padding-bottom: 4px; margin-top: 28px; }
  h3 { font-size: 12pt; color: #2E4D7B; margin-top: 20px; margin-bottom: 4px; }
  h4 { font-size: 11pt; color: #2E4D7B; margin-top: 16px; margin-bottom: 2px; font-style: italic; }
  .meta { color: #555; font-size: 10pt; margin-bottom: 28px; }
  code, .code { font-family: Consolas, "Courier New", monospace; font-size: 10pt; background: #F4F7FB; padding: 1px 4px; border-radius: 2px; color: #1a1a1a; }
  pre { font-family: Consolas, "Courier New", monospace; font-size: 10pt; background: #F4F7FB; border: 1px solid #BDD7EE; border-left: 4px solid #2E4D7B; padding: 12px 16px; border-radius: 0 4px 4px 0; overflow-x: auto; line-height: 1.5; }
  pre .section  { color: #7B2D8B; font-weight: bold; }
  pre .key      { color: #1F6A8F; }
  pre .value    { color: #2D6A2D; }
  pre .comment  { color: #888; font-style: italic; }
  table { border-collapse: collapse; width: 100%; margin: 10px 0 18px 0; font-size: 10.5pt; }
  th { background: #1F3864; color: white; padding: 7px 12px; text-align: left; font-weight: bold; font-size: 10pt; }
  tr:nth-child(even) td { background: #EFF4FB; }
  td { padding: 5px 12px; border-bottom: 1px solid #D0D9E8; vertical-align: top; }
  td code { background: #E8EFF9; }
  .warn { background: #FFF3CD; border: 1px solid #FFEAA0; border-left: 4px solid #F0B429; padding: 10px 14px; border-radius: 0 4px 4px 0; margin: 14px 0; font-size: 10.5pt; }
  .warn strong { color: #7A4F00; }
  .note { background: #E7F3FD; border: 1px solid #B8D9F5; border-left: 4px solid #1F3864; padding: 10px 14px; border-radius: 0 4px 4px 0; margin: 14px 0; font-size: 10.5pt; }
  .optional { color: #666; font-size: 9.5pt; font-style: italic; }
  ul, ol { margin: 6px 0 10px 0; padding-left: 24px; }
  li { margin-bottom: 4px; }
  hr { border: none; border-top: 1px solid #D0D9E8; margin: 30px 0; }
  .key-block { background: #F0F4FA; border: 1px solid #C5D5E8; padding: 8px 12px; border-radius: 4px; margin: 8px 0 12px 0; }
  .key-block .kname { font-family: Consolas, monospace; font-size: 10.5pt; font-weight: bold; color: #1F6A8F; }
  .key-block .ktype { color: #888; font-size: 9.5pt; margin-left: 8px; }
  .default-tag { background: #D4EDDA; color: #155724; font-size: 9pt; padding: 1px 6px; border-radius: 3px; margin-left: 6px; font-weight: bold; }
  .ignored-tag { background: #F8D7DA; color: #721C24; font-size: 9pt; padding: 1px 6px; border-radius: 3px; margin-left: 6px; }
  .mech-table td:first-child { font-family: Consolas, monospace; font-size: 10pt; white-space: nowrap; }
  @media print { body { margin: 40px; } h2 { page-break-before: auto; } }
 </style>
 </head>
 <body>
 <h1>Automatic Config File Format Specification</h1>
 <div class="meta">
  Feature: Console Lobby &ldquo;Load File&rdquo; button &nbsp;|&nbsp;
  Commit: <code>c3346561</code> (branch <code>5.1.0b-in-progress</code>) &nbsp;|&nbsp;
  Date: 2026-07-24, updated 2026-07-24 (commit <code>cd2fe73c</code>)
 </div>
 <h2>1. Overview</h2>
 <p>
 The system operates with <strong>two separate files</strong>:
 </p>
 <ol>
  <li>
    <strong><code>options.ini</code></strong> &mdash; machine-level one-time configuration, read once at game startup.
    Contains the path to the config file. Never changed by the game.
  </li>
  <li>
    <strong>The config file</strong> (path specified in <code>options.ini</code>) &mdash;
    written by the external application before each match.
    Read by the game when the operator clicks <strong>Load File</strong> in the console lobby.
    <strong>Not consumed</strong> &mdash; the game leaves it on disk. Overwrite it to set the next match.
  </li>
 </ol>
 <p>
  When <strong>Load File</strong> is clicked, the game:
 </p>
 <ol>
  <li>Checks that <code>automaticmode=1</code> and the file path is configured.</li>
  <li>Checks that the config file exists on disk (<code>GetFileAttributes</code>). If not, does nothing.</li>
  <li>Reads the file, applies game options, clears all current lobby slots, then fills slots from the file.</li>
  <li>Leaves the file on disk unchanged.</li>
 </ol>
 <hr>
 <h2>2. <code>options.ini</code> Setup (One-Time, Per Machine)</h2>
 <p>Add the following section to the game&rsquo;s <code>options.ini</code> in the game working directory.</p>
 <pre><span class="section">[automaticmode]</span>
 <span class="key">automaticmode</span>=<span class="value">1</span>
 <span class="key">automaticfile</span>=<span class="value">c:\mw4files\nextmatch.ini</span></pre>
 <table>
  <tr><th>Key</th><th>Type</th><th>Description</th></tr>
  <tr><td><code>automaticmode</code></td><td>integer</td><td><code>1</code> = enabled. <code>0</code> = disabled; Load File button does nothing.</td></tr>
  <tr><td><code>automaticfile</code></td><td>string</td><td>Full absolute Windows path to the config file. Max 259 characters. Can be any local drive letter.</td></tr>
 </table>
 <div class="note">
  <strong>Read at startup only.</strong> Changing <code>options.ini</code> requires a game restart.
  If the <code>[automaticmode]</code> section is absent, or <code>automaticmode=0</code>, or
  <code>automaticfile</code> is empty, Load File always does nothing regardless of what config file exists.
 </div>
 <hr>
 <h2>3. Config File Format Rules</h2>
 <p>The config file uses <strong>standard Windows INI format</strong>, parsed by <code>NotationFile::Standard</code>.</p>
 <ul>
  <li><strong>Encoding:</strong> ANSI / ASCII only. No Unicode, no UTF-8 BOM.</li>
  <li><strong>Line endings:</strong> CRLF or LF &mdash; both accepted.</li>
  <li><strong>Section headers:</strong> <code>[sectionname]</code> &mdash; <strong>case-sensitive, must be all lowercase exactly as shown.</strong></li>
  <li><strong>Key names:</strong> Case-sensitive. Must match exactly as documented below.</li>
  <li><strong>String values:</strong> Everything after <code>=</code> to end of line. Do <strong>not</strong> wrap in quotes. Example: <code>MissionName=ScarabStronghold - Attrition</code></li>
  <li><strong>Integer values:</strong> Raw decimal integer only. No quotes, no sign unless negative. Example: <code>GameType=2</code></li>
  <li><strong>Do not use comments</strong> (<code>//</code> or <code>;</code>). Parser behavior is not guaranteed. Keep the file clean.</li>
  <li><strong>Missing key:</strong> If a key is absent from its section, the corresponding lobby value stays at its current setting. No error is raised.</li>
  <li><strong>Missing section:</strong> If <code>[mission]</code> is absent, no game options are changed. If <code>[slot0]</code> is absent, no slots are changed.</li>
 </ul>
 <hr>
 <h2>4. Section: <code>[mission]</code></h2>
 <p>Sets all game lobby parameters. This section is <span class="optional">optional</span> &mdash; omit it to leave game options unchanged and only configure slots.</p>
 <pre><span class="section">[mission]</span>
 <span class="key">MissionName</span>=<span class="value">ScarabStronghold - Attrition</span>
 <span class="key">GameType</span>=<span class="value">2</span>
 <span class="key">TeamAllowed</span>=<span class="value">0</span>
 <span class="key">Visibility</span>=<span class="value">0</span>
 <span class="key">Weather</span>=<span class="value">0</span>
 <span class="key">TimeOfDay</span>=<span class="value">0</span>
 <span class="key">TimeLimit</span>=<span class="value">7</span>
 <span class="key">Radar</span>=<span class="value">0</span>
 <span class="key">HeatOn</span>=<span class="value">0</span>
 <span class="key">FriendlyFire</span>=<span class="value">0</span>
 <span class="key">SplashDamage</span>=<span class="value">0</span>
 <span class="key">UnlimitedAmmo</span>=<span class="value">1</span>
 <span class="key">WeaponJam</span>=<span class="value">0</span>
 <span class="key">AdvanceMode</span>=<span class="value">0</span>
 <span class="key">ArmorMode</span>=<span class="value">0</span></pre>
 <h3>4.1 &nbsp;<code>MissionName</code> &mdash; string, max 255 characters</h3>
 <p>
 The scenario name, <strong>exactly as it appears in the mission list dropdown in the console lobby.</strong>
 Match is exact string equality, case-sensitive. Trailing/leading spaces are stripped by the parser.
 </p>
 <div class="warn">
  <strong>If the name is not found</strong> in the list for the selected <code>GameType</code>,
  mission selection silently fails &mdash; the dropdown stays at its previous value.
  No error is logged. All other parameters (Visibility, Weather, etc.) are still applied.
  The available mission names depend on what scenario files are installed on the machine;
  there is no static guaranteed list.
 </div>
 <h3>4.2 &nbsp;<code>GameType</code> &mdash; integer (dropdown index, 0-based)</h3>
 <div class="warn">
  <strong>This is the position in the game type dropdown, NOT the internal game type ID number.</strong>
  The dropdown is built dynamically at lobby startup &mdash; only game types that have at least
  one installed scenario are shown. If a game type has no installed maps it is skipped and all
  subsequent indices shift down by one.
 </div>
 <p>For a <strong>standard full installation</strong> with all game types present, the order is fixed:</p>
 <table>
  <tr><th>Index</th><th>Display Name</th><th>Mode</th></tr>
  <tr><td><code>0</code></td><td>Destruction</td><td>FFA</td></tr>
  <tr><td><code>1</code></td><td>Team Destruction</td><td>Team</td></tr>
  <tr><td><code>2</code></td><td>Attrition</td><td>FFA &mdash; <strong>default</strong> <span class="default-tag">DEFAULT</span></td></tr>
  <tr><td><code>3</code></td><td>Team Attrition</td><td>Team</td></tr>
  <tr><td><code>4</code></td><td>Capture the Flag</td><td>FFA</td></tr>
  <tr><td><code>5</code></td><td>King of the Hill</td><td>FFA</td></tr>
  <tr><td><code>6</code></td><td>Team King of the Hill</td><td>Team</td></tr>
  <tr><td><code>7</code></td><td>Steal the Bacon</td><td>FFA</td></tr>
  <tr><td><code>8</code></td><td>Master Trial</td><td>Special</td></tr>
  <tr><td><code>9</code></td><td>Siege Assault</td><td>Special</td></tr>
  <tr><td><code>10+</code></td><td>Custom map variants</td><td>Varies (if custom content installed)</td></tr>
 </table>
 <p><strong>Team vs. FFA is important:</strong> it determines whether the <code>Team</code> or <code>Skin</code> field is applied to each slot. See Section 5 for details.</p>
 <h3>4.3 &nbsp;<code>Visibility</code> &mdash; integer</h3>
 <table>
  <tr><th>Value</th><th>Display Name</th><th>Description</th></tr>
  <tr><td><code>0</code></td><td>Default</td><td>Same as Clear <span class="default-tag">DEFAULT</span></td></tr>
  <tr><td><code>1</code></td><td>Clear</td><td>Full visibility range</td></tr>
  <tr><td><code>2</code></td><td>Light Fog</td><td>Reduced visibility range</td></tr>
  <tr><td><code>3</code></td><td>Heavy Fog</td><td>Heavily reduced visibility range</td></tr>
  <tr><td><code>4</code></td><td>Pea Soup Fog</td><td>Near-zero visibility range</td></tr>
 </table>
 <h3>4.4 &nbsp;<code>Weather</code> &mdash; integer</h3>
 <table>
  <tr><th>Value</th><th>Display</th></tr>
  <tr><td><code>0</code></td><td>Off <span class="default-tag">DEFAULT</span></td></tr>
  <tr><td><code>1</code></td><td>On (rain or snow depending on map)</td></tr>
 </table>
 <h3>4.5 &nbsp;<code>TimeOfDay</code> &mdash; integer</h3>
 <table>
  <tr><th>Value</th><th>Display</th></tr>
  <tr><td><code>0</code></td><td>Day <span class="default-tag">DEFAULT</span></td></tr>
  <tr><td><code>1</code></td><td>Night</td></tr>
 </table>
 <h3>4.6 &nbsp;<code>TimeLimit</code> &mdash; integer (<strong>actual minutes</strong>, not a list index)</h3>
 <p>
  Specify the desired match length in <strong>real minutes</strong>.
  Valid values that appear in the lobby dropdown:
 </p>
 <p>
  <code>1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 20, 25, 30</code>
 </p>
 <p>
  Other integers are accepted and applied to the network parameter but will not match a dropdown item
  (the visual display may show the nearest value).
 </p>
 <p>
  Special value <code>-1</code>: use the server&rsquo;s current default time (7 minutes unless changed separately).
 </p>
 <p>Default if key absent: server current default (equivalent to <code>-1</code>).</p>
 <h3>4.7 &nbsp;<code>Radar</code> &mdash; integer</h3>
 <table>
  <tr><th>Value</th><th>Display</th><th>Description</th></tr>
  <tr><td><code>0</code></td><td>Novice</td><td>All mechs visible, no range limit <span class="default-tag">DEFAULT</span></td></tr>
  <tr><td><code>1</code></td><td>Normal</td><td>Standard radar with range cutoff</td></tr>
  <tr><td><code>2</code></td><td>Team Only</td><td>Only your own team visible on radar</td></tr>
  <tr><td><code>3</code></td><td>No Radar</td><td>Radar completely disabled for all players</td></tr>
 </table>
 <h3>4.8 &nbsp;<code>HeatOn</code> &mdash; integer</h3>
 <table>
  <tr><th>Value</th><th>Description</th></tr>
  <tr><td><code>0</code></td><td>Off &mdash; heat never builds, weapons never overheat <span class="default-tag">DEFAULT</span></td></tr>
  <tr><td><code>1</code></td><td>On &mdash; standard heat management enabled</td></tr>
 </table>
 <h3>4.9 &nbsp;<code>FriendlyFire</code> &mdash; integer</h3>
 <table>
  <tr><th>Value</th><th>Description</th></tr>
  <tr><td><code>0</code></td><td>Off &mdash; friendly fire disabled <span class="default-tag">DEFAULT</span></td></tr>
  <tr><td><code>1</code></td><td>On &mdash; 100% damage to teammates</td></tr>
 </table>
 <h3>4.10 &nbsp;<code>SplashDamage</code> &mdash; integer</h3>
 <table>
  <tr><th>Value</th><th>Description</th></tr>
  <tr><td><code>0</code></td><td>Off <span class="default-tag">DEFAULT</span></td></tr>
  <tr><td><code>1</code></td><td>On &mdash; area/splash damage from missiles and explosions</td></tr>
 </table>
 <h3>4.11 &nbsp;<code>UnlimitedAmmo</code> &mdash; integer</h3>
 <table>
  <tr><th>Value</th><th>Description</th></tr>
  <tr><td><code>0</code></td><td>Off &mdash; ammo is finite</td></tr>
  <tr><td><code>1</code></td><td>On &mdash; unlimited ammo <span class="default-tag">DEFAULT (console/arcade)</span></td></tr>
 </table>
 <h3>4.12 &nbsp;<code>WeaponJam</code> &mdash; integer</h3>
 <table>
  <tr><th>Value</th><th>Description</th></tr>
  <tr><td><code>0</code></td><td>Off <span class="default-tag">DEFAULT</span></td></tr>
  <tr><td><code>1</code></td><td>On &mdash; weapons can randomly jam</td></tr>
 </table>
 <h3>4.13 &nbsp;<code>AdvanceMode</code> &mdash; integer</h3>
 <table>
  <tr><th>Value</th><th>Description</th></tr>
  <tr><td><code>0</code></td><td>Off <span class="default-tag">DEFAULT</span></td></tr>
  <tr><td><code>1</code></td><td>On</td></tr>
 </table>
 <h3>4.14 &nbsp;<code>ArmorMode</code> &mdash; integer</h3>
 <table>
  <tr><th>Value</th><th>Description</th></tr>
  <tr><td><code>0</code></td><td>Off <span class="default-tag">DEFAULT</span></td></tr>
  <tr><td><code>1</code></td><td>On</td></tr>
 </table>
 <h3>4.15 &nbsp;<code>TeamAllowed</code> &mdash; integer <span class="optional">(required for correct team/FFA slot display on first click)</span></h3>
 <p>Must match the <code>GameType</code> selected. Controls whether <code>Team</code> or <code>Skin</code> is applied to slots, and whether team dropdowns are shown.</p>
 <table>
  <tr><th>Value</th><th>Description</th></tr>
  <tr><td><code>0</code></td><td>FFA mode ? slot <code>Skin</code> field is used <span class="default-tag">DEFAULT</span></td></tr>
  <tr><td><code>1</code></td><td>Team game ? slot <code>Team</code> field is used</td></tr>
 </table>
 <h3>4.16 &nbsp;<code>TeamCount</code> &mdash; integer <span class="optional">(optional, only when TeamAllowed=1)</span></h3>
 <p>Number of teams. Valid range: 2&ndash;8. Default: <code>2</code>.</p>
 <hr>
 <h2>5. Sections: <code>[slot0]</code> through <code>[slot15]</code></h2>
 <p>One section per roster slot, numbered starting from <strong>zero</strong>.</p>
 <div class="warn">
  <strong>Slots must be contiguous starting from <code>[slot0]</code>.</strong>
  The parser stops at the first missing slot number. If <code>[slot2]</code> is absent,
  <code>[slot3]</code> through <code>[slot15]</code> are never read, even if present in the file.
  Do not skip numbers.
 </div>
 <p>Maximum: <strong>16 slots</strong> (indices 0&ndash;15). All slots are cleared before applying file data, so slots not defined in the file will be empty in the lobby after Load File is clicked.</p>
 <pre><span class="section">[slot0]</span>
 <span class="key">Type</span>=<span class="value">1</span>
 <span class="key">PilotName</span>=<span class="value">Alpha One</span>
 <span class="key">Mech</span>=<span class="value">Atlas</span>
 <span class="key">Team</span>=<span class="value">0</span>
 <span class="key">Skin</span>=<span class="value">0</span>
 <span class="key">Decal</span>=<span class="value">3</span></pre>
 <h3>5.1 &nbsp;<code>Type</code> &mdash; integer, required</h3>
 <p>Determines what occupies this slot. All other fields are ignored when <code>Type=0</code>.</p>
 <table>
  <tr><th>Value</th><th>Description</th></tr>
  <tr><td><code>0</code></td><td>Empty &mdash; slot skipped, left empty in lobby</td></tr>
  <tr><td><code>1</code></td><td>Player slot &mdash; a human pilot can connect to this seat</td></tr>
  <tr><td><code>2</code></td><td>Bot, difficulty level 1 (easiest)</td></tr>
  <tr><td><code>3</code></td><td>Bot, difficulty level 2</td></tr>
  <tr><td><code>4</code></td><td>Bot, difficulty level 3</td></tr>
  <tr><td><code>5</code></td><td>Bot, difficulty level 4</td></tr>
  <tr><td><code>6</code></td><td>Bot, difficulty level 5</td></tr>
  <tr><td><code>7</code></td><td>Bot, difficulty level 6</td></tr>
  <tr><td><code>8</code></td><td>Bot, difficulty level 7</td></tr>
  <tr><td><code>9</code></td><td>Bot, difficulty level 8 (hardest)</td></tr>
 </table>
 <p>If <code>Type</code> key is absent, it defaults to <code>0</code> (empty) due to zero-initialization.</p>
 <h3>5.2 &nbsp;<code>PilotName</code> &mdash; string, max 63 characters</h3>
 <p>Only meaningful when <code>Type=1</code> (player slot). Sets the callsign shown in the lobby pilot editbox. The connecting player can override this after they connect.</p>
 <p>For bots (<code>Type=2&ndash;9</code>), this field is read from the file but ignored by the script.</p>
 <p>Set to empty value or omit key to leave the name blank: <code>PilotName=</code></p>
 <p>Strings longer than 63 characters are silently truncated.</p>
 <h3>5.3 &nbsp;<code>Mech</code> &mdash; string (chassis name, exact and case-sensitive)</h3>
 <p>Must match <strong>exactly</strong> one of the chassis names from <code>MechTable.tbl</code>. The lookup is case-sensitive exact string comparison. If the name is not found, the mech dropdown for that slot stays at its previous value. No error is raised.</p>
 <div class="warn">
  <strong>These are the table key strings, not display labels.</strong>
  Pay close attention to capitalization, spacing, and special characters (hyphens, Roman numerals).
 </div>
 <table class="mech-table">
  <tr><th>Exact <code>Mech=</code> value</th><th>Notes</th></tr>
  <tr><td>Annihilator</td><td></td></tr>
  <tr><td>Archer</td><td></td></tr>
  <tr><td>Arctic Wolf</td><td>space between words</td></tr>
  <tr><td>Ares</td><td></td></tr>
  <tr><td>Argus</td><td></td></tr>
  <tr><td>AssassinII</td><td>no spaces; capital I</td></tr>
  <tr><td>Atlas</td><td></td></tr>
  <tr><td>Avatar</td><td></td></tr>
  <tr><td>Awesome</td><td></td></tr>
  <tr><td>Battlemaster</td><td></td></tr>
  <tr><td>BattlemasterIIC</td><td>no spaces</td></tr>
  <tr><td>Behemoth</td><td></td></tr>
  <tr><td>BehemothII</td><td>no space; capital I</td></tr>
  <tr><td>Black Hawk</td><td>space between words</td></tr>
  <tr><td>Black Knight</td><td>space between words</td></tr>
  <tr><td>Black Lanner</td><td>space between words</td></tr>
  <tr><td>Brigand</td><td></td></tr>
  <tr><td>Bushwacker</td><td></td></tr>
  <tr><td>Catapult</td><td></td></tr>
  <tr><td>Cauldron-Born</td><td>hyphen between words</td></tr>
  <tr><td>Chimera</td><td></td></tr>
  <tr><td>Commando</td><td></td></tr>
  <tr><td>Cougar</td><td></td></tr>
  <tr><td>Cyclops</td><td></td></tr>
  <tr><td>Daishi</td><td></td></tr>
  <tr><td>Deimos</td><td></td></tr>
  <tr><td>Dragon</td><td></td></tr>
  <tr><td>Fafnir</td><td></td></tr>
  <tr><td>Flea</td><td></td></tr>
  <tr><td>Gladiator</td><td></td></tr>
  <tr><td>Grizzly</td><td></td></tr>
  <tr><td>Hauptmann</td><td></td></tr>
  <tr><td>Hellhound</td><td></td></tr>
  <tr><td>Hellspawn</td><td></td></tr>
  <tr><td>Highlander</td><td></td></tr>
  <tr><td>HollanderII</td><td>no space; capital I</td></tr>
  <tr><td>Hunchback</td><td></td></tr>
  <tr><td>Kodiak</td><td></td></tr>
  <tr><td>Loki</td><td></td></tr>
  <tr><td>Longbow</td><td></td></tr>
  <tr><td>Mad Cat</td><td>space between words</td></tr>
  <tr><td>Mad Cat MKII</td><td>space + "MKII" all caps, no period</td></tr>
  <tr><td>Masakari</td><td></td></tr>
  <tr><td>Mauler</td><td></td></tr>
  <tr><td>Nova Cat</td><td>space between words</td></tr>
  <tr><td>Osiris</td><td></td></tr>
  <tr><td>Owens</td><td></td></tr>
  <tr><td>Puma</td><td></td></tr>
  <tr><td>Raven</td><td></td></tr>
  <tr><td>Rifleman</td><td></td></tr>
  <tr><td>Ryoken</td><td></td></tr>
  <tr><td>Shadow Cat</td><td>space between words</td></tr>
  <tr><td>Solitaire</td><td></td></tr>
  <tr><td>Sunder</td><td></td></tr>
  <tr><td>Templar</td><td></td></tr>
  <tr><td>Thanatos</td><td></td></tr>
  <tr><td>Thor</td><td></td></tr>
  <tr><td>Uller</td><td></td></tr>
  <tr><td>Urbanmech</td><td></td></tr>
  <tr><td>Uziel</td><td></td></tr>
  <tr><td>Victor</td><td></td></tr>
  <tr><td>Vulture</td><td></td></tr>
  <tr><td>Warhammer</td><td></td></tr>
  <tr><td>Wolfhound</td><td></td></tr>
  <tr><td>Zeus</td><td></td></tr>
 </table>
 <h3>5.4 &nbsp;<code>Team</code> &mdash; integer</h3>
 <p>
  <strong>Only applied in team game modes</strong> (game types marked &ldquo;Team&rdquo; in Section 4.2 table).
  <strong class="ignored-tag">IGNORED in FFA modes.</strong>
 </p>
 <table>
  <tr><th>Value</th><th>Team</th><th>Default Color</th></tr>
  <tr><td><code>0</code></td><td>Team 1</td><td>Blue</td></tr>
  <tr><td><code>1</code></td><td>Team 2</td><td>Red</td></tr>
  <tr><td><code>2</code></td><td>Team 3</td><td>Yellow</td></tr>
  <tr><td><code>3</code></td><td>Team 4</td><td>Green</td></tr>
  <tr><td><code>4</code></td><td>Team 5</td><td>Purple</td></tr>
  <tr><td><code>5</code></td><td>Team 6</td><td>Light Blue</td></tr>
  <tr><td><code>6</code></td><td>Team 7</td><td>Orange</td></tr>
  <tr><td><code>7</code></td><td>Team 8</td><td>Charcoal</td></tr>
 </table>
 <h3>5.5 &nbsp;<code>Skin</code> &mdash; integer (FFA camo, dropdown index 0-based)</h3>
 <p>
  <strong>Only applied in FFA game modes.</strong>
  <strong class="ignored-tag">IGNORED in team modes.</strong>
 </p>
 <table>
  <tr><th>Value</th><th>Camo Color/Pattern</th></tr>
  <tr><td><code>0</code></td><td>Blue</td></tr>
  <tr><td><code>1</code></td><td>Red</td></tr>
  <tr><td><code>2</code></td><td>Yellow</td></tr>
  <tr><td><code>3</code></td><td>Green</td></tr>
  <tr><td><code>4</code></td><td>Purple</td></tr>
  <tr><td><code>5</code></td><td>Light Blue</td></tr>
  <tr><td><code>6</code></td><td>Orange</td></tr>
  <tr><td><code>7</code></td><td>Charcoal</td></tr>
  <tr><td><code>8</code>&ndash;<code>15</code></td><td>Additional camo patterns</td></tr>
 </table>
 <h3>5.6 &nbsp;<code>Decal</code> &mdash; integer (faction emblem, 0&ndash;63)</h3>
 <p>
  Applied in <strong>both team and FFA modes.</strong>
  Valid range: <code>0</code>&ndash;<code>63</code>. All values in range are accepted. Common values:
 </p>
 <table>
  <tr><th>Value</th><th>Faction</th></tr>
  <tr><td><code>0</code></td><td>None</td></tr>
  <tr><td><code>2</code></td><td>Davion</td></tr>
  <tr><td><code>3</code></td><td>Steiner</td></tr>
  <tr><td><code>4</code></td><td>Kurita</td></tr>
  <tr><td><code>5</code></td><td>Liao</td></tr>
  <tr><td><code>6</code></td><td>Marik</td></tr>
  <tr><td><code>9</code></td><td>ComStar</td></tr>
  <tr><td><code>10</code></td><td>Star League</td></tr>
  <tr><td><code>11</code></td><td>Wolf Clan</td></tr>
  <tr><td><code>12</code></td><td>Jade Falcon</td></tr>
  <tr><td><code>16</code></td><td>Ghost Bear</td></tr>
  <tr><td><code>20</code></td><td>Hell Horses</td></tr>
  <tr><td><code>21</code></td><td>Coyote</td></tr>
  <tr><td><code>22</code></td><td>Blood Spirit</td></tr>
  <tr><td><code>24</code></td><td>Ice Hellion</td></tr>
  <tr><td><code>27</code></td><td>Goliath Scorpion</td></tr>
  <tr><td><code>46</code></td><td>BKG</td></tr>
  <tr><td><code>47</code></td><td>FSA</td></tr>
  <tr><td><code>48</code></td><td>331st</td></tr>
  <tr><td><code>49</code></td><td>DDC</td></tr>
  <tr><td><code>50</code></td><td>VGL</td></tr>
 </table>
 <hr>
 <h2>6. Complete Example File</h2>
 <pre><span class="section">[mission]</span>
 <span class="key">MissionName</span>=<span class="value">ScarabStronghold - Attrition</span>
 <span class="key">GameType</span>=<span class="value">2</span>
 <span class="key">Visibility</span>=<span class="value">0</span>
 <span class="key">Weather</span>=<span class="value">0</span>
 <span class="key">TimeOfDay</span>=<span class="value">0</span>
 <span class="key">TimeLimit</span>=<span class="value">7</span>
 <span class="key">Radar</span>=<span class="value">0</span>
 <span class="key">HeatOn</span>=<span class="value">0</span>
 <span class="key">FriendlyFire</span>=<span class="value">0</span>
 <span class="key">SplashDamage</span>=<span class="value">0</span>
 <span class="key">UnlimitedAmmo</span>=<span class="value">1</span>
 <span class="key">WeaponJam</span>=<span class="value">0</span>
 <span class="key">AdvanceMode</span>=<span class="value">0</span>
 <span class="key">ArmorMode</span>=<span class="value">0</span>
 <span class="section">[slot0]</span>
 <span class="key">Type</span>=<span class="value">1</span>
 <span class="key">PilotName</span>=<span class="value">Blackjack</span>
 <span class="key">Mech</span>=<span class="value">Atlas</span>
 <span class="key">Team</span>=<span class="value">0</span>
 <span class="key">Skin</span>=<span class="value">0</span>
 <span class="key">Decal</span>=<span class="value">3</span>
 <span class="section">[slot1]</span>
 <span class="key">Type</span>=<span class="value">1</span>
 <span class="key">PilotName</span>=<span class="value">Viper</span>
 <span class="key">Mech</span>=<span class="value">Mad Cat</span>
 <span class="key">Team</span>=<span class="value">0</span>
 <span class="key">Skin</span>=<span class="value">1</span>
 <span class="key">Decal</span>=<span class="value">4</span>
 <span class="section">[slot2]</span>
 <span class="key">Type</span>=<span class="value">2</span>
 <span class="key">PilotName</span>=
 <span class="key">Mech</span>=<span class="value">Thor</span>
 <span class="key">Team</span>=<span class="value">1</span>
 <span class="key">Skin</span>=<span class="value">1</span>
 <span class="key">Decal</span>=<span class="value">4</span>
 <span class="section">[slot3]</span>
 <span class="key">Type</span>=<span class="value">2</span>
 <span class="key">PilotName</span>=
 <span class="key">Mech</span>=<span class="value">Warhammer</span>
 <span class="key">Team</span>=<span class="value">1</span>
 <span class="key">Skin</span>=<span class="value">1</span>
 <span class="key">Decal</span>=<span class="value">4</span></pre>
 <hr>
 <h2>7. Known Constraints and Caveats</h2>
 <ol>
  <li>
    <strong>Slots must be numbered contiguously from <code>[slot0]</code>.</strong>
    The parser uses a loop that breaks on the first missing section. Defining <code>[slot0]</code>
    and <code>[slot2]</code> without <code>[slot1]</code> means only slot 0 is processed.
  </li>
  <li>
    <strong>All current slots are cleared before file slots are applied.</strong>
    Any slot not defined in the file (or defined with <code>Type=0</code>) will be empty in the lobby.
  </li>
  <li>
    <strong>Team vs. FFA display is correct on the first click</strong> provided <code>TeamAllowed=</code> is set correctly in the file.
    The game updates <code>team_allowed</code> synchronously from this field before processing slots.
    If <code>TeamAllowed</code> is absent, it defaults to <code>0</code> (FFA) regardless of <code>GameType</code>.
  </li>
  <li>
    <strong><code>MissionName</code> and <code>Mech</code> matches are case-sensitive.</strong>
    <code>atlas</code> will not match <code>Atlas</code>.
  </li>
  <li>
    <strong>The file is never deleted by the game.</strong>
    Write it before the match, overwrite it before the next match. No locking is performed.
  </li>
  <li>
    <strong><code>options.ini</code> is read only at game startup.</strong>
    Changing the <code>automaticfile</code> path or enabling/disabling the feature requires a restart.
    The config file itself is re-read fresh on every Load File button click.
  </li>
  <li>
    <strong>Buffer limits:</strong> <code>PilotName</code> &le; 63 chars (truncated silently);
    <code>MissionName</code> &le; 255 chars;
    <code>automaticfile</code> path &le; 259 chars (<code>MAX_PATH&nbsp;&minus;&nbsp;1</code>).
  </li>
  <li>
    <strong>Mech names are sourced from <code>MechTable.tbl</code>.</strong>
    If the game installation has custom mechs added or some mechs removed, the valid name list
    changes accordingly. The table above reflects the standard Firestorm build.
  </li>
 </ol>
 <hr>
 <p style="font-size:9pt; color:#888; text-align:center; margin-top:30px;">
  Generated from source: <code>MW4Shell.cpp</code> &mdash; <code>CTCL_LoadAutoFile</code>,
  <code>CTCL_GetAutoSlotName/Mech/Int</code> &nbsp;|&nbsp;
  <code>ConLobby.script</code> &mdash; <code>o_load_file</code> handler &nbsp;|&nbsp;
  <code>ConLobbyMission.script</code> &mdash; <code>MAIL_LOAD_AUTO_MISSION</code> &nbsp;|&nbsp;
  Commit cd2fe73c &nbsp;|&nbsp; 2026-07-24
 </p>
 </body>
 </html>
@@ -0,0 +1,111 @@
 #!/usr/bin/env python3
 """Generate special_weapon_locations.csv and rear_facing_weapons.csv from stock mech subsystems."""
 import csv
 from pathlib import Path
 BASE       = Path("Gameleap/mw4/Content")
 MECH_TABLE = BASE / "Tables" / "MechTable.tbl"
 OUT_DIR    = Path("BTFrstrm")
 def parse_ini(path):
    sections, cur_sec, cur_dict = [], None, {}
    with open(path, 'r', encoding='latin-1', errors='replace') as f:
        for raw in f:
            line = raw.strip()
            if line.startswith('[') and line.endswith(']'):
                if cur_sec is not None:
                    sections.append((cur_sec, cur_dict))
                cur_sec, cur_dict = line[1:-1], {}
            elif '=' in line and cur_sec is not None:
                k, _, v = line.partition('=')
                cur_dict[k.strip()] = v.strip()
    if cur_sec is not None:
        sections.append((cur_sec, cur_dict))
    return sections
 def find_dir_ci(parent, name):
    """Case-insensitive directory lookup for Linux."""
    exact = parent / name
    if exact.exists():
        return exact
    name_lower = name.lower()
    for child in parent.iterdir():
        if child.is_dir() and child.name.lower() == name_lower:
            return child
    return None
 def weapon_model(model_path):
    return Path(model_path.replace('\\', '/')).stem
 # Read chassis list from MechTable.tbl
 chassis_list = []
 with open(MECH_TABLE, 'r', encoding='latin-1') as f:
    for raw in f:
        line = raw.strip()
        if not line or line.startswith('//') or line.startswith('[') or '=' not in line:
            continue
        name, _, rel = line.partition('=')
        # rel is like "Mechs\Atlas\Atlas.instance"
        parts = rel.strip().replace('\\', '/').split('/')
        chassis_list.append((name.strip(), parts))  # parts = ['Mechs', 'Atlas', 'Atlas.instance']
 print(f"Found {len(chassis_list)} chassis in MechTable.tbl")
 HDR = ['Chassis', 'InternalLocation', 'Model', 'Site', 'AmmoCount', 'GroupIndex', 'WeaponFacing']
 special_rows, rear_rows, missing = [], [], []
 mechs_dir = BASE / "Mechs"
 for chassis_name, path_parts in chassis_list:
    # path_parts[1] is the mech directory name (e.g. 'Atlas', 'MadCat_MkII', 'Urbanmech')
    if len(path_parts) < 2:
        missing.append(chassis_name)
        continue
    mech_dir = find_dir_ci(mechs_dir, path_parts[1])
    if not mech_dir:
        missing.append(f"{chassis_name} (dir not found: {path_parts[1]})")
        continue
    subs = [f for f in mech_dir.glob('*.subsystems') if f.suffix == '.subsystems']
    if not subs:
        missing.append(f"{chassis_name} (no .subsystems in {mech_dir.name})")
        continue
    subsys_file = subs[0]
    sections = parse_ini(subsys_file)
    for sec_name, fields in sections:
        if 'WeaponSubsystem' not in fields.get('Model', ''):
            continue
        loc    = fields.get('InternalLocation', '')
        model  = weapon_model(fields.get('Model', ''))
        site   = fields.get('Site', '')
        ammo   = fields.get('AmmoCount', '')
        group  = fields.get('GroupIndex', '')
        facing = fields.get('WeaponFacing', '')
        if loc in ('Special1', 'Special2'):
            special_rows.append([chassis_name, loc, model, site, ammo, group, facing])
        if facing and facing != '0':
            rear_rows.append([chassis_name, loc, model, site, ammo, group, facing])
 # Write CSVs
 out1 = OUT_DIR / 'special_weapon_locations.csv'
 with open(out1, 'w', newline='') as f:
    w = csv.writer(f)
    w.writerow(HDR)
    w.writerows(special_rows)
 out2 = OUT_DIR / 'rear_facing_weapons.csv'
 with open(out2, 'w', newline='') as f:
    w = csv.writer(f)
    w.writerow(HDR)
    w.writerows(rear_rows)
 print(f"Spreadsheet 1 ? Special1/2 weapon locations: {len(special_rows)} rows -> {out1}")
 print(f"Spreadsheet 2 ? Non-forward WeaponFacing:     {len(rear_rows)} rows -> {out2}")
 if missing:
    print(f"\nSkipped: {missing}")
@@ -292,3 +292,363 @@ At the time this doc was written:
 - non-playable mechs are explicitly marked `No`
 - Templar and other mechs with rear or side mounts have facing visible in the CSV
 - the file is intended to be a living audit artifact for future data cleanup and enablement work
 ---
 ## MechEditor Web App — Data Sources, Fields, and Conversions (documented 2026-07-23)
 The MechEditor is a single-file Python HTTP server at `/home/rich/Repositories/MechEditor/mech_editor.py`.  
 It runs at `localhost:8765`, parses the firestorm content tree, and presents a full mech configuration editor in the browser.  
 This section documents every data field it reads, every conversion it performs, and every naming rule it enforces.
 ---
 ### Data Files Parsed Per Mech
 All files live under `Gameleap/mw4/Content/Mechs/<MechDir>/`.
 #### `.data` file  (`parse_data()`)
 | Field in file | Editor key | Notes |
 |---|---|---|
 | `VehicleTonnage` | `tonnage` | chassis base tonnage (float) |
 | `MaxVehicleTonnage` | `max_tonnage` | max loadout tonnage (float) |
 | `TechType` | `tech` | `$(Tech_IS)` ? `"IS"`, `$(Tech_Clan)` ? `"Clan"` |
 | `MaxHeat` | `max_heat` | heat capacity (int) |
 | `VehicleTradeValue` | `trade_value` | C-bills |
 | `DragoonValue` | `dragoon` | used in Power Rating bar scaling |
 | `MinMaxSpeed` | `min_max_speed` | base speed ceiling in **m/s** |
 | `MaxSpeed` | `max_speed` | absolute speed ceiling in **m/s** (engine upgrades may not exceed this) |
 | `FullStopTurnRate` | `full_stop_turn` | turn rate at zero speed, in **degrees/sec** |
 | `TopSpeedTurnRate` | `top_speed_turn` | turn rate at top speed, in **degrees/sec** |
 | `Acceleration` | `acceleration` | forward acceleration in **m/s²** |
 | `Decceleration` | `decceleration` | forward braking in **m/s²** — **double-c spelling is canonical in the engine source** |
 | `ReverseAccelerationMultiplier` | `rev_accel_mult` | multiplier applied to Acceleration for reverse |
 | `ReverseDeccelerationMultiplier` | `rev_decel_mult` | multiplier applied to Decceleration for reverse — double-c canonical |
 | `MinStandTransitionSpeed` | not surfaced | animation threshold only — see note below |
 | `CanLoadJumpJets` | `can_jj` | Yes/No |
 | `CanLoadECM` | `can_ecm` | Yes/No |
 | `CanLoadBeagle` | `can_bap` | Yes/No |
 | `CanLoadLightAmp` | `can_lightamp` | Yes/No |
 | `CanLoadAMS` | `can_ams` | Yes/No |
 | `CanLoadLAMS` | `can_lams` | Yes/No |
 | `CanLoadIFF_Jammer` | `can_iff` | Yes/No |
 **MinStandTransitionSpeed** is the speed (m/s) below which the mech switches from its walking animation to its idle/standing animation.  
 It is NOT a hard movement limit.  It is purely an animation state machine threshold in `Mech.cpp`.  
 Code path: `animStateEngine?RequestState(StandState)` when `currentSpeedMPS <= minStandTransitionSpeed`.  
 Must be > 0 (validated in `Vehicle_Tool.cpp`).  Argus = 12.631 m/s = 45.5 kph.
 #### `.instance` file  (`parse_instance()`)
 | Field | Editor key | Notes |
 |---|---|---|
 | `PowerRating` | `PowerRating` | mechlab bar value, 0–100 |
 | `ArmorRating` | `ArmorRating` | mechlab bar value, 0–100 |
 | `SpeedRating` | `SpeedRating` | mechlab bar value, 0–100 |
 | `HeatRating` | `HeatRating` | mechlab bar value, 0–100 |
 | `DoesHaveLightAmp` | `has_lightamp` | 0 or 1, default 1 — whether LightAmp is currently installed |
 #### `.subsystems` file  (`parse_subsystems()`)
 Provides: armor type + per-zone multipliers, installed heatsinks, jump jets, engine upgrades, weapons, electronics.
 **Armor block:**
 - `ArmorType=` ? armor type string (`Standard`, `FerroFiberus`, `Reactive`, `Reflective`, `Solarian`)
 - Per-zone entries: `LeftArm=1.0`, `RightTorso=2.5`, etc. — multiplier for that zone
 **Engine:**
 - `EngineUpgrade` blocks counted ? `engine_upgrades` (0–5)
 **Weapons** — each weapon block contains:
 - `Model=` ? weapon subsystem resource path (name extracted)
 - `InternalLocation=` ? zone name
 - `Site=` ? mount port name (from armature)
 - `GroupIndex=` ? weapon group number
 - `WeaponFacing=` ? 0=Front, 1=Rear, 2=Side (absent = Front)
 - `AmmoCount=` ? rounds for ammo-using weapons
 - `EjectSite=` ? optional ejection site for ammo
 **Electronics:** ECM, Beagle (BAP), AMS, LAMS, IFF_Jammer detected by subsystem model path.
 #### `.damage` file  (`parse_damage()`)
 Per zone section `[ZoneInternal]`:
 - `BaseArmorValue` ? starting armor (float)
 - `MaxArmorValue` ? hard cap on armor pts for that zone
 - `InternalHPValue` ? internal structure HP
 - `OmniSlots`, `BeamSlots`, `MissileSlots`, `ProjectileSlots` ? weapon slot counts
 Special zones:
 - `SpecialAttachedToZone=` ? which body section this special zone is attached to
 - `DamagePropagationZone=` ? where overflow damage propagates
 #### `.engine` file  (`parse_engine()`)
 | Field | Editor key | Notes |
 |---|---|---|
 | `NumHeatSinks` | `NumHeatSinks` | free heatsinks from engine (not in subsystems) |
 | `TonsPerUpgrade` | `TonsPerUpgrade` | tonnage cost per engine upgrade tier |
 | `MPSPerUpgrade` | `MPSPerUpgrade` | m/s speed gain per upgrade tier |
 #### `.torso` file  (`parse_torso()`)
 | Field | Notes |
 |---|---|
 | `TwistSpeed` | torso horizontal rotation speed — may be a macro reference |
 | `PitchSpeed` | torso vertical rotation speed — may be a macro reference |
 | `TwistRadius` | max horizontal twist angle — may be a macro reference |
 | `PitchRadius` | max vertical pitch angle — may be a macro reference |
 | `ArmRatioAngle` | ratio of arm tracking vs torso rotation — may be a macro reference |
 All torso fields may reference macros from `Content/Defines/MechTorso.defines`.  
 The editor resolves them using a preloaded `TORSO_DEFINES` dict.  Notable values:
 ```
 NORMAL_RATIO   = 40
 SNAIL_TSPEED   = 40
 NORMAL_TSPEED  = 60
 FAST_TSPEED    = 80
 WIDE_TRADIUS   = 160
 NORMAL_PRADIUS = 40
 ```
 ---
 ### Calculated Ratings and Conversions
 #### Speed (kph)
 ```
 top_speed_kph = min(MinMaxSpeed + MPSPerUpgrade × engine_upgrades, MaxSpeed) × 3.6
 ```
 - `MinMaxSpeed` and `MaxSpeed` from `.data` (m/s)
 - `MPSPerUpgrade` from `.engine` (m/s per tier)
 - `engine_upgrades` from `.subsystems` (0–5)
 - Multiply by 3.6 to convert m/s ? kph
 - Argus example: (20.28 + 1.11 × 10) × 3.6 = 113.5 kph
 #### Speed Rating (bar)
 ```
 speed_rating = (top_speed_mps / MaxSpeed) × 100   [capped at 100]
 ```
 #### Turn Rate — degrees to radians
 The `.data` file stores turn rates in **degrees/sec**.  The mechlab UI label was changed to show rad/sec:
 - `StringResource.rc`: `IDS_ML_CH_TURNRATE` ? `"Turn Rate (Top Speed Rad/Sec):"`
 - Conversion: `radians = degrees × ?/180` where `?/180 ? 0.017453`
 - Argus: FullStopTurn = 75° = **1.309 rad/sec**, TopSpeedTurn = 45° = **0.785 rad/sec**
 #### Acceleration / Deceleration (m/s²)
 Stored directly in `.data`.  Reverse values are derived:
 ```
 reverse_accel = Acceleration × ReverseAccelerationMultiplier
 reverse_decel = Decceleration × ReverseDeccelerationMultiplier
 ```
 **The double-c spelling (`Decceleration`, `ReverseDeccelerationMultiplier`) is canonical — it matches the engine source.  Do not "fix" the spelling.**
 #### Heat Rating (bar)
 ```
 total_hs = NumHeatSinks (engine) + installed_heatsinks (subsystems)
 effective_hs = total_hs × (2 if Double else 1)
 heat_rating = (effective_hs / MaxHeat) × 100   [capped at 100]
 ```
 #### Power Rating (bar)
 ```
 total_damage = ? (DamageAmount × NumFire)  for each installed weapon
 power_rating = (total_damage / 80) × 100   [capped at 100]
 ```
 - `DamageAmount` and `NumFire` come from `WeaponSubsystems/<weapon>.data` following `!include` chains
 - Parsed by `load_weapon_damages()` at server startup, cached in `Handler.weapon_damages`
 - Argus example with default load: ~36.2 total damage ? 45 rating (stored = 42)
 #### Armor Rating (bar)
 ```
 for each zone:
    pts = multiplier × ARMOR_PTS_PER_TON[armor_type]
    effective = min(pts, MaxArmorValue[zone])
 armor_rating = (? effective / ? MaxArmorValue) × 100
 ```
 Armor pts per ton by type (from `Adept/ResourceImagePool.cpp` and game design):
 | Type | Pts/ton |
 |---|---|
 | Standard | 32 |
 | FerroFiberus | 38 |
 | Reactive | 30 |
 | Reflective | 30 |
 | Solarian | 60 |
 Note: `FerroFiberus` is the canonical internal token (not player-visible).  The player sees `DNL_FERROFIB = "Ferro Fibrous"` via string lookup.
 ---
 ### Active-in-Game Detection
 Source: `Gameleap/mw4/Content/Tables/MechChassisTable.tbl`
 Format:
 ```
 DisplayKey=Mechs\DirName\FileName.data
 //CommentedKey=Mechs\DirName\FileName.data   <- inactive
 ```
 - Active = entry exists AND is not prefixed with `//`
 - Currently the only inactive mech: **Dasher** (commented out)
 - The editor shows a green **ACTIVE IN GAME** or red **NOT IN GAME** banner at top of Stats tab
 ---
 ### hsh/ Image Naming Conventions
 The `hsh/` directory under `Gameleap/mw4/` holds loose BMP files loaded at runtime (not packed into `.mw4`).  
 There are four relevant subdirectories, each with a different naming authority.
 #### `hsh/hud/` — in-game HUD damage silhouette (own mech)
 #### `hsh/MFD/` — MFD target display silhouette (target mech)
 #### `hsh/radar/hud/` — radar damage overlay
 **All three use identical stems** sourced from `huddamage.cpp` `texturename[]` array.
 Load path:
 - hud/MFD: `hsh\<texturename>.bmp` where texturename = `hud\<stem>`  ?  file = `hsh/hud/<stem>.bmp`
 - radar: `hsh\radar\<texturename>.bmp`  ?  file = `hsh/radar/hud/<stem>.bmp`
 Code: `render.cpp` `CRadar_Device::LoadRadarDamageTexture()` and `huddamage.cpp` `HUDDamage`.
 #### `hsh/Mechs/` — mw4print scorecard portrait
 Load path: `recscore.cpp` ? `GetLocString(model->m_nameIndex)` ? `DNL_*` string from `StringResource.rc` ? lowercased filename.  
 Different naming authority from the other three.
 ---
 ### Complete Canonical Name Table
 Key: mech directory name (case-insensitive) ? canonical stem for `hsh/hud/`, `hsh/MFD/`, `hsh/radar/hud/`.  
 Entries in **bold** differ from the directory name.
 | Directory | hud/MFD/radar stem | hsh/Mechs/ portrait filename |
 |---|---|---|
 | Annihilator | annihilator | annihilator.bmp |
 | Archer | archer | archer.bmp |
 | ArcticWolf | arcticwolf | arctic wolf.bmp |
 | Ares | ares | ares.bmp |
 | Argus | argus | argus.bmp |
 | Assassin2 | assassin2 | **assassin ii.bmp** |
 | Atlas | atlas | atlas.bmp |
 | Avatar | avatar | avatar.bmp |
 | Awesome | awesome | awesome.bmp |
 | Battlemaster | battlemaster | battlemaster.bmp |
 | Battlemaster2c | **battlemasteriic** | **battlemaster iic.bmp** |
 | Behemoth | behemoth | behemoth.bmp |
 | Behemoth2 | **behemothii** | **behemoth ii.bmp** |
 | Blackhawk | blackhawk | black hawk.bmp |
 | Blacknight | **blackknight** | black knight.bmp |
 | Blacklanner | blacklanner | black lanner.bmp |
 | Brigand | brigand | brigand.bmp |
 | Bushwacker | bushwacker | bushwacker.bmp |
 | Catapult | catapult | catapult.bmp |
 | CauldronBorn | cauldronborn | **cauldronborn.bmp** (table key has hyphen; DNL does not) |
 | Chimera | chimera | chimera.bmp |
 | Commando | commando | commando.bmp |
 | Cougar | cougar | cougar.bmp |
 | Cyclops | cyclops | cyclops.bmp |
 | Daishi | daishi | daishi.bmp |
 | Deimos | deimos | deimos.bmp |
 | Dragon | dragon | dragon.bmp |
 | Fafnir | fafnir | fafnir.bmp |
 | Flea | flea | flea.bmp |
 | Gladiator | gladiator | gladiator.bmp |
 | Grizzly | grizzly | grizzly.bmp |
 | Hauptmann | hauptmann | hauptmann.bmp |
 | Hellhound | hellhound | hellhound.bmp |
 | Hellspawn | hellspawn | hellspawn.bmp |
 | Highlander | highlander | highlander.bmp |
 | Hollander | **hollanderii** | **hollander ii.bmp** |
 | Hunchback | hunchback | hunchback.bmp |
 | Kodiak | kodiak | kodiak.bmp |
 | Loki | loki | loki.bmp |
 | Longbow | longbow | longbow.bmp |
 | Madcat | madcat | mad cat.bmp |
 | Madcat_MKII | **madcat2** | mad cat mkii.bmp |
 | Masakari | masakari | masakari.bmp |
 | Mauler | mauler | mauler.bmp |
 | Novacat | novacat | nova cat.bmp |
 | Osiris | osiris | osiris.bmp |
 | Owens | owens | owens.bmp |
 | Puma | puma | puma.bmp |
 | Raven | raven | raven.bmp |
 | Rifleman | rifleman | rifleman.bmp |
 | Ryoken | ryoken | ryoken.bmp |
 | Shadowcat | shadowcat | shadow cat.bmp |
 | Solitaire | solitaire | solitaire.bmp |
 | Sunder | sunder | sunder.bmp |
 | Templar | templar | templar.bmp |
 | Thanatos | thanatos | thanatos.bmp |
 | Thor | thor | thor.bmp |
 | Uller | uller | uller.bmp |
 | Urbanmech | urbanmech | urbanmech.bmp |
 | Uziel | uziel | uziel.bmp |
 | Victor | victor | victor.bmp |
 | Vulture | vulture | vulture.bmp |
 | Warhammer | warhammer | warhammer.bmp |
 | Wolfhound | wolfhound | wolfhound.bmp |
 | Zeus | zeus | zeus.bmp |
 **Critical mismatches where directory name ? hud/MFD stem (files must use the stem, not the dir name):**
 | Directory | Wrong name (dir-based) | Correct name (stem) |
 |---|---|---|
 | Battlemaster2c | battlemaster2c.bmp | **battlemasteriic.bmp** |
 | Behemoth2 | behemoth2.bmp | **behemothii.bmp** |
 | Blacknight | blacknight.bmp | **blackknight.bmp** |
 | Hollander | hollander.bmp | **hollanderii.bmp** |
 | Madcat_MKII | madcat_mkii.bmp | **madcat2.bmp** |
 **Portrait mismatches for hsh/Mechs/ (table key ? DNL string):**
 The `MechChassisTable.tbl` display key and `GetLocString()` DNL string differ for these mechs.  
 mw4print uses the DNL string.  The table key is NOT the correct portrait filename for these 5 mechs.
 | Directory | Table key (wrong for mw4print) | DNL string (correct portrait stem) |
 |---|---|---|
 | Assassin2 | AssassinII ? assassinii | `DNL_ASSASSIN2 "Assassin II"` ? **assassin ii.bmp** |
 | Battlemaster2c | BattlemasterIIC ? battlemasteriic | `DNL_BATTLEMASTERIIC "Battlemaster IIc"` ? **battlemaster iic.bmp** |
 | Behemoth2 | BehemothII ? behemothii | `DNL_BEHEMOTHII "Behemoth II"` ? **behemoth ii.bmp** |
 | CauldronBorn | Cauldron-Born ? cauldron-born | `DNL_CAULDRONBORN "Cauldronborn"` ? **cauldronborn.bmp** |
 | Hollander | HollanderII ? hollanderii | `DNL_HOLLANDERII "Hollander II"` ? **hollander ii.bmp** |
 ---
 ### MechEditor Implementation Notes
 The editor encodes all of the above knowledge in two Python dicts:
 **`MECH_HSH_STEMS`** (in `mech_editor.py`)  
 Maps lowercase dir name ? canonical stem for `hsh/hud/`, `hsh/MFD/`, `hsh/radar/hud/`.  
 Source: `huddamage.cpp` `texturename[]` array.
 **`MECH_PORTRAIT_OVERRIDES`** (in `mech_editor.py`)  
 Maps lowercase dir name ? portrait stem for `hsh/Mechs/` where the DNL string differs from the chassis table key.  
 Source: `DNL_*` entries in `Gameleap/code/mw4/Code/scriptstrings/StringResource.rc`.
 For all other mechs, the portrait stem is derived dynamically from `MechChassisTable.tbl` (display key, lowercased).
 The Assets tab in the editor shows all four image types.  When an image is missing, it displays:
 ```
 Wants: hsh/<subdir>/<expected_filename>.bmp
 ```
 so the user knows exactly what to rename or create.
@@ -0,0 +1,64 @@
 Chassis,InternalLocation,Model,Site,AmmoCount,GroupIndex,WeaponFacing
 Archer,LeftTorso,LRM15,site_ldmissile,24,2,2
 Archer,RightTorso,LRM15,site_rdmissile,24,2,2
 Ares,Special2,ClanLRM10,site_lmissileport,24,2,2
 Ares,Special2,ClanLRM10,site_missileport,24,2,2
 Ares,Special2,ClanLRM10,site_rmissileport,24,2,2
 AssassinII,Special1,LRM5,site_missileport,24,2,2
 Atlas,LeftTorso,LRM20,site_lmissileport,12,2,2
 Avatar,LeftTorso,LRM5,site_lmissileport,24,2,2
 Avatar,RightTorso,LRM5,site_rmissileport,24,2,2
 Avatar,LeftTorso,LRM10,site_lmissileport,24,2,2
 Avatar,RightTorso,LRM10,site_rmissileport,24,2,2
 Awesome,CenterTorso,LRM5,site_ctorsoport,24,2,2
 Battlemaster,RightTorso,MediumLaser,site_rdtorsoport,,1,1
 Battlemaster,LeftTorso,MediumLaser,site_ldtorsoport,,1,1
 BattlemasterIIC,RightTorso,ClanERMediumLaser,site_rdtorsoport,,1,1
 BattlemasterIIC,LeftTorso,ClanERMediumLaser,site_ldtorsoport,,1,1
 Black Lanner,Special2,ClanSRM6,site_rmissileport,15,2,2
 Black Lanner,Special1,ClanLRM10,site_lmissileport,24,2,2
 Bushwacker,Special1,LRM5,site_missileport,24,2,2
 Bushwacker,Special1,LRM5,site_missileport,24,2,2
 Catapult,LeftArm,LRM20,site_lmissileport,12,2,2
 Catapult,RightArm,LRM20,site_rmissileport,12,2,2
 Cauldron-Born,Special1,ClanLRM10,site_rmissileport,24,2,2
 Cauldron-Born,Special2,ClanLRM10,site_lmissileport,24,2,2
 Chimera,RightTorso,LRM5,site_missileport,24,2,2
 Chimera,RightTorso,LRM5,site_missileport,24,2,2
 Chimera,RightTorso,LRM5,site_missileport,24,2,2
 Chimera,RightTorso,LRM5,site_missileport,24,2,2
 Cyclops,LeftTorso,LRM10,site_lmissile,24,2,2
 Cougar,LeftTorso,ClanLRM10,site_lmissileport,12,2,2
 Cougar,RightTorso,ClanLRM10,site_rmissileport,12,2,2
 Deimos,Special1,ClanLRM15,site_lmissileport,16,2,2
 Deimos,Special2,ClanLRM15,site_rmissileport,16,2,2
 Dragon,CenterTorso,LRM10,site_missleport,24,2,2
 Flea,LeftTorso,SmallLaser,site_ltorsoport,,1,1
 Flea,RightTorso,SmallLaser,site_rtorsoport,,1,1
 Grizzly,LeftTorso,CLANLRM10,site_missleport,24,2,2
 Hellhound,LeftTorso,ClanLRM10,site_missileport,12,2,2
 Mad Cat,Special1,ClanLRM10,site_lmissileport,24,2,2
 Mad Cat,Special2,ClanLRM10,site_rmissileport,24,2,2
 Mad Cat MKII,Special2,ClanLRM15,site_lmissileport,16,2,2
 Mad Cat MKII,Special1,ClanLRM15,site_rmissileport,16,2,2
 Masakari,LeftTorso,ClanLRM10,site_lmissleport,24,2,2
 Masakari,LeftTorso,ClanLRM10,site_ltorsoport,24,2,2
 Mauler,LeftTorso,LRM5,site_lmissileport,24,2,2
 Mauler,LeftTorso,LRM5,site_lmissileport,24,2,2
 Mauler,LeftTorso,LRM5,site_lmissileport,24,2,2
 Mauler,RightTorso,LRM5,site_rmissileport,24,2,2
 Mauler,RightTorso,LRM5,site_rmissileport,24,2,2
 Mauler,RightTorso,LRM5,site_rmissileport,24,2,2
 Raven,RightTorso,LRM5,site_rtorsoport,24,2,2
 Sunder,LeftTorso,MediumLaser,site_ldtorsoport,,1,1
 Sunder,RightTorso,MediumLaser,site_rdtorsoport,,1,1
 Templar,LeftTorso,MediumPulseLaser,site_ldrtorsoport,,1,1
 Templar,RightTorso,MediumPulseLaser,site_rdrtorsoport,,1,1
 Thor,Special1,CLANLRM10,site_missileport,24,2,2
 Uziel,Special1,LRM10,site_missileport,24,2,2
 Vulture,LeftTorso,ClanLRM5,site_lmissileport,24,2,2
 Vulture,RightTorso,ClanLRM5,site_rmissileport,24,2,2
 Vulture,LeftTorso,ClanLRM10,site_lmissileport,24,2,2
 Vulture,RightTorso,ClanLRM10,site_rmissileport,24,2,2
 Wolfhound,CenterTorso,ClanERMediumLaser,site_reartorsoport,,1,1
 Zeus,RightTorso,MediumPulseLaser,site_reartorsoport,,1,1
@@ -0,0 +1,45 @@
 Chassis,InternalLocation,Model,Site,AmmoCount,GroupIndex,WeaponFacing
 Ares,Special1,ClanERSmallLaser,site_lgunport,,1,
 Ares,Special1,ClanERSmallLaser,site_rgunport,,1,
 Ares,Special2,ClanLRM10,site_lmissileport,24,2,2
 Ares,Special2,ClanLRM10,site_missileport,24,2,2
 Ares,Special2,ClanLRM10,site_rmissileport,24,2,2
 AssassinII,Special1,LRM5,site_missileport,24,2,2
 Atlas,Special1,AC20,site_rtorsoport,10,1,
 Atlas,Special2,SRM6,site_llmissile,15,2,
 Avatar,Special1,MachineGun,site_ltorsoport,200,1,
 Avatar,Special1,MachineGun,site_rtorsoport,200,1,
 Battlemaster,Special2,PPC,site_rdgunport,,1,
 Battlemaster,Special1,SRM6,site_missile,15,2,
 BattlemasterIIC,Special1,ClanSSRM6,site_missile,15,2,
 Behemoth,Special1,LargeLaser,site_ctorsoport,,1,
 BehemothII,Special1,LargeLaser,site_ctorsoport,,1,
 Black Lanner,Special2,ClanSRM6,site_rmissileport,15,2,2
 Black Lanner,Special1,ClanLRM10,site_lmissileport,24,2,2
 Brigand,Special2,MediumLaser,site_ltorsoport,,1,
 Brigand,Special1,MediumLaser,site_rtorsoport,,1,
 Bushwacker,Special1,LRM5,site_missileport,24,2,2
 Bushwacker,Special1,LRM5,site_missileport,24,2,2
 Cauldron-Born,Special1,ClanLRM10,site_rmissileport,24,2,2
 Cauldron-Born,Special2,ClanLRM10,site_lmissileport,24,2,2
 Cyclops,Special1,MediumPulseLaser,site_gunport,,1,
 Deimos,Special1,ClanLRM15,site_lmissileport,16,2,2
 Deimos,Special2,ClanLRM15,site_rmissileport,16,2,2
 Hauptmann,Special1,ClanUltraAC20,site_rutorsoport,16,1,
 Hellspawn,Special1,SSRM2,site_rmissileport,50,2,
 HollanderII,Special2,SmallPulseLaser,site_cltorsoport,,1,
 HollanderII,Special2,SmallPulseLaser,site_crtorsoport,,1,
 HollanderII,Special1,GaussRifle,site_rtorsoport,16,1,
 Hunchback,Special1,AC10,site_rutorsoport,20,1,
 Loki,Special1,ClanSSRM6,site_missileport,15,2,
 Mad Cat,Special1,ClanLRM10,site_lmissileport,24,2,2
 Mad Cat,Special2,ClanLRM10,site_rmissileport,24,2,2
 Mad Cat MKII,Special2,ClanLRM15,site_lmissileport,16,2,2
 Mad Cat MKII,Special1,ClanLRM15,site_rmissileport,16,2,2
 Rifleman,Special1,MediumLaser,site_ltorsoport,,1,
 Rifleman,Special1,MediumLaser,site_rtorsoport,,1,
 Solitaire,Special1,ClanERLargeLaser,site_rtorsoport,,1,
 Thor,Special1,CLANLRM10,site_missileport,24,2,2
 Uziel,Special1,LRM10,site_missileport,24,2,2
 Vulture,Special1,ClanMachineGun,site_ltorsoport,200,1,
 Vulture,Special1,ClanMachineGun,site_rtorsoport,200,1,
@@ -0,0 +1,144 @@
 [mission]
 MissionName=Coliseum - Attrition
 GameType=2
 TeamAllowed=0
 Visibility=1
 Weather=0
 TimeOfDay=0
 TimeLimit=15
 Radar=0
 HeatOn=0
 FriendlyFire=1
 SplashDamage=1
 UnlimitedAmmo=0
 WeaponJam=1
 AdvanceMode=1
 ArmorMode=1
 [slot0]
 Type=1
 PilotName=Viper
 Mech=Atlas
 Team=0
 Skin=0
 Decal=3
 [slot1]
 Type=1
 PilotName=Blackjack
 Mech=Mad Cat
 Team=0
 Skin=1
 Decal=4
 [slot2]
 Type=1
 PilotName=Ghost
 Mech=Warhammer
 Team=0
 Skin=2
 Decal=2
 [slot3]
 Type=1
 PilotName=Maverick
 Mech=Thor
 Team=0
 Skin=3
 Decal=5
 [slot4]
 Type=1
 PilotName=Reaper
 Mech=Loki
 Team=0
 Skin=4
 Decal=6
 [slot5]
 Type=1
 PilotName=Phoenix
 Mech=Daishi
 Team=0
 Skin=5
 Decal=9
 [slot6]
 Type=1
 PilotName=Hammer
 Mech=Shadow Cat
 Team=0
 Skin=6
 Decal=10
 [slot7]
 Type=1
 PilotName=Blade
 Mech=Battlemaster
 Team=0
 Skin=7
 Decal=11
 [slot8]
 Type=1
 PilotName=Ironside
 Mech=Cauldron-Born
 Team=0
 Skin=8
 Decal=12
 [slot9]
 Type=1
 PilotName=Tempest
 Mech=Vulture
 Team=0
 Skin=9
 Decal=3
 [slot10]
 Type=1
 PilotName=Saber
 Mech=Black Hawk
 Team=0
 Skin=10
 Decal=16
 [slot11]
 Type=1
 PilotName=Ajax
 Mech=Archer
 Team=0
 Skin=11
 Decal=49
 [slot12]
 Type=1
 PilotName=Thunder
 Mech=Kodiak
 Team=0
 Skin=12
 Decal=2
 [slot13]
 Type=1
 PilotName=Raven
 Mech=Uziel
 Team=0
 Skin=13
 Decal=50
 [slot14]
 Type=1
 PilotName=Wraith
 Mech=Grizzly
 Team=0
 Skin=14
 Decal=48
 [slot15]
 Type=1
 PilotName=Goliath
 Mech=Annihilator
 Team=0
 Skin=15
 Decal=5
@@ -0,0 +1,145 @@
 [mission]
 MissionName=CentralPark - Team KotH
 GameType=6
 TeamAllowed=1
 TeamCount=4
 Visibility=1
 Weather=0
 TimeOfDay=0
 TimeLimit=15
 Radar=0
 HeatOn=0
 FriendlyFire=1
 SplashDamage=1
 UnlimitedAmmo=0
 WeaponJam=1
 AdvanceMode=1
 ArmorMode=1
 [slot0]
 Type=1
 PilotName=Viper
 Mech=Atlas
 Team=0
 Skin=0
 Decal=3
 [slot1]
 Type=1
 PilotName=Blackjack
 Mech=Mad Cat
 Team=0
 Skin=0
 Decal=3
 [slot2]
 Type=1
 PilotName=Ghost
 Mech=Warhammer
 Team=0
 Skin=0
 Decal=3
 [slot3]
 Type=1
 PilotName=Maverick
 Mech=Thor
 Team=0
 Skin=0
 Decal=3
 [slot4]
 Type=1
 PilotName=Reaper
 Mech=Loki
 Team=1
 Skin=1
 Decal=4
 [slot5]
 Type=1
 PilotName=Phoenix
 Mech=Daishi
 Team=1
 Skin=1
 Decal=4
 [slot6]
 Type=1
 PilotName=Hammer
 Mech=Shadow Cat
 Team=1
 Skin=1
 Decal=4
 [slot7]
 Type=1
 PilotName=Blade
 Mech=Battlemaster
 Team=1
 Skin=1
 Decal=4
 [slot8]
 Type=1
 PilotName=Ironside
 Mech=Cauldron-Born
 Team=2
 Skin=2
 Decal=2
 [slot9]
 Type=1
 PilotName=Tempest
 Mech=Vulture
 Team=2
 Skin=2
 Decal=2
 [slot10]
 Type=1
 PilotName=Saber
 Mech=Black Hawk
 Team=2
 Skin=2
 Decal=2
 [slot11]
 Type=1
 PilotName=Ajax
 Mech=Archer
 Team=2
 Skin=2
 Decal=2
 [slot12]
 Type=1
 PilotName=Thunder
 Mech=Kodiak
 Team=3
 Skin=3
 Decal=5
 [slot13]
 Type=1
 PilotName=Raven
 Mech=Uziel
 Team=3
 Skin=3
 Decal=5
 [slot14]
 Type=1
 PilotName=Wraith
 Mech=Grizzly
 Team=3
 Skin=3
 Decal=5
 [slot15]
 Type=1
 PilotName=Goliath
 Mech=Annihilator
 Team=3
 Skin=3
 Decal=5
@@ -795,6 +795,118 @@ keeping old-RIO (type 0) protocol behavior byte-identical:
  alongside `mw4print.exe`.
 - Version bumped to **2.0**, copyright year updated to **2026**.
 ## 📋 MFD mode 4: right device stagger fix (2026-07-18, eaa5fd3)
 Root cause: `CMFD_Device::BeginScene()` cleared BOTH MFD device back-buffers at `sh_step==0`.
 But in mode 4 the right MFD flip also fires at `sh_step==1` (= old `sh_step==0` after the
 stagger increment), so it presented a just-cleared buffer — only the grid, no channel data.
 Fix: `BeginScene()` now only clears/grids the LEFT device at `sh_step==0`. New `BeginSceneRight()`
 (added to `render.cpp` / `render.hpp`, called from `WinMain.cpp`) clears/grids the RIGHT device at
 `sh_step==1` — one frame AFTER the right flip — so channels 3–4 render into a fresh buffer before
 the next flip. Mode 1 is unchanged.
 Mode 4 cycle (with stagger):
 - `sh_step 0`: radar + left `BeginScene` (clear + grid); no flip
 - `sh_step 1`: flip right MFD (shows channels 3–4 from previous cycle) + right `BeginScene` (clear + grid)
 - `sh_step 2–4`: channels 0–2 → left device
 - `sh_step 5–6`: channels 3–4 → right device
 - `sh_step 0` (next): flip radar + left MFD (shows channels 0–2 from previous cycle)
 Files: `CoreTech/Libraries/GameOS/WinMain.cpp`, `render.cpp`, `render.hpp`.
 ## 📋 Linux→Windows development workflow (2026-07-19, 55b9bfc5)
 `build-env/sync-to-windows.sh` — rsync script that pushes all source, content, toolchain, and
 assets to the Windows build machine at `/vwe/firestorm`. Excludes generated build outputs
 (`rel.bin/`, `dbg.bin/`, `*.mw4`, `*.dep`), `.git`/LFS objects, `_UNUSED/`, and the game deploy
 dir (`MW4/`). Run from Linux before triggering a Windows build.
 ## 📋 ddraw.dll removed from repo; build script moves it aside (2026-07-19, 0ceba9c7, 24825ff3)
 `Gameleap/mw4/ddraw.dll` (DDrawCompat) removed from git (was LFS-tracked); now lives as
 `ddraw.dll.old` in the same dir for reference. `deploy-editor.ps1` installs DDrawCompat as
 `ddraw.dll` at deploy time (the editor needs it for its windowed D3D7 viewport).
 `build-resources.ps1` moves `ddraw.dll` aside (`.buildaside`) before running `MW4pro.exe`
 because **DDrawCompat is fatal to MW4pro.exe in BOTH windowed and fullscreen modes**, then
 restores it in `finally`. The same block also defensively covers dgVoodoo2 interceptors
 (`D3D8/D3D9/D3DImm.dll`) in case they reappear.
 ## 📋 Branch `5.1.0b-in-progress`: multiplayer + RIO + source cleanup (2026-07-19)
 ### ConLobby V5.1.0b1 — Super6 mech rotation (c768f7c4)
 Changes from Buddy 'Highlight' Taylor (MCHL), merged manually:
 - Console version string bumped to **V5.1.0b1**.
 - `ROOKIEMECH` defines expanded from 4 → **6 mechs**: added Archer (ID=1) and Warhammer (ID=62).
 - 16-slot default assignments cycle through all 6 Super6 mechs.
 - Right-click randomizer expanded from `random(0,3)` → `random(0,5)`.
 ### CRIOMAIN.CPP — Korean translation + RIO poll timeout scaling (16fca6c4, a712002f)
 - Translated all EUC-KR/CP949 Korean developer comments (~35 lines) to English. File re-saved
  as clean UTF-8. CRLF line endings preserved (`* -text` in `.gitattributes`).
  ⚠️ **Encoding hazard:** always read/write CRIOMAIN.CPP as binary (or with an explicit encoding
  codec). Python text-mode `readlines()` silently strips `\r`, causing a 3000+-line git diff when
  every line's `\r\n` becomes `\n`. If that happens, restore CRLF with `re.sub(b'(?<!\r)\n', b'\r\n', data)` in binary mode, then amend the commit.
 - Added **`g_dwRIOPollTimeout`** global (default 50 ms). Computed in `SetupConnection` before the
  receive loop using: `clamp(⌈480000/baud⌉, 5, 50)`. Preserves 50 ms at 9600 baud; floors at
  5 ms for 115200 baud. Implemented with explicit ternary — **`min`/`max` are undeclared in this
  translation unit under VC6** (not pulled in by CRIOMAIN's includes); use ternary or `__min`/`__max`.
 ### 16 pilots + 1 cameraship in multiplayer (f76dc05f)
 `MW4Shell.cpp`:
 - `CTCL_DefaultHostSetup` (non-coop): `Environment.NetworkMaxPlayers` set to
  `params->m_maxPlayers + (CTCL_GetTeslaCountAll() - CTCL_GetTeslaCount())`.
  The delta = camera-only seats (Tesla seats not assigned to pilots), reserving one extra
  DirectPlay slot per cameraship so the 17th connection isn't rejected.
 - `SetNetworkMissionParamater / PLAYER_LIMIT_PARAMETER`: same formula applied at runtime when
  host changes the player limit. `gos_NetServerCommands(gos_Commend_UpdateMaxPlayers)` still called;
  `break` must be present in this case (was accidentally dropped once — fall-through to
  `JOIN_IN_PROGRESS_PARAMETER` corrupts `m_joinInProgress`).
 - COOP branch unchanged (capped at 9+bots; no camera seat needed there).
 `ConLobby.script`: launch guard `nTempPlayerCount > 16` raised to `> 17` so the cameraship
 connection doesn't trigger "Too many player/bots".
 ### hsh/ BMP canonical renames (5813aeb6, 2026-07-23)
 All `hsh/MFD/*.bmp` and `hsh/Mechs/*.bmp` filenames reconciled against the canonical stems
 expected by game code. The engine loads MFD images via `huddamage.cpp` `texturename[]` array
 (lowercase, no spaces) and Mechs portraits via `GetLocString` DNL strings (mixed-case with
 spaces). Any mismatch = silently missing image at runtime.
 Key renames:
 - `hsh/MFD/assassinii.bmp` → `assassin2.bmp` (matches `texturename[]` canonical)
 - `hsh/Mechs/battlemasteriic.bmp` → `battlemaster iic.bmp`
 - `hsh/Mechs/mad cat mk.ii.bmp` → `mad cat mkii.bmp`
 - `hsh/Mechs/behemoth ii.bmp` added (was absent)
 Most other files in both directories are LFS pointer updates only (content unchanged).
 ### RookieMission configurable defaults via options.ini (5813aeb6, 2026-07-23)
 CTCL (console) arcade mode has a "Rookie Mission" quick-launch that previously hardcoded all
 game params. Now all 13 params are overridable from an `[RookieMission]` section in
 `options.ini` (read by `CTCL_SetCDSP` at startup):
 - `MW4Shell.cpp`: added 14 `g_` globals (`g_szRookieMission`, `g_nRookieGameType`, and 12
  numeric params); registered as `gosScript_RegisterVariable` in `StartUp`/`ShutDown`;
  `CTCL_SetCDSP` reads the `[RookieMission]` page via `NotationFile` and populates them.
  Defaults: `"ScarabStronghold - Attrition"`, GameType=2 (Attrition), UnlimitedAmmo=1, all
  others zero. `g_nRookieTimeLimit=-1` means "use the server's current time setting".
 - `ConLobbyMission.script`: all hardcoded values in `MAIL_SET_ROOKIE_MISSION` handler replaced
  with `$$g_szRookieMission$$` / `$$g_nRookieXxx$$` references.
 - Requires rebuild: `MW4.exe` (Release + Profile).
 ### Mechlab turn rate label (5813aeb6, 2026-07-23)
 `StringResource.rc` `IDS_ML_CH_TURNRATE`: "Turn Rate (Degrees/Sec.):" →
 "Turn Rate (Top Speed Rad/Sec):" to match the actual `.data` field semantics
 (`TopSpeedTurnRate` is in rad/s at top speed, not deg/s).
 Requires rebuild: `ScriptStrings.dll`.
 ### BTFrstrm design documentation (840bc96c, 2026-07-23)
 Two Word documents added to `BTFrstrm/`:
 - `MechDependencyTree.docx` — dependency relationships between mech chassis/variants.
 - `Special_Zones.docx` — documentation of special zone types used in maps/missions.
 ### mech_loadouts.md: MechEditor data model (0344418a, 2026-07-23)
 `BTFrstrm/mech_loadouts.md` extended with a full reference section documenting the
 MechEditor web app (`/home/rich/Repositories/MechEditor/mech_editor.py`, localhost:8765):
 every `.data`/`.instance`/`.subsystems` field parsed, conversions performed (m/s ↔ kph,
 rad/s ↔ deg/s), and `hsh/` naming rules for MFD/Mechs/HUD/Radar images. Canonical
 reference for future mech data work.
 ## Next steps (proposed)
 - [x] ~~Windowed 3D viewport on Win11~~ — DONE via DDrawCompat (see STEP 8 viewport section).
 - [ ] (Optional) Curate remaining WIP content as features are exercised (editor loads dev `Content\`).
@@ -9,7 +9,7 @@
 #include "recscore.h"
 #endif // !defined(CTCLS_EXPORTS) && !defined(CTCL_LAUNCHER)
-#define MAX_TESLAS          31
+#define MAX_TESLAS          16
 #define MAX_CAMERAS         4
 #define PORT_Launcher       1000
@@ -260,7 +260,7 @@ CInviteCOOP g_InviteCOOP;
 // Mech4 only
 int g_nMech4Comm = 0;
 BOOL g_bIsServer = FALSE;
-SPlayerInfo g_aPlayerInfos[35]; // 31 pilots + 1 CS + 3 spare
+SPlayerInfo g_aPlayerInfos[20];
 int g_nPlayerInfos;
 int g_nServer;
 int g_nTeslas;
@@ -43,7 +43,7 @@ LONG g_LeftPedalLast	= 0;
 LONG g_RightPedalLast	= 0;
 BOOL g_StartGame		= FALSE;
-static int g_nOpenComState = 0; // 鉉
+static int g_nOpenComState = 0; // hyun
 DWORD g_dwLastAnalogUpdate = 0;
@@ -54,7 +54,7 @@ DWORD g_dwLastAnalogUpdate = 0;
 #define RESTART_CHAR	0xFE
 #define IDLE_CHAR		0xFF
-//member 변수처럼 활용할것.
+//Use it like a member variable.
 static HANDLE g_hCom = INVALID_HANDLE_VALUE;
 static OVERLAPPED wos;
 static OVERLAPPED ros;
@@ -108,6 +108,7 @@ int g_nRIOPacketCountB = (sizeof(g_baRIOLengthsB) / sizeof(g_baRIOLengthsB[0]));
 int g_nRIOType = 0; // 0: old(original) type, 1: new type
 DWORD g_dwRIOBaud = 0; // [tbaud] 0: default by RIO type; else COM1 baud forced by -tbaud (high-speed replica of the original RIO board, protocol unchanged)
 DWORD g_dwRIOPollTimeout = 50; // [tbaud] WaitForMultipleObjects timeout (ms); computed from baud rate before the receive loop starts
 int g_nEjectButton = 61; // 61: original, 31: new type
 BYTE* g_pbRIOLengths = NULL;
 int g_nRIOPacketCount = 0;
@@ -318,7 +319,7 @@ void RequestVersion();
 void RequestAnalogUpdate(BYTE bFreq = 3);
 // start - for new RIO Board only...
-//received packet은 각각 다른 스레드에서 처리하므로.. ciritical section이 필요하다..
+//Received packets are handled in different threads.. a critical section is needed..
 BYTE received_buffer[128][16];
 int received_packet=0;//packets count in the received_buffer.
 DWORD received_serial=0;
@@ -569,7 +570,7 @@ BOOL SetupConnection(HANDLE hCom)
 	return TRUE;
 /*
-	원래 처리 루틴..
+	Original processing routine..
 	NPTTYINFO  npTTYInfo=0 ;
 	BYTE bset1 = (BYTE) ((FLOWCTRL( npTTYInfo ) & FC_DTRDSR) != 0) ;
 	BYTE bset2 = (BYTE) ((FLOWCTRL( npTTYInfo ) & FC_RTSCTS) != 0) ;
@@ -603,7 +604,7 @@ BOOL SetupConnection(HANDLE hCom)
-//처리되지 않는 항목들.. GetCommState의 기본값으로 처리한다.	
+//Unhandled items.. handled using GetCommState default values.	
 	DWORD fDsrSensitivity:1;   // DSR sensitivity 
 	DWORD fTXContinueOnXoff:1; // XOFF continues Tx 
 	DWORD fErrorChar: 1;     // enable error replacement 
@@ -647,7 +648,7 @@ HANDLE OpenConnection(int port)
 			g_hLampEvent = CreateEvent(0,FALSE,0,0);
 			g_hCommWatchThread = CreateThread((LPSECURITY_ATTRIBUTES)NULL, 0, (LPTHREAD_START_ROUTINE)CommWatchProc, NULL, CREATE_SUSPENDED, &g_dwThreadID);
 			if (g_hCommWatchThread) {
-				//Thread까지 정상적으로 생성되었다.
+				//Thread was created successfully.
 				//////////////////////////////////////////////
 				//All OK
 				//Exit Point	<======
@@ -744,11 +745,11 @@ retry:
 		for(int i=0;i<(int)dwLength;i++){
 			int ch=(BYTE)lpszBlock[i];
-			//받은 문자만큼 루프를 돈다.
+			//Loop for the number of received characters.
-			//현재.. 받고 있는 packet이 없고.. 어떤 control문자라도 올 수 있는 상태이다.
+			//Currently.. no packet is being received.. can receive any control character.
 			if(packetbyteremain!=0){
-				//패킷에 해당하는 문자가 도착했다.. 나머지 문자들을 받는다.
+				//Character corresponding to a packet has arrived.. receive the remaining characters.
 				if (ch & 0x80) {
 					packetbyteremain=0;
 					chinpacket=0;
@@ -758,7 +759,7 @@ retry:
 				packetbytes[chinpacket] = ch;
 				chinpacket++;
 				if (packetbyteremain == 0) {
-					//하나의 패킷이 완성되었다. 도착했다.. 즉시 반응한다.
+					//A packet has been completed and arrived.. respond immediately.
                    chinpacket--; // exclude check byte
 					int packettype=packetbytes[0];
                    BYTE bCheckByte = 0;
@@ -837,21 +838,21 @@ retry:
 							packettype++;
 							packettype--;
 #endif // _DEBUG
-					    case rio_Ack2://◆◆◆◆◆◆◆◆◆◆
+					    case rio_Ack2:
 							if (g_nRIOType != 0) {
 								BYTE id=packetbytes[1];
 								int popped_index=PopPacket(id);
 								ack_timeout=GetTickCount()+30;
 								if(popped_index==0){
-									//맨처음것... 정상적인 경우이다.
+									//This is the very first one... Normal case.
 								}else if(popped_index>0){
-									//맨처음것이 아닌것.
+									//Not the very first one.
-									//이전것들이 정상적으로 보내지지 않았으므로 다시 보낸다...
+									//Previous ones were not sent successfully, resend...
-									ReSendPackets(popped_index);//잘못된 개수 만큼..
+									ReSendPackets(popped_index);//By the number of incorrect ones..
 								}else{
-									//실패 했다는것은.. 없는 id가 왔다는 것인데.. 
+									//Failure means an id that does not exist arrived.. 
-									//명백한 에러.. 그러나 특별히 대처할 방법은 없다.
+									//An obvious error.. but there is no particular way to handle it.
-									//그냥 무시한다.
+									//Simply ignore it.
 								}
 							}
 							break;
@@ -870,9 +871,9 @@ retry:
 					//					 WriteTTYBlock(hWnd,"|",1);
 					chinpacket=0;
-					//packetbytes버퍼를 지운다.
+					//Clear the packetbytes buffer.
                } else {
-					//아직 패킷 문자들이 다 도착하지 않았다.. 아무것도 하지 않는다.
+					//Packet characters have not all arrived yet.. do nothing.
 					;
 				}
 			}else{
@@ -889,7 +890,7 @@ retry:
 		}//for(int i=0;i<(int)dwLength;i++)
-		//상훈 뒤
+		//sanghoon end
 		if (!fReadStat){
 			if (GetLastError() == ERROR_IO_PENDING){
 				while(!GetOverlappedResult( g_hCom,&ros, &dwLength, TRUE )){
@@ -1000,12 +1001,24 @@ DWORD FAR PASCAL CommWatchProc( LPSTR lpData )
 	}
 	g_dwLastAnalogUpdate = GetTickCount() + 2800;
 	// [tbaud] Scale the poll timeout proportionally to baud rate so faster links
 	// poll more frequently.  Formula: clamp(ceil(480000/baud), 5, 50)
 	// preserves the existing 50ms at 9600 baud, floors at 5ms for high speeds.
 	// effectiveBaud: use -tbaud override if set, else the RIO type's default.
 	{
 		DWORD effectiveBaud = (g_dwRIOBaud != 0) ? g_dwRIOBaud
 		                    : ((g_nRIOType == 0) ? 9600UL : 115200UL);
 		{
 			DWORD t = (480000UL + effectiveBaud - 1) / effectiveBaud;
 			g_dwRIOPollTimeout = (t < 5UL) ? 5UL : (t > 50UL ? 50UL : t);
 		}
 	}
 	while(1) {	
 		DWORD dwEvtMask = 0;
 		WaitCommEvent( g_hCom, &dwEvtMask,&wcos );
-		DWORD ret=WaitForMultipleObjects(3,events,FALSE,50/*INFINITE*/);
+		DWORD ret=WaitForMultipleObjects(3,events,FALSE,g_dwRIOPollTimeout);
 		if(ret==WAIT_OBJECT_0){
 			//An Comm Event has arrived.
 			DWORD bytesread;
@@ -1022,10 +1035,10 @@ DWORD FAR PASCAL CommWatchProc( LPSTR lpData )
 				}
 			} else {*/
 			if (g_nRIOType != 0) {
-				///◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆위의 ReadCommBlock에서 ack를 받았을 경우 duetime을 update시킨다.
+				///When ack is received from ReadCommBlock above, update duetime.
-				///◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆CheckSentBuffer...
+				///CheckSentBuffer...
 				if(GetTickCount()>ack_timeout)
-					ReSendPackets(sent_packet);//sent_buffer에 있는 모든것들을 다시 보내본다.
+					ReSendPackets(sent_packet);//Resend everything in sent_buffer.
 			}
 			/*}*/
 		}else if(ret==WAIT_OBJECT_0+1){
@@ -1039,9 +1052,9 @@ DWORD FAR PASCAL CommWatchProc( LPSTR lpData )
 			//break;
 		}else if (ret==WAIT_TIMEOUT) {
 			if (g_nRIOType != 0) {
-				///◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆CheckSentBuffer...
+				///CheckSentBuffer...
 				if(GetTickCount()>ack_timeout)
-					ReSendPackets(sent_packet);//sent_buffer에 있는 모든것들을 다시 보내본다.
+					ReSendPackets(sent_packet);//Resend everything in sent_buffer.
 			}
 			if (packetbyteremain == 0) {
 				RequestAnalogUpdate();
@@ -1236,8 +1249,8 @@ bool SaveReceivedPacket(const BYTE*ba,int length)
 bool GetSerialFromReceivedBuffer(char * ba)
 {
-//ButtonPressed/Released만 저장해 놓는다..
+//Store only ButtonPressed/Released..
-	//모든 serial packet을 옮긴다.
+	//Transfer all serial packets.
 	if(received_packet>0){
 		if(received_buffer[0][2]==received_serial){
 			CopyMemory(ba,received_buffer[0],16);
@@ -1264,7 +1277,7 @@ bool QueuePacket(const BYTE *ba,int length)
 int PopPacket(BYTE id)
 {
-//lamp는.. id가..
+//lamp.. check by id..
 	//search the packet..
 	for(int i=0;i<sent_packet;i++){
 		if(sent_buffer[i][3]==id){
@@ -1427,7 +1440,7 @@ void CBUTTON_GROUP::SetTable(BOOL bFlag/* = true*/)
 		    for (int b = 0; b < MAXBUTTON_TABLE; b++) {
 			    s_aCtrlLamp[b] = s_aSaveLamp[b];// = s_aButtonTable[b].lamp;
-			    // s_aButtonTable는 Old값이므로 초기치는 Off
+			    // s_aButtonTable is the old value, so the initial value is Off
 			    s_aButtonTable[b].lamp = LAMP_OFF;
 		    }
@@ -1439,7 +1452,7 @@ void CBUTTON_GROUP::SetTable(BOOL bFlag/* = true*/)
 	}
 	else
 	{
-		// 모든 테이블을 원래 상태로
+		// Restore all tables to original state
 		for (int b = 0; b < MAXBUTTON_TABLE; b++) {
 			s_aCtrlLamp[b] = s_aSaveLamp[b];
 		}
@@ -1534,7 +1547,7 @@ void CBUTTON_GROUP::ResetTable(BOOL bFlag/* = true*/)
 	} 
 	else 
 	{
-		// 모든 테이블을 Off
+		// Turn off all tables
 		for (int b = 0; b < MAXBUTTON_TABLE; b++) {
 			switch(b)
            {
@@ -2212,13 +2225,13 @@ void CRIOMAIN::UpdatePadal (DIJOYSTATE &js)
 			 Down			 Up
 			 ======================
-			 ← (+)			(-) →
+			 <-- (+)			(-) -->
 			 ======================
-		  ↗
+		  /^
 	g_LeftPedalStart: INT_MAX (+)
 	lP = (LONG)g_LeftPedalStart - g_LeftPedal;
-	lP 결과값은 무조건 음수	
+	lP result value is always negative	
 */
 	LONG lP = 0;
@@ -2362,9 +2375,9 @@ void CRIOMAIN::UpdateThrottle (DIJOYSTATE &js)
 			 Up			 Down
 			 ======================
-			 ← (-)			(+) →
+			 <-- (-)			(+) -->
 			 ======================
-		  ↗
+		  /^
 	g_ThrottleStart: INT_MIN (-)
 */
@@ -2447,11 +2460,11 @@ void CRIOMAIN::UpdateJoystick (DIJOYSTATE &js)
 	*/
 //////////////////////////////////////////////////////////////////////////////////
 	/*
-		80 의 의미 
+		Meaning of 80 
-		RIO (LEFT :120 ~ RIGHT :-80) 까지의 수를 돌려준다고 가정하고 
+		Assuming RIO returns values in range (LEFT:120 ~ RIGHT:-80) 
-		(LEFT의경우) RIGHT 의 최대값 80 이상인 값을 잘라버리고 나머지는 
+		(In the LEFT case) clip values above the RIGHT maximum of 80, and the rest 
-		버릴경우 LEFT 와 RIGHT가 동일한 속도로 움직일수 있다
+		if discarded, LEFT and RIGHT can move at the same speed
 	*/
 //////////////////////////////////////////////////////////////////////////////////
 	LONG	lJ;
@@ -132,6 +132,10 @@ extern SCRIPTCALLBACK(CTCL_GetMissionState);
 extern SCRIPTCALLBACK(CTCL_DoBreak);
 extern SCRIPTCALLBACK(CTCL_IsGameLoaded);
 extern SCRIPTCALLBACK(CTCL_DoReprint);
 extern SCRIPTCALLBACK(CTCL_LoadAutoFile);
 extern SCRIPTCALLBACK(CTCL_GetAutoSlotName);
 extern SCRIPTCALLBACK(CTCL_GetAutoSlotMech);
 extern SCRIPTCALLBACK(CTCL_GetAutoSlotInt);
 extern SCRIPTCALLBACK(CTCL_CheckPlayMovie);
 extern SCRIPTCALLBACK(CTCL_CheckCoinCounts);
 extern SCRIPTCALLBACK(CTCL_CheckUseJPD);
@@ -158,6 +162,53 @@ int g_nWhyPaused = 0; // 0: not paused - invitation in menu-state, 1: briefing,
 extern SCRIPTCALLBACK(CTCL_WhyPaused);
 int g_nTimeList_Index = 3; // 3rd item in listbox...
 int g_nTimeList_Value = 7; // 7 minutes
 // [RookieMission] options.ini overrides ? defaults match the hardcoded script values
 char g_szRookieMission[256] = "ScarabStronghold - Attrition";
 char* g_pszRookieMission = g_szRookieMission; // pointer used for script registration
 int  g_nRookieGameType    = 2;  // Attrition index in game-type list
 int  g_nRookieVisibility  = 0;  // 0=clear
 int  g_nRookieWeather     = 0;  // 0=off
 int  g_nRookieTimeOfDay   = 0;  // 0=day
 int  g_nRookieTimeLimit   = -1; // -1=use g_nTimeList_Value
 int  g_nRookieRadar       = 0;  // 0=novice
 int  g_nRookieHeat        = 0;  // 0=off
 int  g_nRookieFriendlyFire= 0;
 int  g_nRookieSplash      = 0;
 int  g_nRookieUnlimitedAmmo = 1; // 1=on (be cautious)
 int  g_nRookieWeaponJam   = 0;
 int  g_nRookieAdvanceMode = 0;
 int  g_nRookieArmorMode   = 0;
 // [automaticmode] options.ini ? Load File button
 struct SAutoFileSlot {
    char szName[64];   // pilot name
    char szMech[64];   // mech display name (matched against mech[] array)
    int  nType;        // 0=empty, 1=player, 2-9=bot difficulty level
    int  nTeam;
    int  nSkin;
    int  nDecal;
 };
 static SAutoFileSlot g_aAutoSlots[16];
 static int           g_nAutoSlotsCount = 0;
 static int           g_bAutomaticMode  = 0;
 static char          g_szAutomaticFile[MAX_PATH] = "";
 // [automaticmode] game option globals ? separate from Rookie Mission defaults to preserve Default button behavior
 static char g_szAutoMission[256] = "";
 static char* g_pszAutoMission    = g_szAutoMission;
 static int  g_nAutoGameType      = 2;   // Attrition
 static int  g_nAutoVisibility    = 0;
 static int  g_nAutoWeather       = 0;
 static int  g_nAutoTimeOfDay     = 0;
 static int  g_nAutoTimeLimit     = -1;  // -1 = server default
 static int  g_nAutoRadar         = 0;
 static int  g_nAutoHeat          = 0;
 static int  g_nAutoFriendlyFire  = 0;
 static int  g_nAutoSplash        = 0;
 static int  g_nAutoUnlimitedAmmo = 1;
 static int  g_nAutoWeaponJam     = 0;
 static int  g_nAutoAdvanceMode   = 0;
 static int  g_nAutoArmorMode     = 0;
 static int  g_nAutoTeamAllowed   = 0;   // 0=FFA 1=team game; set via TeamAllowed= in [mission]
 static int  g_nAutoTeamCount     = 2;   // number of teams when TeamAllowed=1
 // MSL 5.06
 int g_nMechVariant = 0; 
 int g_nMechLabOp = 0;
@@ -727,6 +778,54 @@ void MW4Shell::StartUp()
 	gosScript_RegisterCallback("CTCL_WhyPaused",&CTCL_WhyPaused,GOSVAR_INT,0,NULL);
 	gosScript_RegisterVariable("g_nTimeList_Index", &g_nTimeList_Index, GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nTimeList_Value", &g_nTimeList_Value, GOSVAR_INT, 0, NULL);
 	// [RookieMission] ini-driven defaults
 	gosScript_RegisterVariable("g_szRookieMission",    &g_pszRookieMission,     GOSVAR_STRING, 0,   NULL);
 	gosScript_RegisterVariable("g_nRookieGameType",    &g_nRookieGameType,      GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nRookieVisibility",  &g_nRookieVisibility,    GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nRookieWeather",     &g_nRookieWeather,       GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nRookieTimeOfDay",   &g_nRookieTimeOfDay,     GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nRookieTimeLimit",   &g_nRookieTimeLimit,     GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nRookieRadar",       &g_nRookieRadar,         GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nRookieHeat",        &g_nRookieHeat,          GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nRookieFriendlyFire",&g_nRookieFriendlyFire,  GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nRookieSplash",      &g_nRookieSplash,        GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nRookieUnlimitedAmmo",&g_nRookieUnlimitedAmmo,GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nRookieWeaponJam",   &g_nRookieWeaponJam,     GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nRookieAdvanceMode", &g_nRookieAdvanceMode,   GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nRookieArmorMode",   &g_nRookieArmorMode,     GOSVAR_INT, 0, NULL);
 	// [automaticmode] callbacks + g_bAutomaticMode variable for script visibility
 	gosScript_RegisterVariable("g_bAutomaticMode",     &g_bAutomaticMode,     GOSVAR_INT, 0, NULL);
 	gosScript_RegisterCallback("CTCL_LoadAutoFile",    &CTCL_LoadAutoFile,    GOSVAR_INT, 0, NULL);
 	gosScript_RegisterCallback("CTCL_GetAutoSlotName", &CTCL_GetAutoSlotName, GOSVAR_INT, 0, NULL);
 	gosScript_RegisterCallback("CTCL_GetAutoSlotMech", &CTCL_GetAutoSlotMech, GOSVAR_INT, 0, NULL);
 	gosScript_RegisterCallback("CTCL_GetAutoSlotInt",  &CTCL_GetAutoSlotInt,  GOSVAR_INT, 0, NULL);
 	{
 		NotationFile opts("options.ini", NotationFile::Standard, true);
 		Page *pAuto = opts.FindPage("automaticmode");
 		if (pAuto) {
 			pAuto->GetEntry("automaticmode", &g_bAutomaticMode);
 			const char *sz = NULL;
 			if (pAuto->GetEntry("automaticfile", &sz) && sz)
 				strncpy(g_szAutomaticFile, sz, sizeof(g_szAutomaticFile)-1);
 		}
 	}
 	// [automaticmode] game option variables (separate from Rookie globals)
 	gosScript_RegisterVariable("g_szAutoMission",     &g_pszAutoMission,      GOSVAR_STRING, 0, NULL);
 	gosScript_RegisterVariable("g_nAutoGameType",     &g_nAutoGameType,       GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nAutoVisibility",   &g_nAutoVisibility,     GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nAutoWeather",      &g_nAutoWeather,        GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nAutoTimeOfDay",    &g_nAutoTimeOfDay,      GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nAutoTimeLimit",    &g_nAutoTimeLimit,      GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nAutoRadar",        &g_nAutoRadar,          GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nAutoHeat",         &g_nAutoHeat,           GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nAutoFriendlyFire", &g_nAutoFriendlyFire,   GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nAutoSplash",       &g_nAutoSplash,         GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nAutoUnlimitedAmmo",&g_nAutoUnlimitedAmmo,  GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nAutoWeaponJam",    &g_nAutoWeaponJam,      GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nAutoAdvanceMode",  &g_nAutoAdvanceMode,    GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nAutoArmorMode",    &g_nAutoArmorMode,      GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nAutoTeamAllowed",  &g_nAutoTeamAllowed,    GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nAutoTeamCount",    &g_nAutoTeamCount,      GOSVAR_INT, 0, NULL);
 // MSL 5.06
 	gosScript_RegisterVariable("g_nMechVariant", &g_nMechVariant, GOSVAR_INT, 0, NULL);
 	gosScript_RegisterVariable("g_nMechLabOp", &g_nMechLabOp, GOSVAR_INT, 0, NULL);
@@ -1108,6 +1207,44 @@ void MW4Shell::ShutDown()
 // jcem - start
 	gosScript_UnregisterVariable("g_nTimeList_Value");
 	gosScript_UnregisterVariable("g_nTimeList_Index");
 	// [RookieMission] globals
 	gosScript_UnregisterVariable("g_szRookieMission");
 	gosScript_UnregisterVariable("g_nRookieGameType");
 	gosScript_UnregisterVariable("g_nRookieVisibility");
 	gosScript_UnregisterVariable("g_nRookieWeather");
 	gosScript_UnregisterVariable("g_nRookieTimeOfDay");
 	gosScript_UnregisterVariable("g_nRookieTimeLimit");
 	gosScript_UnregisterVariable("g_nRookieRadar");
 	gosScript_UnregisterVariable("g_nRookieHeat");
 	gosScript_UnregisterVariable("g_nRookieFriendlyFire");
 	gosScript_UnregisterVariable("g_nRookieSplash");
 	gosScript_UnregisterVariable("g_nRookieUnlimitedAmmo");
 	gosScript_UnregisterVariable("g_nRookieWeaponJam");
 	gosScript_UnregisterVariable("g_nRookieAdvanceMode");
 	gosScript_UnregisterVariable("g_nRookieArmorMode");
 	// [automaticmode] callbacks + variable
 	gosScript_UnregisterCallback("CTCL_GetAutoSlotInt");
 	gosScript_UnregisterCallback("CTCL_GetAutoSlotMech");
 	gosScript_UnregisterCallback("CTCL_GetAutoSlotName");
 	gosScript_UnregisterCallback("CTCL_LoadAutoFile");
 	gosScript_UnregisterVariable("g_bAutomaticMode");
 	// [automaticmode] game option variables
 	gosScript_UnregisterVariable("g_nAutoTeamCount");
 	gosScript_UnregisterVariable("g_nAutoTeamAllowed");
 	gosScript_UnregisterVariable("g_nAutoArmorMode");
 	gosScript_UnregisterVariable("g_nAutoAdvanceMode");
 	gosScript_UnregisterVariable("g_nAutoWeaponJam");
 	gosScript_UnregisterVariable("g_nAutoUnlimitedAmmo");
 	gosScript_UnregisterVariable("g_nAutoSplash");
 	gosScript_UnregisterVariable("g_nAutoFriendlyFire");
 	gosScript_UnregisterVariable("g_nAutoHeat");
 	gosScript_UnregisterVariable("g_nAutoRadar");
 	gosScript_UnregisterVariable("g_nAutoTimeLimit");
 	gosScript_UnregisterVariable("g_nAutoTimeOfDay");
 	gosScript_UnregisterVariable("g_nAutoWeather");
 	gosScript_UnregisterVariable("g_nAutoVisibility");
 	gosScript_UnregisterVariable("g_nAutoGameType");
 	gosScript_UnregisterVariable("g_szAutoMission");
 // MSL 5.06
 	gosScript_UnregisterVariable("g_nBlackMech");
 	gosScript_UnregisterVariable("g_nMechVariant");
@@ -1828,7 +1965,8 @@ int MW4Shell::SetNetworkMissionParamater(void * instance, int numParms, void **d
 		case PLAYER_LIMIT_PARAMETER:
 			params->m_playerLimit = INTPARM(1);
 			Min_Clamp(params->m_playerLimit, Network::GetInstance()->GetPlayerCount());
-			Environment.NetworkMaxPlayers = params->m_playerLimit;
+			// Add camera slots on top of the pilot limit so cameraships can still connect
 			Environment.NetworkMaxPlayers = params->m_playerLimit + (CTCL_GetTeslaCountAll() - CTCL_GetTeslaCount());
 			gos_NetServerCommands(gos_Commend_UpdateMaxPlayers,0);
 			break;
@@ -12731,6 +12869,143 @@ int __stdcall CTCL_SetCDSP(void* instance, int args, void* data[])
 {
    ASSERT(CTCL_IsConsole());
 	CTCL_DefaultHostSetup(1);
    // Read [RookieMission] section from options.ini and populate script globals.
    // Missing keys leave globals at their initialised defaults (backward-compatible).
    {
        NotationFile options_ini("options.ini", NotationFile::Standard, true);
        Page *page = options_ini.FindPage("RookieMission");
        if (page)
        {
            const char *sz = NULL;
            if (page->GetEntry("MissionName", &sz) && sz)
            {
                strncpy(g_szRookieMission, sz, sizeof(g_szRookieMission) - 1);
                g_szRookieMission[sizeof(g_szRookieMission) - 1] = '\0';
            }
            page->GetEntry("GameType",      &g_nRookieGameType);
            page->GetEntry("Visibility",    &g_nRookieVisibility);
            page->GetEntry("Weather",       &g_nRookieWeather);
            page->GetEntry("TimeOfDay",     &g_nRookieTimeOfDay);
            page->GetEntry("TimeLimit",     &g_nRookieTimeLimit);
            page->GetEntry("Radar",         &g_nRookieRadar);
            page->GetEntry("HeatOn",        &g_nRookieHeat);
            page->GetEntry("FriendlyFire",  &g_nRookieFriendlyFire);
            page->GetEntry("SplashDamage",  &g_nRookieSplash);
            page->GetEntry("UnlimitedAmmo", &g_nRookieUnlimitedAmmo);
            page->GetEntry("WeaponJam",     &g_nRookieWeaponJam);
            page->GetEntry("AdvanceMode",   &g_nRookieAdvanceMode);
            page->GetEntry("ArmorMode",     &g_nRookieArmorMode);
        }
    }
    return 0;
 }
 // [automaticmode] Load File button ? reads automatic file into Rookie Mission globals + per-slot data.
 // Returns 1 if the file was found and loaded, 0 otherwise. File is NOT consumed (stays on disk).
 int __stdcall CTCL_LoadAutoFile(void* instance, int args, void* data[])
 {
    if (!g_bAutomaticMode || !g_szAutomaticFile[0])
        return 0;
    if (GetFileAttributes(g_szAutomaticFile) == 0xFFFFFFFF)
        return 0;
    NotationFile autofile(g_szAutomaticFile, NotationFile::Standard, true);
    // Game options ? stored in dedicated Auto globals, NOT Rookie Mission globals,
    // so the Default button continues to use the original [RookieMission] defaults.
    g_szAutoMission[0] = '\0';
    g_nAutoGameType = 2; g_nAutoVisibility = 0; g_nAutoWeather = 0;
    g_nAutoTimeOfDay = 0; g_nAutoTimeLimit = -1; g_nAutoRadar = 0;
    g_nAutoHeat = 0; g_nAutoFriendlyFire = 0; g_nAutoSplash = 0;
    g_nAutoUnlimitedAmmo = 1; g_nAutoWeaponJam = 0; g_nAutoAdvanceMode = 0;
    g_nAutoArmorMode = 0; g_nAutoTeamAllowed = 0; g_nAutoTeamCount = 2;
    Page *pMission = autofile.FindPage("mission");
    if (pMission) {
        const char *sz = NULL;
        if (pMission->GetEntry("MissionName", &sz) && sz) {
            strncpy(g_szAutoMission, sz, sizeof(g_szAutoMission)-1);
            g_szAutoMission[sizeof(g_szAutoMission)-1] = '\0';
        }
        pMission->GetEntry("GameType",      &g_nAutoGameType);
        pMission->GetEntry("Visibility",    &g_nAutoVisibility);
        pMission->GetEntry("Weather",       &g_nAutoWeather);
        pMission->GetEntry("TimeOfDay",     &g_nAutoTimeOfDay);
        pMission->GetEntry("TimeLimit",     &g_nAutoTimeLimit);
        pMission->GetEntry("Radar",         &g_nAutoRadar);
        pMission->GetEntry("HeatOn",        &g_nAutoHeat);
        pMission->GetEntry("FriendlyFire",  &g_nAutoFriendlyFire);
        pMission->GetEntry("SplashDamage",  &g_nAutoSplash);
        pMission->GetEntry("UnlimitedAmmo", &g_nAutoUnlimitedAmmo);
        pMission->GetEntry("WeaponJam",     &g_nAutoWeaponJam);
        pMission->GetEntry("AdvanceMode",   &g_nAutoAdvanceMode);
        pMission->GetEntry("ArmorMode",     &g_nAutoArmorMode);
        pMission->GetEntry("TeamAllowed",   &g_nAutoTeamAllowed);
        pMission->GetEntry("TeamCount",     &g_nAutoTeamCount);
    }
    // Per-slot data (up to 16 slots via [slot0]..[slot15] pages)
    g_nAutoSlotsCount = 0;
    memset(g_aAutoSlots, 0, sizeof(g_aAutoSlots));
    char szPageName[16];
    for (int i = 0; i < 16; i++) {
        sprintf(szPageName, "slot%d", i);
        Page *pSlot = autofile.FindPage(szPageName);
        if (!pSlot) break;
        g_nAutoSlotsCount = i + 1;
        const char *sz = NULL;
        if (pSlot->GetEntry("PilotName", &sz) && sz)
            strncpy(g_aAutoSlots[i].szName, sz, sizeof(g_aAutoSlots[i].szName)-1);
        sz = NULL;
        if (pSlot->GetEntry("Mech", &sz) && sz)
            strncpy(g_aAutoSlots[i].szMech, sz, sizeof(g_aAutoSlots[i].szMech)-1);
        pSlot->GetEntry("Type",  &g_aAutoSlots[i].nType);
        pSlot->GetEntry("Team",  &g_aAutoSlots[i].nTeam);
        pSlot->GetEntry("Skin",  &g_aAutoSlots[i].nSkin);
        pSlot->GetEntry("Decal", &g_aAutoSlots[i].nDecal);
    }
    return 1;
 }
 // Returns pilot name string for slot k ? data[0]=string output buffer, data[1]=int k
 int __stdcall CTCL_GetAutoSlotName(void* instance, int args, void* data[])
 {
    int k = INTPARM(1);
    const char *sz = (k >= 0 && k < 16) ? g_aAutoSlots[k].szName : "";
    if (STRPARM(0)) gos_Free(STRPARM(0));
    STRPARM(0) = (char *)gos_Malloc(64);
    strncpy(STRPARM(0), sz, 63);
    STRPARM(0)[63] = '\0';
    return 1;
 }
 // Returns mech display name for slot k ? data[0]=string output buffer, data[1]=int k
 int __stdcall CTCL_GetAutoSlotMech(void* instance, int args, void* data[])
 {
    int k = INTPARM(1);
    const char *sz = (k >= 0 && k < 16) ? g_aAutoSlots[k].szMech : "";
    if (STRPARM(0)) gos_Free(STRPARM(0));
    STRPARM(0) = (char *)gos_Malloc(64);
    strncpy(STRPARM(0), sz, 63);
    STRPARM(0)[63] = '\0';
    return 1;
 }
 // Returns int field for slot k ? data[0]=int k, data[1]=int field (0=Type 1=Team 2=Skin 3=Decal)
 // field is passed as a script literal (0/1/2/3), so use VALUEPARM not INTPARM (literals are passed
 // as (void*)N directly, not as pointers; INTPARM would dereference NULL for field=0 and crash).
 int __stdcall CTCL_GetAutoSlotInt(void* instance, int args, void* data[])
 {
    int k     = INTPARM(0);
    int field = VALUEPARM(1);
    if (k < 0 || k >= 16) return 0;
    switch (field) {
        case 0: return g_aAutoSlots[k].nType;
        case 1: return g_aAutoSlots[k].nTeam;
        case 2: return g_aAutoSlots[k].nSkin;
        case 3: return g_aAutoSlots[k].nDecal;
    }
    return 0;
 }
@@ -13307,19 +13582,17 @@ void CTCL_API CTCL_DefaultHostSetup(int nMode)
    params->m_allowdecaltransfer = 0;
    if (g_bCOOP) {
      Environment.NetworkMaxPlayers = 16;
-      //if (CTCL_GetTeslaCount() < CTCL_GetTeslaCountAll()) {
+      // Reserve extra DirectPlay slots for camera seats (tracked separately from pilots in CTCL)
-          // any cameraship installed... so 1 more player can join
+      // Original commented-out intent preserved and now implemented for non-COOP below
          //params->m_maxPlayers = 9;
          //params->m_maxBots = 8;
      //} else {
          params->m_maxPlayers = 9;
          params->m_maxBots = 8;
      //}
    } else {
-    params->m_maxPlayers = 31;           // 31: max that fits in 5-bit bitstream (0-31)
+    params->m_maxPlayers = 16;
-    Environment.NetworkMaxPlayers = 31;
+    // Reserve extra DirectPlay slots for cameraships: they share the session but are tracked
-    params->m_maxBots = 31;
+    // separately from pilot seats in CTCL (CTCL_GetTeslaCountAll - CTCL_GetTeslaCount = camera count).
-    gos_NetServerCommands(gos_Commend_UpdateMaxPlayers, 0); // push the updated limit to the live DirectPlay session
+    // Without this, cameraship connection is rejected by DirectPlay because slot 17 doesn't exist.
    Environment.NetworkMaxPlayers = params->m_maxPlayers + (CTCL_GetTeslaCountAll() - CTCL_GetTeslaCount());
    params->m_maxBots = 16;
    }
    params->m_allow3rdPerson = 1;
    if ((nMode != 0) && (nMode != 4)) {
@@ -808,8 +808,8 @@ void NetMissionParameters::MWNetMissionParameters::SaveParameters(DynamicMemoryS
 	stream->WriteBits(&m_pureMapCycle,1);
-	stream->WriteBits(&m_maxPlayers, 5); // max 31 players
+	stream->WriteBits(&m_maxPlayers, 5); // 16 players maximum
-	stream->WriteBits(&m_maxBots, 5); // max 31
+	stream->WriteBits(&m_maxBots, 5); // 16 players maximum
 	stream->WriteBits(&m_mapID, 16); // 65535 maps available
 	stream->WriteBits(&m_mapClientCRC, 64);
@@ -927,8 +927,8 @@ void NetMissionParameters::MWNetMissionParameters::LoadParameters(MemoryStream *
 	stream->ReadBits(&m_useMapCycle,1);
 	stream->ReadBits(&m_pureMapCycle,1);
-	stream->ReadBits(&m_maxPlayers, 5); // max 31 players
+	stream->ReadBits(&m_maxPlayers, 5); // 16 players max
-	stream->ReadBits(&m_maxBots, 5); // max 31
+	stream->ReadBits(&m_maxBots, 5); // 16 players max
 	stream->ReadBits(&m_mapID, 16); // 65535 maps available
 	stream->ReadBits(&m_mapClientCRC, 64);
@@ -150,7 +150,7 @@ extern int g_nMech4Comm;
 // server & client only
 extern BOOL g_bIsServer;
 // console(All), server & client only(g_aPlayerInfos[0]), server only(g_aPlayerInfos[1..g_nBOTs]
-extern SPlayerInfo g_aPlayerInfos[35]; // 31 pilots + 1 CS + 3 spare
+extern SPlayerInfo g_aPlayerInfos[20];
 extern int g_nPlayerInfos;
 extern int g_nServer;
 extern int g_nTeslas;
@@ -885,7 +885,7 @@ void __stdcall GetGameOSEnvironment(char* CommandLine)
 	Environment.allowMultipleApps		= false;
 	Environment.AllowJoinInProgress		= true;
 	Environment.NetworkGame				= true;
-	Environment.NetworkMaxPlayers		= 31;  // max 31 (fits in 5-bit bitstream)
+	Environment.NetworkMaxPlayers		= 16;
 	Environment.NetworkGUID[0]			= 0x95;
 	Environment.NetworkGUID[1]			= 0x78;
 	Environment.NetworkGUID[2]			= 0xFF;
@@ -9,7 +9,7 @@
 #include "recscore.h"
 #endif // !defined(CTCLS_EXPORTS) && !defined(CTCL_LAUNCHER)
-#define MAX_TESLAS          31
+#define MAX_TESLAS          16
 #define MAX_CAMERAS         4
 #define PORT_Launcher       1000
@@ -263,7 +263,7 @@ CInviteCOOP g_InviteCOOP;
 // Mech4 only
 int g_nMech4Comm = 0;
 BOOL g_bIsServer = FALSE;
-SPlayerInfo g_aPlayerInfos[35]; // 31 pilots + 1 CS + 3 spare
+SPlayerInfo g_aPlayerInfos[20];
 int g_nPlayerInfos;
 int g_nServer;
 int g_nTeslas;
@@ -9,7 +9,7 @@
 #include "recscore.h"
 #endif // !defined(CTCLS_EXPORTS) && !defined(CTCL_LAUNCHER)
-#define MAX_TESLAS          31
+#define MAX_TESLAS          16
 #define MAX_CAMERAS         4
 #define PORT_Launcher       1000
@@ -263,7 +263,7 @@ CInviteCOOP g_InviteCOOP;
 // Mech4 only
 int g_nMech4Comm = 0;
 BOOL g_bIsServer = FALSE;
-SPlayerInfo g_aPlayerInfos[35]; // 31 pilots + 1 CS + 3 spare
+SPlayerInfo g_aPlayerInfos[20];
 int g_nPlayerInfos;
 int g_nServer;
 int g_nTeslas;
@@ -806,7 +806,7 @@ STRINGTABLE DISCARDABLE
 BEGIN
    IDS_ML_CH_ACCELERATION  "Acceleration (Meters/Sec.):"
    IDS_ML_CH_DECELERATION  "Deceleration (Meters/Sec.):"
-    IDS_ML_CH_TURNRATE      "Turn Rate (Degrees/Sec.):"
+    IDS_ML_CH_TURNRATE      "Turn Rate (Top Speed Rad/Sec):"
    IDS_ML_CH_TWISTRANGE    "Torso Twist Range (Degrees):"
    IDS_ML_CH_TWISTSPEED    "Torso Twist Speed (Degrees/Sec.):"
    IDS_ML_CH_NEWMECH       "NEW 'MECH"
@@ -86,7 +86,7 @@ void NetMissionParameters::AdeptNetMissionParameters::ResetParameters(void)
 {
 	m_runDedicated = 0;
 	m_closedGame = 0;
-	m_playerLimit = 31;  // max 31 (fits in 5-bit bitstream)
+	m_playerLimit = 16;
 	m_visibility = 0;
@@ -9,7 +9,7 @@
 #include "recscore.h"
 #endif // !defined(CTCLS_EXPORTS) && !defined(CTCL_LAUNCHER)
-#define MAX_TESLAS          31
+#define MAX_TESLAS          16
 #define MAX_CAMERAS         4
 #define PORT_Launcher       1000
@@ -263,7 +263,7 @@ CInviteCOOP g_InviteCOOP;
 // Mech4 only
 int g_nMech4Comm = 0;
 BOOL g_bIsServer = FALSE;
-SPlayerInfo g_aPlayerInfos[35]; // 31 pilots + 1 CS + 3 spare
+SPlayerInfo g_aPlayerInfos[20];
 int g_nPlayerInfos;
 int g_nServer;
 int g_nTeslas;
@@ -14,6 +14,9 @@
 // 10/10/03  MSL  Added Cameraship to RESET_AFTER_LAUNCH
 // 10/17/05  MSL  Added all remaining Mechs (55)
 // 06/19/18  AVB  Update tab stops
 // 06/24/26  Cyd  MechCorps is given access to this script and the loading method (-diskfirst). This includes the CS timer fix.
 // 06/27/26  MCHL MechCorps Highlight: Change Fab4 to Super6.
 // 07/19/26  RT   Bumped console title to V5.1.0b1
 //-------------------------------------------------------------------------
@@ -72,8 +75,8 @@
 #define USE_O_MORE_PODS		$$g_nMechPodNum$$ // 0 = use only 8
 #if USE_O_MORE_PODS
-#define MAX_ROSTER_COUNT        31 // max within 5-bit bitstream (0-31)
+#define MAX_ROSTER_COUNT        16 // Was 8
-#define MAX_TEAMMATE_COUNT      15 // Was 4, then 8
+#define MAX_TEAMMATE_COUNT      8 // Was 4
 #else
 #define MAX_ROSTER_COUNT        8
 #define MAX_TEAMMATE_COUNT      4 // Was 4
@@ -187,13 +190,17 @@
 #define MAIL_PREVIOUS_MISSION			-2222
 #define MAIL_RECORD_MISSION			-4444
 #define MAIL_PREVIOUS_MISSION_PARAMS		-5555
 #define MAIL_LOAD_AUTO_MISSION          -6666 // [automaticmode] sync with Multiplayer/ConLobbyMission.script
 // MSL 5.06
 // MSL ADD MECH
-#define ROOKIEMECH1 			38	//	Loki
+// MechCorps Highlight: expanded from Fab4 to Super6 (added Archer and Warhammer)
-#define ROOKIEMECH2 			40	//	Madcat
+#define ROOKIEMECH1 			1	//	Archer
-#define ROOKIEMECH3 			56	//	Thor
+#define ROOKIEMECH2 			38	//	Loki
-#define ROOKIEMECH4 			61	//	Vulture
+#define ROOKIEMECH3 			40	//	Madcat
 #define ROOKIEMECH4 			56	//	Thor
 #define ROOKIEMECH5 			61	//	Vulture
 #define ROOKIEMECH6 			62	//	Warhammer
 main
 {
@@ -246,7 +253,7 @@ main
 		o_frame.type			= 0
 		o_frame.location			= 0, 0, 100
 // MSL Version
-		o_frame.screen_name		= "BattleTech Console V5.0.7Df" // localize$(IDS_MP_LOBBY_GAME_LOBBY)
+		o_frame.screen_name		= "BattleTech Console V5.1.0b1" // localize$(IDS_MP_LOBBY_GAME_LOBBY)
 		initialize(o_frame)
 		int team_camo[16] // team_camo[selected team number] is skin number(0..36)...
@@ -364,7 +371,7 @@ main
 		cur_team_val = callback($$CTCL_GetTeamParams$$, cur_team_count[0])
 		int skin_id   ///////VERY IMPORTANT FOR NEW SKIN INTERFACE
-		int skin_ids[32]
+		int skin_ids[17]
 		int update_skin = false
 // MSL 5.05
 		int decal_id   ///////VERY IMPORTANT FOR NEW DECAL INTERFACE
@@ -522,7 +529,7 @@ main
 		///---------holds faction name for scroll list		
-		string faction_name[32]	
+		string faction_name[17]	
 		callback($$Shell_CallbackHandler$$, ShellInitMPScreen)
@@ -645,12 +652,12 @@ main
 		team_legal_to_join[8] = TRUE
 		int update_team = 0
-		int max_players = 31  // max within 5-bit bitstream
+		int max_players = 16
 		int player_num = 0
 	//	int num_of_teams = 8
 		int mech_id
-		int name_color[32]
+		int name_color[17]
 		int lupe
 		for lupe = 0; lupe < nRosterCount;lupe++
@@ -675,33 +682,33 @@ main
 		player_num = -1
 		// ComboBox for the Player Type
-		object o_BotList[32]
+		object o_BotList[17]
-		object o_BotList_bu[32]
+		object o_BotList_bu[17]
-		int m_naLastSelected[32]
+		int m_naLastSelected[17]
 		for x = 0; x < nRosterCount; x++
 		{
 			m_naLastSelected[x] = 0
 		}
-		object o_Editbox[32]
+		object o_Editbox[17]
-		object o_print_text[32]
+		object o_print_text[17]
-		object o_mech_variant[32]
+		object o_mech_variant[17]
-		object o_mech_variant_bu[32]
+		object o_mech_variant_bu[17]
 #if USE_O_MECH_VARIANT2
-		object o_mech_variant2[32]
+		object o_mech_variant2[17]
-		object o_mech_variant2_bu[32]
+		object o_mech_variant2_bu[17]
 #endif // USE_O_MECH_VARIANT2
-		object o_mech_rand[32]
+		object o_mech_rand[17]
-		object o_skins[32]
+		object o_skins[17]
-		object o_skins_bu[32]
+		object o_skins_bu[17]
 // MSL 5.05
-		object o_decal[32]
+		object o_decal[18]
-		object o_decal_bu[32]
+		object o_decal_bu[18]
-		object o_team[32]
+		object o_team[18]
-		object o_team_bu[32]
+		object o_team_bu[18]
-		object o_decal_box[32]
+		object o_decal_box[18]
-		object o_skin_box[32]
+		object o_skin_box[18]
-		object o_status[32]
+		object o_status[18]
-		int roster_posy[32]
+		int roster_posy[18]
 		int coolbaby
 		int stock_size = 0
@@ -1005,7 +1012,7 @@ main
 			o_decal[x].list_item[15] = "16"
 			o_decal[x].list_item[16] = "17"
-			for coolbaby = 17;coolbaby < o_decal[x].list_size;coolbaby++
+			for coolbaby = 17;coolbaby < o_decal[x].list_size+1;coolbaby++
 				o_decal[x].list_item[coolbaby] = conv$(coolbaby+1)
 			o_decal[x].nselected = 3
@@ -1072,7 +1079,7 @@ main
 			o_skins[x].list_item[14] = "15"
 			o_skins[x].list_item[15] = "16"
-			for coolbaby = 16;coolbaby < o_skins[x].list_size;coolbaby++
+			for coolbaby = 16;coolbaby < o_skins[x].list_size+1;coolbaby++
 				o_skins[x].list_item[coolbaby] = conv$(coolbaby+1)
 			o_skins[x].nselected = 3
@@ -1223,6 +1230,18 @@ main
            o_all_random_mech.state             	= 0 // initially enabled
 		initialize(o_all_random_mech)
 // [automaticmode] Load File button -- below Pick Cond., left of Reprint
 		object o_load_file				= s_multistatepane
 		o_load_file.total_states		= 3
 		o_load_file.textsize			= 1
 		o_load_file.text				= "Load File"
 		o_load_file.file				= WPATH "button_reg_138x23m_3state.tga"
 		o_load_file.location			= 467, 510, o_frame.location.z + 1
 		o_load_file.state				= 0 // initially enabled
 		initialize(o_load_file)
 		if ($$g_bAutomaticMode$$ != 1)
 			o_load_file.state = 3 // hide when automaticmode is not active
 // MSL Added default settings button
 		object o_default				= s_multistatepane
 		o_default.total_states			= 3
@@ -1658,6 +1677,119 @@ main
            mail(MAIL_RESET_AFTER_LAUNCH, this) // reset
            return
        }
 // [automaticmode] Load File button handler
    if (sender == o_load_file)
    {
        play press, 1
        if callback($$CTCL_LoadAutoFile$$)
        {
            // Apply game options using dedicated Auto globals.
            // Rookie Mission globals are NOT touched so the Default button keeps working.
            int m
            if exists(@ConLobbyMission@)
            {
                @ConLobbyMission@o_game_options[0].nselected = $$g_nAutoGameType$$
                for (m = 0; m < @ConLobbyMission@o_game_options[1].list_size; m++)
                {
                    if equal$(@ConLobbyMission@o_game_options[1].list_item[m], $$g_szAutoMission$$)
                    {
                        @ConLobbyMission@o_game_options[1].nselected = m
                        break
                    }
                }
                mail(MAIL_LOAD_AUTO_MISSION, @ConLobbyMission@)
            }
            // Update team state synchronously so slot display is correct on the first click.
            // MAIL_LOAD_AUTO_MISSION is async; setting team_allowed directly here lets
            // CTCL_GetTeamParams return the correct cur_team_val before the slot loop runs.
            callback($$SetNetworkMissionParamater$$, team_allowed, $$g_nAutoTeamAllowed$$)
            if $$g_nAutoTeamAllowed$$
                callback($$SetNetworkMissionParamater$$, num_of_teams, $$g_nAutoTeamCount$$)
            cur_team_val = callback($$CTCL_GetTeamParams$$, cur_team_count[0])
            // Clear all slots
            o_cam_list.nselected = 0
            for (k = 0; k < nRosterCount; k++)
            {
                if (1 <= o_BotList[k].nselected)
                {
                    if (o_BotList[k].nselected == 1) && (k < MAXTESLA_P)
                    {
                        o_Editbox[k].boxValue = ""
                        initialize(o_Editbox[k])
                        deactivate(o_Editbox[k])
                    }
                    o_BotList[k].nselected = 0
                    m_naLastSelected[k] = 0
                    if (ROSTER_top_of_list <= k) && (k < ROSTER_top_of_list + ROSTER_DISPLAY_COUNT)
                        mail(MAIL_PLAYER_TYPE_CHANGED, k, this)
                }
            }
            // Apply per-slot data from file
            string szAutoName
            string szAutoMech
            int nAutoType
            int j
            for (k = 0; k < nRosterCount; k++)
            {
                nAutoType = callback($$CTCL_GetAutoSlotInt$$, k, 0)
                if nAutoType > 0
                {
                    o_BotList[k].nselected = nAutoType
                    m_naLastSelected[k] = nAutoType
                    if (o_BotList[k].nselected > 0)
                        activate(o_BotList[k])
                    if (nAutoType == 1) && (k < MAXTESLA_P)
                    {
                        callback($$CTCL_GetAutoSlotName$$, szAutoName, k)
                        o_Editbox[k].boxValue = szAutoName
                        initialize(o_Editbox[k])
                        activate(o_Editbox[k])
                    }
                    callback($$CTCL_GetAutoSlotMech$$, szAutoMech, k)
                    if (!equal$(szAutoMech, ""))
                    {
 #if USE_ALLOWED_MECHS
                        // stock_array[j] = index in mech[] where chassis j lives (skips variant entries).
                        // mech[allowed_mechs[j]] would hit variant names; stock_array corrects this.
                        for (j = 0; j < MAX_ALLOWED_MECHS; j++)
                        {
                            if equal$(mech[stock_array[allowed_mechs[j]]], szAutoMech)
                            {
                                o_mech_variant[k].nselected = j
                                break
                            }
                        }
 #else
                        for (j = 0; j < $$m_mechCount$$; j++)
                        {
                            if equal$(mech[j], szAutoMech)
                            {
                                o_mech_variant[k].nselected = j
                                break
                            }
                        }
 #endif
                    }
                    // Always set both team and skin unconditionally.
                    // The game type may not have propagated to cur_team_val yet
                    // (MAIL_SET_ROOKIE_MISSION is async); setting both is safe --
                    // the launch code uses whichever is correct for the active mode.
                    o_team[k].nselected = callback($$CTCL_GetAutoSlotInt$$, k, 1)
                    o_skins[k].nselected = callback($$CTCL_GetAutoSlotInt$$, k, 2)
                    o_decal[k].nselected = callback($$CTCL_GetAutoSlotInt$$, k, 3)
                    initialize(o_mech_variant[k])
                    if (ROSTER_top_of_list <= k) && (k < ROSTER_top_of_list + ROSTER_DISPLAY_COUNT)
                    {
                        activate(o_mech_variant[k])
                        mail(MAIL_PLAYER_TYPE_CHANGED, k, this)
                    }
                    else
                        deactivate(o_mech_variant[k])
                }
            }
        }
        return
    }
        if (sender == o_reprint)
        {
            play press,1
@@ -1761,38 +1893,39 @@ main
 		        for (k = 0; k < nRosterCount; k++)
                {
 // MSL
 // MechCorps Highlight: Super6 slot assignments (16 slots, 6-mech cycle; Vulture+Warhammer appear twice)
 				if k == 0
-	                        o_mech_variant[k].nselected = ROOKIEMECH1 // Loki
+	                        o_mech_variant[k].nselected = ROOKIEMECH1 // Archer
 				if k == 1
-		                  o_mech_variant[k].nselected = ROOKIEMECH2 // Madcat
+		                  o_mech_variant[k].nselected = ROOKIEMECH2 // Loki
 				if k == 2
-	      	            o_mech_variant[k].nselected = ROOKIEMECH3 // Thor
+	      	            o_mech_variant[k].nselected = ROOKIEMECH3 // Madcat
 				if k == 3
-	            	      o_mech_variant[k].nselected = ROOKIEMECH4 // vulture
+	            	      o_mech_variant[k].nselected = ROOKIEMECH4 // Thor
 				if k == 4
-	                  	o_mech_variant[k].nselected = ROOKIEMECH1 // Loki
+	                  	o_mech_variant[k].nselected = ROOKIEMECH5 // Vulture
 				if k == 5
-		                  o_mech_variant[k].nselected = ROOKIEMECH2 // Madcat
+		                  o_mech_variant[k].nselected = ROOKIEMECH6 // Warhammer
 				if k == 6
-		                  o_mech_variant[k].nselected = ROOKIEMECH3 // Thor
+		                  o_mech_variant[k].nselected = ROOKIEMECH1 // Archer
 				if k == 7
-					o_mech_variant[k].nselected = ROOKIEMECH4 // Vulture
+					o_mech_variant[k].nselected = ROOKIEMECH2 // Loki
 				if k == 8
-	                        o_mech_variant[k].nselected = ROOKIEMECH1 // Loki
+	                        o_mech_variant[k].nselected = ROOKIEMECH3 // Madcat
 				if k == 9
-		                  o_mech_variant[k].nselected = ROOKIEMECH2 // Madcat
+		                  o_mech_variant[k].nselected = ROOKIEMECH4 // Thor
 				if k == 10
-	      	            o_mech_variant[k].nselected = ROOKIEMECH3 // Thor
+	      	            o_mech_variant[k].nselected = ROOKIEMECH5 // Vulture
 				if k == 11
-	            	      o_mech_variant[k].nselected = ROOKIEMECH4 // vulture
+	            	      o_mech_variant[k].nselected = ROOKIEMECH6 // Warhammer
 				if k == 12
-	                  	o_mech_variant[k].nselected = ROOKIEMECH1 // Loki
+	                  	o_mech_variant[k].nselected = ROOKIEMECH1 // Archer
 				if k == 13
-		                  o_mech_variant[k].nselected = ROOKIEMECH2 // Madcat
+		                  o_mech_variant[k].nselected = ROOKIEMECH2 // Loki
 				if k == 14
-		                  o_mech_variant[k].nselected = ROOKIEMECH3 // Thor
+		                  o_mech_variant[k].nselected = ROOKIEMECH3 // Madcat
 				if k == 15
-					o_mech_variant[k].nselected = ROOKIEMECH4 // Vulture
+					o_mech_variant[k].nselected = ROOKIEMECH4 // Thor
 #if USE_O_MECH_VARIANT2
                if (USE_ALLOWED_MECHS)
 				    last_count = stock_array[allowed_mechs[o_mech_variant[k].nselected]]
@@ -2714,7 +2847,8 @@ main
            }
        }
 // MSL 5.06
-        if nLaunchState == 0 && (nTempPlayerCount > 31)
+// RT 07/19/26: raised cap from 16 to 17 to allow 16 pilots + 1 cameraship
        if nLaunchState == 0 && (nTempPlayerCount > 17)
        {
            o_error_string.text = "Too many player/bots"
            nLaunchState = -7
@@ -4000,17 +4134,24 @@ mech_randomizer
 		else // right button
 		{
 			int pick_mech = 0
-			pick_mech = random(0, 3)
+			//pick_mech = random(0, 3) // Fab4
 // MechCorps Highlight: Super6 - expand right-click random range to 6
 			pick_mech = random(0, 5)
 // MSL
 // MechCorps Highlight: Super6 - added Archer (0) and Warhammer (5) to right-click mech pool
 			if pick_mech = 0
-				last_mech = ROOKIEMECH1 // Loki
+				last_mech = ROOKIEMECH1 // Archer
 			if pick_mech = 1
-				last_mech = ROOKIEMECH2 // Madcat
+				last_mech = ROOKIEMECH2 // Loki
 			if pick_mech = 2
-				last_mech = ROOKIEMECH3 // Thor
+				last_mech = ROOKIEMECH3 // Madcat
 			if pick_mech = 3
-				last_mech = ROOKIEMECH4 // vulture
+				last_mech = ROOKIEMECH4 // Thor
 			if pick_mech = 4
 				last_mech = ROOKIEMECH5 // Vulture
 			if pick_mech = 5
 				last_mech = ROOKIEMECH6 // Warhammer
 		}
            if (USE_ALLOWED_MECHS)
            {
@@ -52,6 +52,7 @@
 #define MAIL_PREVIOUS_MISSION			-2222
 #define MAIL_RECORD_MISSION			-4444
 #define MAIL_PREVIOUS_MISSION_PARAMS		-5555
 #define MAIL_LOAD_AUTO_MISSION          -6666 // [automaticmode] sync with ConLobby.script
 #define ROOKIE_MISSION          "ScarabStronghold - Attrition"
@@ -793,15 +794,15 @@ main
            if (getmessage() == MAIL_SET_ROOKIE_MISSION) // set rookie, see conlobby.script
            {
                // caution: actually 0 is not correct but who care? ^^
-                if (o_game_options[0].nselected != 2)
+                if (o_game_options[0].nselected != $$g_nRookieGameType$$)
                {
-                    o_game_options[0].nselected = 2
+                    o_game_options[0].nselected = $$g_nRookieGameType$$
                    mail(MAIL_SET_ROOKIE_MISSION, this)
                }
                // find mission: 
                for k = 0; k < o_game_options[1].list_size; k++
                {
-                    if equal$(o_game_options[1].list_item[k], ROOKIE_MISSION)
+                    if equal$(o_game_options[1].list_item[k], $$g_szRookieMission$$)
                    {
                        // found mission
                        break
@@ -830,6 +831,82 @@ main
                mail(MAIL_PREVIOUS_MISSION_PARAMS, this)
                return
            }
            // [automaticmode] Load File button: apply Auto globals, separate from Rookie Mission defaults
            if (getmessage() == MAIL_LOAD_AUTO_MISSION)
            {
                callback($$SetNetworkMissionParamater$$, game_type, selection_to_standard[$$g_nAutoGameType$$])
                // visibility
                o_game_options[2].nselected = $$g_nAutoVisibility$$
                callback($$SetNetworkMissionParamater$$, visibility, o_game_options[2].nselected)
                // weather
                o_game_options[3].nselected = $$g_nAutoWeather$$
                callback($$SetNetworkMissionParamater$$, weather, o_game_options[3].nselected)
                // time of day
                o_game_options[4].nselected = $$g_nAutoTimeOfDay$$
                callback($$SetNetworkMissionParamater$$, night_parameter, o_game_options[4].nselected)
                callback($$Shell_CallbackHandler$$, ShellSetTime, o_game_options[4].nselected)
                // time limit
                int nAutoTL = $$g_nAutoTimeLimit$$
                int temp_num
                if nAutoTL >= 0
                    temp_num = nAutoTL
                else
                    temp_num = TIME_VALUE_DEFAULT
                int m
                for (m = 0; m < o_game_options[5].list_size; m++)
                {
                    if (makeint(o_game_options[5].list_item[m]) == temp_num)
                    {
                        o_game_options[5].nselected = m
                        break
                    }
                }
                callback($$SetNetworkMissionParamater$$, time_limit, temp_num)
                // radar
                int nTempParam = radar
                int nTempValue = $$g_nAutoRadar$$
                o_game_options[6].nselected = nTempValue
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                // heat
                nTempParam = HEAT_PARAMETER
                nTempValue = $$g_nAutoHeat$$
                o_game_options[7].state = 0
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                // friendly fire
                nTempParam = FRIENDLY_FIRE_PERCENTGE_PARAMETER
                nTempValue = $$g_nAutoFriendlyFire$$
                o_game_options[8].state = 0
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                // splash
                nTempParam = SPLASH_ON_PARAMETER
                nTempValue = $$g_nAutoSplash$$
                o_game_options[9].state = 0
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                // unlimited ammo
                nTempParam = UNLIMITED_AMMO_PARAMETER
                nTempValue = $$g_nAutoUnlimitedAmmo$$
                o_game_options[10].state = 0
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                // weapon jam
                nTempParam = WEAPON_JAM_PARAMETER
                nTempValue = $$g_nAutoWeaponJam$$
                o_game_options[14].state = 0
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                // advance mode
                nTempParam = ADVANCE_MODE_PARAMETER
                nTempValue = $$g_nAutoAdvanceMode$$
                o_game_options[15].state = 0
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                // armor mode
                nTempParam = ARMOR_MODE_PARAMETER
                nTempValue = $$g_nAutoArmorMode$$
                o_game_options[16].state = 0
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                initialize(this)
                // notify ConLobby: game type/params changed (updates cur_game_type, cur_team_val display)
                mail(-9998, parent)
                return
            }
        }
        if (sender == this)
        {
@@ -855,24 +932,26 @@ main
 			else
 			{
      	          // visibility
-				o_game_options[2].nselected = 0 // Default
+				o_game_options[2].nselected = $$g_nRookieVisibility$$ // [RookieMission] ini
 				callback($$SetNetworkMissionParamater$$, visibility, o_game_options[2].nselected)
 	                // weather
-				o_game_options[3].nselected = 0 // off
+				o_game_options[3].nselected = $$g_nRookieWeather$$ // [RookieMission] ini
 				callback($$SetNetworkMissionParamater$$, weather, o_game_options[3].nselected)
      	          // time of day
-				o_game_options[4].nselected = 0
+				o_game_options[4].nselected = $$g_nRookieTimeOfDay$$ // [RookieMission] ini
 				callback($$SetNetworkMissionParamater$$, night_parameter, o_game_options[4].nselected)
 				callback($$Shell_CallbackHandler$$, ShellSetTime, o_game_options[4].nselected)
 			}
-
+                // time limit - use ini override if set, else TIME_VALUE_DEFAULT
-                // time limit
+                if $$g_nRookieTimeLimit$$ >= 0
                    temp_num = $$g_nRookieTimeLimit$$ // [RookieMission] ini
                else
                    temp_num = TIME_VALUE_DEFAULT
                for k = 0; k < o_game_options[5].list_size; k++
                {
-				    temp_num = makeint(o_game_options[5].list_item[k])
+				    if (makeint(o_game_options[5].list_item[k]) == temp_num)
                    if (temp_num == TIME_VALUE_DEFAULT)
                    {
                        o_game_options[5].nselected = k
                        break
@@ -935,31 +1014,31 @@ main
 		{
                // radar
                nTempParam = radar
-                nTempValue = 0 // Novice
+                nTempValue = $$g_nRookieRadar$$ // [RookieMission] ini (0=Novice)
 				o_game_options[6].nselected = nTempValue
 				callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                // heat management
 		        nTempParam = HEAT_PARAMETER
-                nTempValue = 0
+                nTempValue = $$g_nRookieHeat$$ // [RookieMission] ini
                o_game_options[7].state = 0
 		        callback($$SetNetworkMissionParamater$$,nTempParam, nTempValue)
                // friendly fire
 		        nTempParam = FRIENDLY_FIRE_PERCENTGE_PARAMETER
-                nTempValue = 0
+                nTempValue = $$g_nRookieFriendlyFire$$ // [RookieMission] ini
                o_game_options[8].state = 0
 		        callback($$SetNetworkMissionParamater$$,nTempParam, nTempValue)
                // splash
 		        nTempParam = SPLASH_ON_PARAMETER
-                nTempValue = 0
+                nTempValue = $$g_nRookieSplash$$ // [RookieMission] ini
                o_game_options[9].state = 0
 		        callback($$SetNetworkMissionParamater$$,nTempParam, nTempValue)
                // unlimited ammo
 		        nTempParam = UNLIMITED_AMMO_PARAMETER
-                nTempValue = 1 // be cautious
+                nTempValue = $$g_nRookieUnlimitedAmmo$$ // [RookieMission] ini
                o_game_options[10].state = 0
 		        callback($$SetNetworkMissionParamater$$,nTempParam, nTempValue)
@@ -975,7 +1054,7 @@ main
                // weapon jam
 		        nTempParam = WEAPON_JAM_PARAMETER
-                nTempValue = 0
+                nTempValue = $$g_nRookieWeaponJam$$ // [RookieMission] ini
                o_game_options[14].state = 0
 		        callback($$SetNetworkMissionParamater$$,nTempParam, nTempValue)
@@ -987,13 +1066,13 @@ main
                // advance mode
 		        nTempParam = ADVANCE_MODE_PARAMETER
-                nTempValue = 0
+                nTempValue = $$g_nRookieAdvanceMode$$ // [RookieMission] ini
                o_game_options[15].state = 0
 		        callback($$SetNetworkMissionParamater$$,nTempParam, nTempValue)
                // armor mode
 		        nTempParam = ARMOR_MODE_PARAMETER
-                nTempValue = 0
+                nTempValue = $$g_nRookieArmorMode$$ // [RookieMission] ini
                o_game_options[16].state = 0
 		        callback($$SetNetworkMissionParamater$$,nTempParam, nTempValue)
@@ -1005,6 +1084,81 @@ main
                return
            }
            if (getmessage() == MAIL_PREVIOUS_MISSION_PARAMS)
            {
                callback($$SetNetworkMissionParamater$$, game_type, selection_to_standard[$$g_nAutoGameType$$])
                // visibility
                o_game_options[2].nselected = $$g_nAutoVisibility$$
                callback($$SetNetworkMissionParamater$$, visibility, o_game_options[2].nselected)
                // weather
                o_game_options[3].nselected = $$g_nAutoWeather$$
                callback($$SetNetworkMissionParamater$$, weather, o_game_options[3].nselected)
                // time of day
                o_game_options[4].nselected = $$g_nAutoTimeOfDay$$
                callback($$SetNetworkMissionParamater$$, night_parameter, o_game_options[4].nselected)
                callback($$Shell_CallbackHandler$$, ShellSetTime, o_game_options[4].nselected)
                // time limit
                int nAutoTL = $$g_nAutoTimeLimit$$
                int temp_num
                if nAutoTL >= 0
                    temp_num = nAutoTL
                else
                    temp_num = TIME_VALUE_DEFAULT
                int m
                for (m = 0; m < o_game_options[5].list_size; m++)
                {
                    if (makeint(o_game_options[5].list_item[m]) == temp_num)
                    {
                        o_game_options[5].nselected = m
                        break
                    }
                }
                callback($$SetNetworkMissionParamater$$, time_limit, temp_num)
                // radar
                int nTempParam = radar
                int nTempValue = $$g_nAutoRadar$$
                o_game_options[6].nselected = nTempValue
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                // heat
                nTempParam = HEAT_PARAMETER
                nTempValue = $$g_nAutoHeat$$
                o_game_options[7].state = 0
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                // friendly fire
                nTempParam = FRIENDLY_FIRE_PERCENTGE_PARAMETER
                nTempValue = $$g_nAutoFriendlyFire$$
                o_game_options[8].state = 0
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                // splash
                nTempParam = SPLASH_ON_PARAMETER
                nTempValue = $$g_nAutoSplash$$
                o_game_options[9].state = 0
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                // unlimited ammo
                nTempParam = UNLIMITED_AMMO_PARAMETER
                nTempValue = $$g_nAutoUnlimitedAmmo$$
                o_game_options[10].state = 0
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                // weapon jam
                nTempParam = WEAPON_JAM_PARAMETER
                nTempValue = $$g_nAutoWeaponJam$$
                o_game_options[14].state = 0
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                // advance mode
                nTempParam = ADVANCE_MODE_PARAMETER
                nTempValue = $$g_nAutoAdvanceMode$$
                o_game_options[15].state = 0
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                // armor mode
                nTempParam = ARMOR_MODE_PARAMETER
                nTempValue = $$g_nAutoArmorMode$$
                o_game_options[16].state = 0
                callback($$SetNetworkMissionParamater$$, nTempParam, nTempValue)
                initialize(this)
                // notify ConLobby: game type/params changed (updates cur_game_type, cur_team_val display)
                mail(-9998, parent)
                return
            }
            if (getmessage() == MAIL_PREVIOUS_MISSION_PARAMS)
            {
                // visibility
 				o_game_options[2].nselected = game_options_2
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
dicion	06de4534da	BTFrstrm: add Load File test ini files (FFA Coliseum + 4-team KotH CentralPark)	2026-07-24 11:01:11 -05:00
dicion	23284b18b0	Fix MAIL_LOAD_AUTO_MISSION: move handler to sender==@conlobby@ block Handler was inside 'if (sender == this)' but MAIL_LOAD_AUTO_MISSION is sent from ConLobby (sender != this), so it never fired. All game params (FriendlyFire, SplashDamage, UnlimitedAmmo, WeaponJam, AdvanceMode, ArmorMode, etc.) were silently ignored on every Load File click. Fix: move the ~70-line handler to the 'if (sender == @conlobby@)' block, alongside MAIL_SET_ROOKIE_MISSION and MAIL_PREVIOUS_MISSION — where all ConLobby-originated mails are handled. No rebuild required (script only).	2026-07-24 10:56:57 -05:00
dicion	62dc0952b1	BTFrstrm: add Load File test configs (FFA Coliseum, Team KoH CentralPark)	2026-07-24 10:46:24 -05:00
dicion	9a9f2d0df2	autoconfig-file-spec.html: add TeamAllowed/TeamCount to example; fix caveat #3	2026-07-24 10:37:37 -05:00
dicion	cd2fe73c88	Fix Load File: separate Auto globals; fix team/FFA double-press Issue 1 — double press to fix team/FFA display: cur_team_val is updated by ConLobbyMission's -9998 signal which was async. Fix: call SetNetworkMissionParamater(team_allowed, ...) directly in ConLobby before the slot loop, then re-read cur_team_val via CTCL_GetTeamParams. This is synchronous so the slot display is correct on the first click. New file keys: TeamAllowed=0/1, TeamCount=2 (default 2 teams). Issue 2 — Default button broken after Load File click: CTCL_LoadAutoFile was overwriting g_nRookieGameType/g_szRookieMission etc. so the Default button loaded the last auto-file params instead of defaults. Fix: 14 new dedicated g_nAutoXxx/g_szAutoMission globals. CTCL_LoadAutoFile populates ONLY these. Rookie Mission globals are never touched. New MAIL_LOAD_AUTO_MISSION (-6666) sent to ConLobbyMission applies the Auto globals (mirrors MAIL_SET_ROOKIE_MISSION_PARAMS but uses g_nAutoXxx). ConLobby reads game type/mission from Auto globals directly into the ConLobbyMission dropdowns (@ConLobbyMission@o_game_options[N].nselected). Files changed: MW4Shell.cpp: 16 new globals, StartUp/ShutDown registration, CTCL_LoadAutoFile ConLobby.script: MAIL_LOAD_AUTO_MISSION define, updated handler ConLobbyMission.script: MAIL_LOAD_AUTO_MISSION define + handler autoconfig-file-spec.html: document TeamAllowed + TeamCount fields Rebuild required: MW4.exe (Release + Profile).	2026-07-24 10:35:11 -05:00
dicion	3f2d79a038	BTFrstrm: add weapon location spreadsheets (Special1/2 and rear-facing)	2026-07-24 10:18:06 -05:00
dicion	c3d82d78c9	Load File: hide button when automaticmode!=1; fix team/skin double-click 1. Expose g_bAutomaticMode as gosScript variable so ConLobby can check it at init time. o_load_file.state is set to 3 (disabled/hidden) if automaticmode != 1 in options.ini. Button is fully visible and active only when the feature is intentionally enabled. Rebuild required: MW4.exe (Release + Profile). 2. Remove cur_team_val conditional for team/skin slot assignment. Previously, only one of o_team[k] or o_skins[k] was set depending on cur_team_val at click time, but MAIL_SET_ROOKIE_MISSION propagates the new game type asynchronously -- cur_team_val would not reflect the file's GameType until the next frame, requiring a second click. Fix: always set both o_team[k] and o_skins[k] unconditionally. The mission launch code uses whichever is relevant for the active mode; the other is harmlessly ignored. No rebuild (script-only).	2026-07-24 10:08:21 -05:00
dicion	17ca966473	Fix Load File mech lookup: use stock_array to get chassis name mech[j] in the flat sorted array hits variant entries (e.g. 'Assassin2 A' sorts before 'AssassinII' alphabetically, pushing all subsequent chassis indices off by 1 or more). The script's stock_array[] maps each chassis index -> its actual position in the flat mech[] array, bypassing variant entries. Fix: mech[allowed_mechs[j]] -> mech[stock_array[allowed_mechs[j]]] Only stock (chassis) names are supported in Mech= field. Operators can adjust variants manually after Load File is clicked. No rebuild required (script-only change).	2026-07-24 10:02:13 -05:00
dicion	7852269dc7	Fix Load File crash: VALUEPARM for literal field arg in CTCL_GetAutoSlotInt Script calls callback(CTCL_GetAutoSlotInt, k, 0/1/2/3) where 0-3 are integer literals. The script engine passes literals as (void)N directly (not as pointers), so INTPARM(1) = ((int*)data[1]) dereferences NULL when field=0, producing the 'Attempt to read from NULL' STOP. Fix: VALUEPARM(1) = (int)data[1] reads the value without dereferencing. k (data[0]) remains INTPARM because it is a script variable (passed as a pointer to the variable's storage, not a literal). Also add exists(@ConLobbyMission@) guard before MAIL_SET_ROOKIE_MISSION for defensive safety if the sub-script is not running. Rebuild required: MW4.exe (Release + Profile).	2026-07-24 09:31:51 -05:00
dicion	76121f1c68	BTFrstrm: add autoconfig-file-spec.html (Load File format reference)	2026-07-24 09:13:37 -05:00
dicion	c33465611f	Add [automaticmode] Load File button to console lobby options.ini [automaticmode] section: automaticmode=1 automaticfile=c:\path\to\config.ini Right-click was considered then dropped in favor of a dedicated button at 467,510 (below Pick Cond., left of Reprint). C++ (MW4Shell.cpp): - SAutoFileSlot struct + g_aAutoSlots[16], g_bAutomaticMode, g_szAutomaticFile globals - [automaticmode] ini read at StartUp - CTCL_LoadAutoFile: checks file exists, reads [mission] page into existing g_nRookieXxx globals + [slot0]..[slot15] pages into g_aAutoSlots[]; returns 1 if loaded - CTCL_GetAutoSlotName(out_str, k): pilot name for slot k - CTCL_GetAutoSlotMech(out_str, k): mech display name for slot k - CTCL_GetAutoSlotInt(k, field): Type/Team/Skin/Decal for slot k (fields 0-3) - Register/unregister all 4 callbacks in StartUp/ShutDown Script (ConLobby.script): - o_load_file button at 467, 510 - Handler: CTCL_LoadAutoFile -> if loaded, sends MAIL_SET_ROOKIE_MISSION to ConLobbyMission (game options), clears all slots, then applies per-slot data in a loop (pilot names, mech by display-name lookup in allowed_mechs[], team, skin, decal). USE_ALLOWED_MECHS/non-ALLOWED_MECHS both handled via #if. File not consumed (stays on disk); external app overwrites for next load. Rebuild required: MW4.exe (Release + Profile).	2026-07-24 08:44:57 -05:00
dicion	fccdc2dee4	CLAUDE.md: document `5813aeb6` through `0344418a` work (2026-07-23) - hsh/ BMP canonical renames (MFD + Mechs, commit `5813aeb6`) - RookieMission configurable defaults via options.ini (MW4Shell.cpp + ConLobbyMission.script, `5813aeb6`) - Mechlab turn rate label correction (StringResource.rc, `5813aeb6`) - BTFrstrm design docs: MechDependencyTree.docx + Special_Zones.docx (`840bc96c`) - mech_loadouts.md: MechEditor data sources, field conversions, hsh naming reference (`0344418a`)	2026-07-23 22:18:43 -05:00
dicion	0344418aae	mech_loadouts.md: document MechEditor data sources, conversions, hsh naming (2026-07-23)	2026-07-23 21:56:14 -05:00
dicion	520a860414	Update testing checklist through 2026-07-23 (RookieMission, turnrate label, hsh renames)	2026-07-23 21:47:08 -05:00
dicion	5813aeb6e9	Fix missing asset files with ones from 5.0.7D	2026-07-23 21:36:27 -05:00
dicion	840bc96cc1	Documentation!	2026-07-23 16:16:45 -05:00
dicion	72e1e59d8e	CLAUDE.md: document `eaa5fd3` through 5.1.0b-in-progress work - MFD mode 4 right-device stagger fix (`eaa5fd3`): cycle diagram, files touched - Linux→Windows rsync workflow: sync-to-windows.sh (`55b9bfc5`) - ddraw.dll removed from repo; build-resources.ps1 moves it aside (`0ceba9c7`, `24825ff3`) - ConLobby V5.1.0b1 / Super6 6-mech rotation from Highlight (`c768f7c4`) - CRIOMAIN.CPP Korean translation + RIO poll timeout scaling; CRLF hazard note; min/max undeclared in VC6 in this TU (`16fca6c4`, `a712002f`) - 16 pilots + 1 cameraship: NetworkMaxPlayers formula, fall-through break warning (`f76dc05f`)	2026-07-19 19:55:46 -05:00
dicion	b591bae273	add checklist of changes for testing!	2026-07-19 19:18:09 -05:00
dicion	a712002fec	CRIOMAIN.CPP: fix min/max undeclared identifier (VC6) min() and max() are not in scope in this translation unit under VC6. Replace with explicit ternary clamping expression; no new headers needed.	2026-07-19 19:00:08 -05:00
dicion	f76dc05f46	Support 16 pilots + 1 cameraship in multiplayer MW4Shell.cpp: - CTCL_DefaultHostSetup (non-coop): replaced hardcoded Environment.NetworkMaxPlayers=16 with params->m_maxPlayers + (CTCL_GetTeslaCountAll() - CTCL_GetTeslaCount()) so DirectPlay reserves one extra slot per installed cameraship. CTCL_GetTeslaCountAll() - CTCL_GetTeslaCount() = camera-only seat count. - SetNetworkMissionParamater / PLAYER_LIMIT_PARAMETER: applied the same camera-slot formula when the host changes the player limit at runtime. Also restored the gos_NetServerCommands(gos_Commend_UpdateMaxPlayers) call (was accidentally dropped) and the missing break that caused fall-through into JOIN_IN_PROGRESS_PARAMETER. - COOP branch: no change (capped at 9+bots; camera seats not needed there). ConLobby.script: - Raised the launch-guard cap from nTempPlayerCount > 16 to > 17, allowing the 17th connection (the cameraship) to not trigger the 'Too many player/bots' error.	2026-07-19 18:54:38 -05:00
dicion	16fca6c4f1	CRIOMAIN.CPP: translate Korean comments to English, clean UTF-8 Translated all EUC-KR/CP949 Korean developer comments (~35 lines) to English. File re-saved as UTF-8 (was CP949/EUC-KR on disk). Also included: g_dwRIOPollTimeout formula that scales WaitForMultipleObjects timeout by baud rate: clamp(ceil(480000/baud), 5, 50) ms. Key translations: - Developer markers (sanghoon/hyun) - Packet receive loop comments - ACK/NAK handling comments - Thread/COM init comments - Button table comments - Joystick pedal/throttle diagram comments Decorative diamond markers (◆) stripped from case labels and section dividers. Unicode arrows (← →) in diagram comments replaced with ASCII.	2026-07-19 18:52:30 -05:00
dicion Claude Sonnet 4.6 GitHub Copilot	c768f7c46b	Bump console version to V5.1.0b1; merge Highlight Super6 changes Version bumped to V5.1.0b1 to align with the 5.1.0b-in-progress branch name and the goal of producing a tested release candidate. Incorporated manually-tested script changes from Buddy 'Highlight' Taylor of MechCorps (MCHL), who expanded the default mech pool from Fab4 to Super6: - ROOKIEMECH defines extended to 6 entries (added Archer ID=1, Warhammer ID=62) - 16-slot default mech assignments updated to cycle through all 6 Super6 mechs - Right-click mech randomizer expanded from random(0,3) to random(0,5) to include Archer and Warhammer in the pool Changelog entries for Cyd (06/24/26), MCHL (06/27/26), and RT (07/19/26) added to the script header. Co-authored-by: Claude Sonnet 4.6 (Anthropic) <noreply@anthropic.com> Co-authored-by: GitHub Copilot <copilot@github.com>	2026-07-19 17:19:08 -05:00
dicion	24825ff396	more ddraw handling fixes for profiler. ugh.	2026-07-19 16:41:45 -05:00
dicion	0ceba9c778	ddraw.dll breaking mw4pro windowed mode	2026-07-19 16:28:51 -05:00
dicion Claude Sonnet 4.6 GitHub Copilot	55b9bfc521	Add sync-to-windows.sh: rsync script for Linux→Windows build machine Syncs all source, content, toolchain, and assets needed to build and test the game on the Windows machine at /vwe/firestorm. Excludes generated build outputs (bin dirs, .mw4, .dep), .git/LFS, _UNUSED, and the MW4 deploy dir. Co-authored-by: Claude Sonnet 4.6 (Anthropic) <noreply@anthropic.com> Co-authored-by: GitHub Copilot <copilot@github.com>	2026-07-19 15:40:24 -05:00