GBooster 1.4.2

Global Booster Plugin (Jobs/McMMO/Minecraft)

  1. leop2
    Native Minecraft Version:
    1.17
    Tested Minecraft Versions:
    • 1.17
    • 1.18
    Source Code:
    https://github.com/TamrielNetwork/GBooster
    Contributors:
    zManu__

    [​IMG] [​IMG] [​IMG] [​IMG] [​IMG] [​IMG]

    About The Project


    Description

    GBooster is a Booster Plugin created to provide Global Boosters for JobsReborn, McMMO and Minecraft!

    This plugin is perfect for any server wishing to receive donations from their players without becoming pay to win!

    Features

    • Global Minecraft Experience Boosters
    • Global McMMO Experience Boosters
    • Global Jobs Experience and Money Boosters
    • MySQL/MariaDB support
    • A Bar that shows active boosters and hides automatically when there are none active
    • Support for scheduled boosters from JobsReborn
    • Placeholders and the ability to create a menu to activate boosters through DeluxeMenus for example

    Built With


    Getting Started


    To get the plugin running on your server follow these simple steps.

    Commands and Permissions

    1. Permission: gbooster.give
    • Command: /gbooster give <player> <boosterid> <amount>
    • Description: Give a player a certain amount of boosters

    2. Permission: gbooster.use
    • Command: /gbooster use <boosterid>
    • Description: Use a specified booster

    3. Permission: gbooster.time
    • Command: /gbooster time
    • Description: Shows time of booster that ends next

    Configuration

    config.yml

    Code (YAML):

    #---------------------------------------------------------------#
    #   __________________                       __                 #
    #  /  _____/\______   \ ____   ____  _______/  |_  ___________  #
    # /   \  ___ |    |  _//  _ \ /  _ \/  ___/\   __\/ __ \_  __ \ #
    # \    \_\  \|    |   (  <_> |  <_> )___ \  |  | \  ___/|  | \/ #
    #  \______  /|______  /\____/ \____/____  > |__|  \___  >__|    #
    #         \/        \/                  \/            \/        #
    #---------------------------------------------------------------#

    # This bar will be displayed in order when boosters are active
    # To not display anything for specified values set them to: ""
    # Set every value to "" to disable the bar.
    bar-pattern
    :
      minecraft
    : "&a%minecraft%% &fExp"
      mcmmo
    : "&a%mcmmo%% &fMcMMO"
      jobs-xp
    : "&a%jobs_xp%% &fJob"
      jobs-money
    : "&a%jobs_money%% &e$"
      duration
    : " &7[&f%duration% min&7]"
      separator
    : " &8&mo&r "

    # Choose a storage system (mysql or yaml)
    storage-system
    : yaml

    # How often the plugin should save players (time in seconds)
    saving-time
    : 600

    mysql
    :
      host
    : "localhost"
      port
    : 3306
      database
    : gbooster
      username
    : "gbooster"
      password
    : ""
      prefix
    : "server_"
      # prefix: "" # Use for no prefix

    boosters
    :
      jobs_xp_2
    :
       # Choose from jobs_xp, jobs_money, mcmmo and minecraft
        type
    : jobs_xp
        # Choose a multiplier (only numbers from 1-8 -> +20% would be 1.2)
        multiplier
    : 2
        # Choose a duration (seconds)
        duration
    : 3600
      jobs_money_2
    :
        type
    : jobs_money
        multiplier
    : 2
        duration
    : 3600
      mcmmo_xp_2
    :
        type
    : mcmmo
        multiplier
    : 2
        duration
    : 3600
      minecraft_xp_2
    :
        type
    : minecraft
        # Don't use floating-point numbers for type minecraft!
        multiplier
    : 2
        duration
    : 3600
     

    messages.yml

    Code (YAML):

    cmd
    : "&fUsage: &b/gbooster use &3<booster>"
    give-boosters
    : "&fYou gave %amount% %booster% to %player%"
    # Comment line (#) below and uncomment the one below that to get a message!
    receive-boosters
    : [ ]
    #receive-boosters: "&aYou got &c%amount%x &b%booster%"
    active-booster
    : "&aYou just activated a booster"
    active-booster-broadcast
    : "&b%player%&a just activated a booster"
    no-active-booster
    : "&cThere is no active booster!"
    booster-timer
    : "&fNext booster ends in &b%duration%&f minutes."
    no-perms
    : "&cYou don't have enough permissions!"
    player-only
    : "&cThis command can only be executed by players!"
    invalid-player
    : "&cInvalid player!"
    invalid-booster
    : "&cID doesn't exist!"
    invalid-amount
    : "&cInvalid amount!"
    countdown-active
    : "&cYou can only use the same type of booster once!"
    limit
    : "&cThe global limit has been reached!"
    no-booster
    : "&cYou don't have a booster of this type!"
     

    Placeholders

    1. Display amount of boosters from player
    • Structure: %gbooster_ + booster_id¹ + %
    • ¹ Exact ID from config.yml including _, can be found under boosters:
    • Example: %gbooster_minecraft_xp_2%

    2. Display multiplier of booster id in percent
    • Structure: %gbooster_ + booster_id¹ + _multiplier%
    • ¹ Exact ID from config.yml including _, can be found under boosters:
    • Example: %gbooster_minecraft_xp_2_multiplier%

    3. Display duration of booster id in minutes
    • Structure: %gbooster_ + booster_id¹ + _duration%
    • ¹ Exact ID from config.yml including _, can be found under boosters:
    • Example: %gbooster_minecraft_xp_2_duration%

    4. Display time until next booster runs out
    • Structure: %gbooster_time%

    5. Usage Example

    Roadmap


    See the open issues for a list of proposed features (and known issues).

    Contributing


    Contributions are what make the open source community such an amazing place to be, learn, inspire, and create. Any contributions you make are greatly appreciated.

    1. Fork the Project
    2. Create your Feature Branch git checkout -b feature/AmazingFeature
    3. Commit your Changes git commit -m 'Add some AmazingFeature'
    4. Push to the Branch git push origin feature/AmazingFeature
    5. Open a Pull Request

    License


    Distributed under the GNU General Public License v3.0. See LICENSE for more information.

    Contact


    Leopold Meinel - @TamrielN - Twitter

    Leopold Meinel - [email protected] - eMail

    Project Link - GBooster - Github

    Acknowledgements

    Houdeeny and MishaNeYT like this.

Recent Reviews

  1. DaddyHammy
    DaddyHammy
    5/5,
    Version: 1.4.1
    Amazing plugin. Does exactly as intended, would be awesome to see a way to reload the plugin and force stop/pause boosts.
    1. leop2
      Author's Response
      Thanks a lot for the nice review!
      I might add that functionality in the future, at the moment that isn't a priority tho.
  2. LuciusHusky
    LuciusHusky
    5/5,
    Version: 1.3.2
    I like the plugin, but would it be possible to add an option to the config where you can change the cooldown that lasts before you can do another boost?
    1. leop2
      Author's Response
      I just saw your comment, sorry.
      I will add that in the next release and add it to my to-do list :)
      Tbh, I thought I already had that.
  3. IzoTope
    IzoTope
    5/5,
    Version: 1.0.5
    A fly booster would be cool, so everyone can fly
    .
    1. leop2
      Author's Response
      Thats a nice idea! The plugin is mainly focused on skills and money atm. If I find the time Ill try to add that for sure tho! Thanks for the review.