promotional bannermobile promotional banner

FirstLogin

A lightweight, friendly first-join plugin for Spigot/Paper. Welcomes new players with clean MiniMessage formatting, a configurable Welcome GUI, optional reopen‑until‑accepted rules.
Download

File Details
Download

firstlogin-1.6.jar

ByBooyaka101
  • R
  • Aug 22, 2025
  • 948.42 KB
  • 39
  • 1.21.8+17

File Name

firstlogin-1.6.jar

Supported Versions

  • 1.21.5-Snapshot
  • 1.21.8
  • 1.21.7
  • 1.21.6
  • 1.21.5
  • 1.21.4
  • 1.21.3
  • 1.21.2
  • 1.21.1
  • 1.21
  • 1.20.3-Snapshot
  • 1.20.5-Snapshot
  • 1.20.6
  • 1.20.5
  • 1.20.4
  • 1.20.3
  • 1.20.2
  • 1.20.1
# FirstLogin – Changelog

## 1.6 (2025‑08‑22)

- New: MiniMessage formatting with legacy color fallback
  - Supports Adventure MiniMessage tags (e.g., <green>, <gray>)
  - Seamless fallback for legacy "&" color codes when MiniMessage isn’t used in a line
- New: First-join visuals (configurable)
  - Title + subtitle with fade timings
  - Optional action bar message
  - Optional sound to celebrate first join
- New: Admin command `/firstlogin` with subcommands
  - `reload` – reloads config and messages
  - `seen <player>` – checks if a player has been marked as "seen" by this plugin
  - `reset <player|all>` – resets the seen state (per player or all)
- New: Returning player gate
  - Only send the "messageBack" greeting if the player has been offline for at least `returningGate.minDaysOffline` days (configurable)
- New: Placeholder support
  - Built-in placeholders: `{player}`, `{online}`, `{total}`, `{owner}`
  - Optional PlaceholderAPI integration (if installed and enabled in config)
- New: bStats metrics (configurable)
  - Controlled by `metrics.enabled`
  - `metrics.pluginId` added (now set to your plugin ID)
- Quality: Better logging and configuration handling
  - Logs the plugin version dynamically from `plugin.yml`
  - Replaced deprecated YAML header API usage
  - Removed unused imports and minor code cleanups
- Build: Shaded jar with dependencies (Adventure + bStats) for easy deployment
- Branding: Updated author to "BooPug Studios"

### Upgrade notes from older versions
- Drop-in replacement. Keep your existing `config.yml` and adjust new sections:
  - `formatting` (MiniMessage, placeholders, PlaceholderAPI)
  - `firstJoinVisuals` (title/actionbar/sound)
  - `returningGate.minDaysOffline`
  - `metrics` (enable/disable + pluginId)
- Restart the server (preferred) after replacing the jar.