🍍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)
# Version of the configuration file, do not
# modify this file or you will disrupt the
# version and a new file will be created.
Config-Version: 8.0.0
Plugin-Version: 8.2
# Plugin Settings, you can edit them according to your needs.
# The Disable-MCJoinLeave-Messages key disables the default join and leave messages on the server.
Plugin-Configuration:
Enabled: true
Disable-MCJoinLeave-Messages: true
# Plugin permissions
Plugin-Permissions:
Send-Ads: ads.send
Manage-Ads: ads.manage
Reload-Plugin: ads.reload
# Plugin messages, you can edit them according to your needs.
Messages:
Prefix: '<aqua>Fruit<white>Forge <dark_gray><bold>» <reset>'
No-Perms: "<red>You dont have permissions to run this command"
No-Subcmd: "<red>This command doesnt exist"
No-Ad-Found: "<red>This ad doesnt exist"
No-Player-Found: "<red>This player doesnt exist"
Ad-Failed: "<red>Error sending ad to player"
Reloaded-Sucess: "<green>Config was reloaded correctly"
Only-players: "<red>This command can only be used by players"
Disabled-Plugin: "<red>The plugin was successfully disabled"
Already-Disabled-Plugin: "<red>The plugin is already disabled"
Enabled-Plugin: "<green>The plugin was successfully enabled"
Already-Enabled-Plugin: "<red>The plugin is already enabled"
Everyone-Send: "<green>Ad sent to all players"
Player-Send: "<green>Ad sent correctly to the player"
Usage: "<yellow>Usage: /ads send <AdName> <Player/*>"
Welcome-Ad:
Enabled: true
WelcomeAd-Content:
# / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / /
Chat:
Enabled: true
Sound: BLOCK_NOTE_BLOCK_PLING
Ad-content:
- ''
- '<dark_gray><st>-----------------------------------------------------'
- ''
- '<center><aqua><bold>Welcome %player_name%</bold></aqua></center>'
- ''
- '<center><gray>Thank you for downloading the plugin</gray></center>'
- ''
- '<dark_gray><st>-----------------------------------------------------'
Bossbar:
Enabled: true
Message: "<dark_purple>Welcome %player_name%!</dark_purple>"
Color: PINK
Style: SOLID
Actionbar:
Enabled: true
Message: "<red>Welcome to DragonStudio</red>"
Title:
Enabled: true
Title: "<blue>DS-Ads</blue>"
Subtitle: "<yellow>Thanks for another opportunity!</yellow>"
FadeIn: 10
Stay: 70
FadeOut: 20
# Advertisement configuration, you can set up as many as
# you want with restrictions that suit your needs
# Advertisement configuration, you can set up as many as you want with restrictions that suit your needs
Ads-Configuration:
Ads-Cooldown: 15 # In Seconds, For all ads
Ad-Example-1:
worlds:
- world
permission: ads.ad1
Chat:
Enabled: true
Sound: BLOCK_NOTE_BLOCK_PLING
Ad-content:
- ''
- '<dark_gray><st>-----------------------------------------------------'
- ''
- '<center><aqua><bold>Hi %player_name%</bold></aqua></center>'
- ''
- '<center><gray>What do you think of this plugin?</gray></center>'
- ''
- '<dark_gray><st>-----------------------------------------------------'
Bossbar:
Enabled: true
Message: "<gradient:#ff5555:#5555ff>Look, a Bossbar with MiniMessage</gradient>"
Color: PINK
Style: SOLID
Actionbar:
Enabled: true
Message: "<gradient:#55ff55:#5555ff>And here you have one in ActionBar</gradient>"
Title:
Enabled: true
Title: "<blue>DS-Ads</blue>"
Subtitle: "<yellow>Thanks for another opportunity!</yellow>"
FadeIn: 10
Stay: 70
FadeOut: 20
Ad-Example-2:
worlds:
- world_nether
permission: ads.ad2
Chat:
Enabled: true
Sound: ENTITY_ENDER_DRAGON_GROWL
Ad-content:
- ''
- '<dark_gray><st>-----------------------------------------------------'
- ''
- '<center><red><bold>Explore the Nether</bold></red></center>'
- ''
- '<center><gray>Discover new challenges</gray></center>'
- ''
- '<dark_gray><st>-----------------------------------------------------'
Bossbar:
Enabled: true
Message: "<gradient:#ffaa00:#ff00aa>Brave the Nether</gradient>"
Color: RED
Style: SEGMENTED_10
Actionbar:
Enabled: true
Message: "<gradient:#ff5555:#ffaa00>Watch out for the Ghasts!</gradient>"
Title:
Enabled: true
Title: "<dark_red>Nether Adventures</dark_red>"
Subtitle: "<gold>Are you ready?</gold>"
FadeIn: 20
Stay: 100
FadeOut: 30
Ad-Example-3:
worlds:
- world_the_end
permission: ads.ad3
Chat:
Enabled: true
Sound: ENTITY_ENDERMAN_SCREAM
Ad-content:
- ''
- '<dark_gray><st>-----------------------------------------------------'
- ''
- '<center><light_purple><bold>Conquer the End</bold></light_purple></center>'
- ''
- '<center><gray>Ultimate challenge awaits</gray></center>'
- ''
- '<dark_gray><st>-----------------------------------------------------'
Bossbar:
Enabled: true
Message: "<gradient:#5b00a4:#a400a4>Defeat the Ender Dragon</gradient>"
Color: PURPLE
Style: SEGMENTED_6
Actionbar:
Enabled: true
Message: "<gradient:#a4005b:#5b00a4>End Cities and Shulkers</gradient>"
Title:
Enabled: true
Title: "<dark_purple>End Exploration</dark_purple>"
Subtitle: "<light_purple>Gather your gear!</light_purple>"
FadeIn: 15
Stay: 150
FadeOut: 40
BungeeCord Configuration (bSettings.yml)
# Version of the configuration file, do not
# modify this file or you will disrupt the
# version and a new file will be created.
Config-Version: 8.0.0
Plugin-Version: 8.3
# Plugin Settings, you can edit them according to your needs.
Plugin-Configuration:
Enabled: true
# Plugin permissions
Plugin-Permissions:
Send-Ads: ads.send
Manage-Ads: ads.manage
Reload-Plugin: ads.reload
# Plugin messages, you can edit them according to your needs.
Messages:
Prefix: '<aqua>Fruit<white>Forge <dark_gray><bold>» <reset>'
No-Perms: "<red>You dont have permissions to run this command"
No-Subcmd: "<red>This command doesnt exist"
No-Ad-Found: "<red>This ad doesnt exist"
No-Player-Found: "<red>This player doesnt exist"
Ad-Failed: "<red>Error sending ad to player"
Reloaded-Sucess: "<green>Config was reloaded correctly"
Only-players: "<red>This command can only be used by players"
Disabled-Plugin: "<red>The plugin was successfully disabled"
Already-Disabled-Plugin: "<red>The plugin is already disabled"
Enabled-Plugin: "<green>The plugin was successfully enabled"
Already-Enabled-Plugin: "<red>The plugin is already enabled"
Everyone-Send: "<green>Ad sent to all players"
Player-Send: "<green>Ad sent correctly to the player"
Usage: "<yellow>Usage: /ads send <AdName> <Player/*>"
Welcome-Ad:
Enabled: true
WelcomeAd-Content:
# / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / /
Chat:
Enabled: true
Ad-content:
- ''
- '<dark_gray><st>-----------------------------------------------------'
- ''
- '<center><aqua><bold>Welcome %player_name%</bold></aqua></center>'
- ''
- '<center><gray>Thank you for downloading the plugin</gray></center>'
- ''
- '<dark_gray><st>-----------------------------------------------------'
Title:
Enabled: true
Title: "<blue>DS-Ads</blue>"
Subtitle: "<yellow>Thanks for another opportunity!</yellow>"
FadeIn: 10
Stay: 70
FadeOut: 20
# Advertisement configuration, you can set up as many as
# you want with restrictions that suit your needs
# Advertisement configuration, you can set up as many as you want with restrictions that suit your needs
Ads-Configuration:
Ads-Cooldown: 15 # In Seconds, For all ads
Ad-Example-1:
servers:
- lobby
permission: ads.ad1
Chat:
Enabled: true
Ad-content:
- ''
- '<dark_gray><st>-----------------------------------------------------'
- ''
- '<center><aqua><bold>Hi %player_name%</bold></aqua></center>'
- ''
- '<center><gray>What do you think of this plugin?</gray></center>'
- ''
- '<dark_gray><st>-----------------------------------------------------'
Title:
Enabled: true
Title: "<blue>DS-Ads</blue>"
Subtitle: "<yellow>Thanks for another opportunity!</yellow>"
FadeIn: 10
Stay: 70
FadeOut: 20
Ad-Example-2:
servers:
- survival
- skyblock
permission: ads.ad2
Chat:
Enabled: true
Ad-content:
- ''
- '<dark_gray><st>-----------------------------------------------------'
- ''
- '<center><red><bold>Explore the Server</bold></red></center>'
- ''
- '<center><gray>Discover new challenges</gray></center>'
- ''
- '<dark_gray><st>-----------------------------------------------------'
Title:
Enabled: true
Title: "<dark_red>Server Adventures</dark_red>"
Subtitle: "<gold>Are you ready?</gold>"
FadeIn: 20
Stay: 100
FadeOut: 30
Ad-Example-3:
servers:
- minigames
- events
permission: ads.ad3
Chat:
Enabled: true
Ad-content:
- ''
- '<dark_gray><st>-----------------------------------------------------'
- ''
- '<center><light_purple><bold>Join the Minigames</bold></light_purple></center>'
- ''
- '<center><gray>Ultimate challenge awaits</gray></center>'
- ''
- '<dark_gray><st>-----------------------------------------------------'
Title:
Enabled: true
Title: "<dark_purple>Minigame Time</dark_purple>"
Subtitle: "<light_purple>Gather your gear!</light_purple>"
FadeIn: 15
Stay: 150
FadeOut: 40
Velocity Configuration (vSettings.yml)
# Version of the configuration file, do not
# modify this file or you will disrupt the
# version and a new file will be created.
Config-Version: 8.0.0
Plugin-Version: 8.3
# Plugin Settings, you can edit them according to your needs.
Plugin-Configuration:
Enabled: true
# Plugin permissions
Plugin-Permissions:
Send-Ads: ads.send
Manage-Ads: ads.manage
Reload-Plugin: ads.reload
# Plugin messages, you can edit them according to your needs.
Messages:
Prefix: '<aqua>Fruit<white>Forge <dark_gray><bold>» <reset>'
No-Perms: "<red>You dont have permissions to run this command"
No-Subcmd: "<red>This command doesnt exist"
No-Ad-Found: "<red>This ad doesnt exist"
No-Player-Found: "<red>This player doesnt exist"
Ad-Failed: "<red>Error sending ad to player"
Reloaded-Sucess: "<green>Config was reloaded correctly"
Only-players: "<red>This command can only be used by players"
Disabled-Plugin: "<red>The plugin was successfully disabled"
Already-Disabled-Plugin: "<red>The plugin is already disabled"
Enabled-Plugin: "<green>The plugin was successfully enabled"
Already-Enabled-Plugin: "<red>The plugin is already enabled"
Everyone-Send: "<green>Ad sent to all players"
Player-Send: "<green>Ad sent correctly to the player"
Usage: "<yellow>Usage: /ads send <AdName> <Player/*>"
Welcome-Ad:
Enabled: true
WelcomeAd-Content:
# / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / /
Chat:
Enabled: true
Ad-content:
- ''
- '<dark_gray><st>-----------------------------------------------------'
- ''
- '<center><aqua><bold>Welcome %player_name%</bold></aqua></center>'
- ''
- '<center><gray>Thank you for downloading the plugin</gray></center>'
- ''
- '<dark_gray><st>-----------------------------------------------------'
Title:
Enabled: true
Title: "<blue>DS-Ads</blue>"
Subtitle: "<yellow>Thanks for another opportunity!</yellow>"
FadeIn: 10
Stay: 70
FadeOut: 20
# Advertisement configuration, you can set up as many as
# you want with restrictions that suit your needs
# Advertisement configuration, you can set up as many as you want with restrictions that suit your needs
Ads-Configuration:
Ads-Cooldown: 15 # In Seconds, For all ads
Ad-Example-1:
servers:
- lobby
permission: ads.ad1
Chat:
Enabled: true
Ad-content:
- ''
- '<dark_gray><st>-----------------------------------------------------'
- ''
- '<center><aqua><bold>Hi %player_name%</bold></aqua></center>'
- ''
- '<center><gray>What do you think of this plugin?</gray></center>'
- ''
- '<dark_gray><st>-----------------------------------------------------'
Title:
Enabled: true
Title: "<blue>DS-Ads</blue>"
Subtitle: "<yellow>Thanks for another opportunity!</yellow>"
FadeIn: 10
Stay: 70
FadeOut: 20
Ad-Example-2:
servers:
- survival
- skyblock
permission: ads.ad2
Chat:
Enabled: true
Ad-content:
- ''
- '<dark_gray><st>-----------------------------------------------------'
- ''
- '<center><red><bold>Explore the Server</bold></red></center>'
- ''
- '<center><gray>Discover new challenges</gray></center>'
- ''
- '<dark_gray><st>-----------------------------------------------------'
Title:
Enabled: true
Title: "<dark_red>Server Adventures</dark_red>"
Subtitle: "<gold>Are you ready?</gold>"
FadeIn: 20
Stay: 100
FadeOut: 30
Ad-Example-3:
servers:
- minigames
- events
permission: ads.ad3
Chat:
Enabled: true
Ad-content:
- ''
- '<dark_gray><st>-----------------------------------------------------'
- ''
- '<center><light_purple><bold>Join the Minigames</bold></light_purple></center>'
- ''
- '<center><gray>Ultimate challenge awaits</gray></center>'
- ''
- '<dark_gray><st>-----------------------------------------------------'
Title:
Enabled: true
Title: "<dark_purple>Minigame Time</dark_purple>"
Subtitle: "<light_purple>Gather your gear!</light_purple>"
FadeIn: 15
Stay: 150
FadeOut: 40
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.send
Usage:
/ads send Ad-Example-1 PlayerName
- Send to specific player/ads send Ad-Example-1 *
- Send to all players
/ads reload
/ads reload
Reload the plugin configuration.
Required permission:
ads.reload
Usage:
/ads reload
/ads enable
/ads enable
Enable the plugin globally.
Required permission:
ads.manage
Usage:
/ads enable
/ads disable
/ads disable
Disable the plugin globally.
Required permission:
ads.manage
Usage:
/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:
PINK
BLUE
RED
GREEN
YELLOW
PURPLE
WHITE
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_PLING
ENTITY_ENDER_DRAGON_GROWL
ENTITY_ENDERMAN_SCREAM
ENTITY_PLAYER_LEVELUP
UI_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
.jar
file in your server'splugins/
folderRestart the server
Configure
Settings.yml
in 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
.jar
file in your proxy'splugins/
folderRestart the proxy
Configure
bSettings.yml
in 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
.jar
file in your proxy'splugins/
folderRestart the proxy
Configure
vSettings.yml
in 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
:
Your-Custom-Ad:
worlds: # For Spigot
- world
- world_nether
servers: # For BungeeCord/Velocity
- lobby
- survival
permission: ads.custom
Chat:
Enabled: true
Sound: BLOCK_NOTE_BLOCK_PLING # Spigot only
Ad-content:
- ''
- '<center><gradient:#ff0000:#00ff00>Custom Advertisement</gradient></center>'
- '<center><gray>Your custom message here</gray></center>'
- ''
Title:
Enabled: true
Title: "<rainbow>Custom Title</rainbow>"
Subtitle: "<yellow>Custom Subtitle</yellow>"
FadeIn: 10
Stay: 70
FadeOut: 20
Support
To report bugs or request features:
Discord: https://fruitforge.com/discord
Plugin developed by FruitForge Studio
Last updated