firstlogin-1.7.2.jar

Details

  • Filename
    firstlogin-1.7.2.jar
  • Uploaded by
  • Uploaded
    Aug 24, 2025
  • Size
    988.40 KB
  • Downloads
    285
  • MD5
    992ed656cddb3a023e319c7bafefdaa2

Supported Bukkit Versions

  • 1.21.8
  • 1.21.7
  • 1.21.6
  • 1.21.5
  • 1.21.1
  • 1.21.2
  • 1.21.3
  • 1.21.4
  • 1.21.5-Snapshot
  • 1.21
  • 1.20.6
  • 1.20.5
  • 1.20.5-Snapshot
  • 1.20.4
  • 1.20.3-Snapshot
  • 1.20.3
  • 1.20.2
  • 1.20.1
  • 1.20

Changelog

## 1.7.2 (2025‑08‑24)

- Add: Optional confirmation dialog before accepting rules in the Welcome GUI (`welcomeGui.confirmOnAccept`)
- Add: In-plugin telemetry counters for daily GUI opens and rules accepted; view/reset via `/firstlogin metrics [reset]`
- Add: Runtime command toggles via `/firstlogin set <key> <value>` (no file edit required)
  - Keys: `welcomeGui.reopenOnJoinUntilAccepted`, `welcomeGui.blockCloseUntilAccepted`, `welcomeGui.confirmOnAccept`, `welcomeGui.rulesVersion`, `debug.gui`, `debug.inventory`
- Add: Granular admin permissions for each `/firstlogin` subcommand under `firstlogin.admin.*`
- Add: New admin subcommands with tab-completion: `set`, `metrics`
- Update: `plugin.yml` usage expanded and permissions detailed for new subcommands

- Change: Switch Welcome GUI persistence to asynchronous player data saving (non-blocking writes to `players.yml`)

- Add: Persist player timestamps to `players.yml`
  - `timestamps.<uuid>.first_join` – epoch millis of first join (fallback to Bukkit firstPlayed)
  - `timestamps.<uuid>.rules_accepted` – epoch millis when rules were accepted
- Add: PlaceholderAPI placeholders for timestamps and status
  - `%firstlogin_first_join_date%`, `%firstlogin_rules_accepted_date%` (formatted via `formatting.datePattern`)
  - `%firstlogin_days_since_first_join%`, `%firstlogin_days_since_rules_accepted%`
  - `%firstlogin_first_join_ts%`, `%firstlogin_rules_accepted_ts%`
  - `%firstlogin_rules_version_accepted%`, `%firstlogin_rules_pending%`
- Add: PlaceholderAPI telemetry + join order placeholders
  - `%firstlogin_gui_opens_today%`, `%firstlogin_rules_accepted_today%`
  - `%firstlogin_item_clicks_today_<key>%` (per-GUI-item click counter)
  - `%firstlogin_join_order%` (alias `%firstlogin_join_number%`) – 1-based join order across known players
- Note: `formatting.datePattern` defaults to `yyyy-MM-dd HH:mm:ss` and can be customized.