FirstJoinBefore PlaceholderAPI 扩展

这是一个 PlaceholderAPI 扩展，用于判断玩家是否在指定的 Unix 时间戳之前首次进入服务器。

功能说明

• 占位符格式: %firstjoinbefore_<timestamp>%
• 参数: Unix时间戳（秒）
• 返回值:
  • yes - 如果玩家首次进入时间在指定时间戳之前
  • no - 如果玩家首次进入时间在指定时间戳之后或相等
  • 空字符串 - 如果参数无效或玩家为空

使用示例

%firstjoinbefore_1700000000%

这将检查玩家是否在 Unix时间戳 1700000000（2023年11月14日）之前首次进入服务器。

编译方法

前置要求

• Java 8 或更高版本
• Maven 3.x

编译步骤

1. 确保你已经安装了 Maven
2. 在项目根目录执行：

mvn clean package

3. 编译完成后，在 target 目录下会生成 FirstJoinBeforeExpansion-1.0.0.jar 文件

安装方法

1. 确保你的服务器已经安装了 PlaceholderAPI 插件
2. 将编译好的 jar 文件放入 plugins/PlaceholderAPI/expansions/ 目录
3. 执行命令 /papi reload 重载 PlaceholderAPI
4. 使用 /papi list 查看扩展是否成功加载

依赖项

• Spigot API 1.20.1 (或兼容版本)
• PlaceholderAPI 2.11.5 (或兼容版本)

版本信息

• 版本: 1.0.0
• 作者: ImCur_
• 标识符: firstjoinbefore

应用场景

此扩展可以用于：

• 判断老玩家身份（在某个日期之前加入的玩家）
• 根据玩家加入时间给予不同权限或奖励
• 配合其他插件（如 ConditionalEvents、Skript 等）实现基于首次加入时间的逻辑

技术细节

• 使用 Bukkit 的 OfflinePlayer.getFirstPlayed() 方法获取玩家首次进入时间
• Bukkit 返回的时间是毫秒，会自动转换为秒与参数比较
• 继承自 PlaceholderExpansion 类
• 设置 persist() 为 true，避免重载时被注销

许可证

此项目为开源项目，可自由使用和修改。