Advanced HUD Advertisements Plugin

Version: 1.0
Author: illusion @ eSportsDesigns
Plugin Name: Advanced HUD Advertisements

Description

AdvertsNEW is an AMX Mod X plugin for Counter-Strike servers that displays customizable rotating advertisements to players using HUD messages. The plugin supports multiple display modes, random colors, and various visual effects to create eye-catching server announcements.

Features

• ✅ Rotating Advertisements: Display multiple ads in sequence or random order
• ✅ HUD Message Display: Shows ads using colorful HUD messages on screen
• ✅ Random Colors: Each ad displays with randomly generated colors for visual variety
• ✅ Customizable Position: Configure X/Y position of HUD messages
• ✅ Visual Effects: Multiple fade-in/fade-out effects and display modes
• ✅ Dynamic Variables: Support for %map% and %newline% placeholders
• ✅ Live Reload: Reload advertisements without server restart
• ✅ Auto Config Creation: Automatically creates default config if missing

Installation

1. Compile the Plugin:

   amxxpc AdvertsNEW.sma
   

2. Upload Files:

   • Place AdvertsNEW.amxx in /addons/amxmodx/plugins/
   • Add AdvertsNEW.amxx to /addons/amxmodx/configs/plugins.ini

3. Configuration:

   • The plugin will automatically create /addons/amxmodx/configs/adverts_hud.ini
   • Edit this file to add your custom advertisements

Configuration File

File: /addons/amxmodx/configs/adverts_hud.ini

Format:

; Adverts HUD Configuration File
; Each line represents one advertisement
; Lines starting with ; are comments and will be ignored

Welcome to our server!
Join our community at www.example.com
Type !menu to open server menu
Current map: %map%
Line 1%newline%Line 2 of same ad

Special Variables:

• %map% - Replaced with current map name
• %newline% - Creates a line break in the HUD message
• Lines starting with ; or / are treated as comments

CVars (Console Variables)

Effect Types:

• 0 - No effect
• 1 - Fade in/out
• 2 - Flash/strobe effect
• 3 - Write-out effect

Admin Commands

Usage Examples

Basic Configuration:

Welcome to [SERVER NAME]!
Visit our website: www.yoursite.com
Current map: %map%
Join our Discord: discord.gg/yourserver
Type !shop to open the store

Multi-line Advertisement:

=== SERVER RULES ===%newline%1. No cheating%newline%2. No spam%newline%3. Have fun!

Dynamic Content:

You are playing on: %map%
Server time: Check !time command

Technical Details

• Dependencies: amxmodx, amxmisc, reapi, reapi_stocks
• Maximum Advertisements: 32
• Maximum Message Length: 192 characters
• Array-based Storage: Uses dynamic arrays for efficient memory management
• Color System: Random RGB values generated for each display

Configuration Tips

1. Position Settings:

   • X: -1.0 centers horizontally, 0.0 = left, 1.0 = right
   • Y: 0.0 = top of screen, 1.0 = bottom of screen

2. Timing Recommendations:

   • Interval: 30-120 seconds (avoid spam)
   • Hold time: 3-8 seconds (readable duration)
   • Fade times: 0.1-0.5 seconds (smooth transitions)

3. Message Guidelines:

   • Keep messages concise and clear
   • Use %newline% sparingly to avoid clutter
   • Test different effect types for best visibility

Troubleshooting

Ads not showing?

• Check amx_adverts_enabled is set to 1
• Verify config file exists and has valid content
• Ensure at least one non-comment line in config

Position issues?

• Adjust amx_adverts_x and amx_adverts_y values
• Test with different screen resolutions

Performance concerns?

• Increase interval time if server experiences lag
• Reduce number of advertisements if memory usage is high

Support

For issues or questions:

• Author: illusion @ eSportsDesigns
• Check AMX Mod X documentation for HUD message limitations
• Verify ReAPI installation for proper functionality

Note: This plugin requires ReAPI for advanced HUD message functionality. Ensure ReAPI is properly installed and configured on your Counter-Strike server.