📚Information

Highly optimized, feature-packed, and unique Boosters plugin

Elevate your server’s gameplay with the AbyssBoosters plugin, designed to offer both global and personal boosters that enhance the gaming experience. Global boosters provide server-wide enhancements, while personal boosters deliver tailored benefits to individual players. With a variety of powerful effects, players can activate boosters to gain significant advantages and improve their in-game performance. Enjoy advanced features like stack limits, dynamic menus, and external boosters for a fully customizable and engaging experience.

Highlights

• Stack Limits: Control stack limits for both boosters and their assigned categories, allowing for balanced and strategic use.

• Flexible Stacking Options: Choose whether to stack booster time, multipliers, both, or neither for tailored effects.

• Dynamic Menu: Experience an interactive menu that updates in real-time, so you can monitor booster time and effects as they progress.

• External Boosters: Implement permanent external boosters that can be added or removed via commands or the API, with specific labels for easy management.

• Unified Booster Menu: View all server boosters in a single, consolidated menu, making it simple to track and manage various effects.

Short Showcase Video

Interested in purchasing the plugin? Visit https://blockm.art or join our Discord server and open a ticket!

Commands

Arguments wrapped in diamonds <arg> are required for the command to run properly. Arguments wrapped in square braces[arg] are treated as optional

Admin Commands (Permission: abyssboosters.admin)

• /boosters give <player> <PERSONAL || GLOBAL> <booster> <amount>

  • Gives a player an amount of specified personal or global boosters

• /boosters addexternal <player> <boost-category> <custom-source-label> <multiplier>

  • Adds an external boost with a custom label to a player, mainly used to unify server boosters in the GUI and handle all player/server boosts through TideBoosters.

• /boosters delexternal <player> <boost-category> <custom-source-label>

  • Deletes an external boost from a category with the specified label if it is present. Used to remove boosters that are no longer unified or active (For example, unequipping a pet)

• /boosters help

  • Sends the admin help message if the permission is met, otherwise sends the player help message to the command sender.

• /boosters reload

  • Reloads the TideBoosters plugin and configuration files

Player Commands (Permission: None unless specified)

• /boosters

  • Opens the boosters menu

Default Configuration Files

Default Global Booster Config File

global/global-money.yml

settings:
    name: "1.5x Global Money Booster"
    multiplier: 0.5
    time: 60 # Seconds
    boost-category: "money" # Where to sort the boost under in the menu
    boost-format:  "&a&l→ &7%name%: &f%boost%x&7 (&f%time%&7)"

limit-settings:
    limit: 3
    stack-time: true

item:
    enchanted: true
    material: "EMERALD"
    name: "&2&l[&a&l!&2&l] &a1.5x Global Money Booster &7(Right-Click)"
    lore:
        - " "
        - "&aInformation"
        - "&a&l→ &7Multiplier: &f1.5x"
        - "&a&l→ &7Time: &f1 minute"
        - " "
        - "&6&nThis booster activates for the entire server."
        - " "
        - "&7&o(( Right-Click to &f&oactivate&7&o this booster! )) "

Default Personal Booster Config File

personal/personal-money.yml

settings:
    name: "1.5x Personal Money Booster"
    multiplier: 0.5
    time: 60 # Seconds
    boost-category: "money" # Where to sort the boost under in the menu
    boost-format:  "&a&l→ &7%name%: &f%boost%x&7 (&f%time%&7)"

limit-settings:
    limit: 3
    stack-multiplier: false
    stack-time: true

item:
    enchanted: true
    material: "EMERALD"
    name: "&2&l[&a&l!&2&l] &a1.5x Money Booster &7(Right-Click)"
    lore:
        - " "
        - "&aInformation"
        - "&a&l→ &7Multiplier: &f1.5x"
        - "&a&l→ &7Time: &f1 minute"
        - " "
        - "&7&o(( Right-Click to &f&oactivate&7&o this booster! )) "

Default Booster Category Config File

categories/money.yml

settings:
    external-boost-format:  "&a&l→ &f%boost%x &7External Money Boost&7 (&f%source%&7)"

boosts:
    - "shopguiplus"

allow-multiple-types-of-boosters:
    enabled: true
    personal-limit: 3 # 3 Different Types of Boosters, does not count for stacked boosters
    global-limit: 1

menu-item:
    material: "EMERALD"
    name: "&2&l[&a&l!&2&l] &aMoney Boosters"
    lore:
        - " "
        - "&aPersonal Boosts"
        - "%personal-boosts%"
        - "%external-boosts%"
        - " "
        - "&eGlobal Boosts"
        - "%global-boosts%"
        - " "
        - "&7&o(( You have a total boost of &f&o%total-boost%x&7&o. ))"

Menus Config File

menus.yml

menus:
    "booster-menu":
        title: "&8&lBOOSTERS"
        rows: 3
        borders:
            "gray":
                material: "GRAY_STAINED_GLASS_PANE"
                name: " "
                lore: []
                slots:
                    - "0-26"
            "white":
                material: "WHITE_STAINED_GLASS_PANE"
                name: " "
                lore: []
                slots:
                    - "11-11"
                    - "13-13"
                    - "15-15"
        boost-categories:
            "money":
                category: "money"
                slot: 11

Messages Config File

lang.yml

messages:
    "shopguiplus-boost":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &8&l→ &7You received an extra &a$%amount%&7. &7(/boosters)"
    "experience-boost":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &8&l→ &7You received an extra &d%amount%x&7 exp. &7(/boosters)"
    "tideeconomy-credits-boost":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &8&l→ &7You received an extra &c🪙 %amount%x&7 credit(s). &7(/boosters)"
    "coralprisons-vault-boost":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &8&l→ &7You received an extra &a$%amount%&7. &7(/boosters)"
    "no-permission":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7You do not have &cpermission&7 to perform this action."
    "reloaded":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &f&l→ &7You have successfully reloaded &bTideBoosters&7 in &b%time%ms&7."
    "invalid-player":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7You have specified an &cinvalid player&7."
    "invalid-booster-type":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7You must specify a valid booster type! &8(&fGLOBAL &7| &fPERSONAL&8)"
    "invalid-category":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7You must specify a valid &ccategory&7 type."
    "invalid-booster":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7You have specified an &cinvalid booster&7."
    "invalid-amount":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7You have specified an &cinvalid amount&7."
    "invalid-source":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7You have specified an &cinvalid source&7."
    "does-not-have-external-boost-in-category":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7The player specified has no external boosters in the specified &ccategory&7."
    "already-has-external-booster":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7The player you have specified already has an &cexternal boost&7 with that source and category."
                - "&7&o(( &f&oTip: &7&oTry specifying a new source-label or remove it and try again! ))"
    "stacking-limit-reached":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7You cannot stack anymore of this type of &cbooster&7!"
    "stacking-disallowed":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &8&l→ &7You are unable to stack &cboosters&7 of this type."
    "activated-personal-booster":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &8&l→ &7You have activated a(n) &b%booster%&7."
    "activated-global-booster-broadcast":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &8&l→ &b%player%&7 has activated a(n) &b%booster%&7."
                - "&7&o(( All players can enjoy the &f&operks&7&o of this booster! ))"
    "given-booster-to-player":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &8&l→ &7You have given &b%player% %amount%x %booster%&7(s)."
    "received-booster":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &8&l→ &7You have been given &b%amount%x %booster%&7(s) by &b%player%&7."
    "added-external-boost-to-player":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &8&l→ &7You have added a &b%multiplier%x&7 external boost to &b%player%&7 with source &b%source%&7."
    "removed-external-boost-from-player":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &8&l→ &7You have removed a &7the external boost in category &b%category%&7 with source &b%source%&7 from &b%player%&7."
    "admin-help":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&f&m----------------------------------"
                - " "
                - "&b&lTech&3&lTide &7— &bBoosters Admin Help"
                - "&7&oCarefully crafted with expertise by &f&oindustry leaders&7&o."
                - " "
                - "&7<> = Required"
                - "&7[] = Optional"
                - " "
                - "&b&lCommands"
                - "&b&l→ &7/tb give <player> <personal|global> <type> <amount>"
                - "&b&l→ &7/tb addexternal <player> <category> <source> <multiplier>"
                - "&b&l→ &7/tb delexternal <player> <category> <source>"
                - "&b&l→ &7/tb reload"
                - " "
                - "&f&m----------------------------------"
    "player-help":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&f&m----------------------------------"
                - " "
                - "&b&lTech&3&lTide &7— &bBoosters Help"
                - "&7&oCarefully crafted with expertise by &f&oindustry leaders&7&o."
                - " "
                - "&7<> = Required"
                - "&7[] = Optional"
                - " "
                - "&b&lCommands"
                - "&b&l→ &7/boosters"
                - " "
                - "&f&m----------------------------------"

Settings Config File

settings.yml

command:
    base-command-name: "boosters"
    aliases:
        - "booster"
        - "tb"
        - "tideboosters"
        - "tidebooster"
        - "tbooster"
        - "tboosters"
        - "boost"
    sub-commands:
        "reload":
            base-alias: "reload"
            aliases: []
        "help":
            base-alias: "help"
            aliases: []
        "give":
            base-alias: "give"
            aliases: []
            not-enough-args:
                sound:
                    enabled: true
                    value: "FIZZ"
                    volume: 1
                    pitch: 1
                message:
                    enabled: true
                    value:
                    - "&c&lTech&4&lTide &8&l→ &7Invalid arguments! Proper usage: &c/tb give <player> <personal|global> <type> <amount>"
        "addexternal":
            base-alias: "addexternal"
            aliases:
                - "addext"
                - "putext"
                - "putexternal"
            not-enough-args:
                sound:
                    enabled: true
                    value: "FIZZ"
                    volume: 1
                    pitch: 1
                message:
                    enabled: true
                    value:
                        - "&c&lTech&4&lTide &8&l→ &7Invalid arguments! Proper usage: &c/tb addexternal <player> <category> <source> <multiplier>"
        "delexternal":
            base-alias: "delexternal"
            aliases:
                - "delext"
                - "removeexternal"
                - "remext"
            not-enough-args:
                sound:
                    enabled: true
                    value: "FIZZ"
                    volume: 1
                    pitch: 1
                message:
                    enabled: true
                    value:
                        - "&c&lTech&4&lTide &8&l→ &7Invalid arguments! Proper usage: &c/tb delexternal <player> <category> <source>"

Storage Config File

storage.yml

storage:
    type: "JSON" # JSON | SQL
    host: 0.0.0.0
    username: "username"
    password: "password"
    database: "database"
    port: 3306