Valheim世界编辑器（以及WorldEditorBridge）

[size=6][b]WorldEditorBridge[/b][/size]

[b]在游戏运行时编辑你的 Valheim 世界。[/b]WorldEditorBridge 将 [url=https://github.com/Shuiei/valheim-world-editor]Valheim World Editor[/url]（一款适用于 Windows 和 Linux 的 3D 世界编辑器）连接到你的游戏或专用服务器。塑造地形、建造、放置或移除任何东西，所有在线玩家都会立即看到它出现，就像一位速度极快的维京人手工完成的一样。

[img]https://raw.githubusercontent.com/Shuiei/valheim-world-editor/main/docs/images/overview.jpg[/img]

[quote][b]这个模组是桥梁，不是编辑器。[/b]从本页面的 [b]Files[/b] 标签页（Windows 或 Linux）或编辑器的 [b][url=https://github.com/Shuiei/valheim-world-editor/releases/latest]发布页面[/url][/b]获取编辑器：解压并启动即可，无需安装任何东西。请使用与你所用的此模组相同版本的编辑器。[/quote][size=5][b]人们的用途[/b][/size]

[list]
[][b]修复破坏行为。[/b]有人传送门枢纽旁边挖了个大坑或烧毁了一片森林？仅针对该区域，从备份中恢复地面和树木，而无需回滚整个世界。[/]
[][b]准备建筑工地。[/b]将山顶夷平、将斜坡修成梯田、铺整庭院，然后在游戏中建造。[/]
[][b]在基地之间修建道路。[/b]在地图上绘制路线：编辑器会将其平整并铺设路面，在爬坡处添加坡道。[/]
[][b]制造地标。[/b]升起一座超出游戏 ±8 米限制的山峰、火山或悬崖，开凿峡谷，或挖掘一个用巨石作顶的洞穴。玩家无需任何模组即可看到它们。[/]
[][b]制作地牢。[/b]根据风格和种子生成整个地牢（墓穴、堡垒、Dvergr 据点、哥布林巢穴……），里面布满生物和战利品，或为游戏自带的地牢（霜洞、墓穴、虫蚀矿坑……）添加房间并移除它们。由游戏来构建它们，玩家无需模组。[/]
[][b]导入建筑。[/b]在编辑器的 Workshop 中设计它（或使用 [url=https://thunderstore.io/c/valheim/p/sighsorry/Homestead/]Homestead[/url] 蓝图）并将其粘贴到世界中：挡路的小山会被挖开，那里的树木和岩石会被清除。[/]
[][b]让 Claude 来建造。[/b]让 Claude（Claude Code 或 Claude Desktop）根据提示在编辑器中工作：塑造地面、铺设道路、种植森林、建造房屋和地牢。你只需观看它发生，在你应用之前游戏内不会有任何变化。[/]
[][b]装饰大厅。[/b]填充箱子、书写告示牌、将武器和战利品挂在物品架上、摆放不会消失的食物来布置餐桌，以及装饰盔甲架。[/]
[][b]用正确的种子开始新世界。[/b]在种子世界存在之前就预览它：出生点、Boss 祭坛、商人和地牢，都精确地位于游戏将要放置它们的位置。让编辑器搜索在出生点附近拥有你想要的内容的种子，然后创建世界（一个正常的世界：游玩它不需要此模组）。[/]
[][b]整理。[/b]种植森林、清除田野上的岩石、移除区域内的每一棵树、找到存放你最后一块黑金属的箱子。[/]
[/list]你可以撤销每一项更改，即使在应用之后，而且下次打开世界时历史记录仍然存在。

[img]https://raw.githubusercontent.com/Shuiei/valheim-world-editor/main/docs/images/new-world.jpg[/img]

[size=5][b]工作原理[/b][/size]

[list=1]
[]模组在[b]托管[/b]世界的游戏（你的游戏或专用服务器）内运行并等待编辑器。它仅在该计算机上监听，并且只用其秘密令牌进行应答。[/]
[]编辑器从中加载世界并以 3D 形式显示，使用游戏自身的地形、纹理和模型。玩家保持连接，他们在你编辑区域内建造、移除或挖掘的内容会实时显示在编辑器中。[/]
[]你进行编辑。在你按下 [b]Apply live[/b]（或开启 [b]Auto[/b]）之前，任何内容都不会到达游戏。然后游戏会接收更改后的地面和对象，玩家会看到它们，游戏照常保存它们。[/]
[/list]专用服务器通过编辑器自行打开的加密 SSH 连接访问：模组永远不会暴露在互联网上，你无需进行其他设置。

[size=5][b]安装[/b][/size]

将其安装在[b]托管世界的地方[/b]，其他地方都不需要。

[i]你的游玩方式…… / 将模组安装到……[/i]
[list]
[][b]单人游戏，或你从游戏中托管的世界[/b]：你的游戏，像安装其他模组一样通过你的模组管理器安装[/]
[][b]在专用服务器上[/b]：服务器：模组管理器的服务器配置文件，或将 [font=Courier New]WorldEditorBridge.dll[/font] 复制到其 [font=Courier New]BepInEx/plugins[/font] 中[/]
[/list][b]加入的玩家不需要任何东西[/b]：无需模组，无需 BepInEx。主机和跨平台玩家照常加入并看到每一项更改。

然后[b]启动一次游戏或服务器[/b]并加载模组。首次启动会写入 [font=Courier New]BepInEx/config/Tie.WorldEditorBridge.cfg[/font]，其中包含一个随机 [b]Token[/b]，编辑器需要它。

[size=5][b]连接[/b][/size]

[list]
[][b]你自己的游戏：[/b]在编辑器中选择 [b]My game[/b] 并在 Valheim 中加载你的世界。编辑器会自动找到模组及其令牌（包括模组管理器配置文件）并显示 [b]Edit live[/b]。[/]
[][b]专用服务器：[/b]选择 [b]A dedicated server[/b]，输入服务器地址、你的 SSH 登录信息和服务器 [font=Courier New]Tie.WorldEditorBridge.cfg[/font] 中的令牌，然后点击 [b]Connect[/b]。服务器会被记住：下次只需一键。[/]
[/list]当模组运行时，BepInEx 日志会显示 [font=Courier New]WorldEditorBridge <version> listening on http://127.0.0.1:5182/[/font]。

[size=5][b]须知[/b][/size]

[list]
[][b]加载世界会使游戏暂停片刻。[/b]编辑器会一次性读取世界中的每个对象；在一个庞大、古老的世界中，这可能需要几秒钟。加载一次，然后想编辑多久就编辑多久。非常大的更改（一次性数千个对象）在应用时可能导致服务器卡顿。[/]
[][b]只能编辑主机。[/b]在加入了他人服务器的游戏中，模组拒绝更改任何内容。[/]
[][b]区域重置[/b]（从头重新生成一个区域）一旦应用便无法撤销。[/]
[][b]保管好令牌。[/b]有了它和端口访问权限，任何人都可以更改世界。在文件中留空以在下次启动时获取新令牌。[/]
[]编辑器的更改是普通的游戏对象和地面：其他模组和游戏会像对待玩家建造、种植或挖掘的任何东西一样对待它们。[/]
[/list][size=5][b]如果无法连接[/b][/size]

编辑器会说明出了什么问题：

[i]编辑器提示 / 应对措施[/i]
[list]
[][b]refused the login[/b]：检查 SSH 用户和密码或密钥文件。[/]
[][b]No answer[/b]：检查服务器地址，以及其上是否启用了 SSH。[/]
[][b]refused the token[/b]：再次从服务器的 [font=Courier New].cfg[/font] 文件复制 [font=Courier New]Token[/font] 行。[/]
[][b]does not answer[/b]：游戏或服务器未在 BepInEx 和此模组下运行（检查上面的日志行）。[/]
[][b]does not host the world[/b]：模组运行在加入了他人服务器的游戏中。请改为将其安装在服务器上。[/]
[][b]identity changed[/b]：服务器的 SSH 身份与之前看到的不同。如果你没有重装它，请不要连接。[/]
[/list][size=5][b]设置[/b][/size]

在 [font=Courier New]BepInEx/config/Tie.WorldEditorBridge.cfg[/font] 中：

[i]设置 / 默认值 / 含义[/i]
[list]
[][b][font=Courier New]BindAddress[/font][/b]（默认值：[font=Courier New]127.0.0.1[/font]；含义：仅此计算机可以连接。保持此设置：服务器通过编辑器的 SSH 隧道访问。）[/]
[][b][font=Courier New]Port[/font][/b]（默认值：[font=Courier New]5182[/font]；含义：如果其他程序使用了 5182，请更改它（编辑器会从文件读取，或询问）。）[/]
[][b][font=Courier New]Token[/font][/b]（默认值：随机；含义：编辑器发送的秘密。留空以在下次启动时获取新令牌。）[/]
[/list][size=5][b]更多[/b][/size]

[list]
[][url=https://github.com/Shuiei/valheim-world-editor]编辑器，包含每个工具的截图[/url][/]
[][url=https://github.com/Shuiei/valheim-world-editor/blob/main/docs/live-mode.md]实时编辑详解[/url][/]
[][url=https://github.com/Shuiei/valheim-world-editor/issues]报告问题或提出建议[/url][/]
[][url=https://github.com/Shuiei/valheim-world-editor/blob/main/CHANGELOG.md]每个版本的更改内容[/url][/]
[/list][size=5][b]许可证[/b][/size]

[url=https://github.com/Shuiei/valheim-world-editor/blob/main/LICENSE]MIT[/url]，© 2026 Shuiei。源代码位于 [url=https://github.com/Shuiei/valheim-world-editor]GitHub[/url]。与 Iron Gate 或 Coffee Stain 无关联，也未获其认可。

[size=5][b]从 Nexus 安装[/b][/size]

[list]
[][b]Vortex：[/b]点击 [i]Mod Manager Download[/i]。Vortex 会自行安装适用于 Valheim 的 BepInEx。[/]
[][b]手动安装：[/b]先安装 [url=https://thunderstore.io/c/valheim/p/denikson/BepInExPack_Valheim/]BepInExPack_Valheim[/url]，然后将此压缩包解压到 Valheim 或专用服务器文件夹（包含 valheim.exe 或 valheim_server.exe 的文件夹）。插件将放入 [font=Courier New]BepInEx/plugins/WorldEditorBridge/[/font]。[/]
[/list][size=5][b]支持[/b][/size]
编辑器和此模组是免费且开源的。如果它们为你节省了一些工作：

[url=https://buymeacoffee.com/tieboo][img]https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png[/img][/url]