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
76
77
# 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-name: entity_player_levelup
      listen-permission: firstjoinplus.notify
    smoke-effect:
      enabled: true
    launch-firework:
      enabled: true
  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/'
  reset-state:
    enabled: false
  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 ServerMiner ServerMiner Jul 17, 2016 at 14:33 UTC - 0 likes

    We love your plugin so we decided to create a video to showcase its features!

    We created a YouTube video tutorial for you, feel free to use it on your plugin info area: https://www.youtube.com/watch?v=RX1Y0Y6pAPg

    ServerMiner is the leader in Minecraft Server Hosting. Packed with incredible features, awesome support and years of experience and passion. Get a server today at ServerMiner.com

  • Avatar of Flashera Flashera Jul 09, 2016 at 23:48 UTC - 0 likes

    Is this still fully functional at 1.10? If so, is this the reason for a lack of update?

  • Avatar of chaseoes chaseoes Jul 06, 2016 at 15:43 UTC - 0 likes

    @AeSixReficul: Go

    This is already addressed in the FAQ above: "Is it possible to do X in the first-join starter kit?". I suggest reading a bit into that for my reasoning.

    The short answer is no, because this plugin used to have a few features like it but it ended up at the point where the code required to do that kind of stuff equaled the same amount of code the rest of the plugin took so I scrapped the idea to keep it lightweight and focus on the simplicity of first join stuff.

    There are much better plugins for kits that will give you a lot more flexibility, and I suggest using one of those in conjunction. You can set FJP to run a command from that plugin when a player joins.

    Last edited Jul 06, 2016 by chaseoes

    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 AeSixReficul AeSixReficul Jul 06, 2016 at 13:58 UTC - 0 likes

    couple things... it would be nice if this was updated to use new item notation so I can specific which color wool, or which banner design, etc to give in the kit.
    - wool:pink 5
    (5 pink wool)
    - banner 1 0 {BlockEntityTag:{Base:10,Patterns:[{Pattern:bs,Color:8},{Pattern:gru,Color:15},{Pattern:rs,Color:0},{Pattern:ls,Color:0},{Pattern:ss,Color:0},{Pattern:bo,Color:0}]}}
    (a green lightsabre banner)

    I know this might be outside your ability to do, but it sure would be nice if it could be done, would really make FJP step up to next level.

    It would also be nice if "air" is allowed as a spacer, so items can be given at the left and right side of the user's bar. Or possibly adding the slot number after the items
    - wool:pink 5 4
    (5 pink wool in slot 4)

    Just some thoughts on making this a better plugin :)  Choose to ignore if you want.

  • Avatar of chaseoes chaseoes Jun 20, 2016 at 08:00 UTC - 0 likes

    @zerooblivious: Go

    I'd suggest making sure the spawn is set to the right world. If you are getting that warning, there is more that goes along with it, check your server logs and post the entire stacktrace so I can let you know what's wrong.

    Last edited Jun 20, 2016 by chaseoes
  • Avatar of zerooblivious zerooblivious May 20, 2016 at 21:22 UTC - 0 likes

    New players are not spawning where I want them to spawn, all the cord, pitch & yaw are the exact number.

    They spawn at the main spawn. Why?

    Also why am i getting this warning?

    WARN [FirstJoinPlus] Task #1212 for FirstJoinPlus v2.4 generated an exception

    Last edited May 20, 2016 by zerooblivious
  • Avatar of chaseoes chaseoes Apr 10, 2016 at 11:45 UTC - 0 likes

    @mellowism: Go

    No. This is specifically intended for actions upon first joining the server only.

  • Avatar of mellowism mellowism Apr 10, 2016 at 10:10 UTC - 0 likes

    This is a really nice plugin. Stable and many nice features.

    One request/suggestion, could you make it so that you can have one set of rules for joining one world and one set for another world? Example:

    # FirstJoinPlus Configuration -- Configuration Help: http://dev.bukkit.org/bukkit-plugins/firstjoinplus/ #
    world1:
        settings:
          allow-automatic-updating: true
          every-join-is-first-join: false
        on-first-join:
          delay-everything-below-by: 5
          first-join-message:
            enabled: false
            message: '&d%player_name has joined us!'
          fun-stuff:.......
    world2:
        settings:
          allow-automatic-updating: true
          every-join-is-first-join: false
        on-first-join:
    

    and so on...

  • Avatar of nashoxx nashoxx Mar 12, 2016 at 21:07 UTC - 0 likes

    Thanks for the update.

  • Avatar of Goldentoenail Goldentoenail Mar 08, 2016 at 23:03 UTC - 0 likes

    Thank you very much. Our servers rely upon your plugin because it is really stable for us.

    Probably the reason it has not been updated for such a long time :)

Facts

Date created
Mar 20, 2012
Categories
Last update
Mar 09, 2016
Development stage
Mature
Language
  • enUS
License
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
FirstJoinPlus
Downloads
343,719
Recent files

Authors