πDS-Ads
DS-Ads-Renewed is a powerful and versatile advertisement plugin designed for Minecraft servers. This plugin allows server administrators to create and manage custom advertisements with multiple display types including chat messages, titles, boss bars, action bars, and sounds. Compatible with Spigot, BungeeCord, and Velocity platforms.
Main Features
π― Multi-Platform Support
Spigot/Paper: Full feature support with all advertisement types
BungeeCord: Network-wide advertisements with server-specific targeting
Velocity: Modern proxy support with advanced features
Cross-Platform: Unified configuration across all platforms
π’ Advanced Advertisement System
Multiple Display Types: Chat, Title, Boss Bar, Action Bar, and Sound notifications
Smart Targeting: World-based (Spigot) or server-based (BungeeCord/Velocity) restrictions
Permission Control: Individual permissions for each advertisement
Cooldown System: Configurable global cooldown to prevent spam
Welcome Advertisements: Special ads for new player joins
π¨ Rich Formatting Support
MiniMessage: Full MiniMessage support for advanced text formatting
Gradients: Beautiful color gradients in messages
Center Alignment: Automatic text centering capabilities
Sound Effects: Customizable sound notifications
Boss Bar Styles: Multiple boss bar colors and styles
Configuration Files
DS-Ads-Renewed uses platform-specific configuration files:
Settings.yml - Spigot/Paper configuration
bSettings.yml - BungeeCord configuration
vSettings.yml - Velocity configuration
Spigot Configuration (Settings.yml)
BungeeCord Configuration (bSettings.yml)
Velocity Configuration (vSettings.yml)
Configuration Options
Plugin Settings
Plugin-Configuration
Enabled:
true/false- Enable or disable the plugin globallyDisable-MCJoinLeave-Messages:
true/false- (Spigot only) Disable default Minecraft join/leave messages
Plugin-Permissions
Send-Ads:
ads.send- Permission to send advertisements manuallyManage-Ads:
ads.manage- Permission to manage plugin settingsReload-Plugin:
ads.reload- Permission to reload plugin configuration
Messages
Customize all plugin messages including:
Prefix: Plugin message prefix with MiniMessage formatting
No-Perms: No permission message
No-Subcmd: Invalid subcommand message
No-Ad-Found: Advertisement not found message
No-Player-Found: Player not found message
Ad-Failed: Error sending advertisement message
Reloaded-Sucess: Successful reload message
Only-players: Player-only command message
Disabled-Plugin: Plugin disabled message
Already-Disabled-Plugin: Already disabled message
Enabled-Plugin: Plugin enabled message
Already-Enabled-Plugin: Already enabled message
Everyone-Send: Advertisement sent to everyone message
Player-Send: Advertisement sent to player message
Usage: Command usage message
Welcome Advertisement
Welcome-Ad Configuration
Enabled:
true/false- Enable welcome advertisements for new players
WelcomeAd-Content Types
Chat
Enabled:
true/false- Enable chat welcome messageSound: (Spigot only) Sound effect to play
Ad-content: List of chat messages with MiniMessage formatting
Boss Bar (Spigot only)
Enabled:
true/false- Enable boss bar welcome messageMessage: Boss bar text with MiniMessage formatting
Color: Boss bar color (PINK, RED, PURPLE, etc.)
Style: Boss bar style (SOLID, SEGMENTED_6, SEGMENTED_10, etc.)
Action Bar (Spigot only)
Enabled:
true/false- Enable action bar welcome messageMessage: Action bar text with MiniMessage formatting
Title
Enabled:
true/false- Enable title welcome messageTitle: Main title text with MiniMessage formatting
Subtitle: Subtitle text with MiniMessage formatting
FadeIn: Title fade-in time in ticks
Stay: Title display time in ticks
FadeOut: Title fade-out time in ticks
Advertisement Configuration
Global Settings
Ads-Cooldown:
15- Cooldown in seconds between advertisements (applies to all ads)
Individual Advertisement Settings
Each advertisement can be configured with:
Targeting
worlds: (Spigot) List of worlds where the ad will be shown
servers: (BungeeCord/Velocity) List of servers where the ad will be shown
permission: Required permission to receive the advertisement
Advertisement Types
Chat Advertisement
Enabled:
true/false- Enable chat advertisementSound: (Spigot only) Sound effect to play
Ad-content: List of chat messages with MiniMessage formatting
Boss Bar Advertisement (Spigot only)
Enabled:
true/false- Enable boss bar advertisementMessage: Boss bar text with MiniMessage formatting
Color: Boss bar color
Style: Boss bar style
Action Bar Advertisement (Spigot only)
Enabled:
true/false- Enable action bar advertisementMessage: Action bar text with MiniMessage formatting
Title Advertisement
Enabled:
true/false- Enable title advertisementTitle: Main title text with MiniMessage formatting
Subtitle: Subtitle text with MiniMessage formatting
FadeIn: Title fade-in time in ticks
Stay: Title display time in ticks
FadeOut: Title fade-out time in ticks
Commands
/ads send <AdName> <Player/*>
/ads send <AdName> <Player/*>Send a specific advertisement to a player or all players.
Required permission:
ads.sendUsage:
/ads send Ad-Example-1 PlayerName- Send to specific player/ads send Ad-Example-1 *- Send to all players
/ads reload
/ads reloadReload the plugin configuration.
Required permission:
ads.reloadUsage:
/ads reload
/ads enable
/ads enableEnable the plugin globally.
Required permission:
ads.manageUsage:
/ads enable
/ads disable
/ads disableDisable the plugin globally.
Required permission:
ads.manageUsage:
/ads disable
Permissions
ads.send
Send advertisements manually to players
OP
ads.manage
Enable/disable plugin and manage settings
OP
ads.reload
Reload plugin configuration
OP
ads.ad1
Receive Ad-Example-1 advertisements
All Players
ads.ad2
Receive Ad-Example-2 advertisements
All Players
ads.ad3
Receive Ad-Example-3 advertisements
All Players
Available Variables
In advertisement messages you can use the following variables:
%player_name%- Display name of the player receiving the advertisement
MiniMessage Formatting
DS-Ads-Renewed supports full MiniMessage formatting including:
Colors:
<red>,<blue>,<green>, etc.Gradients:
<gradient:#ff5555:#5555ff>text</gradient>Bold/Italic:
<bold>,<italic>,<underlined>Strikethrough:
<st>text</st>Center Alignment:
<center>text</center>Reset:
<reset>to clear all formatting
Boss Bar Colors (Spigot only)
Available boss bar colors:
PINKBLUEREDGREENYELLOWPURPLEWHITE
Boss Bar Styles (Spigot only)
Available boss bar styles:
SOLID- Solid barSEGMENTED_6- 6 segmentsSEGMENTED_10- 10 segmentsSEGMENTED_12- 12 segmentsSEGMENTED_20- 20 segments
Sound Effects (Spigot only)
Common sound effects you can use:
BLOCK_NOTE_BLOCK_PLINGENTITY_ENDER_DRAGON_GROWLENTITY_ENDERMAN_SCREAMENTITY_PLAYER_LEVELUPUI_BUTTON_CLICK
Platform Differences
Spigot/Paper Features
β Chat advertisements
β Title advertisements
β Boss bar advertisements
β Action bar advertisements
β Sound effects
β World-based targeting
β Join/leave message control
BungeeCord Features
β Chat advertisements
β Title advertisements
β Boss bar advertisements
β Action bar advertisements
β Sound effects
β Server-based targeting
β Join/leave message control
Velocity Features
β Chat advertisements
β Title advertisements
β Boss bar advertisements
β Action bar advertisements
β Sound effects
β Server-based targeting
β Join/leave message control
How It Works
Initialization: Plugin loads configuration and sets up advertisement system
Player Join: Welcome advertisements are displayed to new players (if enabled)
Advertisement Cycling: Advertisements are sent automatically based on cooldown settings
Manual Sending: Staff can manually send specific advertisements to players
Targeting: System checks player permissions and location/server before displaying ads
Installation
Spigot/Paper Installation
Download the Spigot version of DS-Ads-Renewed
Place the
.jarfile in your server'splugins/folderRestart the server
Configure
Settings.ymlin theplugins/DS-Ads-Renewed/folderSet up permissions as needed
Reload the plugin with
/ads reload
BungeeCord Installation
Download the BungeeCord version of DS-Ads-Renewed
Place the
.jarfile in your proxy'splugins/folderRestart the proxy
Configure
bSettings.ymlin theplugins/DS-Ads-Renewed/folderSet up permissions as needed
Reload the plugin with
/ads reload
Velocity Installation
Download the Velocity version of DS-Ads-Renewed
Place the
.jarfile in your proxy'splugins/folderRestart the proxy
Configure
vSettings.ymlin theplugins/DS-Ads-Renewed/folderSet up permissions as needed
Reload the plugin with
/ads reload
Compatibility
Minecraft Version: 1.13 - 1.21.8
Platforms: Spigot, Paper, BungeeCord, Velocity
Dependencies: PlaceholderAPI (For Spigot)
Creating Custom Advertisements
To create a new advertisement, add a new section under Ads-Configuration:
Support
To report bugs or request features:
Discord: https://fruitforge.com/discord
Plugin developed by FruitForge Studio
Last updated