feat: add IW4 Bot Warfare guide

astro.config.mjs

@@ -70,6 +70,10 @@ export default defineConfig({
               label: "IW3",
               items: ["guides/iw3/bot-warfare"],
             },
+            {
+              label: "IW4",
+              items: ["guides/iw4/bot-warfare"],
+            },
             {
               label: "T4",
               items: ["guides/t4/bot-warfare"],

src/content/docs/guides/codxe.mdx

@@ -115,6 +115,7 @@ After extracting the CoD Xe `.zip`, the folder should look similar to this:
 
 - codxe
   - iw3/
+  - iw4/
   - t4/
   - xenia
     - patches/

src/content/docs/guides/iw3/bot-warfare.mdx

@@ -9,6 +9,13 @@ Bot Warfare adds playable AI bots to Call of Duty 4 multiplayer.
 
 The original mod was created by [INeedGames](https://ineedbots.github.io). This port runs through the CoD Xe plugin.
 
+<LinkButton
+  href="https://github.com/codxenon/iw3-bot-warfare-xenon"
+  icon="github"
+>
+  View **IW3 Bot Warfare Xenon port** on GitHub
+</LinkButton>
+
 ## What You Need
 
 - A **genuine** copy of Call of Duty 4: Modern Warfare
@@ -48,24 +55,33 @@ Install CoD Xe first, then return to this guide:
 
 Call of Duty 4 must be running **TU4**.
 
-On Xbox 360, install and enable TU4 through your normal title update workflow.
+Download the TU4 file:
 
-In Xenia, press `File` > `Install Content...`, then install the IW3 TU4 file
-from the extracted CoD Xe release:
+<LinkButton
+  href="https://github.com/codxenon/xbox360-title-updates/raw/refs/heads/main/games/Call%20of%20Duty%204%20-%20Modern%20Warfare%20%28USA%2C%20Europe%29/TU4/TU_10LC1V6_0000004000000.0000000000101"
+  download
+  icon="download"
+>
+  Download **Call of Duty 4 TU4**
+</LinkButton>
 
-<FileTree>
+### Xbox 360
 
-- codxe
-  - iw3
-    - `Title Updates/`
-      - TU4/
-        - **TU_10LC1V6_0000004000000.0000000000101**
-    - ...
-  - ...
+Copy the downloaded TU4 file to `Hdd1/Cache/`:
 
-</FileTree>
+```text
+Hdd1/Cache/TU_10LC1V6_0000004000000.0000000000101
+```
+
+### Xenia
+
+Press `File` > `Install Content...`, then select the downloaded TU4 file:
+
+```text
+TU_10LC1V6_0000004000000.0000000000101
+```
 
-After TU4 is installed, boot `default_mp.xex` for multiplayer.
+After TU4 is installed, continue to the Bot Warfare install.
 
 ## Install Bot Warfare
 
@@ -102,7 +118,7 @@ When installed correctly, your folder should look like this:
 
 Start Call of Duty 4.
 
-If the mod loaded, you will see the `Active mod: bot_warfare` text in the top left:
+If the mod loaded, you will see the `Mod: bot_warfare` text in the top left:
 
 ![Bot Warfare active mod](../../../../assets/botwarfare/botwarfare_active_mod.webp)
 

src/content/docs/guides/iw4/bot-warfare.mdx

@@ -0,0 +1,202 @@
+---
+title: "IW4 Bot Warfare"
+description: Install Bot Warfare for Modern Warfare 2 on Xbox 360 or Xenia.
+---
+
+import { LinkButton, FileTree, Aside } from "@astrojs/starlight/components";
+
+Bot Warfare adds playable AI bots to Call of Duty: Modern Warfare 2 multiplayer.
+
+The original mod was created by [INeedGames](https://ineedbots.github.io). This port runs through the CoD Xe plugin.
+
+<LinkButton
+  href="https://github.com/codxenon/iw4-bot-warfare-xenon"
+  icon="github"
+>
+  View **IW4 Bot Warfare Xenon port** on GitHub
+</LinkButton>
+
+## What You Need
+
+- A **genuine** copy of Call of Duty: Modern Warfare 2
+- The game extracted to a normal folder
+- The Call of Duty: Modern Warfare 2 title update used by this guide: **TU6**
+- One of these setups:
+  - An Xbox 360 that can run unsigned code: **XDK**, **RGH**, **JTAG**, or **BadUpdate**
+  - **Xenia Canary Netplay** on Windows
+
+<Aside type="caution" title="Supported region">
+  Use the **USA / Europe** region of Call of Duty: Modern Warfare 2. Other
+  regions are not supported.
+</Aside>
+
+<Aside type="caution" title="Supported title update">
+  IW4 Bot Warfare currently requires **TU6**. Other title updates are not
+  supported by this guide.
+</Aside>
+
+## Prepare The Game
+
+Extract Call of Duty: Modern Warfare 2 to a normal folder.
+
+Do not use:
+
+- GOD / Games on Demand format
+- ISO format
+
+Your game folder should contain the normal game files, such as `default_mp.xex`.
+
+## Install CoD Xe
+
+CoD Xe is required. Bot Warfare will not load without it.
+
+Install CoD Xe first, then return to this guide:
+
+<LinkButton href="/guides/codxe/" icon="right-arrow">
+  Install **CoD Xe**
+</LinkButton>
+
+## Install TU6
+
+Call of Duty: Modern Warfare 2 must be running **TU6**.
+
+<Aside type="caution" title="Remove TU9 first">
+  If the **TU9** file, the latest Modern Warfare 2 update, is still installed,
+  Xbox 360 or Xenia will prefer TU9 over TU6. Delete TU9 before installing TU6.
+
+On Xbox 360, the TU9 file is stored at
+`Hdd1/Cache/TU_10LC20N_0000018000000.000000000028A`.
+
+</Aside>
+
+Download the TU6 file:
+
+<LinkButton
+  href="https://github.com/codxenon/xbox360-title-updates/raw/refs/heads/main/games/Call%20of%20Duty%20-%20Modern%20Warfare%202%20%28USA%2C%20Europe%29/TU6/TU_10LC20N_0000018000000.00000000001GA"
+  download
+  icon="download"
+>
+  Download **Modern Warfare 2 TU6**
+</LinkButton>
+
+### Xbox 360
+
+Copy the downloaded TU6 file to `Hdd1/Cache/`:
+
+```text
+Hdd1/Cache/TU_10LC20N_0000018000000.00000000001GA
+```
+
+### Xenia
+
+Press `File` > `Install Content...`, then select the downloaded TU6 file:
+
+```text
+TU_10LC20N_0000018000000.00000000001GA
+```
+
+After TU6 is installed, continue to the Bot Warfare install.
+
+## Install Bot Warfare
+
+Download the latest IW4 Bot Warfare release:
+
+<LinkButton
+  href="https://github.com/codxenon/iw4-bot-warfare-xenon/releases/download/v2.3.0-xenon/iw4bw-2.3.0-xenon.zip"
+  download
+  icon="download"
+>
+  Download **IW4 Bot Warfare**
+</LinkButton>
+
+Extract the contents of the `.zip` into your Call of Duty: Modern Warfare 2
+game folder.
+
+When installed correctly, your folder should look like this:
+
+<FileTree>
+
+- `Call of Duty - Modern Warfare 2`
+  - \_codxe
+    - codxe.json
+    - mods
+      - bot_warfare
+        - maps/
+        - scriptdata/
+        - scripts/
+  - default_mp.xex
+  - ...
+
+</FileTree>
+
+## Using Bot Warfare
+
+Start Call of Duty: Modern Warfare 2 multiplayer.
+
+If the mod loaded, you will see the `Mod: bot_warfare` text in the top left.
+
+![Bot Warfare active mod](../../../../assets/iw4_botwarfare/iw4_botwarfare_active_mod.webp)
+
+Load a System Link or private match game, then open the Bot Warfare menu with
+the Action Slot 2 button.
+
+### Bot Limits
+
+<Aside type="caution" title="Xbox 360 bot limit">
+  Use **7 or 8 bots** for the best results. Higher bot counts can cause lag on
+  Xbox 360.
+</Aside>
+
+<Aside type="note" title="Xenia bot limit">
+  Xenia can handle higher bot counts than Xbox 360, depending on the map and
+  your PC. Start lower and increase the count if performance stays stable.
+</Aside>
+
+### In-Game Menu
+
+Use the in-game menu to add bots, change bot difficulty, and adjust bot
+settings.
+
+![Bot Warfare ingame menu](../../../../assets/iw4_botwarfare/iw4_botwarfare_ingame_menu.webp)
+
+Navigate the menu with movement controls, then select options with jump. Press
+the menu button again to close it.
+
+### Rename Bots
+
+Bot names are stored in `botnames.txt`.
+
+Open the file and add one bot name per line:
+
+<FileTree>
+
+- `Call of Duty - Modern Warfare 2`
+  - \_codxe
+    - mods
+      - bot_warfare
+        - scriptdata
+          - **botnames.txt**
+  - ...
+
+</FileTree>
+
+### Unlock Stats
+
+IW4 can save multiplayer progression in Splitscreen and System Link. If you
+only want to build custom classes for offline matches, use the console command
+`unlockstats` instead of manually leveling the profile.
+
+Open the CoD Xe in-game console, type:
+
+```text
+unlockstats
+```
+
+Then submit the command.
+
+![unlockstats command](../../../../assets/iw4_botwarfare/iw4_unlockstats_command.webp)
+
+After the command runs, check Barracks. The profile should be level 70, with
+create-a-class weapons and options available for offline play.
+
+![unlockstats result in Barracks](../../../../assets/iw4_botwarfare/iw4_barracks_unlockstats_result.webp)

src/content/docs/guides/t4/bot-warfare.mdx

@@ -7,7 +7,14 @@ import { LinkButton, FileTree, Aside } from "@astrojs/starlight/components";
 
 Bot Warfare adds playable AI bots to Call of Duty: World at War multiplayer.
 
-The original mod was created by [INeedGames](https://ineedbots.github.io). This guide uses CoD Xe to run it on Xbox 360 or Xenia.
+The original mod was created by [INeedGames](https://ineedbots.github.io). This port runs through the CoD Xe plugin.
+
+<LinkButton
+  href="https://github.com/codxenon/t4-bot-warfare-xenon"
+  icon="github"
+>
+  View **T4 Bot Warfare Xenon port** on GitHub
+</LinkButton>
 
 ## What You Need
 
@@ -53,24 +60,33 @@ Install CoD Xe first, then return to this guide:
 
 Call of Duty: World at War must be running **TU7**.
 
-On Xbox 360, install and enable TU7 through your normal title update workflow.
+Download the TU7 file:
 
-In Xenia, press `File` > `Install Content...`, then install the T4 TU7 file from
-the extracted CoD Xe release:
+<LinkButton
+  href="https://github.com/codxenon/xbox360-title-updates/raw/refs/heads/main/games/Call%20of%20Duty%20-%20World%20at%20War%20%28USA%2C%20Europe%29/TU7/TU_10LC20S_0000010000000.00000000001O8"
+  download
+  icon="download"
+>
+  Download **World at War TU7**
+</LinkButton>
 
-<FileTree>
+### Xbox 360
 
-- codxe
-  - t4
-    - `Title Updates/`
-      - TU7/
-        - **TU_10LC20S_0000010000000.00000000001O8**
-    - ...
-  - ...
+Copy the downloaded TU7 file to `Hdd1/Cache/`:
 
-</FileTree>
+```text
+Hdd1/Cache/TU_10LC20S_0000010000000.00000000001O8
+```
+
+### Xenia
+
+Press `File` > `Install Content...`, then select the downloaded TU7 file:
+
+```text
+TU_10LC20S_0000010000000.00000000001O8
+```
 
-After TU7 is installed, boot `default_mp.xex` for multiplayer.
+After TU7 is installed, continue to the Bot Warfare install.
 
 ## Install Bot Warfare
 
@@ -108,7 +124,7 @@ When installed correctly, your folder should look like this:
 
 Start Call of Duty: World at War multiplayer.
 
-If the mod loaded, you will see the `Active mod: bot_warfare` text in the top left:
+If the mod loaded, you will see the `Mod: bot_warfare` text in the top left:
 
 ![Bot Warfare active mod](../../../../assets/t4_botwarfare/t4_botwarfare_active_mod.webp)