✓ BossReferral [1.7/1.8/1.9/1.10] [MySQL/Flatfile] 2.1.0

data:
  # If you would like to use mysql as your storage method or not.
  # If true, you must provide the correct mysql-settings below.
  # If not, it will use file storage, which doesn't require configuration.
  use-mysql: true
  mysql-settings:
    # The host of your mysql server
    host: 'localhost'
    # The port of your mysql server
    port: 3306
    # The username to authenticate to your mysql server (must have access to the database below)
    user: 'bossreferrals'
    # The password to authenticate with the username
    password: 'secret'
    # The name of the database to use
    database: 'bossreferrals'

# Main settings of BossReferral
settings:
  # The default limit of how many you can officially refer through the plugin.
  default-max-referrals: 3
  # Specifiy group-based limits of how many you can officially refer through the plugin. Use -1 to disable the limit for that group.
  max-referrals-for:
    donator: 5
    moderator: 10
    admin: -1
  # The maximum amount of active codes a user can have on his account.
  max-active-codes: 10
  # The length of the code generated through /brs generate. Minimum of 8 is recommended
  code-length: 10
  # Allow players to be referred by someone else on the same ip address. It's recommended to keep this false.
  allow-same-ip-redeem: false
  # You can enable this to use player names instead of referral codes.
  use-player-names: false
  # Specify time in seconds before someone can execute the /brs redeemcode command. Set to 0 to disable.
  time-before-redeem: 0
  # Specify if some commands should have a small cooldown. It's recommended to keep this true.
  commands-cooldown: true
  # Specify your primary world name.
  primary-world-name: "world"
  # If false, commands under "execute-console-commands" will be directly executed on redeem wheter the player is online or not.
  # By having this true, the commands will be executed the first moment that player joins the game.
  # If you would like to execute commands on an online player, then this is recommended to be true.
  execute-commands-login: true

# Specify rewards for both the referrer and the newbie. Note that the convention of all the rewards (giving money, executing commands and giving items)
# is all the same. This means that even in this example one of the above is not specified, it doesn't mean it isn't supported. You can for example add a
# "giveitems" section under the referrer section.
rewards:
  # All rewards for the referrer
  referrer:
    # How many money to give to the referrer once someone is referred by this player.
    givemoney: 25
    # What console commands should be executed once someone is referred by this player.
    execute-console-commands:
    - "say %referrer% has invited %newbie% to this server! Welcome %newbie%"
    # You could optionally have a "giveitems" section here aswell. It should be in the same format as the default one under "newbie". See note above "rewards".
  newbie:
    # How many money to give to the newbie if he executes the /brs redeemcode command successfully.
    givemoney: 25
    # What items should be given to the newbie if he executes the /brs redeemcode command successfully. Remove this complete block to give no items.
    giveitems:
      # The item id
      267:
        # The amount of items to give
        amount: 1
        # (optional) The name of the item
        name: "&9Newbie's sword"
        # (optional) The lore of the item
        lore:
        - "&6This is an unique item."
        # (optional) Enchants of the item. To look up all enchantments, look at:
        # https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html
        enchantments:
          # The name of the enchantment, please look up the above document for all names.
          DAMAGE_ALL:
            # The level of the enchantment.
            level: 1
      # ... more items ...
  # Specials are certain rewards given if a milestone has been reached.
  specials:
    # Milestone: 5: Given if someone has referred 5 players. All rewards that you have seen above are also possible in this section.
    5:
      givemoney: 500
      execute-console-commands:
      - "say %referrer% has invited an total of 5 players!"
    # Milestone: 10: Given if someone has referred 10 players. All rewards that you have seen above are also possible in this section.
    10:
      givemoney: 1250
      execute-console-commands:
      - "say %referrer% has invited an total of 10 players!"
    # You can of course change the milestone's number, remove and/or add new milstones.

commands:
  brs:
    general:
      players-only: "&cThis command is for players only."
      no-permission: "&cYou do not have permission to do this!"
      not-loaded: "&cIt seems like you are not loaded yet -- please wait a few seconds before trying this command again. If that doesnt solve this issue, please contact your server administrator."
      wait: "&cPlease wait 2 seconds between BossReferral commands."
    redeemcode:
      already-referred: "&cYou are already referred!"
      use-own-name: "&cYou can't use your own name!"
      redeem-localhost: "&cYou can't redeem an code from an localhost player!"
      redeem-early: "You can't redeem an code yet. You need to play at least %MINUTES% minutes before you can redeem an code."
      referrer-limited: "&cYour referrer has reached the maximum amount of refers!"
      player-doesnt-exist: "&cThat player does not exist!"
      use-own-code: "&cYou can't use your own codes!"
      code-doesnt-exist: "&cThat code does not exist!"
      redeem-successful-code: "&aYou have successfully redeemed the code!"
      redeem-successful-name: "&aYou have successfully redeemed the name!"
      inventory-full: "&cYour inventory is full and therefor your reward items are dropped under you!"
    help:
      help: "&aThis command gives more information about subcommands including an brief description and parameters."
      codes-disabled: "&cThis command is disabled on this server. Use player names instead."
      codes-enabled: "&aView an list of your current active codes."
      generate-disabled: "&cThis command is disabled on this server. Use player names instead."
      generate-enabled: "&aGenerate an new random code that you can use to refer someone."
      refertop: "&aSee the top player referrers. You can send an optional second parameter for the maximum place (eg 20). Second parameter must be an number."
      referstats: "&aSee statistics about an certain player or yourself. Optional second parameter must be the name of your target player."
      redeemcode-name: "Verify that you are referred by someone using their name. Second parameter must be your referrers name."
      redeemcode-code: "Verify that you are referred by someone using their code. Second parameter must be the code given by your referrer."
      reload: "&aReloads the configuration and all messages."
      not-found: "&cI didn't found that command. Please try again."
    referstats:
      not-found: "&cThat player does not exist in our database."
      name: "&7[&6BossReferral&7] &aName: &b%NAME%"
      referred: "&7[&6BossReferral&7] &aReferred: %REFERRED%"
      amount: "&7[&6BossReferral&7] &aAmount referred: &b%AMOUNT_REFERRED%"
      playing-since: "&7[&6BossReferral&7] &aPlaying since: &b%PLAYING_SINCE%"
    refertop:
      not-in-range: "&cPlease specify an amount between 1 and 25."
      layout: "&a%RANK%. %NAME% (%AMOUNT%)"
      not-number: "&cYour argument must be an number!"
    generate:
      codes-disabled: "&cCodes are disabled. Use your username instead."
      maximum-reached: "&cYou have reached the maximum amount of active codes!"
      new-code: "&aNew code created: &6%CODE%"
    codes:
      codes-disabled: "&cCodes are disabled. Use your username instead."
      no-codes: "&cYou have no active codes at this moment."
      layout-header: "&6You have &a%AMOUNT_CODES% &6codes available:"
      layout: "&a- %CODE%"
    usage:
      usage:
        - "&cUsage: /brs <codes, generate, refertop, referstats, redeemcode, ?>"
        - "&cFor more information about an command, execute:"
        - "&c/brs ? <subcommand>"
  brsadmin:
    general:
      no-permission: "&cYou do not have permission to do this!"
    reload:
      success: "&aSuccessfully reloaded configuration files!"
    load:
      wrong-args: "&cUsage: /brsadmin load <playername>"
      offline-player: "&cThat player is not online!"
      success: "&aSuccessfully loaded player!"
    loadall:
      success: "&aSuccessfully loaded all (online) players!"
    save:
      wrong-args: "&cUsage: /brsadmin save <playername>"
      offline-player: "&cThat player is not online!"
      success: "&aSuccessfully saved player!"
    saveall:
      success: "&aSuccessfully saved all online players!"
    reset:
      wrong-args: "&cUsage: /brsadmin reset <playername>"
      unknown-player: "&cPlayer not found!"
      success: "&aSuccessfully resetted that player!"
    resetall:
      success: "&aSuccessfully resetted all players!"
    changeattr:
      wrong-args: "&cUsage: /brsadmin changeattr <playername> <isreferred, totalreferred> <[true, false], [0-...]>"
      unknown-player: "&cPlayer not found!"
      boolean-parse-failed: "&cFailed to parse! The value must be 'true' or 'false'."
      integer-parse-failed: "&cFailed to parse! The value must be an integer. (0 --> ...)"
      unknown-attr: "&cCannot find that attribute!"
      success: "&aSuccessfully changed attribute!"
    addcode:
      wrong-args: "&cUsage: /brsadmin addcode <playername> <code>"
      success: "&aSuccessfully added the code."
      code-exists: "&cThat player already has that code."
      unknown-player: "&cCannot find that player!"
    removecode:
      wrong-args: "&cUsage: /brsadmin removecode <playername> <code>"
      success: "&aSuccessfully removed the code."
      code-doesnt-exists: "&cThat player doesnt has that code."
      unknown-player: "&cCannot find that player!"
    clearcodes:
      wrong-args: "&cUsage: /brsadmin clearcodes <playername>"
      success: "&aSuccessfully cleared all codes."
      unknown-player: "&cCannot find that player!"
    clearsavedstacks:
      wrong-args: "&cUsage: /brsadmin clearsavedstacks <playername>"
      success: "&aSuccessfully cleared all saved stacks!"
      unknown-player: "&cCannot find that player!"
    clearsavedcommands:
      wrong-args: "&cUsage: /brsadmin clearcommands <playername>"
      success: "&aSuccessfully cleared all saved commands!"
      unknown-player: "&cCannot find that player!"
events:
  join:
    items: "&aHere some extra items you got by referring other players!"
    inventory-full: "&cYour inventory is full and therefor an reward item is dropped under you!"

commands:
  brs:
    general:
      players-only: "&cThis command is for players only."
      no-permission: "&cYou do not have permission to do this!"
      not-loaded: "&cIt seems like you are not loaded yet -- please wait a few seconds before trying this command again. If that doesnt solve this issue, please contact your server administrator."
      wait: "&cPlease wait 2 seconds between BossReferral commands."
    redeemcode:
      already-referred: "&cYou are already referred!"
      use-own-name: "&cYou can't use your own name!"
      redeem-localhost: "&cYou can't redeem an code from an localhost player!"
      redeem-early: "You can't redeem an code yet. You need to play at least %MINUTES% minutes before you can redeem an code."
      referrer-limited: "&cYour referrer has reached the maximum amount of refers!"
      player-doesnt-exist: "&cThat player does not exist!"
      use-own-code: "&cYou can't use your own codes!"
      code-doesnt-exist: "&cThat code does not exist!"
      redeem-successful-code: "&aYou have successfully redeemed the code!"
      redeem-successful-name: "&aYou have successfully redeemed the name!"
      inventory-full: "&cYour inventory is full and therefor your reward items are dropped under you!"
    help:
      help: "&aThis command gives more information about subcommands including an brief description and parameters."
      codes-disabled: "&cThis command is disabled on this server. Use player names instead."
      codes-enabled: "&aView an list of your current active codes."
      generate-disabled: "&cThis command is disabled on this server. Use player names instead."
      generate-enabled: "&aGenerate an new random code that you can use to refer someone."
      refertop: "&aSee the top player referrers. You can send an optional second parameter for the maximum place (eg 20). Second parameter must be an number."
      referstats: "&aSee statistics about an certain player or yourself. Optional second parameter must be the name of your target player."
      redeemcode-name: "Verify that you are referred by someone using their name. Second parameter must be your referrers name."
      redeemcode-code: "Verify that you are referred by someone using their code. Second parameter must be the code given by your referrer."
      reload: "&aReloads the configuration and all messages."
      not-found: "&cI didn't found that command. Please try again."
    referstats:
      not-found: "&cThat player does not exist in our database."
      name: "&7[&6BossReferral&7] &aName: &b%NAME%"
      referred: "&7[&6BossReferral&7] &aReferred: %REFERRED%"
      amount: "&7[&6BossReferral&7] &aAmount referred: &b%AMOUNT_REFERRED%"
      playing-since: "&7[&6BossReferral&7] &aPlaying since: &b%PLAYING_SINCE%"
    refertop:
      not-in-range: "&cPlease specify an amount between 1 and 25."
      layout: "&a%RANK%. %NAME% (%AMOUNT%)"
      not-number: "&cYour argument must be an number!"
    generate:
      codes-disabled: "&cCodes are disabled. Use your username instead."
      maximum-reached: "&cYou have reached the maximum amount of active codes!"
      new-code: "&aNew code created: &6%CODE%"
    codes:
      codes-disabled: "&cCodes are disabled. Use your username instead."
      no-codes: "&cYou have no active codes at this moment."
      layout-header: "&6You have &a%AMOUNT_CODES% &6codes available:"
      layout: "&a- %CODE%"
    usage:
      usage:
        - "&cUsage: /brs <codes, generate, refertop, referstats, redeemcode, ?>"
        - "&cFor more information about an command, execute:"
        - "&c/brs ? <subcommand>"
  brsadmin:
    general:
      no-permission: "&cYou do not have permission to do this!"
    reload:
      success: "&aSuccessfully reloaded configuration files!"
    load:
      wrong-args: "&cUsage: /brsadmin load <playername>"
      offline-player: "&cThat player is not online!"
      success: "&aSuccessfully loaded player!"
    loadall:
      success: "&aSuccessfully loaded all (online) players!"
    save:
      wrong-args: "&cUsage: /brsadmin save <playername>"
      offline-player: "&cThat player is not online!"
      success: "&aSuccessfully saved player!"
    saveall:
      success: "&aSuccessfully saved all online players!"
    reset:
      wrong-args: "&cUsage: /brsadmin reset <playername>"
      unknown-player: "&cPlayer not found!"
      success: "&aSuccessfully resetted that player!"
    resetall:
      success: "&aSuccessfully resetted all players!"
    changeattr:
      wrong-args: "&cUsage: /brsadmin changeattr <playername> <isreferred, totalreferred> <[true, false], [0-...]>"
      unknown-player: "&cPlayer not found!"
      boolean-parse-failed: "&cFailed to parse! The value must be 'true' or 'false'."
      integer-parse-failed: "&cFailed to parse! The value must be an integer. (0 --> ...)"
      unknown-attr: "&cCannot find that attribute!"
      success: "&aSuccessfully changed attribute!"
    addcode:
      wrong-args: "&cUsage: /brsadmin addcode <playername> <code>"
      success: "&aSuccessfully added the code."
      code-exists: "&cThat player already has that code."
      unknown-player: "&cCannot find that player!"
    removecode:
      wrong-args: "&cUsage: /brsadmin removecode <playername> <code>"
      success: "&aSuccessfully removed the code."
      code-doesnt-exists: "&cThat player doesnt has that code."
      unknown-player: "&cCannot find that player!"
    clearcodes:
      wrong-args: "&cUsage: /brsadmin clearcodes <playername>"
      success: "&aSuccessfully cleared all codes."
      unknown-player: "&cCannot find that player!"
    clearsavedstacks:
      wrong-args: "&cUsage: /brsadmin clearsavedstacks <playername>"
      success: "&aSuccessfully cleared all saved stacks!"
      unknown-player: "&cCannot find that player!"
    clearsavedcommands:
      wrong-args: "&cUsage: /brsadmin clearcommands <playername>"
      success: "&aSuccessfully cleared all saved commands!"
      unknown-player: "&cCannot find that player!"
events:
  join:
    items: "&aHere some extra items you got by referring other players!"
    inventory-full: "&cYour inventory is full and therefor an reward item is dropped under you!"