docs: IW3 mods and custom maps

astro.config.mjs

@@ -102,7 +102,13 @@ export default defineConfig({
           items: [
             {
               label: "Call of Duty 4 (IW3)",
-              items: [{ label: "Bot Warfare", slug: "guides/iw3/bot-warfare" }],
+              items: [
+                { label: "Bot Warfare", slug: "guides/iw3/bot-warfare" },
+                {
+                  label: "Custom Maps & Fastfiles",
+                  slug: "guides/iw3/fastfiles",
+                },
+              ],
             },
             {
               label: "Modern Warfare 2 (IW4)",

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

@@ -74,7 +74,6 @@ When installed correctly, your folder should look like this:
 
 - `Call of Duty 4 - Modern Warfare`
   - \_codxe
-    - codxe.json
     - mods
       - bot_warfare
         - maps/
@@ -85,13 +84,40 @@ When installed correctly, your folder should look like this:
 
 </FileTree>
 
+## Required IW3 Fastfiles
+
+Install the [Call of Duty 4 Custom Maps & Fastfiles](/guides/iw3/fastfiles/)
+package before playing. Its fastfiles are required by CoD Xe; the custom maps
+included in the package are optional.
+
+## Select Bot Warfare
+
+CoD Xe automatically lists mod folders in `_codxe/mods` in the native **Mods**
+menu. You do not need to edit `codxe.json` to choose an active mod.
+
+1. Start Call of Duty 4 and select **Mods** from the main menu.
+
+![Call of Duty 4 main menu with Mods selected](../../../../assets/iw3_botwarfare/main-menu-mods.webp)
+
+2. Select **bot_warfare** from the list.
+
+![Mods menu with bot_warfare selected](../../../../assets/iw3_botwarfare/mods-menu-bot-warfare.webp)
+
+After you select it, the game returns to the main menu. The top left shows
+`Mod: bot_warfare` when Bot Warfare is active.
+
+![Call of Duty 4 main menu with Bot Warfare active](../../../../assets/iw3_botwarfare/bot-warfare-active.webp)
+
 ## Using Bot Warfare
 
-Start Call of Duty 4.
+Start a System Link or private match.
+
+### Offline Create a Class
 
-If the mod loaded, you will see the `Mod: bot_warfare` text in the top left:
+CoD Xe enables **Create a Class** in **System Link** and **Split Screen**, so
+you can customise your loadouts completely offline.
 
-![Bot Warfare active mod](../../../../assets/botwarfare/botwarfare_active_mod.webp)
+![System Link setup screen with Create a Class](../../../../assets/iw3_botwarfare/system-link-create-a-class.webp)
 
 ### In-Game Menu
 

src/content/docs/guides/iw3/fastfiles.mdx

@@ -0,0 +1,139 @@
+---
+title: "Call of Duty 4 Custom Maps & Fastfiles"
+description: Install CoD Xe fastfiles and custom maps for Call of Duty 4.
+head:
+  - tag: meta
+    attrs:
+      property: og:image
+      content: https://codxenon.dev/og/iw3-fastfiles-mp_firingrange.webp
+  - tag: meta
+    attrs:
+      property: og:image:type
+      content: image/webp
+  - tag: meta
+    attrs:
+      property: og:image:width
+      content: "2560"
+  - tag: meta
+    attrs:
+      property: og:image:height
+      content: "1440"
+  - tag: meta
+    attrs:
+      property: og:image:alt
+      content: The mp_firingrange custom map running in Call of Duty 4 through CoD Xe
+  - tag: meta
+    attrs:
+      name: twitter:card
+      content: summary_large_image
+  - tag: meta
+    attrs:
+      name: twitter:image
+      content: https://codxenon.dev/og/iw3-fastfiles-mp_firingrange.webp
+  - tag: meta
+    attrs:
+      name: twitter:image:alt
+      content: The mp_firingrange custom map running in Call of Duty 4 through CoD Xe
+---
+
+import {
+  Aside,
+  CardGrid,
+  FileTree,
+  LinkButton,
+  LinkCard,
+} from "@astrojs/starlight/components";
+
+This package contains the CoD Xe fastfiles needed for Call of Duty 4, together
+with a collection of custom maps. Keeping them in one download makes
+sure the fastfiles and maps stay compatible.
+
+![The mp_firingrange custom map running in Call of Duty 4 through CoD Xe](/og/iw3-fastfiles-mp_firingrange.webp)
+
+## What You Need
+
+- A **genuine USA / Europe copy** of Call of Duty 4: Modern Warfare
+- Call of Duty 4 **TU4**
+- The latest **CoD Xe** plugin
+
+Install CoD Xe before continuing:
+
+<CardGrid>
+  <LinkCard
+    title="Xbox 360"
+    href="/guides/codxe/xbox-360/"
+    description="Install CoD Xe on an Xbox 360."
+  />
+  <LinkCard
+    title="Xenia"
+    href="/guides/codxe/xenia/"
+    description="Install CoD Xe on Xenia Canary."
+  />
+</CardGrid>
+
+## Download and Install
+
+<LinkButton
+  href="https://downloads.codxenon.dev/codxe-iw3-fastfiles-v0.1.0.zip"
+  download
+  icon="download"
+>
+  Download **CoD Xe IW3 Fastfiles v0.1.0**
+</LinkButton>
+
+1. Extract the `.zip`.
+2. Open the extracted `codxe-iw3-fastfiles-v0.1.0` folder.
+3. Copy its `_codxe` folder into your Call of Duty 4 game folder and allow it
+   to merge with your existing `_codxe` folder.
+
+Do **not** delete or replace your existing `_codxe` folder.
+
+When installed correctly, the relevant files should look like this:
+
+<FileTree>
+
+- `Call of Duty 4 - Modern Warfare`
+  - \_codxe
+    - zone
+      - **codxe_common_mp.ff**
+      - **codxe_ui_mp.ff**
+    - usermaps
+      - mp_4nuketown
+        - mp_4nuketown.ff
+        - mp_4nuketown_load.ff
+      - mp_mw2_rust
+        - mp_mw2_rust.ff
+        - mp_mw2_rust_load.ff
+      - ...
+  - default_mp.xex
+  - ...
+
+</FileTree>
+
+## Required Fastfiles and Optional Maps
+
+The fastfiles in `_codxe/zone` are required for CoD Xe on Call of Duty 4. Keep
+`codxe_common_mp.ff` and `codxe_ui_mp.ff` installed, even if you do not want to
+play custom maps.
+
+The maps in `_codxe/usermaps` are optional. You can leave them installed to
+play them, or remove individual map folders later if you need the storage.
+
+## Use Custom Maps
+
+CoD Xe automatically adds maps in `_codxe/usermaps` to the map picker. The
+**Custom Maps** list updates when map folders are added or removed.
+
+1. When choosing a map for a System Link or private match, select
+   **Custom Maps**.
+
+![Choose Map menu with Custom Maps selected](../../../../assets/iw3_fastfiles/custom-maps-menu.webp)
+
+2. Select a map from the scrollable list.
+
+![Scrollable Custom Maps list](../../../../assets/iw3_fastfiles/custom-maps-list.webp)
+
+## Next Step
+
+Install [IW3 Bot Warfare](/guides/iw3/bot-warfare/) to add bots to Call of Duty
+4 multiplayer.

src/content/docs/reference/supported-games.mdx

@@ -43,6 +43,7 @@ listed 007: Quantum of Solace release includes English and French.
 ## Published Game Guides
 
 - [Call of Duty 4 Bot Warfare](/guides/iw3/bot-warfare/)
+- [Call of Duty 4 Custom Maps & Fastfiles](/guides/iw3/fastfiles/)
 - [Modern Warfare 2 Bot Warfare](/guides/iw4/bot-warfare/)
 - [Modern Warfare 2 Fastfiles](/guides/iw4/fastfiles/)
 - [World at War Bot Warfare](/guides/t4/bot-warfare/)