Interactive Join Rewards 1.0.0 (1.8-1.10.2)

Reward players with an interactive method!

  1. RictAcius
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    Contributors:
    Max Kreminski
    [​IMG]
    Interactive Join Rewards (IntJR for short) is a plugin that enables you to give out rewards via commands to your players. The reason the plugin is "Interactive" is because much of what happens is determined by user input. The config is pretty much fully customizable, except for a few things which I choose to reserve for myself (to prevent overriding other plugins).

    If you had a version of this plugin before 1.0.0 and you want to update to 1.0.0, please remember to rename your plugin folder from "InteractiveJoinRewards_BETA" to "InteractiveJoinRewards"
    [​IMG]
    When players join your server, based on a set delay, they will be sent a message informing them about their reward, and whether they choose to accept it or dismiss it. When the player clicks on an option the plugin will update its records for that player. You can set as many commands as you like for each reward and you can choose whether to send them as Console or as the Player. There are currently 10 available variables that you can use in your commands, you can also choose not to use variables, to prevent errors. The plugin allows for multiple rewards to be setup in the same config file, all you need to do is choose which one you want to use at the moment.
    [​IMG]
    - Send rewards to select players with a permission
    - Limit the players who can claim a reward with a permission
    - Enable / Disable the whole plugin
    - Can have as many rewards as you want in the same config
    - Use variables in commands
    - Have as many commands as you like
    - Fully customise all messages and options
    - Ingame config & rewards updater
    - JSON rewards
    [​IMG]
    To install Interactive Join Rewards you must first download the plugin by clicking on the link in the top right hand corner.
    Once downloaded put it in your server plugins and restart your server.
    The plugin will automatically generate config files which you should customise before you let players use it (disable the rewards in the config while you customise your rewards)
    Reload the plugin
    Enable the rewards
    Enjoy!
    [​IMG]
    You can set most of the permissions in the config and rewards file. But here are the permissions that I set myself [permissions updated for full customisation :) ]
    [​IMG]
    <...> = required, [...] = Optional, ...|... = selection of input
    /intjr
    - /intjr reload
    - /intjr listprizes
    - /intjr enabled <true | false>
    - /intjr listcurrent
    - /intjr addcurrent <prizeName>
    - /intjr removecurrent <prizeName>
    - /intjr setdelay <prizeName> <delay>
    - /intjr settooltip <tooltip>
    - /intjr blanklines <true | false>
    - /intjr usevariables <true | false>
    - /intjr commandalias <alias>
    - /intjr debugmode <true | false>
    - /intjr debugplugin
    - /intjr openmenu <menuFileName>
    [​IMG]
    Code (Text):
    #                                        #
    ##########################################
    #                                        #
    #              Main Config               #
    #     MAKE SURE TO READ THE COMMENTS     #
    # AS THEY WILL BE REMOVED ONCE RELOADED! #
    ##########################################

    DoNotTouch: 0.6.3
    #Set to 'no tooltip' to disable the tooltip#
    RewardMessageTooltip: "&aClick on Accept or Deny to dismiss this message"
    #Should blank lines be included to make readin easier?#
    IncludeBlankLines: true
    PrizeAlreadyAccepted: "&cFailure! &7You have already claimed this reward! Sorry :("
    PrizeAlreadyDismissed: "&cFailure! &7You have already dismissed this reward! Sorry :("
    #Should the plugin replace variables with custom info like %pworld% ?#
    UseVariables: true
    #For any this message if you dont want to use colour or format just put '&r' at the beginning to prevent any errors, cheers!#
    PrizesNotEnabledMessage: '&cPrizes are disabled right now :('
    IJRAdminPermission: 'rictacius.joinrewards.admin'
    IJRNoPermissionMessage: '&cYou shall not pass!'
    Debug: 'true'
    #Future update DO NOT REMOVE#
    IJRCommandALias: 'intjr'
    Code (Text):
    #                                        #
    ##########################################
    #                                        #
    #             Prize Config               #
    #     MAKE SURE TO READ THE COMMENTS     #
    # AS THEY WILL BE REMOVED ONCE RELOADED! #
    ##########################################

    #For any prize messages if you dont want to use#
    #colour or format just put '&r' at the beginning#
    #to prevent any errors, cheers!#

    #Are prizes to be given out right now?#
    Prizes Enabled: true
    #Which events should prizes be given for?#
    Enabled Prizes:
    - First Join
    - MenuReward
    #Ignore this part as it is to be used in future updates :)#
    #But you can still use it as a reference for PRIZE MESSAGES#
    Variables In Use:
    # %pname%  #
      PlayerName: true
      # %puuid%  #
      PlayerUUID: false
      # %phealth%  #
      PlayerHealth: false
      # %pmaxhealth%  #
      PlayerMaxHealth: false
      # %pgamemode%  #
      PlayerGamemode: false
      # %pworld%  #
      PlayerWorld: false
      #This will show the player's cords as (x y z)#
      # %pcords%  #
      PlayerCords: false
      # %plocx%  #
      PlayerLocationX: false
      # %plocy%  #
      PlayerLocationY: false
      # %plocz%  #
      PlayerLocationZ: false
    #A list of all available prizes (for use in-game)#
    PrizeList:
      - First Join
      - MenuReward
    #An example of a prize to be given#
    First Join:
      Prize See Permission: 'rictacius.joinrewards.see'
      Prize Claim Permission: 'rictacius.joinrewards.claim'
      Menu:
       Enabled: false
       Name:
      Deploy Commands as Console: true
      #This is in ticks (20 ticks = 1 second)#
      DelayTillRewardMessage: 200
      Prize Reward Commands:
       - msg %pname% 1
       - msg %pname% 2
       - msg %pname% 3
      Prize Message: '&bThank you for joining this server! &eWelcome, we hope you have fun!'
      Prize Accept Confirmation Message: '&aSuccess! &6You have claimed this reward!'
      Prize Accept Message: ' &aAccept'
      PrizeAlreadyAccepted: '&cFailure! You have already accepted this reward!'
      Prize Deny Confirmation Message: '&dDismissed! &6We wont bother you with this notification again!'
      Prize Deny Message: ' &cDeny'
      PrizeAlreadyDismissed: '&cFailure! You have already dismissed this reward!'
      Prize Acceptors:
    MenuReward:
      Prize See Permission: 'rictacius.joinrewards.see'
      Prize Claim Permission: 'rictacius.joinrewards.claim'
      Menu:
       Enabled: true
       Name: exampleMenu
       #Make sure to sync your inventory name with the one in your menu file
       #if the plugin doesn't do it for you!
       InventoryName: 'Example Menu'
      Deploy Commands as Console: true
      #This is in ticks (20 ticks = 1 second)#
      DelayTillRewardMessage: 200
      Prize Reward Commands:
       - msg %pname% 1
       - msg %pname% 2
       - msg %pname% 3
      Prize Message: '&bThank you for joining this server! &eWelcome, we hope you have fun!'
      Prize Accept Confirmation Message: '&aSuccess! &6You have claimed this reward!'
      Prize Accept Message: ' &aAccept'
      PrizeAlreadyAccepted: '&cFailure! You have already accepted this reward!'
      Prize Deny Confirmation Message: '&dDismissed! &6We wont bother you with this notification again!'
      Prize Deny Message: ' &cDeny'
      PrizeAlreadyDismissed: '&cFailure! You have already dismissed this reward!'
      Prize Acceptors:
    Code (Text):
    #                                        #
    ##########################################
    #                                        #
    #             Example Menu               #
    #     MAKE SURE TO READ THE COMMENTS     #
    # AS THEY WILL BE REMOVED ONCE RELOADED! #
    ##########################################

    #PLEASE NOT THAT MENUS ARE NOT 100% PERFECT RIGHT NOW
    #I AM WORKING TO MAKE THEM MORE CUSTOMISABLE IN THE NEAR FUTURE!
    #Settings for menu generation *REQUIRED!*
    menu-settings:
    name: 'Example Menu'
    rows: 3
    #How many items are there in this menu?
    totalItems: 3
    #The amount of time (in seconds) that the menu will refresh
    #Not available in versions under 0.6.3!
    updateTime: 3
    #Items that will be in the menu
    #FOR NOW DO NOT USE DUPLICATE ITEM NAMES
    #UNTIL I HAVE FIGURED OUT HOW TO DIFFERENTIATE THEM!
    menu-items:
    1:
      itemCommand:
       - 'msg %pname% &6&lExamine the dirt block!'
      itemName: '&eA dirt block!'
      #DO NOT PUT AN ID HERE, PUT THE NAME!
      itemID: DIRT
      itemAmount: 30
      #The lore is not compulsory.
      Lore:
       - '&aEver seen a dirt block?'
       - '&bYes! Just now!'
      x-posistion: 3
      y-posistion: 2
    2:
      #Please note that using internal commands such as the one below
      #may generate errors, as the plugin does not expect the command
      #to be sent from a menu. I am working to fix this.
      itemCommand:
       - 'ijrprizesacceptrewards %rewardSendArgs%'
       - 'msg %pname% &6&lI can see through this! Well slightly.'
      itemName: '&eA glass block! (accept)'
      itemID: STAINED_GLASS_PANE:5
      itemAmount: 1
      #You can just leave the permission empty to use no permission
      itemSeePermission: rictacius.examplemenu.see.2
      Lore:
       - '&aEver seen a glass block?'
       - '&bThat''s not a glass block!'
      x-posistion: 5
      y-posistion: 2
    3:
      itemCommand:
       - 'ijrprizesdenyrewards %rewardSendArgs%'
      itemName: '&eA wool block! (deny)'
      #You can change the data value of the Item by using a colon ':'
      itemID: 'WOOL:5'
      itemAmount: 7
      Lore:
       - '&bWhat colour is it?'
       - '&aGREEN!'
      x-posistion: 7
      y-posistion: 2
    [​IMG]
    Much thanks to Max Kreminski for creating the FancifulAPI
    [​IMG]
    Please do not report bugs/errors/glitches in the reviews section, instead please post it as an issue on the GITHub Page. Or as an alternative post your issue on the discord support room by clicking the link below.
    [​IMG][​IMG]
    Resoluciones likes this.