HalfGridSnap

版本 v1.1.0·更新於 2026-02-28

Allows you to snap coordinates to half-grid points. 允許你進行對半格點的座標進行吸附。

模組介紹 作者原文

HalfGridSnap | English Description

允許將座標吸附到“半格點”。本插件通過 Harmony Transpiler 替換遊戲中 PlanetGrid 的硬編碼常量,從而改變網格吸附間距,實現半格點吸附效果。

主要功能

  • 將 PlanetGrid 中的硬編碼常量 5.0f 替換爲 10.0f,改變吸附間距以實現半格點行爲。
  • 在運行時通過按默認快捷鍵 ~ 切換半格點吸附(默認已啓用),快捷鍵可通過遊戲內自定義。

安裝

  • 直接拷貝輸出的 DLL 到 BepInEx/plugins 或者通過模組管理器導入 Output 目錄下的 zip 壓縮包進行安裝。

從源碼構建

  • 使用支持.NET Standard 2.1 的 SDK / Visual Studio(例如 Visual Studio 2026)。
  • 恢復 NuGet 包或手動引用 BepInEx 與 HarmonyLib 的程序集(項目中應已有引用)。
  • 編輯項目.csproj 裏面的 GameDir 爲你的實際遊戲目錄。
  • 在解決方案中選擇 Release/Debug,生成項目:
  • Visual Studio:打開解決方案 -> 右鍵項目 -> __生成__。

實現說明(開發者)

  • 關鍵實現位於 PlanetGridPatch.cs:
  • 使用 HarmonyTranspiler 遍歷 IL 指令,查找 ldc.r4 5.0,並將其替換爲 ldc.r4 10.0。
  • 這樣修改後,PlanetGrid 的吸附行爲會以新的常量進行計算,從而實現期望的吸附效果。

安裝與使用 安裝:BepInEx 外掛

  1. 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
  2. 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
  3. 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
  4. 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。

帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。

前置依賴

下面這些內容需要先安裝,否則該模組不會生效:

xiaoye97-BepInExCommonAPI-CommonAPI

檔案與校驗

檔案名稱
HalfGridSnap-1.1.0.zip
檔案大小
131.4 KiB