Key Features:

- **7 Unique Races** with different abilities (more races coming in future updates)

- **Integrated Shop System** with basic and War3ft items

- **Experience and Level System** (up to level 20)

- **Ultimate Abilities** for each race

- **Visual and Sound Effects**

- **Active Development** - regular updates and new content planned

- **Roadmap** - ongoing additions of new races, new shop items, and expanded admin commands

---

## Race System

### Available Races:

1. **Undead Scourge**

2. **Human Alliance**

3. **Orcish Horde**

4. **Night Elf**

5. **Blood Mage**

6. **Shadow Hunter**

7. **Warden**

### Ability System:

- **Level 1-20**: Each level grants ability points

- **4 Abilities per race**: 3 passive/active + 1 ultimate

- **Cooldown system**: Ultimate abilities have recovery time

- **Visual effects**: Each ability has unique effects

---

## Shop System

### Currency:

- **Credits** (default) or **CS Money**

- **Kill rewards**: 10 credits for normal kill, 15 for headshot

- **nVault storage** for local data persistence

### Item Types:

1. **Basic Items** - speed, gravity, damage, health, armor

2. **War3ft Items** - special items with unique effects

3. **Purchase limits** - different limits for different items

### Integration:

- **Status bar display** - shows active items

- **Persistence** - items persist until death

- **Quick commands** - direct purchase commands

---

## Detailed Race Descriptions

### 1. Undead Scourge

**Abilities:**

- **Vampiric Aura** (Max Level 6) - Convert damage dealt into health

- **Unholy Aura** (Max Level 6) - Speed boost with all weapons  

- **Levitation** (Max Level 5) - Reduced gravity for higher jumps

- **Suicide Bomber** (Ultimate, Max Level 2) - Explode on death and regenerate

**Details:**

- **Vampiric Aura**: Heals based on damage dealt (configurable percentage per level), adds red glow effect

- **Unholy Aura**: Base speed 250 + (level × configured speed bonus)

- **Levitation**: Reduces gravity by 15% per level (minimum gravity limit applies)

- **Suicide Bomber**: 

  - Requires level 6 to unlock

  - Base damage + 75 per level in explosion radius

  - Triggers automatically on death OR can be manually activated

  - Respawns player after 2 seconds with reduced health (50 HP at level 1, 75 HP at level 2)

  - Has cooldown between uses

  - Creates visual explosion effects with purple shockwave and smoke

### 2. Human Alliance

**Abilities:**

- **Invisibility** (Max Level 6) - Partial invisibility (better with knife)

- **Devotion Aura** (Max Level 5) - Additional health +10/lvl

- **Bash** (Max Level 6) - Chance to immobilize enemy for 1s

- **Teleport** (Ultimate, Max Level 2) - Teleport + 2s invisibility

**Details:**

- **Invisibility**: 

  - Base alpha 180, reduces by 15 per level

  - Knife bonus: -39 alpha (more invisible with knife)

  - Minimum alpha 10, maximum 255

  - Enhanced invisibility when holding knife

- **Devotion Aura**: +10 health per level at spawn (not armor!)

- **Bash**: 

  - 8% chance per level to stun enemy for 1.0 seconds

  - Sets victim speed to 1.0 during stun

  - Blocked by immunity systems

- **Teleport**: 

  - Requires level 6 to unlock

  - Range: 800 units (level 1) or 1200 units (level 2)

  - Cooldown: 30s (level 1) or 20s (level 2)

  - Teleports to aimed location with safety checks

  - Grants full invisibility for 2 seconds after teleport

  - Creates blue shockwave visual effects and sparks

### 3. Orcish Horde

**Abilities:**

- **Critical Strike** (Max Level 6) - 8% chance per level to deal 2x damage

- **Critical Grenade** (Max Level 5) - Grenades deal +20 damage per level (max 100)

- **Berserk Rage** (Max Level 6) - When HP < 30%, gain speed, damage and regeneration

- **Chain Lightning** (Ultimate, Max Level 2) - Lightning bolt jumps between nearby enemies

**Details:**

- **Critical Strike**: 

  - 8% chance per level for 2.0x damage multiplier

  - Enhanced by berserk damage bonus when active

  - Creates red sparks visual effect

- **Critical Grenade**: 

  - +20 damage per level, maximum +100 damage

  - Creates orange explosion effects

- **Berserk Rage**: 

  - Activates automatically when health drops below 25 HP

  - Duration: 6 seconds, Cooldown: 4 seconds after end

  - Effects: +50 speed, damage multiplier, +6 HP/sec regeneration

  - Red glow visual effect during berserk

- **Chain Lightning**: 

  - Requires level 6 to unlock

  - Activation mode: 5 seconds to target an enemy within 800 units

  - Base damage: 30 + (15 × level) = 45/60 damage

  - Jumps to up to 4 targets within 300 unit radius

  - Damage decreases per jump: 100%, 85%, 70%, 55%, 40%

  - Cooldown: 25 seconds

  - Creates lightning beam effects between targets

### 4. Night Elf

**Abilities:**

- **Evasion** (Max Level 6) - 3% chance per level to completely avoid attacks

- **Thorns Aura** (Max Level 6) - Reflects 5% damage per level back to attackers

- **Trueshot Aura** (Max Level 5) - +2 bonus damage per level to all attacks

- **Entangle Roots** (Ultimate, Max Level 2) - Immobilizes target and swaps positions

**Details:**

- **Evasion**: 

  - 3% chance per level to completely negate damage (max 18%)

  - Does not work against explosive damage

  - Creates blue dodge visual effect

- **Thorns Aura**: 

  - Reflects 5% of received damage per level back to attacker

  - Maximum 15 damage reflection per hit

  - Does not work against explosive damage

  - Creates green lightning beam effect from victim to attacker

- **Trueshot Aura**: 

  - +2 bonus damage per level, maximum +15 damage

  - Does not work against teammates or explosive damage

  - Creates golden sparks and light effects on target

- **Entangle Roots**: 

  - Requires level 6 to unlock

  - Activation mode: 5 seconds to target an enemy within 800 units

  - Duration: 6 seconds of complete immobilization

  - Cooldown: 30 seconds

  - Swaps positions between caster and target with safety checks

  - Creates elaborate root/vine visual effects around target

  - Includes auto-unstuck system to prevent geometry issues

### 5. Blood Mage

**Abilities:**

- **Banish** (Max Level 6) - 8% chance per level to teleport attackers away

- **Siphon Mana** (Max Level 6) - Steal $100 per level from enemies when damaging them

- **Flame Strike** (Max Level 5) - Burn enemies for 0.6 damage per level over 3 seconds

- **Inferno Rain** (Ultimate, Max Level 2) - Target enemy for intense burning damage

**Details:**

- **Banish**: 

  - 8% chance per level to teleport attacker 400-800 units away

  - Triggers when Blood Mage takes damage from enemies

  - Uses collision detection for safe teleport locations

  - Creates implosion visual effect

- **Siphon Mana**: 

  - Steals $100 per level from victim when dealing damage (max $600)

  - Only works against enemies, not teammates

  - Creates golden light effect on victim

  - Transfers money directly between players

- **Flame Strike**: 

  - 0.6 damage per level every 0.5 seconds for 3 seconds (max 3 damage/tick)

  - Only applies if target is not already burning

  - Creates flame sprite and fire light effects

  - Includes proper kill credit system

- **Inferno Rain**: 

  - Requires level 6 to unlock

  - Activation mode: 5 seconds to target an enemy within 800 units

  - Cooldown: 45 seconds

  - Burns target for 2-3 damage per tick over 5 seconds

  - Creates intense flame burst with multiple fire explosions

  - Includes continuous flame sprites, smoke, and sparks effects

### 6. Shadow Hunter

**Abilities:**

- **Healing Wave** (Max Level 6) - Auto-heal 5 HP per level to self and nearby allies

- **Hex** (Max Level 6) - 10% chance per level to hex attackers for 3 seconds

- **Curse of Weakness** (Max Level 5) - Hook enemy and drain 15 HP over 2 seconds

- **Spirit Guardian** (Ultimate, Max Level 2) - Summons 2-4 attacking ghost spirits

**Details:**

- **Healing Wave**: 

  - Auto-heals 5 HP per level every 10 seconds (max 30 HP)

  - 250 unit radius, affects self and teammates

  - Only triggers when someone needs healing

  - Creates green beam cylinder visual effects

- **Hex**: 

  - 10% chance per level to hex attackers (max 60%)

  - Slows movement to 100 speed and disables skills for 3 seconds

  - Creates purple spiral beam effects around hexed target

- **Curse of Weakness**: 

  - Manual activation with 5-second targeting mode

  - Range: 500 units, Cooldown: 7 seconds

  - Immobilizes target and pulls them rapidly toward caster

  - Drains 15 HP total over 2 seconds while healing caster

  - Launches target away with pushback at close range

  - Creates dark chain beam visual effects during pull

- **Spirit Guardian**: 

  - Requires level 6 to unlock

  - Summons 2 spirits (level 1) or 4 spirits (level 2)

  - Duration: 15 seconds, Cooldown: 25 seconds

  - 4 seconds of complete godmode at start

  - Spirits orbit player and attack nearby enemies for 1 damage

  - 25% block chance per level after godmode ends (max 50%)

  - Creates 3D ghost models with blue glow effects with godmode for 10-40 seconds

### 7. Warden

**Abilities:**

- **Shadow Masquerade** (Max Level 5) - Disguise as nearby enemies when close to them

- **Spell Immunity** (Max Level 6) - Passive immunity to ability damage

- **Shadow Strike** (Max Level 6) - Chance to throw poisoned daggers

- **Phantom Assault** (Ultimate, Max Level 2) - Create illusory clone that confuses enemies

**Details:**

- **Shadow Masquerade**: 

  - Automatically activates when near enemies within 300 units range

  - Copies enemy model appearance for 5 seconds base duration

  - 10 second cooldown between uses

  - Creates shadow effects when disguise activates and deactivates

- **Spell Immunity**: 

  - 12.5% chance per level to block magical attacks (max 75% at level 6)

  - Completely blocks spell effects from other races' abilities

  - Also blocks shop item spell effects

  - Creates visual immunity effects when blocking spells

- **Shadow Strike**: 

  - 6.67% chance per level to trigger on dealing damage (max 40% at level 6)

  - Fires multiple shadowstrike projectiles with visual trail effects

  - Deals 10 damage per skill level

  - Drops target to ground for 2 seconds (speed reduced to 1.0)

  - Applies poison effect dealing 3 damage per second for 3 seconds

- **Phantom Assault**: 

  - Requires level 6 to unlock

  - Creates phantom clone that actively hunts enemies within 400 units

  - Caster becomes invisible for 2 seconds and dashes forward with 600 velocity

  - Clone shoots at enemies with 1-second cooldown dealing 5-10 damage

  - Clone can kill enemies (XP credit goes to caster)

  - Clone lasts 8 seconds, has 50 HP per level

  - 45 second cooldown

---

## Shop Items

### Basic Items:

#### Speed Boost (+50%)

- **Price**: 100 credits

- **Effect**: Increases speed by 50%

- **Limit**: 1 per life

#### Low Gravity

- **Price**: 150 credits

- **Effect**: Reduces gravity by 50%

- **Limit**: 1 per life

#### Damage Boost (+25%)

- **Price**: 200 credits

- **Effect**: Increases damage by 25%

- **Limit**: 1 per life

#### Extra Health (+50HP)

- **Price**: 75 credits

- **Effect**: Adds 50 health

- **Limit**: 3 per life

#### Extra Armor (+100AP)

- **Price**: 100 credits

- **Effect**: Adds 100 armor

- **Limit**: 2 per life

#### Unlimited Clip

- **Price**: 250 credits

- **Effect**: No reload needed

- **Limit**: 1 per life

#### Unlimited Ammo

- **Price**: 300 credits

- **Effect**: Infinite backup ammo

- **Limit**: 1 per life

#### HE Grenade Pack

- **Price**: 300 credits

- **Effect**: Gives 5 HE grenades

- **Limit**: 3 per life

### War3ft Items:

#### Mask of Death

- **Price**: 400 credits

- **Effect**: 25% life steal - heals when dealing damage

- **Limit**: 1 per life

#### Necklace of Immunity

- **Price**: 350 credits

- **Effect**: Blocks enemy ultimates (3 charges)

- **Limit**: 3 charges maximum

#### Mole

- **Price**: 500 credits

- **Effect**: Spawn at enemy base next round

- **Limit**: 1 use

#### Tome of Experience

- **Price**: 250 credits

- **Effect**: Gives experience based on level (50-500 XP)

- **Limit**: Unlimited

#### Scroll of Respawning

- **Price**: 600 credits

- **Effect**: Revives player after death

- **Limit**: 1 use

#### Mirror Shield

- **Price**: 450 credits

- **Effect**: Reflects 30% damage back

- **Limit**: 1 per life

---

## Commands and Controls

### Basic Commands:

- `say /shopmenu` or `shopmenu` - Opens shop menu

- `say /myitems` - Shows owned items

- `say /shopinfo` - Shop information

### Quick Commands for Basic Items:

- `say speed` - Buy Speed Boost

- `say gravity` or `say grav` - Buy Low Gravity

- `say damage` or `say dmg` - Buy Damage Boost

- `say hp` - Buy Extra Health

- `say armor` - Buy Extra Armor

- `say clip` - Buy Unlimited Clip

- `say ammo` - Buy Unlimited Ammo

- `say he` - Buy HE Grenade Pack

### Quick Commands for War3ft Items:

- `say mask` - Buy Mask of Death

- `say necklace` or `say immunity` - Buy Necklace of Immunity

- `say mole` - Buy Mole

- `say tome` or `say xp` - Buy Tome of Experience

- `say scroll` or `say respawn` - Buy Scroll of Respawning

- `say mirror` or `say shield` - Buy Mirror Shield

### War3ft Commands:

---

## Configuration

### Basic CVARs:

#### Currency:

- `shop_currency_type "0"` - 0 = credits, 1 = CS money

- `shop_kill_reward "10"` - Kill reward

- `shop_headshot_reward "15"` - Headshot reward

#### Item Limits:

- `shop_speed_limit "1"` - Speed Boost limit

- `shop_gravity_limit "1"` - Low Gravity limit

- `shop_damage_limit "1"` - Damage Boost limit

- `shop_health_limit "3"` - Extra Health limit

- `shop_armor_limit "2"` - Extra Armor limit

- `shop_unlimitedclip_limit "1"` - Unlimited Clip limit

- `shop_unlimitedammo_limit "1"` - Unlimited Ammo limit

- `shop_hegrenade_limit "3"` - HE Grenade Pack limit

#### Basic Item Prices:

- `shop_speed_price "100"` - Speed Boost price

- `shop_gravity_price "150"` - Low Gravity price

- `shop_damage_price "200"` - Damage Boost price

- `shop_health_price "75"` - Extra Health price

- `shop_armor_price "100"` - Extra Armor price

- `shop_unlimitedclip_price "250"` - Unlimited Clip price

- `shop_unlimitedammo_price "300"` - Unlimited Ammo price

- `shop_hegrenade_price "300"` - HE Grenade Pack price

#### War3ft Item Prices:

- `shop_mask_price "400"` - Mask of Death price

- `shop_necklace_price "350"` - Necklace of Immunity price

- `shop_mole_price "500"` - Mole price

- `shop_tome_price "250"` - Tome of Experience price

- `shop_scroll_price "600"` - Scroll of Respawning price

- `shop_mirror_price "450"` - Mirror Shield price

## Technical Details

### System Integration:

- **Status bar display**: Shows active items from both systems

- **Immunity system**: Necklace of Immunity integrated with War3ft immunity

- **XP system**: Tome of Experience directly gives War3ft experience

- **Persistence**: Items persist until death, not until new round

### Optimizations:

- **Reduced stack usage**: Optimized arrays to prevent crashes

- **Efficient display**: Status bar updates every second

- **nVault persistence**: Local key-value storage for saving progress

### Compatibility:

- **Counter-Strike 1.6**: Full compatibility

- **AMXX 1.8.2+**: Requires modern AMX Mod X version

- **AMXX nVault module**: Built-in persistence (no external database required)

---

## Testing and Reporting

Every race and every spell has been tested repeatedly and refined many times until reaching a near-perfect state. Despite this extensive playtesting and QA, complex systems can still surface rare edge-case bugs. Please remain vigilant and report any issue immediately at: Contact us and Report 

We will continue shipping frequent updates, including new races, brand-new items in the `shopmenu`, and expanded admin commands. Your timely reports help us fix issues faster and guide what we add next.

The mod is designed to be easy to use for players, but with depth for those who want to master different races and strategies.