FirstJoinPlus

FirstJoinPlus is a highly configurable Minecraft plugin that gives players a warm welcome when they join your server for the first time. It supports custom messages, kits, books, sounds, particles, fireworks, teleportation, and more.

Features

• First Join Detection: Detects when a player joins for the first time (or on every join, if configured).

• Customizable Messages: Set unique messages for first join, join, and quit events.

• Permission Support: Restrict features to players with specific permissions.

• Debug Command: Reset and simulate a first join for testing.

• Kits: Give new players a configurable set of items.

• Custom Books: Give new players a written book with server rules or information.

• Sounds & Particles: Play sounds and spawn particles on first join.

• Fireworks: Launch a random firework to celebrate new players.

• Teleportation: Teleport new players to a specific location.

• Potion Effects: Apply potion effects to new players.

• Run Commands: Run player or console commands on first join.

Installation

1. Download the plugin JAR and place it in your server's plugins folder.
2. Start or reload your server.
3. The plugin will generate default configuration files in plugins/FirstJoinPlus/.

Configuration

All configuration files are located in the plugin's data folder.

config.yml

Customize all features, including messages, kits, teleportation, and more.

Example:

prefix: "&7[&6FJP&7]"
need-permission: true
reset-state: false
every-join-is-first-join: false
only-teleport-on-every-join: false
everyone-sounds: true
first-join-message: true
join-message: true
quit-message: true

on-first-join:
  sounds:
    enabled: true
    type: entity_player_levelup
  particles:
    enabled: true
    type: VILLAGER_HAPPY
  firework:
    enabled: true
  kit:
    enabled: true
    items:
      - wood_sword
      - wood_pickaxe
      - wood_spade
      - wood_axe
      - bread:5
  give-xp:
    enabled: true
    amount: 0
  potion-effects:
    enabled: true
    effects:
      - SPEED:1:15
  give-book:
    enabled: true
    path: rules.txt
  run-commands:
    enabled: true
    commands:
      - me just joined for the first time!
    console-commands: []
  teleport:
    enabled: true
    x: 0
    y: 64
    z: 0
    pitch: 0
    yaw: 0
    world: world

messages.yml

Customize all plugin messages, including placeholders like %player_name%.

Example:

first-join-message: "&6Welcome to our server, %player_name!"
join-message: "&6%player_name joined the game."
quit-message: "&e%player_name left the game."
noPermission: "&cYou don't have permission to do that."
invalidCommand: "&cInvalid command. Use /fjp help for a list of commands!"
help: "&6FirstJoinPlus Help \nUsage: /fjp <reload|help|debug [player]>"
reloaded: "&6Reloaded Config!"
playerNotFound: "&cPlayer not found!"

book.txt

Write a custom book to give to new players. Use /newpage to start a new page. Placeholders and color codes are supported.

Example:

&bOur Rules
julizey
Hey %player_name, this is the first page!

&lPlease read our rules!
/newpage
This is page 2 of the book!
/newpage
Wow, page 3 of the book!

Have you tried &acolor codes&0?

Commands

Command	Description	Permission
/firstjoinplus	Plugin info
/firstjoinplus help	Show help
/firstjoinplus reload	Reload config and messages
/firstjoinplus debug <player> <type>	Simulates for a player
/fjp	Alias for /firstjoinplus

Permissions

• firstjoinplus.admin — Access all admin commands.
• firstjoinplus.use — Required to trigger first join actions (if need-permission is true).

Placeholders

You can use the following placeholders in messages and books:

• %player% — Player's name
• %player_displayname% — Player's display name
• %player_uuid% — Player's UUID
• %total_players% — Total number of players
• %new_line% — New line

API

You can listen for the custom FirstJoinEvent in your own plugins.

Contributing

Feel free to contribute to this project by submitting issues or pull requests.

License

This project is licensed under the MIT License.

---

Enjoy welcoming your new players!