FirstLogin

插件

· 作者 Booyaka101

一款轻量、友好的 Spigot/Paper 首次加入插件。使用简洁的 MiniMessage 格式欢迎新玩家,提供可配置的欢迎 GUI,并支持可选的“重新打开直至接受”规则。

0 本站下载 0 关注 更新于 9 个月前

最新 firstlogin-1.8.0.jar · 1.21

一键开服(送7天)
# FirstLogin (v1.8.0)
为 Spigot/Paper 打造的轻量、友好的首次加入体验。展示精美的欢迎消息,可选的视觉效果(标题/动作栏/音效),以及可配置的欢迎 GUI,支持通过可选确认对话框来“锁定规则已接受”状态。包含异步玩家数据保存功能,并支持 PlaceholderAPI 占位符用于时间戳、遥测数据和加入顺序。

## 功能特性
- 全局与私有的欢迎消息
- Adventure MiniMessage 支持(无缝兼容传统的 `&` 格式回退)
- 可选视觉效果:标题、动作栏、音效
- 回归玩家门控:仅在离线 X 天后再次问候
- 欢迎 GUI:每项物品拥有独立的权限控制和门控逻辑(一次性/冷却时间/点击关闭/点击音效)
- 直到当前规则被接受前,每次加入都重新打开 GUI(可配置)
- 接受前的可选确认对话框
- 异步保存 players.yml(非阻塞式)
- 遥测计数器(今日统计):GUI 打开次数、规则接受次数、单项物品点击次数
- PlaceholderAPI 支持(时间戳、遥测数据、加入顺序)
- bStats 指标上报(可选择退出)

### 实验性功能(需手动启用)
- 首次加入时的粒子效果 (`particles.enabled`) — 默认禁用
- 动画 NPC 向导 (`animatedGuide.enabled`) — 默认禁用
- 在 `config.yml` 中切换,并通过 `/firstlogin reload` 在运行时应用更改

## 依赖要求
- Spigot 或 Paper 1.20+
- Java 17
- 可选:PlaceholderAPI(用于使用 `%firstlogin_*%` 占位符)
  - 通过 `placeholderapi.enabled` 切换 FirstLogin 扩展插件。使用 `/firstlogin reload` 在运行时动态注册/注销该扩展。

## 安装方法
1) 将 `firstlogin-1.8.0.jar` 放入你的 `plugins/` 文件夹。 
2) 启动服务器一次以生成以下文件:
   - `plugins/FirstLogIn/config.yml`
   - `plugins/FirstLogIn/messages.yml`
   - `plugins/FirstLogIn/players.yml`
3) 根据你的喜好配置消息和视觉效果。 
4) 重启服务器(建议重启而非使用 `/reload`)。

## 命令列表
- `/listp` — 显示至今为止加入过的玩家总数  
- `/pnames` — 列出至今为止加入过的玩家名字  
- `/owner` — 打印配置中的服务器所有者  
- `/onlinep` — 在线/总人数摘要  
- `/firsthelp` — 快速帮助  
- `/firstlogin` — 管理工具(支持 Tab 补全)
  - `reload` — 重载配置/消息
  - `gui <open [player]|accept [player]|trigger <key> [player]>`
  - `clearcooldown <player> <key|all>`
  - `clearflag <player> <flag|all>`
  - `seen <player>` / `reset <player|all>` / `status [player]`
  - `set <key> <value>` — 运行时开关设置
  - `metrics [reset|when|now]` — 查看遥测数据(带美观格式的上次/下次重置时间与间隔)、重置今日数据或立即重置

## PlaceholderAPI 占位符
时间戳与状态:
- `%firstlogin_first_join_date%` — 格式化后的首次加入时间(使用 `formatting.datePattern`,默认为 `yyyy-MM-dd HH:mm:ss`)
- `%firstlogin_rules_accepted_date%` — 格式化后的规则接受时间
- `%firstlogin_days_since_first_join%` — 距离首次加入的天数(取整)
- `%firstlogin_first_join_ts%` — 首次加入的时间戳毫秒数(未知则为 0)
- `%firstlogin_rules_accepted_ts%` — 规则接受的时间戳毫秒数(未知则为 0)
- `%firstlogin_days_since_rules_accepted%` — 距离规则接受的天数(取整,未知则为 0)
- `%firstlogin_rules_version_accepted%` — 已接受的最高规则版本号(若无则返回 0)
- `%firstlogin_rules_pending%` — 若玩家尚未接受当前版本规则则返回 true

遥测数据与加入顺序(1.7.2 新增):
- `%firstlogin_gui_opens_today%`
- `%firstlogin_rules_accepted_today%`
- `%firstlogin_item_clicks_today_<key>%` — 基于你设置的物品键值统计的今日单项物品点击计数
- `%firstlogin_join_order%` — 1-based 加入顺序(别名:`%firstlogin_join_number%`)

遥测重置相关(1.7.3 新增):
- `%firstlogin_metrics_reset_date%` — 最近一次遥测重置的格式化日期/时间
- `%firstlogin_metrics_last_reset_ts%` — 最近一次遥测重置的时间戳毫秒数(从未重置则为 0)
- `%firstlogin_metrics_next_reset_date%` — 下一次计划遥测重置的格式化日期/时间
- `%firstlogin_metrics_next_reset_ts%` — 下一次计划遥测重置的时间戳毫秒数(禁用则为 0)

其他时间与美化格式占位符(1.7.3 新增):
- `%firstlogin_metrics_next_reset_in_seconds%`
- `%firstlogin_metrics_next_reset_in_minutes%`
- `%firstlogin_metrics_next_reset_in_hours%`
- `%firstlogin_metrics_next_reset_pretty%` — 例如 "3h 14m 5s"
- `%firstlogin_metrics_last_reset_pretty%` — 例如 "1d 2h 3m 4s ago"

示例:
```
/papi parse me %firstlogin_player%
/papi parse me %firstlogin_first_join_date%
/papi parse me %firstlogin_gui_opens_today%
/papi parse me %firstlogin_item_clicks_today_confirm_accept%
/papi parse me %firstlogin_join_order%
/papi parse me %firstlogin_metrics_reset_date%
/papi parse me %firstlogin_metrics_next_reset_date%
```

## 配置亮点
- `formatting`:切换 MiniMessage、内置函数和 PlaceholderAPI 解析
- `returningGate.minDaysOffline`:仅在玩家离线 X 天后才向回归玩家打招呼
- `welcomeGui`:定义物品、权限、门控逻辑、一次性/冷却设置,以及点击动作和音效
- 通过 `/firstlogin set <key> <value>` 进行运行时切换(无需编辑文件)
- GUI/库存日志的调试开关
- 遥测重置计划调度:`telemetry.reset.enabled`(布尔值),`telemetry.reset.time`(HH:mm;更改后立即重新调度)

## 权限(示例)
- `firstlogin.admin` — 使用 `/firstlogin` 管理命令
- `firstlogin.command.listp` — `/listp`
- `firstlogin.command.pnames` — `/pnames`
- `firstlogin.command.owner` — `/owner`
- `firstlogin.command.onlinep` — `/onlinep`
- `firstlogin.command.firsthelp` — `/firsthelp`

## bStats
匿名使用统计数据有助于指导开发,并且可以禁用:
- 全局通过 `plugins/bStats/config.yml`
- 或按插件在 `plugins/FirstLogIn/config.yml` 中配置(如果暴露该选项)

## 1.8.0 新增功能

### 增强的 GUI 系统
- **29 种动作类型**:message, command, url, sound, give, teleport, effect, title, actionbar, broadcast, heal, feed, gamemode, fly, firework, particle, bossbar, velocity, cleareffects, sudo, op, random, delay, if, chance, repeat
- **13 种要求类型**:flag, !flag, perm, !perm, level, health, food, gamemode, world, online, time, weather, cooldown, played
- **10 种物品显示选项**:amount, glow, customModelData, hideAttributes, hideFlags, skullOwner, color, enchantments, potionColor, potionEffects
- **15+ 新占位符**:{health}, {food}, {level}, {xp}, {world}, {x}, {y}, {z}, {gamemode}, {time}, {weather}, {playtime}, {ping}, {uuid_short}
- **进度条**:{bar_health}, {bar_food}, {bar_xp},自定义格式 {progress:current:max:width:filledColor:emptyColor}

### 加入追踪与事件
- 登录连续天数追踪(连续游玩天数、最大连续天数)
- 周年纪念检测与庆祝消息
- 供其他插件使用的 `FirstJoinEvent` 和 `ReturningPlayerEvent` 自定义事件
- 里程碑提醒消息(7, 14, 30, 60, 90, 100, 365 天)
- 推荐系统与管理员备注功能

### Discord/Slack Webhook 通知
- 首次加入和回归玩家的 Webhook 通知
- 支持占位符的可自定义消息
- Webhook 中的周年纪念通知

## 1.7.2 新增功能
- Welcome GUI 状态的异步 `players.yml` 保存(非阻塞式)
- 持久化时间戳:`timestamps.<uuid>.first_join`, `timestamps.<uuid>.rules_accepted`
- PlaceholderAPI:首次加入 + 规则接受日期/纪元时间戳、距今天数;遥测计数器;加入顺序
- `/firstlogin metrics` 查看/重置今日计数
- GUI 改进:在接受前每次加入时重新打开,可选确认对话框

---
感谢体验 FirstLogin!欢迎提供反馈和建议。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源