FTB Essentials 适用于 Valheim - 通过聊天使用 /home、/sethome、/back、/tpa、/tpaccept、/rtp 命令。无冷却，无预热。专为私服打造。

英灵神殿核心功能

一个受《我的世界》FTB Essentials模组启发的《英灵神殿》模组，通过游戏内聊天添加传送指令。专为与朋友一起玩的私人服务器打造——无预热计时、无冷却、无权限限制。

功能

• 命名住宅 — 保存、传送至并管理多个命名地点
• 返回 — 返回传送或死亡前的最后位置
• TPA — 请求传送到另一位在线玩家
• 实时传输协议 — 随机传送到世界任意一处安全的陆地位置

指令

命令	描述
/sethome <名称>	将你当前的位置保存为命名的家
/回家 <name>	传送到保存的家
/delhome <name>	删除已保存的家
/家园	列出你所有已保存的家园及数量
/back	回到你上一次的位置（传送或死亡前）
/tpa <player>	请求传送到其他玩家（支持部分名称匹配）
/tpaccept	接受传入的传送请求
/rtp	随机传送至安全地点

工作原理

聊天命令

所有命令都在游戏内的常规聊天框（不是控制台）中输入。以 / 会被拦截，绝不会作为聊天消息出现在其他玩家那里。普通聊天消息不受影响，正常通过。

家园系统

• 每位玩家最多可保存5个家园（可配置）
• 家园名称不区分大小写（基地 = 基地)
• 房屋按世界分别保存在以下文本文件中： BepInEx/config/ValheimEssentials/homes_<世界名>.txt
• 每位玩家的家园都存储在自己的电脑上，并通过其Steam ID进行识别。
• 家园在服务器重启后仍会保留

返回系统

• 每次传送前自动保存位置（主页, /tpa, /rtp)
• 死亡时也会保存位置—— 返回 带你前往死亡地点
• 显示情境感知消息：“已传送至死亡地点！”与“已传送至先前位置！”
• 连续两次 /back 指令将在两个位置之间切换

传送至玩家

• 玩家A输入 /tpa PlayerB → 玩家B在聊天中收到请求
• 玩家B输入 接受传送 → 玩家A传送到玩家B
• 请求将在60秒后自动过期（双方玩家都会收到通知）
• 部分名称匹配： /传送 Jo 找到“JoJo”（若为唯一匹配项）
• 多个匹配项会显示消歧提示
• 自我传送被阻止
• 每位玩家同时只能有一个待处理请求
• 通过ZRoutedRpc在P2P（主机）和专用服务器模式下均可运行

随机传送

• 传送至可配置半径内的一处随机安全陆地区域
• 使用 世界生成器 在未加载的区块中也能验证地形
• 避开海洋生物群系并定位在水面以下
• 寻找安全位置时显示“正在寻找安全位置……”
• 使用 远程传送 处理卸载区域平滑过渡的标志
• 默认范围：距离玩家位置1000-8000个方块

安装

需求

• BepInEx 5.x 已安装到您的英灵神殿文件夹中
• .NET Framework 4.6.2 SDK（用于从源代码构建）

自发布起

1. 下载 瓦尔海姆必备.dll 从 版本发布
2. 把它放在 Valheim/BepInEx/plugins/ValheimEssentials/
3. 开始游戏

从源代码构建

1. 克隆仓库
2. 更新 瓦尔海姆目录 在 瓦尔海姆基础模块.csproj 指向你的英灵神殿安装目录
3. 奔跑 dotnet 生成
4. DLL已自动复制到 BepInEx/plugins/ValheimEssentials/

重要： 服务器上的所有玩家都需要安装此模组，而不仅仅是主机。

配置

配置通过 BepInEx 配置文件管理，位于 BepInEx/配置/com.jojo.valheimessentials.cfg.

设置	默认	描述
通用/命令前缀	/	聊天命令前缀
RTP/最小范围	1000	距玩家的最小RTP距离
回报率／最大射程	8000	玩家最大RTP距离
冷却秒数	0	传送冷却时间（0 = 禁用）
冷却秒数	0	家园传送冷却时间（0 = 禁用）
家园/最大家园	5	每位玩家的最大住宅数
返回/冷却秒数	0	返回传送冷却（0 = 禁用）

技术细节

• 模组加载器： BepInEx 5.x
• 框架： .NET Framework 4.6.2
• 和谐补丁： 单前缀开启 聊天.输入文本 用于命令拦截
• 网络： 用于跨客户端TPA通信的ZRoutedRpc
• 持久化： 管道符分隔的平面文件，原子写入（临时文件加重命名）
• 玩家身份： Steam ID（玩家.获取玩家ID())— 对名称变更安全
• 语言： 所有游戏内消息均为葡萄牙语（巴西葡萄牙语）

项目结构

ValheimEssentials/ ├── Plugin.cs # BepInEx 入口点，配置 ├── CommandRouter.cs # 聊天拦截，命令分发，Harmony 补丁 ├── FeedbackHelper.cs # 巴西葡萄牙语聊天消息工具 ├── HomeManager.cs # 家园增删改查 + 文件持久化 ├── BackManager.cs # 位置追踪（传送与死亡） ├── TeleportHelper.cs # 传送封装（保存 /back 位置） ├── TpaManager.cs # TPA 请求状态管理 ├── RpcChannels.cs # TPA 的 ZRoutedRpc 网络通信 ├── RtpManager.cs # 随机安全位置查找器 └── ValheimEssentials.csproj

许可证

本项目按原样提供，仅供私人使用。欢迎随意修改并与朋友分享。