## Features

### Player Identification

- **Multiple Recognition Methods**:

  - SteamID-based matching for precise player identification

  - IP address recognition with partial matching support

  - Nickname detection with partial name matching

### Personalized Greetings

- **Colored Chat Messages**: 

  - Supports various color codes for vibrant, attention-grabbing messages

  - Team-based coloring (CT: Blue, T: Red)

  - Replaceable tags like `%flag` that show the player's team

### Sound System

- **Custom Welcome Sounds**:

  - Assign different sounds to different players or groups

  - Compatible with both MP3 and WAV formats (WAV recommended for better reliability)

  - Multiple playback methods for maximum compatibility

### Smart Configuration

- **Easy Setup**:

  - Configuration via standard INI file format

  - Automatic creation of default config if none exists

  - Separated sections for sounds and messages

### User Experience

- **Anti-Spam Protection**:

  - Shows welcome message only once per player session

  - 5-second delay after player join for smoother experience

  - Precaches sounds for lag-free playback

## Installation

1. **Compile the Plugin**:

   - Use AMX Mod X compiler to compile `welcome_plugin.sma`

   - Command: `amxxpc welcome_plugin.sma`

2. **Install Required Files**:

   - Copy `welcome_plugin.amxx` to your `plugins` folder

   - Create directory `cstrike/sound/welcomeadmin/` for sound files

   - Place your welcome sound files in the created directory

3. **Server Configuration**:

   - Add `welcome_plugin.amxx` to your `plugins.ini` file

   - Restart your server or change map to load the plugin

## Configuration

### INI File Format

The plugin uses `addons/amxmodx/configs/welcome.ini` with two main sections:

```

[Music]

STEAM_0:0:123456 = sound/welcomeadmin/admin.mp3

127.0.0.1 = sound/welcomeadmin/lan.mp3

Player = sound/welcomeadmin/regular.mp3

[Chat]

STEAM_0:0:123456 = &x04The Admin &x03%flag &x04has joined the server!

127.0.0.1 = &x03LAN player has joined the server!

Player = &x04Welcome &x03%flag &x04player to the server!

```

### Color Codes

You can use the following color codes in your welcome messages:

- `&x01` - White/Normal (default color)

- `&x03` - Team color (CT: Blue, T: Red)

- `&x04` - Green

### Special Tags

- `%flag` - Replaced with the player's team name (TERRORIST, CT, or SPECTATOR)

## Troubleshooting

### Sound Issues

- If MP3 files don't play, try converting them to WAV format

- Ensure sounds are in the correct directory: `cstrike/sound/welcomeadmin/`

- File paths in the INI should include the `sound/` prefix

### Message Issues

- Make sure your color codes are properly formatted (`&x01`, `&x03`, `&x04`)

- Check your INI file for syntax errors

- Verify player identifiers (SteamID, IP, or name) are correctly entered

## Example Use Cases

### VIP Welcome

[Music]

STEAM_0:0:817434153 = sound/welcomeadmin/vip_welcome.mp3

[Chat]

STEAM_0:0:817434153 = &x04★ VIP &x03%flag &x04Player has joined the server! ★

```

### Admin Announcement

```

[Music]

STEAM_0:0:123456 = sound/welcomeadmin/admin_alert.mp3

[Chat]

STEAM_0:0:123456 = &x03[ADMIN] &x04Server administrator has entered the game &x03- behave yourselves!

```

### Regular Player Welcome

```

[Music]

Player = sound/welcomeadmin/welcome.mp3

[Chat]

Player = &x04Welcome &x03%flag &x04player to the server!

```

## Credits

- Developed for AMX Mod X

- Uses `colorchat.inc` for colored message support

- Uses `textparse_ini.inc` for INI file parsing

---

*This plugin is designed to work with AMX Mod X for Counter-Strike 1.6. Make sure to use compatible versions of all dependencies.*