Advanced HUD Advertisements Plugin
Version: 1.0Author: illusion @ eSportsDesignsPlugin 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
Compile the Plugin:
amxxpc AdvertsNEW.sma
Upload Files:
Place AdvertsNEW.amxx in /addons/amxmodx/plugins/
Add AdvertsNEW.amxx to /addons/amxmodx/configs/plugins.ini
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)
CVar
Default
Description
amx_adverts_enabled
1
Enable/disable the advertisement system
amx_adverts_interval
60.0
Time interval between advertisements (seconds)
amx_adverts_random
0
Random order (1) or sequential (0)
amx_adverts_effect
2
HUD message effect type (0-3)
amx_adverts_holdtime
5.0
How long to display each advertisement
amx_adverts_fadein
0.1
Fade-in duration (seconds)
amx_adverts_fadeout
0.2
Fade-out duration (seconds)
amx_adverts_x
-1.0
X position (-1.0 = center)
amx_adverts_y
0.2
Y position (0.0 = top, 1.0 = bottom)
Effect Types:
0 - No effect
1 - Fade in/out
2 - Flash/strobe effect
3 - Write-out effect
Admin Commands
Command
Access Level
Description
amx_reloadadverts
ADMIN_CVAR
Reloads advertisement configuration without restart
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
Position Settings:
X: -1.0 centers horizontally, 0.0 = left, 1.0 = right
Y: 0.0 = top of screen, 1.0 = bottom of screen
Timing Recommendations:
Interval: 30-120 seconds (avoid spam)
Hold time: 3-8 seconds (readable duration)
Fade times: 0.1-0.5 seconds (smooth transitions)
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.
#cs16
#amxx
#plugin