Team Swap Plugin

Version: 1.0

Author: illusionLabs.dev

Game: Counter-Strike 1.6

📋 Description

Team Swap is a Counter-Strike 1.6 plugin that allows players to exchange teams (Terrorists ↔ Counter-Terrorists) through mutual consent. The plugin includes a request system, cooldown timer, and full administrative control.

✨ Features

🎮 For Players

1. Team swap requests - Send requests to players from the opposing team
2. Interactive menu - Color-coded menu for player selection
3. Confirmation system - Target player must accept the request
4. Cooldown system - Prevents spam and abuse
5. Visual indicators - Colored messages and team indicators

👮 For Administrators

1. Force swap - Command to directly swap teams between two players
2. Bypass privileges - Bypass cooldown and dead player requirements
3. Configurable flag - Set required admin flag
4. Logging - All admin actions are logged

🎯 Commands

Players

Command Description

say /swapOpens menu to select a player for team swapsay_team /swapSame as above, but in team chat

Administrators

Command Description Flag

amx_swap <player1> <player2>Force swap teams of two playersADMIN_LEVEL_A

⚙️ Cvars (Configuration)

All settings are managed through cvars and can be changed in real-time:

Main Settings

// Enable/disable the pluginteamswap_enabled "1"// 0 = disabled// 1 = enabled (default)
// Cooldown timer in secondsteamswap_cooldown "300"// Default: 300 seconds (5 minutes)// Can be changed to any value
// Require players to be deadteamswap_require_dead "1"// 0 = alive players can swap teams// 1 = players must be dead (default)
// Show public messagesteamswap_show_messages "1"// 0 = hide team swap messages// 1 = show public messages (default)

Customization Settings

// Chat and menu prefixteamswap_prefix "[Team Swap]"// Default: "[Team Swap]"// Can be changed to any text, e.g., "[TS]", "[Swap]", "Team Swap"// This prefix appears in all chat messages and menu titles

Admin Settings

// Admin flag for bypass privilegesteamswap_admin_flag "b"// Default: "b" (reservation)// Can be changed to: "a", "c", "d", etc.
// Admins bypass cooldownteamswap_admin_bypass_cooldown "1"// 0 = admins follow cooldown rules// 1 = admins bypass cooldown (default)
// Admins bypass dead player requirementteamswap_admin_bypass_dead "1"// 0 = admins must be dead// 1 = admins can swap while alive (default)

📦 Installation

Requirements

1. AMX Mod X 1.8.2 or newer
2. Counter-Strike 1.6

Dependencies

#include <amxmodx>#include <amxmisc>#include <cstrike>

Installation Steps

1. Compile the plugin:
2. Place TeamSwap.sma in addons/amxmodx/scripting/
3. Compile with amxxpc TeamSwap.sma
4. Install the .amxx file:
5. Copy TeamSwap.amxx to addons/amxmodx/plugins/
6. Activate the plugin:
7. Add TeamSwap.amxx to addons/amxmodx/configs/plugins.ini
8. Configure settings:
9. Add cvars to addons/amxmodx/configs/amxx.cfg or create a separate config file
10. Restart the server or change the map

🎨 How It Works

For Players

1. Starting a request:
2. Player types /swap in chat
3. A menu opens with players from the opposing team
4. Players are color-coded: 🔴 Terrorists, 🔵 Counter-Terrorists
5. Selecting a player:
6. Player selects who they want to swap teams with
7. Request is sent to the selected player
8. Cooldown timer is activated
9. Confirmation:
10. Target player receives a menu with "Yes" / "No" options
11. On "Yes" - teams are swapped immediately
12. On "No" - request is declined
13. Cooldown:
14. After sending a request, cooldown is activated
15. Player sees remaining time in MM:SS format
16. Cooldown applies to both players after successful swap

For Administrators

1. Force swap:

amx_swap "Player1" "Player2"

1. Directly swaps teams without confirmation
2. No cooldown applied
3. Action is logged
4. Bypass privileges:
5. Admins can bypass cooldown (if enabled)
6. Admins can swap teams while alive (if enabled)
7. Flag is determined by teamswap_admin_flag

🔒 Restrictions and Checks

Automatic Checks

1. ✅ Player is not spectator or unassigned
2. ✅ Player is dead (if required)
3. ✅ Target player is from opposing team
4. ✅ Cooldown timer has expired
5. ✅ Both players are connected during swap
6. ✅ Plugin is enabled

Error Messages

The plugin displays clear messages when:

1. Attempting to use while disabled
2. Attempting to use as spectator
3. Attempting to use while alive (if required)
4. No available players to swap with
5. Active cooldown timer
6. Invalid request or disconnected player

🐛 Troubleshooting

Plugin not working

1. Check if it's added to plugins.ini
2. Check if teamswap_enabled is "1"
3. Check console for loading errors

Players cannot swap teams

1. Check teamswap_require_dead - may require players to be dead
2. Check cooldown timer - may not have expired
3. Check if there are players from opposing team

Admins don't have bypass

1. Check teamswap_admin_flag - must match admin's flag
2. Check teamswap_admin_bypass_cooldown and teamswap_admin_bypass_dead
3. Check users.ini for correct flags

Cooldown not working properly

1. Cooldown activates when sending the request, not during swap
2. Both players receive cooldown after successful swap
3. Admins can bypass cooldown (if enabled)

📝 Logs

The plugin logs the following actions in AMX logs:

Admin [Name] <SteamID> swapped teams of [Player1] and [Player2]

Logs are located in: addons/amxmodx/logs/

🔄 Changelog

Version 1.0

1. ✅ Core team swap functionality
2. ✅ Request system with confirmation
3. ✅ Cooldown timer
4. ✅ Interactive menus
5. ✅ Admin command for force swap
6. ✅ Full cvar configuration
7. ✅ Admin bypass system
8. ✅ Configurable admin flag
9. ✅ Customizable prefix for chat and menus
10. ✅ Colored messages and indicators

📞 Support

For questions, issues, or suggestions:

1. Author: illusionLabs.dev / illusion
2. Plugin: Team Swap v1.0

📄 License

This plugin was created by illusionLabs.dev / eSportsDesigns.com for Counter-Strike 1.6 servers.

🎉 Credits

Thanks to everyone who uses and tests this plugin!

Enjoy the game! 🎮