ValheimMassFarm

ValheimMassFarm

給耕耘機（Cultivator）加一個「3x3 密植」模式：一次點擊種下 3x3 的九株作物，株距取遊戲允許的最大密度。再用,（逗號） 打開「自動吸附」，下一塊 3x3 就會自動貼合上一塊，按最大密度無縫拼成大片農田。

只改變"一次種幾株""種在哪"，不改任何配方、產量、生長速度或生長規則。

功能

• 3x3 密植：手持耕耘機、選中任意作物（樹苗/種子）後按 V 切換開關（默認關）。開啓後，準星處會顯示一塊 3x3 綠色網格預覽，點擊一次即種下整塊 3x3。
• 最大密度：株距 = 2 × 該作物的生長半徑（遊戲判定"空間不足"時的臨界距離），即不互相擠壓前提下的最密間距。
• 自動吸附：按,（逗號）切換。開啓後，下一塊 3x3 會自動吸附到已種下的密植格點上，沿 3x3 的邊長整數倍平移，與上一塊嚴絲合縫地拼接。連續點擊即可不斷向外鋪田。
• 網格預覽：密植模式下用線框顯示即將種下的 3x3 範圍，方便對準。
• 關閉密植模式時完全是原版行爲。

操作

| 按鍵 | 作用 |

| --- | --- |

| V | 開/關「3x3 密植」模式（默認關） |

|,（逗號） | 開/關「自動吸附」（默認關） |

| 左鍵 | 在密植模式下種下一整塊 3x3 |

用法示例：

• 裝備耕耘機，選好要種的作物。
• 按 V 打開密植模式，對準一塊已耕耘的土地，左鍵 → 種下第一塊 3x3。
• 按, 打開自動吸附，把準星移到相鄰位置，左鍵 → 第二塊自動貼合第一塊。
• 反覆移動 + 左鍵，即可無縫鋪滿整片田。

安裝

方式一：r2modman Mod Manager（推薦）

• 已在 上架：在 mod 管理器裏搜索 ValheimMassFarm 安裝即可（會自動帶入 BepInEx 依賴）。
• 本地包導入：下載本倉庫 dist/ 下的 SuperVikingDepartment-ValheimMassFarm-1.0.0.zip，在 r2modman 中

Settings → Import local mod（或 Install from file）選擇該 zip。

• 手動放入 profile：把 ValheimMassFarm.dll 放到

%APPDATA%\r2modmanPlus-local\Valheim\profiles\\BepInEx\plugins\ 下（可放在任意子文件夾）。

注意：用 r2modman 啓動遊戲時，生效的是 profile 目錄，而不是遊戲安裝根目錄下的 BepInEx。

方式二：手動安裝（直接啓動遊戲）

• 先安裝 BepInExPack for Valheim（denikson-BepInExPack_Valheim）。
• 把 ValheimMassFarm.dll 放入遊戲根目錄的 BepInEx/plugins/。
• 啓動遊戲。

配置

首次啓動後生成 BepInEx/config/SuperVikingDepartment.ValheimMassFarm.cfg：

| 配置項 | 默認值 | 說明 |

| --- | --- | --- |

| ToggleKey | V | 開關「3x3 密植」模式的按鍵。 |

| SnapKey | Comma | 開關「自動吸附」的按鍵。 |

| SpacingMultiplier | 1 | 間距係數。間距 = 2 × 生長半徑 × 係數。默認 1.0 即最大密度；若個別作物出現「空間不足」可略微調大（如 1.05）。 |

| DebugLogging | false | 開啓後在日誌輸出補丁細節，用於排查。 |

按鍵填 KeyCode 名稱（V、Comma、Period、B、LeftAlt 等）。改完需重啓遊戲。

會不會影響成就

不會。本 mod 不設置 Game.isModded、不觸碰人物的 m_usedCheats、不給物品打作弊標記。放置完全走遊戲自身的 PlacePiece 管線（含正常扣資源、扣體力、扣耐久、技能成長），因此不會禁用成就。若你同時使用控制台作弊命令或其他主動標記 mod 的插件，則屬於那些功能自身的影響。

兼容性

• 遊戲版本：Unity 6 時期的 Valheim（使用新版 Input System）。
• 依賴：BepInEx 5.x + HarmonyX。
• 與「一鍵裝滿」類 mod（如 ValheimQuickFill）互不衝突。
• 與 FarmGrid 等對齊類 mod 功能重疊：兩者都改 Player.UpdatePlacementGhost 相關流程，建議只啓用其一。

工作原理（簡述）

• 中心那一株仍由原版 Player.TryPlacePiece 放置，因此校驗、扣費、網絡同步全部沿用原版。
• 補丁只在原版放置成功之後，補上週圍 8 株，並逐株按原版規則校驗地塊（耕地/生物羣系/領地/建造禁區）、扣資源與體力、扣耐久、加技能。
• 每株間距取 2 × Plant.m_growRadius，與遊戲 Plant.HaveGrowSpace 的判定一致，故爲最大密度。

從源碼構建

• 安裝.NET SDK（目標 netstandard2.1）與 Node.js（打包腳本用）。
• 把本倉庫克隆到 Valheim 安裝目錄下（默認假定.. 就是遊戲根目錄）。
• 遊戲根目錄需已安裝 BepInEx（BepInEx/core/BepInEx.dll、BepInEx/core/0Harmony.dll）。
• 構建並生成發佈包：./build-package.sh 你的ThunderstoreTeam名

產物：dist/你的Team名-ValheimMassFarm-版本號.zip

倉庫不在遊戲目錄下時，用屬性覆蓋路徑：

dotnet build -c Release -p:ValheimDir="C:\Steam\steamapps\common\Valheim\"

上傳到

• 運行./build-package.sh SuperVikingDepartment 生成 dist/SuperVikingDepartment-ValheimMassFarm-1.0.0.zip。
• 打開，登錄後選擇該 zip 上傳。
• 若使用 r2modman 的團隊賬號，也可在其「Publish」流程中選擇該 zip。

zip 內容（ 要求）：

manifest.json 包元數據

README.md 商店頁正文

CHANGELOG.md 更新日誌

icon.png 256x256 圖標

LICENSE 許可證

plugins/ValheimMassFarm.dll ← 會自動路由到 BepInEx/plugins/

倉庫結構：

MassFarmPlugin.cs 插件源碼

ValheimMassFarm.csproj 項目文件

manifest.json 元數據

README.md / CHANGELOG.md / LICENSE

icon.png 圖標（256x256）

build-package.sh 一鍵構建 + 打包

tools/zip.js 無依賴 ZIP 打包器（保證 zip 內爲正斜槓路徑）

tools/make-icon.js 重新生成 icon.png

已知問題 / 說明

• 修改按鍵或開關插件後需要重啓遊戲，無法熱插拔。
• 用 r2modman 啓動時，插件與配置都在 profile 目錄下，遊戲安裝根目錄的 BepInEx 不參與加載。
• 自動吸附的格點方向取自第一塊 3x3 的朝向（滾動滾輪可旋轉該朝向）。
• Steam 的"驗證遊戲文件完整性"可能刪除根目錄的 winhttp.dll，導致 mod 失效；此時重裝 BepInEx 即可。
• 若按鍵無效，把 BepInEx/LogOutput.log 發到問題區。加載成功會有 ValheimMassFarm loaded 一行。

來源與許可

MIT License，詳見倉庫內 LICENSE。歡迎提 issue / PR。