PremiumAds - Player Based Announcements

This plugin has been discontinued and will no longer receive updates. An updated and active alternative with a similar concept is available here.

Let your players broadcast in chat for a price!

This could be used to advertise faction recruitment or advertise a skyblock island shop - It’s great for all kind of servers!

◉ Full Customisation - Adjust all settings and messages to your servers' needs!

◉ Compatible with 1.8.x - 1.13 - The plugin supports most major server versions.

◉ Announcement sounds - Makes sure your players are informed about the announcements!

◉ Custom Ad Credits System - A custom economy built into the plugin!

◉ Supports Third Party Plugins - Not a fan of the Ad Credits? Use Vault or TokenManager.

◉ Formatted Cooldowns - It presents cooldowns in 00h 00m 00s format!

◉ Word Blacklist - Want to block certain words from being broadcasted? This feature will help you!

◉ Easy Configuration - The configuration is simple and straightforward to use!

◉ Flat File Storage - Ad Credit balances are stored in a credits.yml file.

/premiumads help

/premiumads reload

/premiumads reset <player>

/advertise <message>

• Advertise in chat
• Permission » premiumads.advertise
  • Use color codes in message
    • Permission » premiumads.advertise.color

Bypass Permissions

• Bypass all checks
• Permission » premiumads.bypass.*
  • Cooldown check
    • Permission » premiumads.bypass.cooldown
  • Cost check
    • Permission » premiumads.bypass.cost
  • Word blacklist check
    
    • Permission » premiumads.bypass.blocked

All Credits Permissions

• All credits related permissions
  • Permission » premiumads.credits.*

/premiumads credits balance [player]

• Check the amount of Ad Credits you have
• Permission » premiumads.credits.balance
  • Check other players balances
    • Permission » premiumads.credits.balance.others

/premiumads credits add <player> <amount>

• Add Ad Credits to a players balance
  • Permission » premiumads.credits.add

/premiumads credits take <player> <amount>

• Remove Ad Credits to a players balance
  • Permission » premiumads.credits.take

/premiumads credits set <player> <amount>

/credits [player]

• Check the amount of Ad Credits you have
• Permission » premiumads.credits.balance
  • Check other players balances
    • Permission » premiumads.credits.balance.others

NOTE: Operators have all of these permissions by default

Config.yml

#-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=#
#      ____                     _                    _       _             #
#     |  _ \ _ __ ___ _ __ ___ (_)_   _ _ __ ___    / \   __| |___         #
#     | |_) | '__/ _ \ '_ ` _ \| | | | | '_ ` _ \  / _ \ / _` / __|        #
#     |  __/| | |  __/ | | | | | | |_| | | | | | |/ ___ \ (_| \__ \        #
#     |_|   |_|  \___|_| |_| |_|_|\__,_|_| |_| |_/_/   \_\__,_|___/        #
#                                                                          #
#                            By ItsLewizzz                                 #
#-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=#
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
# GENERAL SETTINGS
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#

# Check for plugin updates (recommended true)
update-check: true

# Players will not be allowed to advertise in these worlds
disabled-worlds:
  - 'disabled_world_here'
  - 'world_the_end'

# Words here will not be allowed in advertisements
blocked-words:
  - 'blockedwordtest'

Currency:
  # Types available:

  # CREDITS - Our very own built in Ad Credits system
  # MONEY - Requires Vault (https://dev.bukkit.org/projects/vault)
  # TOKENMANAGER - Requires TokenManager (https://www.spigotmc.org/resources/tokenmanager.8610/)

  Type: CREDITS

  # This will only work if the type value is set to 'CREDITS'
  Credits:
   Cost: 1
   No_Funds: '%prefix% &7You need &e%credits% &6Ad Credits &7to make an advertisement!'
   Paid: '%prefix% &aYou have paid &e%credits% &6Ad Credits &afor an advertisement!'

  # This will only work if the type value is set to 'MONEY'
  Money:
   Cost: 250
   No_Funds: '%prefix% &7You need &e$%money% &7to make an advertisement!'
   Paid: '%prefix% &aYou have paid &e$%money% &afor an advertisement!'
 
  # This will only work if the type value is set to 'TOKENMANAGER'
  TokenManager:
   Cost: 20
   No_Funds: '%prefix% &7You need &e%tokens% &7tokens to make an advertisement!'
   Paid: '%prefix% &aYou have paid &e%tokens% &atokens for an advertisement!'

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
# PLUGIN SETTINGS
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#

Broadcast:

  Cooldown:
    # Cooldown time in minutes
    Cooldown_Time: 1
    Cooldown_Active: '%prefix% &cYou must wait &f%time% &cbefore sending another announcement!'

  Sound:
    Enabled: true
    # 1.8 equivalent to this sound is NOTE_PLING
    Sound: BLOCK_NOTE_PLING

  Message:
    - '&8&m+------------&r&8( &e&lPLAYER ADVERTISEMENT &8)&8&m------------+'
    - ''
    - '&bMessage: &r%message%'
    - '&7&oSent by %player%'
    - '&8&m+--------------------------------------------------+'

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#
# PLUGIN MESSAGES
#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~#

Messages:
  Prefix: '&6PremiumAds &8|'
  No_Permission: '%prefix% &cYou do not have permission to do this!'
  Invalid_Arguments: '%prefix% &cInvalid arguments! Use &e/premiumads help &cto view the help.'
  Config_Reload: '%prefix% &aConfiguration has been reloaded!'
  Disabled_World: '%prefix% &cYou are not allowed to make announcements in this world!'
  Cooldown_Reset_Usage: '%prefix% &cUsage: &e/premiumads reset <player>'
  Cooldown_Reset: '%prefix% &7You have reset the cooldown for &e%player%'
  Invalid_Player: '%prefix% &e%player% &cis not online!'
  Advertise_Usage:
    - '%prefix% &cUsage: &e/advertise <message>'
    - '%prefix% &cBroadcast global messages to the server'
  Blocked_Word: '%prefix% &e%word% &cis not allowed in advertisements!'

  Credits:
    Credits_Not_Enabled: '%prefix% &6Ad Credits &7are not enabled! To enable the use of &6Ad Credits&7, go to your config and set the currency type to credits!'
    Credits_Invalid_Arguments: '%prefix% &cUsage: &e/premiumads credits <add/take/set> <player> <amount>'
    Credits_Invalid_Number: '%prefix% &e%invalid_number% &cis an invalid number or is out of the range!'
    Credits_Balance: '%prefix% &7You have &e%credits% &6Ad Credits'
    Credits_Balance_Other: '%prefix% &e%player% &7has &e%credits% &6Ad Credits'
    Credits_Set: '%prefix% &7You have set &e%credits% &6Ad Credits &7to &e%player%'
    Credits_Added: '%prefix% &e%credits% &6Ad Credits &7have been &aadded &7to &e%player%'
    Credits_Removed: '%prefix% &e%credits% &6Ad Credits &7have been &cremoved &7from &e%player%'

  Errors:
    Invalid_Currency_Type: '%prefix% &cThe currency type specified in the configuration is invalid! &7(Valid Types: CREDITS, MONEY, TOKENMANAGER)'
    Vault_Not_Found: '%prefix% &cVault plugin not found! Please contact a server administrator.'
    TokenManager_Not_Found: '%prefix% &cTokenManager plugin not found! Please contact a server administrator.'

Valid Currency Types

CREDITS
Built-in Ad Credits system.

MONEY
Money from the Vault plugin
Requires: https://dev.bukkit.org/projects/vault

TOKENMANAGER
Tokens from the TokenManager plugin
Requires: https://www.spigotmc.org/resources/tokenmanager.8610/