# 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!欢迎提供反馈和建议。
你是这个资源的作者?登录后可认领此资源。
相似资源
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
可自定义玩家模型
tom5454
自定义你的Minecraft头像!
装饰社交
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
WorldEdit
me4502
一个在游戏内运行的 Minecraft 地图编辑器! 支持选区、蓝图、复制粘贴、笔刷和脚本。 可在创造模式中使用,也可在生存模式中临时使用。
前置管理
10
LobbyAPI
Zombie_Striker_Dev
创建用户友好的菜单以前往不同的世界
管理交通
9
tkChat
tkkr
专为 Velocity 打造的自制聊天插件,功能丰富——支持跨服群组/全局/私聊消息,并集成 LibertyBans 的禁言功能。
管理社交
9
评论 0
登录后参与评分
还没有评论,来抢沙发吧