feat: 新增饱和度显示、自定义迷雾、AutoText 快捷消息与 Windows SMTC 集成

.github/workflows/ci-release.yml

@@ -23,7 +23,39 @@ env:
   ARTIFACT_SOURCE_TYPE: external_url
 
 jobs:
+  # Windows SMTC bridge DLL. The binaries are not committed to the repository —
+  # they are built here and injected into src/main/resources before packaging,
+  # so the shipped jar can never contain a stale binary built from older C++.
+  build-native:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build fpsmaster-smtc (x64 + x86)
+        shell: pwsh
+        run: |
+          cmake -S native/smtc -B native/smtc/build-x64 -A x64
+          cmake --build native/smtc/build-x64 --config Release
+          cmake -S native/smtc -B native/smtc/build-win32 -A Win32
+          cmake --build native/smtc/build-win32 --config Release
+
+      - name: Collect DLLs
+        shell: pwsh
+        run: |
+          New-Item -ItemType Directory -Force -Path dist/x64, dist/x86 | Out-Null
+          Copy-Item native/smtc/build-x64/Release/fpsmaster-smtc.dll dist/x64/
+          Copy-Item native/smtc/build-win32/Release/fpsmaster-smtc.dll dist/x86/
+          Get-ChildItem -Recurse dist | Select-Object FullName, Length
+
+      - name: Upload native artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: smtc-native
+          path: dist
+          if-no-files-found: error
+
   build:
+    needs: build-native
     runs-on: ubuntu-latest
     outputs:
       should_publish: ${{ steps.decision.outputs.should_publish }}
@@ -133,6 +165,26 @@ jobs:
         if: steps.decision.outputs.should_build == 'true'
         uses: gradle/actions/setup-gradle@v3
 
+      - name: Inject SMTC native libraries
+        if: steps.decision.outputs.should_build == 'true'
+        uses: actions/download-artifact@v4
+        with:
+          name: smtc-native
+          path: src/main/resources/native/windows
+
+      - name: Verify native libraries are present
+        if: steps.decision.outputs.should_build == 'true'
+        shell: bash
+        run: |
+          for arch in x64 x86; do
+            dll="src/main/resources/native/windows/$arch/fpsmaster-smtc.dll"
+            if [ ! -s "$dll" ]; then
+              echo "Missing or empty $dll — the jar would silently ship without SMTC" >&2
+              exit 1
+            fi
+            echo "$arch: $(stat -c%s "$dll") bytes, sha256 $(sha256sum "$dll" | awk '{print $1}')"
+          done
+
       - name: Build with Gradle Wrapper
         if: steps.decision.outputs.should_build == 'true'
         shell: bash

.gitignore

@@ -21,3 +21,7 @@ remeasure.ps1
 /usercache.json
 /usernamecache.json
 /FPSMaster Edge/
+
+# SMTC 原生库由 CI 构建后注入（native/smtc/CMakeLists.txt），不提交二进制
+src/main/resources/native/windows/*/*.dll
+native/smtc/build-*/

build.gradle.kts

@@ -123,6 +123,10 @@ dependencies {
     shadowImpl("com.google.zxing:core:3.5.3") {
         isTransitive = false
     }
+    // Windows SMTC 桥接：JNA 加载原生 DLL 调用 WinRT。
+    shadowImpl("net.java.dev.jna:jna:5.17.0") {
+        isTransitive = true
+    }
     // If you don't want to log in with your real minecraft account, remove this line
     runtimeOnly("me.djtheredstoner:DevAuth-forge-legacy:1.1.2")
     compileOnly("org.projectlombok:lombok:1.18.38")

docs/tasks.md

@@ -31,12 +31,14 @@ FPSMaster v4将会在此列表任务大部分完成后发布
 - [ ] 全局搜索
 - [x] 新的OOBE
 - [ ] 功能完整的饰品界面
-- [ ] AutoText
-- [ ] 饱和度显示
+- [x] AutoText
+- [x] 饱和度显示
 - [ ] 账号管理界面
-- [ ] SMTC支持
+- [x] SMTC支持
 - [ ] 时间更改模块改为世界更改，添加天气选项（是否和WorldColor模块合并？）
 - [ ] 修复歌词渲染等特殊组件可能因glflags状态导致的渲染问题
+- [ ] 添加异步光照性能优化
+- [x] 添加自定义迷雾（颜色，距离等）
 - [ ] 按[性能优化路线图](performance-roadmap.md)推进区块、实体、光照、纹理和画质裁剪工作
 - [ ] 添加自定义迷雾（颜色，距离等）
 - [ ] 为客户端的组件颜色选择添加彩色选项

native/smtc/CMakeLists.txt

@@ -0,0 +1,43 @@
+cmake_minimum_required(VERSION 3.20)
+project(fpsmaster-smtc CXX)
+
+# Windows-only: the whole point of this target is the WinRT SMTC bridge.
+if(NOT WIN32)
+    message(FATAL_ERROR "fpsmaster-smtc is a Windows-only target")
+endif()
+
+# C++20, not 17: C++/WinRT's headers pull in coroutine support, and under /std:c++17
+# that resolves to <experimental/coroutine>, which current MSVC rejects outright
+# (STL1011). C++20 gives it the standard <coroutine> instead.
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+# Architecture is selected by the generator platform, e.g.
+#   cmake -B build-x64   -A x64
+#   cmake -B build-win32 -A Win32
+add_library(fpsmaster-smtc SHARED
+    smtc.cpp
+    smtc.def
+)
+
+set_target_properties(fpsmaster-smtc PROPERTIES
+    PREFIX ""
+    OUTPUT_NAME "fpsmaster-smtc"
+)
+
+target_compile_definitions(fpsmaster-smtc PRIVATE
+    UNICODE
+    _UNICODE
+    WIN32_LEAN_AND_MEAN
+    NOMINMAX
+)
+
+if(MSVC)
+    # /EHsc: C++/WinRT throws; /MT: static CRT so the DLL does not need the
+    # VC++ redistributable on the player's machine.
+    target_compile_options(fpsmaster-smtc PRIVATE /EHsc /W3)
+    set_property(TARGET fpsmaster-smtc PROPERTY MSVC_RUNTIME_LIBRARY "MultiThreaded")
+endif()
+
+# WindowsApp.lib provides the WinRT activation/interop entry points.
+target_link_libraries(fpsmaster-smtc PRIVATE WindowsApp)