🍍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 globally

  • Disable-MCJoinLeave-Messages: true/false - (Spigot only) Disable default Minecraft join/leave messages

Plugin-Permissions

  • Send-Ads: ads.send - Permission to send advertisements manually

  • Manage-Ads: ads.manage - Permission to manage plugin settings

  • Reload-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 message

  • Sound: (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 message

  • Message: 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 message

  • Message: Action bar text with MiniMessage formatting

Title

  • Enabled: true/false - Enable title welcome message

  • Title: 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 advertisement

  • Sound: (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 advertisement

  • Message: 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 advertisement

  • Message: Action bar text with MiniMessage formatting

Title Advertisement

  • Enabled: true/false - Enable title advertisement

  • Title: 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/*>

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

Reload the plugin configuration.

  • Required permission: ads.reload

  • Usage: /ads reload

/ads enable

Enable the plugin globally.

  • Required permission: ads.manage

  • Usage: /ads enable

/ads disable

Disable the plugin globally.

  • Required permission: ads.manage

  • Usage: /ads disable

Permissions

Permission
Description
Default

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 bar

  • SEGMENTED_6 - 6 segments

  • SEGMENTED_10 - 10 segments

  • SEGMENTED_12 - 12 segments

  • SEGMENTED_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

  1. Initialization: Plugin loads configuration and sets up advertisement system

  2. Player Join: Welcome advertisements are displayed to new players (if enabled)

  3. Advertisement Cycling: Advertisements are sent automatically based on cooldown settings

  4. Manual Sending: Staff can manually send specific advertisements to players

  5. Targeting: System checks player permissions and location/server before displaying ads

Installation

Spigot/Paper Installation

  1. Download the Spigot version of DS-Ads-Renewed

  2. Place the .jar file in your server's plugins/ folder

  3. Restart the server

  4. Configure Settings.yml in the plugins/DS-Ads-Renewed/ folder

  5. Set up permissions as needed

  6. Reload the plugin with /ads reload

BungeeCord Installation

  1. Download the BungeeCord version of DS-Ads-Renewed

  2. Place the .jar file in your proxy's plugins/ folder

  3. Restart the proxy

  4. Configure bSettings.yml in the plugins/DS-Ads-Renewed/ folder

  5. Set up permissions as needed

  6. Reload the plugin with /ads reload

Velocity Installation

  1. Download the Velocity version of DS-Ads-Renewed

  2. Place the .jar file in your proxy's plugins/ folder

  3. Restart the proxy

  4. Configure vSettings.yml in the plugins/DS-Ads-Renewed/ folder

  5. Set up permissions as needed

  6. 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