Fast Rush Item Plugin

A custom AMXX plugin for Counter-Strike 1.6 that adds a "Fast Rush Teleport" item to the custom shop system, allowing players to perform smooth velocity-based dashes with visual effects.

📋 Overview

The Fast Rush plugin integrates with the custom shop system to provide players with a purchasable item that enables fast horizontal movement. When activated, players perform a smooth dash in their facing direction with optional visual effects including screen fade and particle trails.

✨ Features

• Smooth Movement: Velocity-based dash system instead of instant teleportation
• E Key Activation: Primary activation using the E (USE) key
• Alternative Commands: Chat command /fastrush for activation
• Ground Check: Only works when player is on solid ground (prevents mid-air abuse)
• Cooldown System: 5-second cooldown with visual countdown timer
• Visual Effects:
  • Cyan screen fade effect during dash
  • Particle beam trail following the player
• Colored Messages: All chat notifications use colored text
• Death Handling: Item automatically removed on player death
• Custom Shop Integration: Seamless integration with existing shop system

🎮 How to Use

1. Purchase: Buy "Fast Rush Teleport" from the custom shop for $5000
2. Activate: Press E key or type /fastrush in chat
3. Requirements: Must be alive and standing on solid ground
4. Cooldown: Wait 5 seconds between uses (countdown shown on screen)

⚙️ Configuration

The plugin includes compile-time configuration options that can be modified before compilation:

Visual Effects Settings

#define ENABLE_TRAIL 1        // 1 = Enable trail effect, 0 = Disable
#define ENABLE_SCREENFADE 1   // 1 = Enable screen fade, 0 = Disable

Item Settings

#define ITEM_PRICE 5000       // Price in shop currency
#define RUSH_VELOCITY 1000.0  // Dash speed (units per second)
#define COOLDOWN_TIME 5.0     // Cooldown duration in seconds

🔧 Installation

Prerequisites

• AMX Mod X 1.8.2 or higher
• Custom Shop plugin installed and working
• Counter-Strike 1.6 server

Installation Steps

1. Place fast_rush_item.amxx in addons/amxmodx/plugins/
2. Add fast_rush_item.amxx to addons/amxmodx/configs/plugins.ini
3. Ensure custom shop plugin is loaded before this plugin
4. Restart server or change map

🛠️ Technical Details

Dependencies

• <amxmodx> - Core AMX Mod X functionality
• <amxmisc> - Miscellaneous AMX functions
• <engine> - Engine manipulation functions
• <fun> - Fun module for entity manipulation
• <fakemeta> - Fakemeta for key detection
• <customshop> - Custom shop integration

Key Functions

• E Key Detection: Uses FM_CmdStart forward to detect USE button presses
• Movement System: Applies horizontal velocity while preserving vertical momentum
• Trail System: Creates beam effects using TE_BEAMFOLLOW temporary entities
• Ground Check: Uses FL_ONGROUND flag to ensure valid usage conditions

Performance Notes

• Minimal server impact when effects are disabled
• Trail effects use temporary entities (no permanent entities created)
• Conditional compilation eliminates unused code paths
• Efficient task management for trail cleanup

🎨 Visual Effects Details

Screen Fade

• Color: Cyan (RGB: 0, 150, 255)
• Duration: Short fade-in effect
• Trigger: Activated during dash execution

Trail Effect

• Type: Beam trail following player
• Color: Cyan matching screen fade
• Duration: 1.5 seconds
• Update Rate: 10 times per second for smooth appearance

🚫 Limitations & Restrictions

• Ground Only: Cannot be used while jumping or falling
• Alive Players: Only works for living players
• Cooldown: 5-second mandatory cooldown between uses
• Single Use: Item removed on death (must repurchase)
• Direction: Always dashes in player's facing direction

🐛 Troubleshooting

Common Issues

E Key Not Working

• Ensure no other plugins are blocking the USE key
• Check that fakemeta module is loaded
• Verify player has the item purchased

No Trail Effect

• Confirm ENABLE_TRAIL is set to 1
• Check that sprites/laserbeam.spr exists on server
• Verify client has downloaded the sprite file

Item Not in Shop

• Ensure custom shop plugin is loaded first
• Check for item ID conflicts with other shop items
• Verify plugin compilation was successful

Movement Issues

• Confirm player is on solid ground
• Check for velocity-limiting plugins
• Verify RUSH_VELOCITY setting is appropriate

📝 Changelog

Version 1.0

• Initial release with full feature set
• E key detection using fakemeta
• Smooth velocity-based movement
• Visual effects (trail and screen fade)
• Custom shop integration
• Ground check and cooldown system
• Colored chat messages
• Configurable visual effects

👨‍💻 Developer Information

• Author: illusionlabs.dev
• Version: 1.0
• Plugin Name: CSHOP Item: Fast Rush Item
• Language: Pawn (AMX Mod X)