update standalone

.github/workflows/nightly.yml

@@ -0,0 +1,124 @@
+name: Java CI with Gradle - Nightly
+
+on:
+  schedule:
+    - cron: '0 17 * * *'
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Get latest commit hash
+        id: current
+        run: |
+          echo "sha=$(git rev-parse HEAD)" >> $GITHUB_OUTPUT
+
+      - name: Get last published commit hash
+        id: last
+        run: |
+          last_sha=$(curl -s "https://service.fpsmaster.top/api/github/latest/commit?branch=${GITHUB_REF}")
+          echo "sha=$last_sha" >> $GITHUB_OUTPUT
+
+      - name: Check if new commit exists
+        id: check
+        run: |
+          if [ "${{ steps.current.outputs.sha }}" = "${{ steps.last.outputs.sha }}" ]; then
+            echo "No new commit since last build. Skipping."
+            echo "skip=true" >> $GITHUB_OUTPUT
+          else
+            echo "New commit detected. Continuing."
+            echo "skip=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Stop if no new commit
+        if: steps.check.outputs.skip == 'true'
+        run: exit 0
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          java-version: '17'
+          distribution: 'temurin'
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@417ae3ccd767c252f5661f1ace9f835f9654f2b5 # v3.1.0
+        with:
+          gradle-version: '8.6'
+
+      - name: Build with Gradle Wrapper
+        run: |
+          chmod +x ./v1.8.9/gradlew
+          cd v1.8.9
+          ./gradlew build
+
+      - name: Upload v1.8.9 artifacts
+        uses: actions/upload-artifact@v4.3.3
+        with:
+          name: v1.8.9
+          path: v1.8.9/build/libs/
+
+      - name: Upload artifact
+        run: |
+          cd v1.8.9
+
+          plain_version=$(awk -F'=' '/^version[[:space:]]*=/ {print $2}' gradle.properties | tr -d '[:space:]')
+          sha=$(git rev-parse --short=6 HEAD)
+          date=$(date -u +%Y%m%d)
+          version="${plain_version}-nightly-${sha}"
+          filename="fpsmaster-nightly-${date}.zip"
+
+          mkdir -p build/libs
+          cd build/libs
+
+          export JAR=$(find . -name "*.jar")
+          mkdir -p zip
+          cp "$JAR" zip/fpsmaster.jar
+          cd zip
+          zip -r "$filename" *
+
+          # 创建存储目录
+          RESPONSE=$(curl --location --request POST "https://api.kstore.space/api/v1/file/create" \
+            --header "X-GitHub-Event: workflow_run" \
+            --header "User-Agent: Apifox/1.0.0 (https://apifox.com)" \
+            --form "access_token=${{ secrets.OSS }}" \
+            --form "fileId=0" \
+            --form "name=action-${{ github.sha }}")
+
+          DIR_ID=$(echo "$RESPONSE" | jq -r '.data.id')
+          echo "DirectoryId: $DIR_ID"
+
+          # 上传文件
+          UPLOAD_RESPONSE=$(curl --location --request POST "https://upload.kstore.space/upload/$DIR_ID?access_token=${{ secrets.OSS }}" \
+            -F "file=@$filename")
+
+          DOWNLOAD_URL=$(echo "$UPLOAD_RESPONSE" | jq -r '.data.downloadUrl')
+          FILE_ID=$(echo "$UPLOAD_RESPONSE" | jq -r '.data.id')
+
+          echo "FileId: $FILE_ID"
+          echo "URL: $DOWNLOAD_URL"
+
+          # 设为直接下载
+          RESPONSE=$(curl --location --request POST "https://api.kstore.cc/api/v1/file/direct?access_token=${{ secrets.OSS }}" \
+            --form "fileId=$FILE_ID" \
+            --form "isDirect=1")
+
+          echo "$RESPONSE"
+
+          echo "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+
+          # 推送版本信息
+          curl --get \
+          --data-urlencode "key=${{ secrets.API_KEY }}" \
+          --data-urlencode "commit=${{ github.sha }}" \
+          --data-urlencode "branch=${{ github.ref }}" \
+          --data-urlencode "version=$version" \
+          --data-urlencode "date=$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+          --data-urlencode "link=$DOWNLOAD_URL" \
+          --data-urlencode "release=false" \
+          "https://service.fpsmaster.top/api/github/push"

.github/workflows/gradle.yml → .github/workflows/publish.yml

@@ -1,10 +1,9 @@
 name: Java CI with Gradle
 
 on:
-  push:
-    branches: [ "master", "v4" ]
-  pull_request:
-    branches: [ "master", "v4" ]
+#  push:
+#    branches: [ "master", "v4" ]
+  workflow_dispatch:
 
 jobs:
   build:
@@ -42,8 +41,10 @@ jobs:
         run: |
           cd v1.8.9
 
-          version=$(awk -F'=' '/^version[[:space:]]*=/ {print $2}' gradle.properties | tr -d '[:space:]')
-
+          plain_version=$(awk -F'=' '/^version[[:space:]]*=/ {print $2}' gradle.properties | tr -d '[:space:]')
+          sha=$(git rev-parse --short=6 HEAD)
+          version="${plain_version}-${sha}"
+
           mkdir -p build/libs
           cd build/libs
 
@@ -92,4 +93,4 @@ jobs:
           --data-urlencode "date=$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
           --data-urlencode "link=$DOWNLOAD_URL" \
           --data-urlencode "release=false" \
-          "https://service.fpsmaster.top/pushVersion"
+          "https://service.fpsmaster.top/api/github/push"

README.md

@@ -10,61 +10,26 @@
 FPSMaster 是一个免费、强大的 Minecraft PvP 客户端。
 
 ## 注意：
-本分支是FPSMaster v4的开发分支，目前处于开发阶段，请勿在生产环境中使用。
-
 如果你想参与到开发中，请查看以下注意事项：
-1. SDK将逐渐迁移到java，尽量不要增加新的kotlin代码
-2. 如果您要添加新的功能，请先在issue中提出，并进行讨论，避免您开发的功能与项目目标不一致
-3. 请不要在生产环境中使用，除非你非常熟悉代码，并且知道自己在做什么。
-4. 本分支的1.12.2版本代码暂时不会更新，因此使用1.12.2版本会报错是正常现象。
+1. 如果您要添加新的功能，请先在issue中提出，并进行讨论，避免您开发的功能与项目目标不一致
+2. 请不要在生产环境中使用，除非你非常熟悉代码，并且知道自己在做什么。
+3. 本分支的1.12.2版本代码暂时不会更新，因此使用1.12.2版本会报错是正常现象。
 
 
-### todo:
-- [x] 完全迁移到Java
-- [ ] 优化代码结构
-- [x] 添加固定界面尺寸选项
-- [x] 组件尺寸自定义
-- [ ] 重构MusicPlayer界面
-- [ ] 支持播放无损/VIP音乐
-- [ ] 修复音乐可视化
-- [ ] 添加脚本插件系统
-- [ ] 添加界面自动对齐
-- [ ] 添加翻译功能
-- [ ] 迁移优化代码
-- [ ] 自动更新
-- [ ] 多语言界面
-- [ ] 重写IRC模块
-- [ ] 优化配置文件模块
-- [ ] FPSMaster Intelligence
-- [ ] HitMarker
-- [ ] Waypoint
+### 开发
+ - 查看我们的[代码规范](docs/code_standards.md)了解如何编写符合我们要求的代码。
+ - 查看我们的[环境配置](docs/development_environment.md)了解如何配置开发环境。
+ - 查看我们的[开发指南](docs/development_tutorial.md)了解如何使用我们的模块系统、配置系统等，并完成你的需求。
+ - 查看我们的[任务列表](docs/tasks.md)了解当前的开发计划和进度。
 
 
 ## 开源许可证
 本项目采用 GPL-3.0 许可证。详情请参阅 [LICENSE](LICENSE) 文件。
 
-特别声明：由于疏忽，自`c6a5edaac43fdcca8ce487eee430e9fb059a2db1`前所有版本的代码均错误地使用了MIT协议开源，现已更正为GPL-3.0。
-
 ## 开发环境配置
-1. clone项目
-2. Link Gradle Script
-3. 将Idea的Gradle jdk版本设置为java17
-4. 导入各版本gradle配置文件
-5. 执行`gradle genIntelliJRuns`
-6. 执行`gradle runClient`（这一步会执行downloadAssets等任务，可能因为网络问题失败）
-7. 把生成的Minecraft Client启动配置的运行java版本改为java8（注意，不要改gradle的jdk版本配置）
-
-可能遇到的问题：
-
-- 运行`genIntelliJRuns`之后并没有出现启动配置，此时需要把生成的`.idea/runConfiguration`复制到`v1.8.9/.idea/runConfiguration`
-- 生成的启动配置的vmargs参数中`v1.8.9/.gradle/loom-cache/launch.cfg`中的目录路径可能无法启动，需要手动改成绝对路径
-- 生成的`v1.8.9/.gradle/loom-cache/launch.cfg`中的目录路径错误，这时需要手动修复
-- APPDATA/.gradle/caches/essential-loom/assets/ 目录中的资源无法正常下载，此时可以其他地方复制一份1.8的assets目录过来
-
-
-
+查看我们的[开发环境配置指南](docs/development_environment.md)了解如何配置开发环境。
 
-![Alt](https://repobeats.axiom.co/api/embed/e686f6313e4406de4286bf27e0db4a2bf5a31b7f.svg "Repobeats analytics image")
+![Alt](https://repobeats.axiom.co/api/embed/7d755c063aa9a34d74edb7045541e8bfe6e09b89.svg "Repobeats analytics image")
 
 ## 引用的开源项目：
 [eventbus](https://github.com/therealbush/eventbus)

docs/code_standards.md

@@ -0,0 +1,139 @@
+# FPSMaster 代码规范
+
+本文档概述了FPSMaster项目的代码标准和贡献指南。所有贡献者在提交代码时都应遵循这些标准，以确保代码库的一致性和质量。
+
+## 代码风格指南
+
+### 命名规范
+
+1. 方法名、变量名和包名使用**驼峰式命名法(camelCase)**
+   ```java
+   public void initializeModules() { ... }
+   private String clientVersion;
+   ```
+
+2. 类名和接口名使用**帕斯卡命名法(PascalCase)**
+   ```java
+   public class ModuleManager { ... }
+   public interface EventListener { ... }
+   ```
+
+3. 常量使用**全大写蛇形命名法(UPPER_SNAKE_CASE)**
+   ```java
+   public static final String CLIENT_VERSION = "v4";
+   ```
+
+### 代码组织
+
+1. 按字母顺序组织导入并删除未使用的导入
+2. 将相关方法分组放置
+3. 保持方法专注于单一职责
+4. 限制方法长度以提高可读性(建议控制在50行以内)
+5. 使用适当的访问修饰符(private, protected, public)来加强封装性
+6. 字段应放在类顶部，其次是构造函数，然后是方法
+
+### 格式化
+
+1. 使用4个空格缩进(不要用制表符)
+2. 左大括号与声明放在同一行
+   ```java
+   public void method() {
+       // 代码
+   }
+   ```
+3. 在`if`、`for`、`while`等关键字后使用空格
+   ```java
+   if (condition) {
+       // 代码
+   }
+   ```
+4. 在运算符周围使用空格
+   ```java
+   int a = b + c;
+   ```
+
+### 文档
+
+1. 为所有公共类和方法添加JavaDoc注释
+   ```java
+   /**
+    * 初始化模块系统。
+    * 此方法注册所有模块并设置事件监听器。
+    */
+   public void initializeModules() {
+       // 实现
+   }
+   ```
+2. 为复杂代码段添加行内注释
+3. 保持注释与代码变更同步更新
+
+### 错误处理
+
+1. 使用适当的异常处理
+2. 避免空的catch块；至少应记录异常
+   ```java
+   try {
+       // 可能抛出异常的代码
+   } catch (Exception e) {
+       ClientLogger.error("处理失败: " + e.getMessage());
+   }
+   ```
+3. 提供有意义的错误信息
+
+### 最佳实践
+
+1. 避免使用魔法数字；改用命名常量
+2. 尽量减少静态字段和方法的使用
+3. 遵循最小权限原则(使用尽可能严格的访问修饰符)
+4. 避免代码重复；将通用代码提取为可重用方法
+5. 根据任务选择合适的数据结构
+6. 实现适当的空值检查以避免NullPointerException
+
+## 测试要求
+
+在提交pull request前，贡献者必须：
+
+1. **测试所有受影响的功能**：确保变更不会破坏现有功能
+2. **跨不同Minecraft版本测试**：如适用，验证变更在所有支持的Minecraft版本(1.8.9, 1.12.2等)上都能正常工作
+3. **测试边界情况**：考虑并测试边界条件和异常输入
+4. **性能测试**：对于性能关键代码，验证变更不会对性能产生负面影响
+
+### 测试清单
+
+- [ ] 测试变更的主要功能
+- [ ] 验证变更不会破坏现有功能
+- [ ] 在所有适用的Minecraft版本上测试
+- [ ] 考虑并测试边界情况
+- [ ] 验证性能影响(如适用)
+- [ ] 检查测试过程中是否有控制台错误
+
+## Pull Request指南
+
+提交pull request时：
+
+1. **描述你的变更**：清晰说明PR做了什么
+2. **引用相关问题**：链接到PR解决的所有相关问题
+3. **保持变更专注**：每个PR应只解决一个关注点
+4. **遵循代码风格**：确保代码遵循项目的代码风格指南
+5. **更新文档**：更新变更影响的所有相关文档
+
+### PR清单
+
+- [ ] 代码遵循项目的代码风格指南
+- [ ] 测试所有相关模块
+- [ ] 文档已更新(如适用)
+- [ ] PR只解决一个关注点
+- [ ] PR引用了相关问题
+
+## 贡献流程
+
+1. **Fork仓库**：创建项目的个人fork
+2. **创建分支**：在新分支中进行变更
+3. **实现变更**：开发功能或修复
+4. **测试变更**：确保所有测试通过且变更按预期工作
+5. **提交pull request**：从你的分支向主仓库创建PR
+6. **处理评审反馈**：根据代码评审要求进行修改
+
+## 结语
+
+遵循这些指南有助于保持FPSMaster项目的代码质量和一致性。感谢您的贡献，感谢您帮助FPSMaster变得更好！

docs/development_environment.md

@@ -0,0 +1,27 @@
+# 配置开发环境
+
+## 准备工作
+1. Git
+2. JDK 1.8
+3. JDK 17
+4. IntelliJ IDEA Community / Ultimate
+
+## 配置项目
+
+1. clone项目
+2. Link Gradle Script
+3. 将Idea的Gradle jdk版本设置为java17
+4. 导入相应版本gradle配置文件
+5. 执行`gradle genIntelliJRuns`
+6. 此时并不会出现启动配置，此时需要把生成的`v1.8.9/.idea/runConfiguration`复制到`.idea/runConfiguration`，随后重新打开项目即可识别
+
+### 可能遇到的问题：
+
+- 生成的启动配置的vmargs参数中的目录路径可能无法正确识别，需要手动改为正确路径或绝对路径
+- 生成的`v1.8.9/.gradle/loom-cache/launch.cfg`中的目录路径错误，这时需要手动改为正确路径或绝对路径
+- `APPDATA/.gradle/caches/essential-loom/assets/` 目录中的资源无法正常下载，此时可以其他地方复制一份1.8的assets目录过来
+
+## 启动项目
+
+直接在IDEA的运行配置中选中Minecraft Client，并且将运行java版本改为jdk 1.8（注意，不要改gradle的jdk版本配置）
+