WelcomeGUI icon

WelcomeGUI -----

Simple first-join GUI to show rules, Discord and a starter kit.

Download Now
10.7 KB .jar



WelcomeGUI
Clean first-join GUI for your players
​


WelcomeGUI is a very simple but polished first-join menu plugin.

When a new player joins your server for the first time, it automatically opens a small GUI with:
  • Rules – send your rules or a link in chat
  • Discord – send a clickable invite link
  • Start / Kit – run any command (for example /kit start)

Everything is fully configurable in config.yml.
No databases, no bloat – just a clean and lightweight utility.


✨ Features

  • Open a GUI on first join (can be toggled in config)
  • Custom GUI title and size (multiples of 9)
  • Each slot can run a different action
  • Config-based, no commands needed to set up items
  • Works on modern Spigot / Paper versions (1.16+)


How it works

  1. Player joins the server for the first time.
  2. If open-on-first-join is enabled in the config, the GUI opens automatically.
  3. Player clicks one of the items:
    • Send a chat message with a link (rules, Discord, website…)
    • Run a player command (for example /kit start)
    • Run a console command (for example giving items, opening another menu…)
  4. Players can also open it again with /welcomegui.


⚙️ Commands & Permissions

Code (Text):

/welcomegui   - Open the welcome menu
 
  • Permission: welcomegui.use
    • Default: true (all players can open the menu)

Example config.yml

Code (Text):

settings:
  open-on-first-join: true
  gui-title: "&aWelcome on &bYourServer"

gui:
  size: 27

  items:
    rules:
      slot: 11
      material: BOOK
      name: "&eRules"
      lore:
        - "&7Please read the rules of our server."
        - "&7Click to get the link."
      action: CHAT_LINK
      value: "&eRules: &fhttps://yourserver.com/rules"

    discord:
      slot: 13
      material: PAPER
      name: "&9Discord"
      lore:
        - "&7Join our community on Discord!"
      action: CHAT_LINK
      value: "&9Discord: &fhttps://discord.gg/yourinvite"

    start:
      slot: 15
      material: NETHER_STAR
      name: "&aStart your adventure"
      lore:
        - "&7Click to receive your starter kit."
      action: COMMAND_PLAYER
      value: "kit start"
 

Installation

  1. Download the WelcomeGUI jar file.
  2. Drop it into your
    Code (Text):
    /plugins
    folder.
  3. Start or restart your server.
  4. The plugin will generate
    Code (Text):
    config.yml
    inside the plugin folder.
  5. Edit the config to match your server (title, items, links, commands).
  6. Reload or restart the server again.


Planned features

  • Simple reload command
  • More action types (messages to staff, sounds, etc.)
  • Optional language file

If you have ideas or find a bug, feel free to contact me on Spigot.
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 4
First Release: Yesterday at 12:48 PM
Last Update: Yesterday at 12:48 PM
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings
Ask Questions / Get Support