PROJECT_STRUCTURE.md

项目结构说明

FirstJoinBeforeExpansion/
├── src/
│   └── main/
│       └── java/
│           └── com/
│               └── example/
│                   └── firstjoinbefore/
│                       └── FirstJoinBeforeExpansion.java  # 主扩展类
├── pom.xml                                               # Maven 构建配置
├── build.sh                                              # Linux/Mac 编译脚本
├── build.bat                                             # Windows 编译脚本
├── README.md                                             # 使用说明
└── PROJECT_STRUCTURE.md                                  # 本文件

文件说明

FirstJoinBeforeExpansion.java

这是 PlaceholderAPI 扩展的主类文件，包含了核心逻辑：

• 扩展标识符：firstjoinbefore
• 占位符处理逻辑：比较玩家首次进入时间与给定时间戳
• 返回值处理：返回 PlaceholderAPI 标准的 yes/no 值

pom.xml

Maven 项目配置文件，定义了：

• 项目基本信息（groupId, artifactId, version）
• 依赖项（Spigot API 和 PlaceholderAPI）
• 构建配置（编译插件、打包插件）
• 仓库地址（Spigot 和 PlaceholderAPI 的 Maven 仓库）

build.sh / build.bat

便捷的编译脚本：

• 检查 Maven 是否安装
• 执行 mvn clean package 命令
• 显示编译结果和安装说明

开发环境要求

• Java JDK 8 或更高版本
• Maven 3.x
• （可选）IDE，如 IntelliJ IDEA 或 Eclipse

自定义修改

如果你想修改扩展功能，主要修改以下内容：

1. 修改标识符：在 getIdentifier() 方法中修改返回值
2. 修改逻辑：在 onRequest() 方法中修改占位符处理逻辑
3. 修改版本号：同时更新 getVersion() 方法和 pom.xml 中的版本号

常见问题

Q: 编译后的 jar 文件在哪里？

A: 在项目根目录的 target/ 文件夹下，文件名为 FirstJoinBeforeExpansion-1.0.0.jar

Q: 如何导入到 IDE？

A: 大多数现代 IDE 都支持直接导入 Maven 项目，选择导入项目时指向包含 pom.xml 的目录即可。

Q: 依赖项无法下载怎么办？

A: 确保你的网络可以访问 Maven 中央仓库和配置的第三方仓库。如果在中国大陆，可能需要配置 Maven 镜像。

Q: 如何测试扩展？

A:

1. 启动一个测试服务器（需要安装 PlaceholderAPI）
2. 将编译好的 jar 放入 plugins/PlaceholderAPI/expansions/
3. 执行 /papi reload
4. 使用 /papi parse me %firstjoinbefore_<timestamp>% 测试

贡献

欢迎提交问题报告和改进建议！