英灵神殿 1.0.15：在管理员批准的区域平整地形，并带有基于API的兼容性检查。需要服务器和工具客户端。并非通用反作弊。

完美扁平化 2.0.1

英灵神殿 1.0.15。BepInExPack_Valheim 5.4.2350。无需 Jötunn。

2.0.1 — 兼容性

波兰：模组不会阻止每个新的 Valheim 版本号，而是检查地形操作、权限控制、入口和设置字段的关键方法。兼容的 API 允许模组在新版本上运行，并在日志中给出警告。检测到不兼容时会在使用前阻止该工具；补丁安装失败会被回滚。已检查实际的 1.0.15 版库。原生平整操作仍会保存地形，且游戏针对编译器重复项的修复不会被覆盖。区域格式和权限保持不变。

将版本号阻止替换为针对关键地形、权限和输入 API 的启动检查。签名匹配时允许较新游戏版本运行并给出警告；检测到不匹配时在使用前禁用该工具，且失败的 Harmony 安装会被回滚。已针对真实的 1.0.15 程序集验证契约。使用游戏的地形保存路径并保留其重复编译器修复。现有区域文件和权限规则保持不变。

PL/EN：这并不保证每次更新后都能正常运行 / 这并不保证与每次更新兼容。API 行为、Unity 或 BepInEx 的更改可能需要新的 DLL / API 行为、Unity 或 BepInEx 的更改仍可能需要新的 DLL。未进行实机游玩测试 / 未进行实时游玩测试。

波兰语

平整地形仅限管理员批准的建造区域。必须安装模组 在服务器上和在使用该工具的人那里没有工具的玩家无需安装。

安装 / 更新

关闭游戏，停止服务器并备份世界。

• r2modman：禁用旧版 PerfectFlatten，在配置文件菜单中使用“导入本地模组”，并选择整个 ZIP 文件。如果出现表单：作者 Ezvay，名称 PerfectFlatten，版本 2.0.1。只保留一个已启用的版本。必须安装 BepInEx。
• 服务器：将 ZIP 中 plugins/PerfectFlatten.dll 文件上传到 BepInEx/plugins/PerfectFlatten/。如果之前的 DLL 副本在其他目录中，请删除或替换。
• 通过“Start modded”启动服务器和游戏。如果没有服务器部分，新版本将拒绝编辑。默认情况下区域列表为空：所有地方的均衡都被锁定。

管理员命令

站在计划区域的中心并打开F5控制台：

添加领地 DomKawula 40

创建一个半径为40米（直径80米）的圆形区域。名称不能包含空格/波兰语字符；可以使用字母、数字、_和-。半径5–200米，最多100个区域。权限由服务器根据adminlist.txt检查；管理员无需启用devcommands。

区域列表 区域移除 DomKawula

该列表对所有玩家可见；仅管理员可添加/删除。要更改区域，请删除后站在相应位置重新添加。默认情况下，所有人都可以在区域内使用工具。可选择将其限制为服务器日志中的一个平台标识符：

pf_zone_add DomKawula 40 Steam_此处填写完整号码

请输入真实的标识符，而不是上面的示例文本。区域所有权并不赋予添加或删除区域的权限。现有的守卫仍然可以阻止编辑。区域具有水平边界（X/Z），并非由高度限制的立体范围。

使用

F6 开启/关闭工具，Esc 关闭。滚轮 / Alt+滚轮 调整范围 2–50 米。Shift+滚轮 调整目标高度。Q 切换方形/圆形。左键平整地形。无需锄头。

玩家和整个轮廓必须位于同一个授权区域内。额外的1米边距涵盖地形网格的圆角。因此在边界处需要缩小尺寸或移动中心。面板显示轮廓的初步信息；最终权限检查由服务器执行。

服务器在准备地形前批准编辑，并在执行前再次批准。无响应、离开范围、打开菜单、失去地块所有权以及无法访问守护者都会导致拒绝或取消。等待期间选区会被冻结。适用游戏常规地形高度限制；在某些地方无法实现完全平整。

区域保存

服务器保存中：BepInEx/config/PerfectFlatten/world-<UID>.zones.json

将此文件夹包含在世界备份中，并在更新/迁移服务器时保留它。文件的旧版本会保存为 .bak。手动修改文件需要重启；通常请使用命令。文件损坏时会阻止编辑，而不是开放访问。

保护范围与验证

这是该工具中的访问控制，并非针对整个 Valheim 的服务器端反作弊系统。已批准的操作仍由客户端利用游戏的网络地形机制执行。旧的 PerfectFlatten 1.x、修改过的 DLL 或其他地形模组都可能绕过此工具。请从玩家配置文件中删除旧版本。要完全防止刻意修改过的客户端，需要在服务器端对地形更改进行额外校验。

针对1.0.15版本的编译以及区域边界测试均已通过。未进行游戏玩法或客户端-服务端连接测试。首次尝试请在世界副本上进行：区域外拒绝、区域内允许、跨越边界的轮廓拒绝、普通玩家添加区域被拒绝、区域删除及重启。多片段地形操作不是事务，没有自动回滚。

英语

在管理员批准的建筑区域内平整地形。需要服务器和每个工具使用者的客户端安装此模组。其他玩家无需该工具。支持 Valheim 1.0.15、BepInExPack 5.4.2350。无 Jötunn 依赖。

安装

关闭游戏，停止服务器并备份世界。在 r2modman 中将该 ZIP 作为本地模组导入（作者 Ezvay，名称 PerfectFlatten，版本 2.0.1）。禁用/移除旧副本。在服务器的 BepInEx/plugins/PerfectFlatten/ 下安装 plugins/PerfectFlatten.dll。只保留一份 DLL 副本。区域列表为空或缺少服务器组件即表示不进行编辑。

指令

站在 desired center 并使用 F5：

pf_zone_add MyHome 40 pf_zone_list pf_zone_remove MyHome

半径单位为米，范围 5–200，最多 100 个区域。名称仅可使用 ASCII 字母、数字、下划线或连字符，不得包含空格。服务器通过 adminlist.txt 检查添加/移除。所有玩家均可查看列表。无需开发者命令权限。可选的第四个参数可将区域限制为服务器日志中某个确切的平台身份。若不提供该参数，则所有玩家均可使用该区域。

控制 / 行为

F6切换，Esc退出。滚轮或Alt+滚轮调整大小（2–50米）；Shift+滚轮调整目标高度；Q切换方形/圆形；左键压平。无需锄头。

玩家和完整占地必须完全位于一个授权区域内。1米边距用于覆盖网格取整/接缝。选区访问权限和原生地形限制仍然适用。区域是水平X/Z范围，而非高度受限的体积。服务器会检查每次操作两次；客户端在等待期间锁定编辑参数。缺少批准/超时或访问权限变更都会取消操作。

持久化

将 BepInEx/config/PerfectFlatten/world-<UID>.zones.json 与世界备份一同保留。.bak 文件保存上一次的配置。命令立即生效；手动编辑文件需要重启服务器。无效的区域文件将安全关闭。

安全范围 / 验证

此选项控制的是本工具提供的功能，而非任意客户端造成的所有地形更改。经批准的编辑使用原版客户端的地形网络同步机制。旧版1.x副本、修改过的客户端或其他地形模组可以绕过本工具；请移除旧版本。它并非通用的服务器反作弊系统。

构建与几何测试已通过；实时Unity/客户端-服务器行为尚未测试。请先在世界副本上测试，包括拒绝非管理员命令、外部/边界编辑、允许的编辑、区域移除和重启。多格地形编辑不是原子操作，且没有自动撤销功能。