# Welcome Effects Plugin for Counter-Strike 1.6
## Overview
Welcome Effects is a highly customizable AMX Mod X plugin that creates an immersive welcome experience for players joining your Counter-Strike 1.6 server. The plugin combines visual effects, sound effects, and personalized messages to create a unique entrance for each player.
## Features
- **Background Music**: Custom MP3 playback on player join
- **Visual Effects**: Synchronized screen flashes
- **Sound Effects**: Thunder sounds synchronized with screen flashes
- **Welcome Message**: Personalized HUD message with server name
- **Fully Configurable**: All settings adjustable through config file
## Requirements
- AMX Mod X 1.10.0 or higher
- ReAPI module
- Counter-Strike 1.6 server
## Installation
1. Copy `welcome_effects.amxx` to your `addons/amxmodx/plugins/` directory
2. Create directory `sound/GMSMusic` in your `cstrike` folder
3. Place your welcome music as `newwelcome.mp3` in the `sound/GMSMusic` directory
4. Add `welcome_effects.amxx` to your `plugins.ini`
5. The config file will be automatically created in `addons/amxmodx/configs/welcome_effects.cfg`
## Configuration
The plugin uses a configuration file (`welcome_effects.cfg`) with the following options:
```ini / addons/amxmodx/configs/plugins/welcome_effects.cfg
// Path to welcome music file (relative to sound/)
we_music_path "GMSMusic/newwelcome.mp3"
// Path to thunder sound file (relative to sound/)
we_thunder_path "ambience/thunder_clap.wav"
// Duration of welcome effects in seconds
we_effects_duration "7.0"
// Number of screen flashes
we_flash_count "21"
// Number of thunder sounds
we_thunder_count "5"
// Alpha transparency of screen flashes (0-255)
we_flash_alpha "230"
```
## Effect Sequence
When a player joins the server:
1. Welcome music starts playing
2. Screen begins flashing (default: 21 flashes over 7 seconds)
3. Thunder sounds play at intervals (default: 5 times)
4. Welcome message appears after effects finish
## Technical Details
### Welcome Music
- Format: MP3
- Default location: `sound/GMSMusic/newwelcome.mp3`
- Played using client-side MP3 player
- Duration should match effects duration (default: 7 seconds)
### Screen Effects
- Black screen flashes
- Configurable alpha transparency
- Dynamic timing based on total duration
- Synchronized with thunder sounds
### Thunder Effects
- Uses built-in thunder sound
- Default sound: `ambience/thunder_clap.wav`
- Evenly distributed throughout the effect duration
- Number of thunder sounds is configurable
### Welcome Message
- Uses HUD message system
- Shows player name and server name
- Green/Yellow color scheme
- Position: Upper left corner (X: 0.05, Y: 0.13)
- Duration: 12 seconds
- Fade time: 6 seconds
