FirstJoinPlus

FirstJoinPlus Logo

download permissions commands configuration bugtracker faq

FirstJoinPlus allows you to control every aspect of when new players join. Give new players a starter kit, a special spawn location, have the console run commands, launch fireworks, and more!

Existing players won't get told they joined for the first time after installing this.

features
  • Announce that a new player has just joined (optionally with the amount of unique players that have joined!).
  • Launch a firework or show a cool smoke effect.
  • Give the player a written book with welcome information (example book here)!
  • Give a starter kit with items defined in the configuration.
  • Force the player or the console to run configurable commands.
  • Set the player as invincible (from everything, including PVP) for a pre-defined amount of time.
  • Much more, check out the configuration below!

faq
  • New players not spawning at the first join spawnpoint?
    You have a conflicting plugin. Set the 'delay-everything-below-by' value in the configuration to a higher value, such as 5 or 10 (this option is set in ticks).
  • Want this plugin to kick in for every join instead of only first joins?
    Set 'every-join-is-first-join' in the configuration to true - this will treat every join as a first join. Great for hub servers as you can have the player teleported back to spawn every join, launch a firework every join, and you can set the join and quit messages to %none to completely hide them.
  • The display name variable is using their normal name and not their display name?
    This means another plugin is setting the display name after FirstJoinPlus is getting it, despite FirstJoinPlus using a normal priority. Set the 'delay-everything-below-by' value in the configuration to a higher value, such as 5 or 10 (this option is set in ticks).
  • Is it possible to do X in the first-join starter kit?
    The starter kit functionality has been left as simple as possible. You can only give items based off of their names and set the amount to give, as shown in the default configuration. Things like setting data values, display names, lore, etc isn't possible, simply because I want to leave this plugin as a first-join plugin and not a kit plugin.

    If you need to do more, I suggest finding a fully featured kit plugin, and using it alongside FirstJoinPlus by having FirstJoinPlus run a command from that kit plugin on first join.

commands
CommandDescriptionPermission
/firstjoinplusShow general plugin information.(none)
/firstjoinplus helpShow all available commands.(none)
/firstjoinplus reloadReload the plugin's configuration.firstjoinplus.reload
/firstjoinplus setspawnSet the location where new players will spawn.firstjoinplus.setspawn
/firstjoinplus debugTest your configuration as a new player.firstjoinplus.debug

The command /fjp can be used as an alias in place of /firstjoinplus. All commands default to OP's, no permissions plugin required!

configuration
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
# FirstJoinPlus Configuration -- Configuration Help: http://dev.bukkit.org/bukkit-plugins/firstjoinplus/ #
settings:
  allow-automatic-updating: true
  every-join-is-first-join: false
on-first-join:
  delay-everything-below-by: 0
  first-join-message:
    enabled: true
    message: '&d%player_name has joined for the first time!'
  fun-stuff:
    play-sound:
      enabled: true
      sound: level_up
      listen-permission: firstjoinplus.notify
    smoke-effect:
      enabled: true
    launch-firework:
      enabled: false
  first-join-kit:
    enabled: true
    items:
    - wood_sword
    - wood_pickaxe
    - wood_spade
    - wood_axe
    - bread:5
  give-written-books:
    enabled: false
    book-files:
    - rules.txt
  give-experience:
    enabled: false
    level-amount: 0
  modify-damage:
    disable-pvp:
      enabled: false
      expire-after: 10
    god-mode:
      enabled: false
      expire-after: 10
  run-commands:
    enabled: false
    commands:
    - me just joined for the first time!
  run-console-commands:
    enabled: false
    commands:
    - setgroup %player_name newbies
  apply-potion-effects:
    enabled: false
    effects:
    - SPEED:1:15
  send-messages:
    enabled: false
    messages:
    - '&2Welcome to our server, %player_name! Customize this message in the FirstJoinPlus configuration.'
    - '&6http://dev.bukkit.org/server-mods/firstjoinplus/'
  teleport:
    enabled: false
    x: 0
    y: 64
    z: 0
    pitch: 0
    yaw: 0
    world: world
other-messages:
  join-message:
    enabled: false
    message: '&e%player_name joined the game.'
  quit-message:
    enabled: false
    message: '&e%player_name left the game.'
  kick-message:
    enabled: false
    message: '%none'

Configuration Tips

Available Variables

Variables are used throughout the configuration to display different text (see the description).

VariableDescription
%player_nameThe name of the player.
%player_display_nameThe display name of the player.
%player_uuidThe UUID of the player.
%total_playersThe number of unique players that have joined.
%random_playerThe name of a random online player.
%random_player_display_nameThe display name of a random online player.
%noneUsed in join, quit, and kick messages to completely disable them.
%player_countryThe player's country (GeoIPTools required).
%player_cityThe player's country (GeoIPTools required).


other

Please click here to donate and support the development of my plugins!

We include an auto updater that checks if there is an update available and/or downloads the latest version for you. It is enabled by default. You may disable this in the configuration.

curse spotlight

Stats

We use Metrics to collect anonymous usage stats such as the plugin version, server version, and amount of players online. If you want to see everything, click on the graph above. You may disable data collection in the Metrics configuration.

[ONELINER:FirstJoinPlus allows you to control every aspect of when players join for the first time. Give starter kits, experience, a special spawn location, a group, and more!]

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Mankin59 Mankin59 Apr 17, 2015 at 20:34 UTC - 0 likes
  • Avatar of chris_61 chris_61 Apr 05, 2015 at 18:11 UTC - 0 likes

    Hi I'm in the process of switching from essentials spawn to this and I'm trying to format my new join kit from essentials to this but your pages on how to do this seem to be down?

    http://jd.bukkit.org/rb/apidocs/org/bukkit/Material.html

    Could you tell me how please tell me how to format enchants and give stuff a name and a lore. Here is my essentials kit:

    http://pastebin.com/hpbFKexf

    Thanks, Chris.

    Last edited Apr 05, 2015 by chris_61
  • Avatar of MrPorkchops MrPorkchops Apr 01, 2015 at 16:30 UTC - 0 likes

    I have a question- Is it possible to have it randomly select a first join message from a list?

    I want to make it so players will join a prison server and it will give them a random reason for being in prison. For example:

    - "%player% has been put in prison for first degree murder"

    - "%player% has been put in prison for tax evasion"

    - "%player% has been put in prison for vehicular manslaughter"

    etc.

    Last edited Apr 01, 2015 by MrPorkchops
  • Avatar of Peter234 Peter234 Mar 29, 2015 at 19:11 UTC - 0 likes

    @chaseoes: Go

    Ok, that doesn't answer my second question...

  • Avatar of chaseoes chaseoes Mar 29, 2015 at 07:32 UTC - 0 likes

    @ZachBail: Go

    Nope, no clue why it wouldn't be working.

    chaseoes — My Website - My Plugins
    Click here to follow me (@chaseoes) on Twitter!
    Go here if you like what I do and would like to donate. :)
    BFAK:18365,ed13ea0f70656599767b861bea91e14a2944f7d06c51356d4d520c22f2c379ac

  • Avatar of ZachBail ZachBail Mar 29, 2015 at 07:31 UTC - 0 likes

    @chaseoes: Go

    Anything for me? :D lol

    http://theverve.buycraft.net

  • Avatar of chaseoes chaseoes Mar 29, 2015 at 07:19 UTC - 0 likes

    @Peter234: Go

    No. Read the FAQ.

  • Avatar of Peter234 Peter234 Mar 28, 2015 at 19:10 UTC - 0 likes

    Is it possible to add enchantments to the first-join-kit items? For example I was the kit to spawn in a leather chestplate with protection 1. Also is there anyway you could make the first spawn based on a database or something because as it stands I think the plugin checks if the player is registered in the world folder and since in my server the world folder is being constantly reset it treats every login as if the player was a new player and that was their first spawn.. If you can find some kind of work around that would be great :D

    Last edited Mar 28, 2015 by Peter234
  • Avatar of ZachBail ZachBail Mar 25, 2015 at 09:03 UTC - 0 likes

    For the life of me I can't seem to get the first join message (broadcast) to pop. Everything else works great but the message. Am I missing something easy here or should I file a ticket?

    I've set the delay to 10 ticks and it's enabled.

    Running on Spigot 1.8.3 with the latest Essentials, EssentialsChat, GroupManager, Vault and ProtoLib

    Config: http://pastebin.com/bvvFHZd5

    0 Errors in the console, It's like it's not even trying.

    Thank you very much for this plugin, EssentialsSpawn is far too invasive.

    Last edited Mar 25, 2015 by ZachBail
  • Avatar of terrorvisions terrorvisions Mar 01, 2015 at 19:45 UTC - 0 likes

    @MicroCuts327: Go This was answered a couple pages back. Sorry I would link it but I am not sure how as this is my first post on the forum. Anyway chaseoes said you had to place a text file in the FirstJoinPlus directory (the same directory the config file is in) with the same name you indicated in the config. Also make sure you have the option enabled.

Facts

Date created
Mar 20, 2012
Categories
Last update
Jul 22, 2014
Development stage
Mature
Language
  • enUS
License
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
FirstJoinPlus
Downloads
153,054
Recent files

Authors