# 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)

```yaml
# 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)

```yaml
# 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)

```yaml
# 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 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&#x20;*****(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&#x20;*****(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`:

```yaml
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*