FirstJoinPlus
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.
- 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!
- 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.
Command | Description | Permission |
/firstjoinplus | Show general plugin information. | (none) |
/firstjoinplus help | Show all available commands. | (none) |
/firstjoinplus reload | Reload the plugin's configuration. | firstjoinplus.reload |
/firstjoinplus setspawn | Set the location where new players will spawn. | firstjoinplus.setspawn |
/firstjoinplus debug | Test 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!
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
- The delay-everything-below-by option is set in ticks, while the disable-pvp and god-mode expiration options are set in seconds.
- Click here for a list of valid material names you can use in the first join kit section.
- Click here for a list of valid potion effect types for the first join potion effects section.
- A list of valid sound names for the notify on first join section is available here.
Available Variables
Variables are used throughout the configuration to display different text (see the description).
Variable | Description |
%player_name | The name of the player. |
%player_display_name | The display name of the player. |
%player_uuid | The UUID of the player. |
%total_players | The number of unique players that have joined. |
%random_player | The name of a random online player. |
%random_player_display_name | The display name of a random online player. |
%none | Used in join, quit, and kick messages to completely disable them. |
%player_country | The player's country (GeoIPTools required). |
%player_city | The player's country (GeoIPTools required). |
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.
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!]
I got a bad stacktrace when i put in /fjp debug. here is the console.
[17:24:54 WARN]: [FirstJoinPlus] Task #152 for FirstJoinPlus v2.1 generated an e
xception
java.lang.NullPointerException
at org.bukkit.inventory.ItemStack.<init>(ItemStack.java:68) ~[cb172.jar
git-Bukkit-1.7.2-R0.3-b3020jnks]
at com.chaseoes.firstjoinplus.utilities.Utilities.getFirstJoinKit(Utilit
ies.java:76 ~[?:?]
at com.chaseoes.firstjoinplus.FirstJoinListener$1.run(FirstJoinListener.
java:35) ~[?:?]
at org.bukkit.craftbukkit.v1_7_R1.scheduler.CraftTask.run(CraftTask.java
:53) ~[cb172.jar:git-Bukkit-1.7.2-R0.3-b3020jnks]
at org.bukkit.craftbukkit.v1_7_R1.scheduler.CraftScheduler.mainThreadHea
rtbeat(CraftScheduler.java:345 [cb172.jar:git-Bukkit-1.7.2-R0.3-b3020jnks]
at net.minecraft.server.v1_7_R1.MinecraftServer.u(MinecraftServer.java:5
87) [cb172.jar:git-Bukkit-1.7.2-R0.3-b3020jnks]
at net.minecraft.server.v1_7_R1.DedicatedServer.u(DedicatedServer.java:2
50) [cb172.jar:git-Bukkit-1.7.2-R0.3-b3020jnks]
at net.minecraft.server.v1_7_R1.MinecraftServer.t(MinecraftServer.java:5
45) [cb172.jar:git-Bukkit-1.7.2-R0.3-b3020jnks]
at net.minecraft.server.v1_7_R1.MinecraftServer.run(MinecraftServer.java
:457) [cb172.jar:git-Bukkit-1.7.2-R0.3-b3020jnks]
at net.minecraft.server.v1_7_R1.ThreadServerApplication.run(SourceFile:6
17) [cb172.jar:git-Bukkit-1.7.2-R0.3-b3020jnks]
@ZOO231
Nope.
Could an option be added for first world join?
UPDATE: Ignore the rest of this. It uses the userdata(Contained in default world) to see if someone is new or not ;)
I need to install a plugin like this, but I don't want all my OLD players getting teleported to spawn and such.
I have essentials, but I HATE essentials spawn. Is there any way that this can detect who is new through the essentials userdata folder?
I need to ensure my old players won't be effected by this!
Please add slot number set and add names and lores for the join kits!
@MightyFlyRudy
according to the "Available Variables" above, it says that it's '%player_country', not '{COUNTRY}'
I can't get the {COUNTRY} to show up in the login message. It just says "Player logged in from N/A." I have GeoIPTools installed, what's the problem here?
Please answer my ticket
https://github.com/chaseoes/FirstJoinPlus/issues
@jozefmery
It's only when a player joins for the first time.
How coem the broadcast message isnt working all the times ?
@AzureBlure
Read above..?
permissions?
@FlyingScotsman77
Unlikely.
Is it possible to give a player an item after a command has been executed?
Could you please make a command to spawn in the rules.txt-book again?
Upon joining players receive a book with rules and a lot of info. When they throw it away or lose it there's no way for them to receive the book again.
@JacMan3
Delete their player.dat file or set every-join-is-first-join to true.
is there a way to let fjp 'forget' a player has joined?
@diannetea
They don't. I suggest using another kit plugin and having a command from it run on first join.
Do the kit items support lore? I would really appreciate it if they could.
Is there a way to make beds set a players spawn to disable always first join???