Dev

.github/workflows/build.yml

@@ -9,40 +9,50 @@ on:
 jobs:
   build:
     runs-on: windows-latest
+    strategy:
+      matrix:
+        target_type:
+          - server
+          # - client
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
 
       - uses: xmake-io/github-action-setup-xmake@v1
         # with:
         #   xmake-version: branch@master
-      
-      - uses: actions/cache@v4
+
+      - uses: actions/cache@v6
         with:
           path: |
             ~/AppData/Local/.xmake
           key: xmake-${{ hashFiles('xmake.lua') }}
           restore-keys: |
             xmake-
 
+      - name: Setup LLVM
+        uses: ZhongRuoyu/setup-llvm@v0
+        with:
+          llvm-version: 22
+
       - run: |
           xmake repo -u
 
       - run: |
-          xmake f -a x64 -m release -p windows -v -y
+          xmake f -a x64 -m release -p windows -v --target_type=${{ matrix.target_type }} -y
 
       - run: |
           xmake -v -y
 
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v7
         with:
-          name: ${{ github.event.repository.name }}-windows-x64-${{ github.sha }}
+          name: ${{ github.event.repository.name }}-${{ github.sha }}-${{ matrix.target_type }}-windows-x64
           path: |
             bin/
 
   # clang-format:
-  #   runs-on: windows-latest
+  #   runs-on: windows-2022
   #   steps:
-  #     - uses: actions/checkout@v4
+  #     - uses: actions/checkout@v7
 
   #     - run: |
   #         choco install llvm -y --version=17.0.6

.github/workflows/release.yml

@@ -6,40 +6,51 @@ on:
 jobs:
   build:
     runs-on: windows-latest
+    strategy:
+      matrix:
+        target_type:
+          - server
+          # - client
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
 
       - uses: xmake-io/github-action-setup-xmake@v1
         # with:
         #   xmake-version: branch@master
-      - uses: matbour/setup-sentry-cli@v1
+
+      - uses: matbour/setup-sentry-cli@v2
         with:
           token: ${{ SECRETS.SENTRY_TOKEN }}
           organization: ${{ SECRETS.SENTRY_ORG }}
           project: ${{ SECRETS.SENTRY_PROJECT }}
-      
-      - uses: actions/cache@v4
+
+      - uses: actions/cache@v6
         with:
           path: |
             ~/AppData/Local/.xmake
           key: xmake-${{ hashFiles('xmake.lua') }}
           restore-keys: |
             xmake-
 
+      - name: Setup LLVM
+        uses: ZhongRuoyu/setup-llvm@v0
+        with:
+          llvm-version: 22
+
       - run: |
           xmake repo -u
 
       - run: |
-          xmake f -a x64 -m release -p windows -y --publish=y
+          xmake f -a x64 -m release -p windows --target_type=${{ matrix.target_type }} -y --publish=y
 
       - run: |
           xmake -w -y
       - run: |
           sentry-cli debug-files upload --include-sources bin/LK-Stats
 
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v7
         with:
-          name: ${{ github.event.repository.name }}-windows-x64-${{ github.sha }}
+          name: ${{ github.event.repository.name }}-${{ github.sha }}-${{ matrix.target_type }}-windows-x64
           path: |
             bin/
 
@@ -48,12 +59,12 @@ jobs:
       contents: write
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
 
       - id: extract-release-notes
-        uses: ffurrer2/extract-release-notes@v2
+        uses: ffurrer2/extract-release-notes@v3
 
-      - uses: softprops/action-gh-release@v1
+      - uses: softprops/action-gh-release@v3
         with:
           body: |
             ${{ steps.extract-release-notes.outputs.release_notes }}
@@ -64,23 +75,28 @@ jobs:
       - update-release-notes
     permissions:
       contents: write
+    strategy:
+      matrix:
+        target_type:
+          - server
+          # - client
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
 
-      - uses: actions/download-artifact@v4
+      - uses: actions/download-artifact@v8
         with:
-          name: ${{ github.event.repository.name }}-windows-x64-${{ github.sha }}
+          name: ${{ github.event.repository.name }}-${{ github.sha }}-${{ matrix.target_type }}-windows-x64
           path: artifact
 
       - run: |
           cp CHANGELOG.md LICENSE README.md artifact/
 
       - run: |
-          zip -r ../${{ github.event.repository.name }}-windows-x64.zip *
+          zip -r ../${{ github.event.repository.name }}-${{ matrix.target_type }}-windows-x64.zip *
         working-directory: artifact
 
-      - uses: softprops/action-gh-release@v1
+      - uses: softprops/action-gh-release@v3
         with:
           files: |
-            ${{ github.event.repository.name }}-windows-x64.zip
+            ${{ github.event.repository.name }}-${{ matrix.target_type }}-windows-x64.zip

CHANGELOG.md

@@ -7,12 +7,64 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [未发布]
 
+## [0.11.0] - 2026-09-16
+
+## 新增
+
+- 适配LeviLamina 26.40
+
+## [0.10.1] - 2026-09-13
+
+### 修复
+
+- 修复骑乘状态判断在 LeviLamina 26.32 中失效，导致载具移动距离无法统计的问题。
+- 修复异常伤害值、无效客户端移动数据或计数溢出可能导致统计数值异常增大的问题。
+- 修复抗性、吸收和盾牌伤害统计的边界计算。
+- 修复花盆交互统计组件获取失败，以及村民交易统计中的空指针问题。
+
+## [0.10.0] - 2026-09-12
+
+## 新增
+
+- 适配LeviLamina 26.32
+
+### 更改
+
+- 重构语言文件结构：界面、命令、日志、统计分类与通用统计分别使用嵌套键；Minecraft 名称按 `block`、`item`、`entity` 分类。
+- 更新简体中文、繁体中文（香港）与繁体中文（台湾）的 Minecraft 官方译名数据。
+
+### 修复
+
+- 修复物品/方块混合统计在缺少物品译名时显示 `item.minecraft:<id>`，而不回退到方块译名的问题。
+
 ## [0.9.0] - 2026-07-05
 
 ### 新增
 
 - 适配LeviLamina 26.20
 
+## [0.8.3] - 2026-07-14
+
+### 新增
+
+- GUI 与 RemoteCall 统计查询分页。
+- 在线玩家每 5 分钟异步保存，并支持中断快照恢复。
+
+### 优化
+
+- 优化玩家统计索引、表单查询与内存占用。
+- 增加排行榜缓存和分页排序，降低大数据量查询开销。
+- 优化玩家移动统计热路径。
+
+### 修复
+
+- 修复异常崩溃时在线玩家统计可能长期未保存的问题。
+- 修复统计文件写入中断时可能忽略有效临时快照的问题。
+- 修复玩家重新加入后名称等缓存信息未刷新的问题。
+- 修复部分动物繁殖统计错误及潜在崩溃问题。
+- 修复物品转移统计读取错误来源槽位的问题。
+- 修复排行榜类型无效时错误提示不明确的问题。
+
 ## [0.8.0] - 2026-04-14
 
 ### 新增
@@ -215,8 +267,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 统计玩家与床交互次数
 - 统计玩家与部分方块交互次数
 
-[未发布]: https://github.com/LeafKnife/Stats/compare/v0.9.0...dev
-[0.9.0]: https://github.com/LeafKnife/Stats/compare/v0.8.0...0.9.0
+[未发布]: https://github.com/LeafKnife/Stats/compare/v0.11.0...dev
+[0.11.0]: https://github.com/LeafKnife/Stats/compare/v0.10.1...v0.11.0
+[0.10.1]: https://github.com/LeafKnife/Stats/compare/v0.10.0...v0.10.1
+[0.10.0]: https://github.com/LeafKnife/Stats/compare/v0.9.0...v0.10.0
+[0.9.0]: https://github.com/LeafKnife/Stats/compare/v0.8.3...v0.9.0
+[0.8.3]: https://github.com/LeafKnife/Stats/compare/v0.8.0...v0.8.3
 [0.8.0]: https://github.com/LeafKnife/Stats/compare/v0.7.1...v0.8.0
 [0.7.1]: https://github.com/LeafKnife/Stats/compare/v0.7.0...v0.7.1
 [0.7.0]: https://github.com/LeafKnife/Stats/compare/v0.6.0...v0.7.0

README.md

@@ -48,6 +48,26 @@ const getStats = ll.import("LK-Stats", "getPlayerStats");
 const stats = getStats(uuid, 1);
 ```
 
+### Paginated RemoteCall API
+
+The existing `getPlayerStats` and `getRankStats` exports remain available. For large datasets, use the paginated exports below. Both return a JSON string; `page` starts at `1`, and `pageSize` is limited to `1`-`100` (values less than `1` use `20`). Ranking results may be cached for up to 30 seconds.
+
+```javascript
+const getPlayerStatsPage = ll.import("LK-Stats", "getPlayerStatsPage");
+const statsPage = JSON.parse(getPlayerStatsPage(uuid, 1, 1, 20));
+
+// { page, pageSize, total, totalPages, items: [{ key, value }] }
+logger.info(JSON.stringify(statsPage));
+```
+
+```javascript
+const getRankStatsPage = ll.import("LK-Stats", "getRankStatsPage");
+const rankPage = JSON.parse(getRankStatsPage(1, "minecraft:play_time", 1, 20));
+
+// { page, pageSize, total, totalPages, items: [{ player, value }] }
+logger.info(JSON.stringify(rankPage));
+```
+
 获取排行榜信息
 
 - 参数：
@@ -79,6 +99,34 @@ const rank3 = getRankData(2,""); // 挖掘排行榜
 | ENTITY_KILLED    | 与玩家杀死的实体数量相关的统计信息         | minecraft:killed    |
 | ENTITY_KILLED_BY | 与玩家被实体杀死相关的统计信息             | minecraft:killed_by |
 
+### 语言文件对象键
+
+统计数据和 RemoteCall API 中的对象键仍为原始命名空间 ID，例如 `minecraft:arrow`。语言文件会按用途及来源嵌套：界面为 `gui`，命令为 `command`，日志为 `log`；统计分类标题为 `stats.category`，通用统计项为 `stats.custom`。方块和物品有时使用相同的 ID，有时不同，因此按来源分为 `block`、`item`、`entity` 三组，避免同一 ID 时互相覆盖：
+
+```json
+{
+    "stats": {
+        "category": {
+            "used": "物品使用"
+        },
+        "custom": {
+            "minecraft:jump": "跳跃次数"
+        }
+    },
+    "block": {
+        "minecraft:stone": "石头"
+    },
+    "item": {
+        "minecraft:arrow": "箭"
+    },
+    "entity": {
+        "minecraft:arrow": "射出的箭"
+    }
+}
+```
+
+加载时会将嵌套对象展开为内部翻译键。统计存档和 RemoteCall API 的字段不变：`mined` 使用 `block`，`broken` 使用 `item`，`killed` 与 `killed_by` 使用 `entity`；`crafted`、`used`、`picked_up`、`dropped` 会依次查询 `item` 与 `block`；通用统计使用 `stats.custom`。为兼容旧语言文件，未找到新键时仍会回退到原本的裸 `minecraft:<id>` 键。
+
 ### 统计信息列表
 
 | 统计名称           | 描述                                               | 命名空间                                  |