joinPlus "How to use"

"How to use"

This page should answer many questions about how to use joinPlus, it shows you all features and explain them as they are mostly selfexplaining . If you have some more questions just write me or eitorf a pm or post your question as comment at the main page.

Commands

/joinplus or /jp  shows you informations about this plugin like author, website, version, etc.

/jp setspawn sets the spawn to the current position of the player

/jp spawn teleports the player to the spawn

/jp firstjoin displays your firstjoin date on this server

/jp firstjoin <name> displays the firstjoin of the playername you wrote

/jp totaltime shows your total play-time on this server from your last login

/jp totaltime <name> same as totaltime but shows played time of the player you searched for

Permissions

jp.* allows you to use all commands (admin)

jp.totaltime.me allows you to use the totaltime command

jp.totaltime.others allows you to view total time played of another player

jp.firstjoin.others allows you to use the firstjoin command with an argument

Config

You find the config file at plugins/joinPlus/config.yml

If you add "" when a string is expected it´s like disable the function.

quiz:
  # enable or disable the quiz function
  enable: false
  # set the 'win' message a player receives when passing the quiz
  solved: Welcome on our server!
  # set the 'lose' message if a player write the false answer
  failed: You failed. Do it once again

message:
  join:
     # set the default message when a player joins
    output: Nice to see you
    firstjoin:
    # set the default message when a player joins for the first time
      output: Welcome to the server!
  quit:
    # set the leave message display through the console and to other player
    public: Good Bye
join:
   # 
  command: '' # (needs permission for normal join: jp.join_command)
  display:
   # set to true displays a amount of online player, set to false to disable the message
    playeronline: true
   # plays an effect if set to true if a player joins
  effect:
    enable: true  # (dont work with the permission for normal join: jp.nojoineffect)
additem:
  # gives the player a specific item if the join
  join: 0 # write item id , value here  
            # example: 6 2 4 3 means: player gets 2 saplings and 3 cobblestone (needs permission: jp.additem)
   # gives the player a specific item if he joins for the first time
  firstjoin: 0  # write item id, value here
gamemode:
  # set to true if you want to set the gamemode of players if they join
  force: false
  join: 0 # 0 = Survival 1 = Creative 2 = adventure mode
  # set to true if you want to set the gamemode of players if they join for the first time
  firstjoin: 0
xp:
  firstjoin: 0 # set the level of a player who joins for the first time
  join: 0 # set the level of a player who joins (needs permission: jp.getxp)
money:
  firstjoin: 0 # add an amount of money to the player who joins for the first time
  join: 0 # same but add money at every join (needs permission: jp.money.join)
health:
  enable: false #set to true if you want set the health of players if the join
  firstjoin: 20 # set health at first join (20 = 10 hearts 0 = dead)
  join: 20 # set health at every join (needs permission: jp.health)
food:
  enable: false # same as health but set the food level of players
  firstjoin: 20
  join: 20 # (needs permission: jp.food)
randomspawn: # set a random spawn location around your spawn. players spawn randomly at this area.
  enable: false
  radius: 200 # set the radius of the area
quit: # if you set this to false every player who left the game will be banned, useful for events like hungergames
  enable: true
prefix: # add a prefix to players or admins
  admin: '[Admin]' # prefix for players with op permissions or perm: jp.admin
  default: '[Player]' # prefix for normal players
suffix: # same as prefix, but at the end of your name or perm: jp.admin
  admin: ''
  default: ''

Quizfeature

The quiz makes this plugin inimitable. You are able to add a completly own quiz without constraints.

First enable the quizfuction at your config file. In the same folder you see a .txt file called quiz.txt. In this file you can write your own quiz. It is possible to add as many questions as you want, add keywords excepted as answer or add an answer that have to be equal to the player ones. You can use this quiz for example to check if players read the rules at your forum, if the did they could answer the questions and are able to play if not the have to read the rules first ;) . There are many uses of this function, so try ir out.

Do it like the example given in the file:

Add a question at the first line like this:

Q: Who´s the server admin? (most important is to add the Q: to mark this and the following lines as question)

Verci_ or eitorf? (as you see you can add more than one line to your question)

K: Verci_ (notice: if you write K: you are able to add some keywords, the plugin searchs for them in the answer. if the plugin find one of your keywords the question is marked as passed)

eitorf (as you see it´s also possible to add more than one line and more than one keyword)

Q: Who are the authors of the plugin joinPlus? (just at another question as same as above if you want, you can add as many as you want, but notice that it could cause lags to add more than 20 questions)

A: the authors are eitorf and Verci_. (If you write A: the plugin expect the same asnwer from the player as you write them down here, for example if i write "the authors are eitorf, Verci_." to answer this it will be wrong and i have to start from the beginning)

Screenshots

/joinplus

http://dev.bukkit.org/media/images/45/556/joinplus.png

/firstjoin

http://dev.bukkit.org/media/images/45/557/firstjoin.png

/totaltime

http://dev.bukkit.org/media/images/45/552/playedtime.png

quiz solved

http://dev.bukkit.org/media/images/45/553/quiz1.png

prefix

http://dev.bukkit.org/media/images/45/555/prefix.png

set hunger, health, xp

http://dev.bukkit.org/media/images/45/471/hunger_xp_health.png

individual join message

http://dev.bukkit.org/media/images/45/551/joinMessage.png

amount of online players

http://dev.bukkit.org/media/images/45/554/onlinePlayers.png