Installation

This guide provides a comprehensive, step-by-step process for installing the TF2 Dodgeball core plugin and its optional modules on your SourceMod server.

Prerequisites

Before you begin, ensure you have the following:

• A working Team Fortress 2 server.
• SourceMod 1.10 or newer installed.

---

Step 1: Download the Latest Release

First, you need to download the main package which contains all the necessary files.

1. Go to the Releases Page on GitHub.
2. Download the .zip file from the latest release (e.g., TF2-Dodgeball-Modified-vX.X.X.zip).
3. Extract the contents of the .zip file to a folder on your computer.

---

Step 2: Install the Core Plugin

The core plugin is required for the gamemode to function.

1. Inside the extracted folder, you will find a directory named TF2Dodgeball. Open it.
2. You will see an addons folder. Copy this entire addons folder.
3. Navigate to your server's main directory (usually .../steamapps/common/Team Fortress 2 Dedicated Server/tf/).
4. Paste the addons folder into your tf/ directory. Your system will ask if you want to merge the folders. Click Yes.

This will automatically place the following files in their correct locations:

• plugins/TF2Dodgeball.smx (The main plugin)
• scripting/TF2Dodgeball.sp (The source code)
• scripting/include/tfdb.inc (The developer API)
• configs/dodgeball/general.cfg (The main configuration file)
• translations/tfdb.phrases.txt (The chat messages file)

---

Step 3: Install Optional Modules

Modules are extra plugins that add features like an admin menu, custom trails, or a speed HUD. Install only the ones you want.

1. Go back to the folder you extracted from the .zip file and open the Subplugins directory.
2. Inside, you will find folders for each module (e.g., Menu, Trails, Speedometer).
3. Open the folder for a module you want to install.
4. Copy the .smx file (e.g., TF2DodgeballMenu.smx) from inside that folder.
5. Paste the .smx file into your server's tf/addons/sourcemod/plugins/ directory.
6. Repeat this process for every module you wish to install.

---

Step 4: Install Dependencies

Some modules require extra extensions to function.

• CollisionHook (Required for the Anti Snipe Module only)
  1. Download collisionhook.smx from the AlliedModders thread.
  2. Place the collisionhook.smx file in your server's tf/addons/sourcemod/extensions/ directory.

---

Step 5: Finalize and Restart

After all files are in place:

1. Restart your server completely or change the map to load the new plugins.
2. The Dodgeball gamemode will automatically activate on any map that has the tfdb_ prefix (e.g., tfdb_arena_well).

Your installation is now complete! You can now proceed to the Configuration Guide to customize your gamemode.