BellCommand v1.4.0-beta.1 更新日志 (Changelog)

这是 v1.4.0 系列的首个 Beta 版本，汇总了所有 Alpha 版本的重大更新和重构。

---

## 核心更新 (Core Updates)

### 1. 配置管理系统全面重构
- 多文件夹架构: 引入了 Default_config/ 和自定义文件夹支持，将物品定义从主 config.yml 中解耦，极大提升了大型服务器的可维护性。
- 线程安全: 核心配置读取引入 ReentrantReadWriteLock 读写锁，确保在高并发环境下配置访问的绝对安全。
- 实时热重载: 引入 WatchService 文件监控，实现无需重启、无需命令的磁盘文件实时同步。
- 智能迁移: 支持从 v1.3.x 自动迁移配置，包括全局设置（如 auto-give）的智能分发。

### 2. 次数性物品系统 (Consumable System)
- 新增精细化的物品消耗控制逻辑。
- 四种消耗模式:
    - COUNT: 固定数量消耗。
    - PROBABILITY: 概率触发消耗。
    - RANGE: 随机区间数量消耗。
    - PROBABILITY_RANGE: 概率触发后的随机区间消耗。
- 完美兼容原有命令物品的所有属性（权限、冷却、自动化等）。

### 3. CI/CD 与自动化发布
- Modrinth 集成: 现已支持通过 GitHub Tag 自动发布版本到 Modrinth。
- GitHub Release 自动化: 自动构建、上传 JAR 并生成更新日志。

---

## 技术改进 (Technical Improvements)

- 编码优化: 全面支持 UTF-8，彻底解决多语言乱码。
- API 增强: 优化了针对基岩版（Floodgate）玩家的交互判定。
- 构建环境: 升级至 JDK 21，优化 Maven 构建流程。
- 国际化: 系统日志与提示信息全面国际化。

---

## 开发者说明 (Developer Notes)

- 构建命令: mvn package
- 支持版本: Spigot/Paper/Purpur 1.13 - 1.21
- API 版本: 1.13

Author: leemwood

.github/workflows/maven-publish.yml

@@ -57,25 +57,37 @@ jobs:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
     - name: Publish to Modrinth
-      uses: modrinth/minotaur@v2
-      with:
-        token: ${{ secrets.MODRINTH_TOKEN }}
-        project-id: n18snJd9
-        version-name: BellCommand ${{ github.ref_name }}
-        version-number: ${{ github.ref_name }}
-        file: target/bellcommand-*.jar
-        loaders: |
-          spigot
-          paper
-          purpur
-        game-versions: |
-          1.13
-          1.14
-          1.15
-          1.16
-          1.17
-          1.18
-          1.19
-          1.20
-          1.21
-        changelog: ${{ steps.commit.outputs.message }}
+      env:
+        MODRINTH_TOKEN: ${{ secrets.MODRINTH_TOKEN }}
+      run: |
+        JAR_PATH=$(ls target/bellcommand-*.jar | head -n 1)
+        FILENAME=$(basename $JAR_PATH)
+        VERSION_TYPE="release"
+        if [[ "${{ github.ref_name }}" == *"beta"* ]]; then
+          VERSION_TYPE="beta"
+        elif [[ "${{ github.ref_name }}" == *"alpha"* ]]; then
+          VERSION_TYPE="alpha"
+        fi
+        
+        # 构造 JSON 数据
+        # 注意：game_versions 和 loaders 需要是数组格式
+        DATA_JSON=$(cat <<EOF
+        {
+          "name": "BellCommand ${{ github.ref_name }}",
+          "version_number": "${{ github.ref_name }}",
+          "changelog": $(echo "${{ steps.commit.outputs.message }}" | jq -Rsa .),
+          "game_versions": ["1.13", "1.14", "1.15", "1.16", "1.17", "1.18", "1.19", "1.20", "1.21"],
+          "version_type": "$VERSION_TYPE",
+          "loaders": ["spigot", "paper", "purpur"],
+          "project_id": "n18snJd9",
+          "file_parts": ["file_0"]
+        }
+        EOF
+        )
+        
+        # 使用 curl 调用官方 API
+        curl -X POST \
+          -H "Authorization: $MODRINTH_TOKEN" \
+          -F "data=$DATA_JSON" \
+          -F "file_0=@$JAR_PATH" \
+          https://api.modrinth.com/v2/version

commit_msg.txt

@@ -0,0 +1,43 @@
+BellCommand v1.4.0-beta.1 更新日志 (Changelog)
+
+这是 v1.4.0 系列的首个 Beta 版本，汇总了所有 Alpha 版本的重大更新和重构。
+
+---
+
+## 核心更新 (Core Updates)
+
+### 1. 配置管理系统全面重构
+- 多文件夹架构: 引入了 Default_config/ 和自定义文件夹支持，将物品定义从主 config.yml 中解耦，极大提升了大型服务器的可维护性。
+- 线程安全: 核心配置读取引入 ReentrantReadWriteLock 读写锁，确保在高并发环境下配置访问的绝对安全。
+- 实时热重载: 引入 WatchService 文件监控，实现无需重启、无需命令的磁盘文件实时同步。
+- 智能迁移: 支持从 v1.3.x 自动迁移配置，包括全局设置（如 auto-give）的智能分发。
+
+### 2. 次数性物品系统 (Consumable System)
+- 新增精细化的物品消耗控制逻辑。
+- 四种消耗模式:
+    - COUNT: 固定数量消耗。
+    - PROBABILITY: 概率触发消耗。
+    - RANGE: 随机区间数量消耗。
+    - PROBABILITY_RANGE: 概率触发后的随机区间消耗。
+- 完美兼容原有命令物品的所有属性（权限、冷却、自动化等）。
+
+### 3. CI/CD 与自动化发布
+- Modrinth 集成: 现已支持通过 GitHub Tag 自动发布版本到 Modrinth。
+- GitHub Release 自动化: 自动构建、上传 JAR 并生成更新日志。
+
+---
+
+## 技术改进 (Technical Improvements)
+
+- 编码优化: 全面支持 UTF-8，彻底解决多语言乱码。
+- API 增强: 优化了针对基岩版（Floodgate）玩家的交互判定。
+- 构建环境: 升级至 JDK 21，优化 Maven 构建流程。
+- 国际化: 系统日志与提示信息全面国际化。
+
+---
+
+## 开发者说明 (Developer Notes)
+
+- 构建命令: mvn package
+- 支持版本: Spigot/Paper/Purpur 1.13 - 1.21
+- API 版本: 1.13