Enhance Your Server’s First Impressions with the FirstLogin Plugin
Every server owner knows that a player’s first few seconds can make or break their decision to stay. A bland, silent join often leads to a quick disconnect. FirstLogin transforms that moment into a polished, welcoming experience, complete with customizable messages, visual effects, and an interactive GUI that can even gate rule acceptance. Whether you run a survival world, a minigame hub, or a roleplay community, this lightweight Spigot/Paper plugin gives you the tools to greet newcomers and returning veterans in style.
What is FirstLogin?
FirstLogin is a feature-rich yet performance-friendly plugin designed for Minecraft servers running Spigot or Paper 1.20+ with Java 17. It goes far beyond a simple “welcome to the server” chat line. You can craft global and private greetings using Adventure MiniMessage formatting (with legacy color code fallback), trigger titles, action bar messages, and sounds, and even present a fully configurable Welcome GUI. The GUI can require players to accept server rules before they can play, with optional confirmation dialogs and per-item permissions. All player data is saved asynchronously, so your main thread never lags.
Key Features at a Glance
- Global and private welcome messages – greet everyone or tailor messages to specific players.
- Adventure MiniMessage support – use modern text formatting with seamless legacy
&fallback. - Optional visuals – titles, action bar texts, and sounds on first join.
- Returning player gate – re-greet players only if they’ve been offline for a configurable number of days.
- Welcome GUI – create a custom inventory with items that can run commands, send messages, give items, teleport, and much more. Gate rule acceptance with once/cooldown/closeOnClick behaviors.
- Reopen-on-join until rules accepted – ensure every player sees the latest rules version.
- Asynchronous players.yml saving – non-blocking data storage for GUI states and timestamps.
- Telemetry counters – track GUI opens, rule acceptances, and per-item clicks today.
- PlaceholderAPI support – expose timestamps, join order, telemetry, and more to other plugins.
- Experimental particle effects and animated NPC guide – opt-in features for extra flair.
Installation and Setup
Getting FirstLogin running is straightforward. Start by placing the firstlogin-1.8.0.jar file into your server’s plugins/ folder. Launch the server once to generate the configuration files inside plugins/FirstLogIn/: config.yml, messages.yml, and players.yml. Then, open config.yml to adjust formatting, the returning gate, GUI items, and telemetry settings. A restart is recommended over a simple /reload to ensure all features initialize correctly.
If you’re looking for an even more convenient way to get started, the foxygame.net launcher provides a sleek, all-in-one platform where you can browse and install plugins like FirstLogin right from its built-in menu, saving you the hassle of manual file transfers. This modern launcher keeps your mods organized and up to date, making server management feel effortless.
Commands and Permissions
FirstLogin ships with a set of intuitive commands for both players and admins. Players can use /listp to see how many unique players have joined, /pnames for a list of names, /owner to view the server owner, /onlinep for an online/total summary, and /firsthelp for quick help. Administrators gain access to /firstlogin with tab-complete subcommands: reload the config, open the GUI for a player, clear cooldowns or flags, check a player’s status, reset data, and even adjust runtime toggles without editing files. The /firstlogin metrics command lets you view and reset today’s telemetry counts.
Permissions are granular. For example, firstlogin.admin grants full admin control, while firstlogin.command.listp allows a player to use /listp. You can restrict each command independently, giving you fine-grained control over who sees what.
PlaceholderAPI Integration
If you have PlaceholderAPI installed, FirstLogin automatically registers an expansion (toggleable via placeholderapi.enabled in config). This unlocks a wealth of placeholders for use in other plugins, scoreboards, or chat formats. You can display a player’s first join date with %firstlogin_first_join_date%, check if they have pending rules with %firstlogin_rules_pending%, or show their join order using %firstlogin_join_order%. Telemetry placeholders like %firstlogin_gui_opens_today% and per-item click counters let you build dynamic leaderboards. New in version 1.7.3, you can even display the next telemetry reset time in a pretty format, such as “3h 14m 5s”.
What’s New in Version 1.8.0
The latest release supercharges the Welcome GUI with 29 action types and 13 requirement types. You can now create items that heal, feed, change gamemode, launch fireworks, apply potion effects, or even execute random actions. Requirements let you gate items based on player flags, permissions, health, world, weather, and more. Item display options include custom model data, skull owners, potion colors, and progress bars like {bar_health} or custom {progress:current:max:width:filledColor:emptyColor}.
Beyond the GUI, 1.8.0 introduces login streak tracking, anniversary detection, and custom events (FirstJoinEvent, ReturningPlayerEvent) that other plugins can listen to. Streak milestones (7, 14, 30, 60, 90, 100, 365 days) can trigger celebratory messages. A referral system and player notes help admins keep track of their community. Discord and Slack webhook notifications can now announce first-time joins, returning players, and anniversaries with fully customizable messages.
Conclusion
FirstLogin is more than a welcome mat; it’s a complete first-join management suite that respects your server’s performance. From asynchronous saving to runtime toggles, every detail is built with server health in mind. The plugin’s deep PlaceholderAPI integration and extensible GUI system make it a perfect fit for networks that want to unify their player experience. Whether you’re enforcing rules, celebrating milestones, or simply saying “hello” with style, FirstLogin delivers a professional, memorable start for every player who steps into your world.