NewParkour 2017-08-08

Horse Races, Parkour

  1. Scorpion
    Tested Minecraft Versions:
    • 1.12
    Newparkour used to be a premium resource but decided to release this version for free since i want everyone to be able to enjoy it.

    It used to contain 5 gamemodes but it was dropped and now i picked it back up going alllll the way back to where i started with the plugin which was mainly parkour.
    Hence the name...

    This time however i've added an extra game into it that is somewhat unique in that atleast me...haven't seen it around.

    Each game mode will be listed into its own catagory with their own list of commands permissions and setup.

    Parkour is pretty easy to setup but also has plenty of settings to make each and every arena unique to the next.

    To start you have to create an arena.

    Code (Text):
    Begin by building your arena.
    Pick a place where they end and place a Gold Plate*Configurable*

    Every arena supports checkpoints which are also configurable *Default iron plate*

    Pick a starting point and do:
    /pk create <arena>

    This will mark the starting location for this arena.

    Done.
    Now
    After you setup your arena(s) you need to set a lobby which will act as your hub for the minigame.

    This can be achieved by doing:
    /pk setlobby

    Next and final step is creating the signs.
    Code (Text):
    [parkour]
    <arena name>
    join
    <cost to purchase>

    If you ever played on cubecraft you will know what <cost to purchase> means.
    But for those that havent this is how:
    When a player has never played on that arena they must pay for that arena.
    This purchase is only ones and permanent unless you remove their rights in the stats file.
    The config has an option for currency type.
    Points(Requires my other plugin pointsystemAPI)
    Vault currency(Essentials/Vault) or another economy plugin alongside vault.

    After you done the setup...lets move on to the config file
    Code (Text):
    #################################################
    #           Name: NewParkour                    #
    #           Config Version: 1.0                 #
    #           Only change this if i say so!       #
    #           ConfigRelation: Parkour             #
    #################################################

    #Quick note:
    #Parkour is setup to work with puchases.
    #This means you need credits to "buy" an arena
    #For this plugin to work you need PointsAPI
    #If you don't want people to pay for an arena just set
    #the points for that arena to 0 on the sign.
    #info on how pointsapi works can be found here:
    #https://www.spigotmc.org/resources/pointsystem-api.20241/

    Settings:
      parkourcmdonly: '&9Only use &6/parkour &9commands!'
      prefix: '&6[&9Parkour&6]'
      color1: '&9' #These relate to unchangeable settings such as GUI and Scoreboard
      color2: '&6'
      console: 'Command may only be used ingame'
      reloaded: '&9You reloaded the configuration file' #No longer available
      notingame: '&9You are not ingame'
      signcreated: '&9Successfully created &6{0} &9sign'
      noperm: '&9You dont have permission to do this'
      created: '&9Succesfully created arena &6{0}'
      exists: '&9Arena &6{0} &9already exists'
      noexist: '&9Arena &6{0} &9does not exist'
      removed: '&9Successfully removed arena &6{0}'
      joined: '&9You joined the arena &6{0}'
      left: '&9You left the arena &6{0}'
      hidden: '&9You are now hiding players'
      lobbyset: '&9Set the &6Lobby world &9to world &6{0}'
      nolobby: '&4No lobby set. Access denied'
      nopoints: '&9Insufficient points to buy &6{0}&9!'
      showing: '&9You are now showing players'
      checkpoint: '&9You reached a checkpoint'
    #Valid options: "points"(PointSystemAPI) and "money"(Vault)
    #This option is used for purchasing the arena.
      currency: "points"
      checkpointrespawn: '&9Respawned at last checkpoint'
      respawnstart: '&9You respawned at the start'
      finished: '&6{0} &9Finished Arena &6{1} &9in Parkour'
      notonline: '&9Player &6{0} &9is not online We are working on a fix sorry for any inconvinience'
      timedcommand: '&9Please don''t spam this command!'
      commandset: '&6Command for arena &9{0} &6set in config under &9{1}'
      purchased: '&3Succesfully purchased this arena'
      help:
      - '&9&m=-======-=&6[&9Parkour&6]&9&m=-======-='
      - '&6/pk leave/quit &9- To leave the arena'
      - '&9&m=-======-=&6[&9Parkour&6]&9&m=-======-='
      helpadmin:
      - '&9&m=-======-=&6[&9Parkour&6]&9&m=-======-='
      - '&6/pk create <arena> &9- Creates the arena <arena>'
      - '&6/pk delete/remove <arena> &9- Removes an arena'
      - '&6/pk setcommand <arena> &9- Allows for commands on that location'
      - '&6/pk setlobby &9- Sets the lobby world at your location'
      - '&6/pk admin &9- Returns only the admin commands'
      - '&9&m=-======-=&6[&9Parkour&6]&9&m=-======-='
    #This section here is related to the item given when joining the game.
    #This may change in the future to allow custom items aswell.

    Signs:
      line1: '&6%arena%'
      line2: '&9Join'

    Q: What is {0} {1} etc.?
    A: These are arguments and depending where they are used they have a different meaning E.X: Arena {0} Would return Arena <arena name> or Arena Test (If your arena is called Test)

    Q: Does it support multiple arenas?
    A: Yes and every gamemode or type can have the same arena name as they are not shared.

    Q: Where can i change arena items?
    A: Currently hide and leave are supported and under universalconfig.yml

    Q: Will there ever be a premium release?
    A: Maybe

    Q: Can i change the items for each arena induvidually?
    A: Yes in the arenas.yml each arena has its own unique list of items they are not allowed to stand in.

    What is horse race?
    You should know!!

    Horse race is a race where you compete with 1-3 others to see who is Lucky enough to have the fastest horse, or keyboard.

    Horse race can be done with 2 to 4 players at ones while supporting multiple arenas it only supports 1 game at a time in 1 arena.
    To clarify:
    If you have an arena called Race, race can only do 1 team of 2-4 players before anyone else can join.
    But if you have 2 arena's different names they can run at the same time.

    Code (Text):
    #################################################
    #           Name: NewParkour                    #
    #           Config Version: 1.0                 #
    #           Only change this if i say so!       #
    #           ConfigRelation: Horse Race          #
    #################################################


    Settings:
      console: 'Only allowed ingame'
      prefix: '&3[&9Horse Race&3]'
      noperm: '&4You dont have permission to do this!'
    #A lobby MUST be set before players can join any existing arena.
    #The plugin does no longer contain old location system for teleporting
    #when no lobby is present.
      lobbyset: '&3Lobby succesfully set in world &9{0}'
      nolobby: '&4Lobby missing. Access denied!'
      created: '&3Succesfully created arena &9{0}'
      signcreated: '&3Join sign succesfully created for &9{0}'
      full: '&4This arena is full!'
      joined: '&3You joined arena &9{0}&3. Transfering horse now...'
      left: '&3You left arena &9{0}'
      noexist: '&3Arena &9{0} &3does not exist!'
      exists: '&3Arena &9{0} &3already exists'
      posset: '&3Position for arena &9{0} &3set to &9{1}&3.'
      started: '&3This arena is already going'
      removed: '&3Succesfully removed arena &9{0}'
      full: '&4This are is full'
      playerleave: '&4Cancelled timer due to insufficient players in the arena!'
    #The command addsign is early alpha and may not work 100%
    #If you find a problem with it, report it to me and ill fix it.
    #If the command for whatever reason fails just create them manually.
      wallsign: '&3Wall sign has been changed to arena &9{0}'
      nowallsign: '&4Thats not a correctly placed sign or even a sign'
      signexists: '&3This sign already exists!'
      signremove: '&3Sign removed for arena &9{0}'
      noarena: '&4You are not in any arena'
    #When performing the help command
    #if a player is admin/op or has admin perms
    #they will see all help related things.
    #If they only have regular default permissions only help will show.
      help:
        - '&3&m=-======-=&3[&9Horse Race&3]&3&m=-======-='
        - '&9/hrace leave &3- To leave an arena'
        - '&3&m=-======-=&3[&9Horse Race&3]&3&m=-======-='
      helpadmin:
        - '&3&m=-======-=&3[&9Admin&3]&3&m=-======-='
        - '&9/hrace setpos <arena> <pos> &3- Sets position for arena'
        - '&9/hrace create <arena> &3- Creates arena with <arena> name'
        - '&9/hrace delete/remove <arena> &3- Removes an arena'
        - '&9/hrace setlobby &3- Creates the lobby for the game horse race'
        - '&9/hrace addsign <arena> &3- Creates the sign for you'
        - '&3&m=-======-=&3[&9Admin&3]&3&m=-======-='

    #While i see no reason to change anything i suggest only changing colors
    #In the future on a currently undetermant update...This section might change
    #and allow for more configurable options.
    Signs:
      line1: '&9'
      line2: '&3Join'
      line3: '&9%current%&3/&9%max%'
    Countdown:
    #Supported counters: Title(Requires TitleAPI), XP
    #XP does NOT collect current xp levels for players.
    #So basicly will reset their level!
    #Currently the plugin as is, does not support any other timer forms
    #Nor doesn't support no timer.
    #The plugin is mainly build for use with titleapi BUT XP can be used.
      type: 'TITLE'
      title: '&3Arena: &9%arena%'
      counter: '&9'

    Horse race has a somewhat similar setup but ill still explain it:
    Code (Text):
    To begin you  need to create an arena(Again)...

    Pick your starting location and type:

    /hrace create <arena>

    This should also set pos1 but to be safe lets reset it.

    /hrace setpos <arena> 1-4
    *Note if you did not create the arena setpos will do this for you*

    Now choose a finish line.
    Advice is to make it about 3 wide and 8 in length(This may be reversed depending how you look ofcourse)

    Place concrete(Default but configurable) in the floor this will act as a finish line.

    done.
    If correctly done you should now have a nice horse track setup.
    No checkpoints are in this 1 so no need to add those.

    Now you need to create a sign.
    Code (Text):
    Signs can be set up in 2 ways

    1. Look at a sign and do: /hrace addsign <arena>

    2:
    [horse]
    <arena>
    join

    If done correctly the sign should change to:
    [horse race]
    <arena name>
    join
    0/4
     
    Now right click the sign see if it worked.

    This plugin runs best with TitleAPI

    Code (Text):
    /pk admin *Returns all available admin commands*
    hrace help *Returns all available commands*
     

    Code (Text):
    parkour.setup
    parkour.help
    horse.setup
    horse.help

    All permissions are defaulted to op as they are all admin commands. No sign/arena can be made premium/donator arenas

    Code (Text):
    TitleAPi *optional but lets horse race work better*

    Vault *Is a must at all times*
    Some kind of economy plugin such as Essentials.

    PointSystemAPI *optional if you wanna use points instead of currency*

    If i forgot to add info on a certain area let me know and ill inform you and edit it :)

    Remember: This is a free resource.
    This means you dont have to rage when something breaks.
    These are called "updates".
    Nothing lasts forever!

    Like it? Want to leave a suggestion? Found a bug?
    Let me know below/pm/discussion

    Want a Premium version with more options and even more customizations?
    https://www.spigotmc.org/resources/new-parkour-recoded-premium.16606/

    TOS:
    You are not allowed to decompile and recompile for public use.
    Changing ANY of its codes and i wont give any support.
    You may share it on other plugin related websites aslong as you link to this website and not claim it as your own.