为Valheim服务器添加RCON协议支持的服务器插件。它包含一组最常用的命令。

瓦尔海姆远程控制

此插件为你的英灵神殿服务器添加了RCON协议支持。

• 介绍几个用于远程与服务器交互的命令
• 支持将命令执行结果发送到 Discord
• 提供一个可供第三方模组使用的可扩展RCON命令接口
• 高级安全功能：
  • 支持 CIDR 掩码的 IP 地址过滤（白名单/黑名单）
  • 将安全事件记录到 Discord（登录失败、未授权访问尝试、IP 过滤器拒绝）
  • 空密码保护（密码为空时插件禁用）
  • 自动断开未授权客户端

用途

1. 将插件安装到你的 Valheim 服务器
2. 启动服务器以生成配置文件
3. 在以下位置配置插件 BepInEx/配置/org.tristan.rcon.cfg:
   • 设置RCON端口（默认为服务器端口+2）
   • 更改RCON密码。密码留空将禁用该插件。
   • 配置 IP 过滤（可选）：
     • 白名单：允许的IP地址或CIDR掩码的逗号分隔列表（例如， 192.168.1.0/24, 10.0.0.1)
     • 黑名单：以逗号分隔的已屏蔽 IP 地址或 CIDR 掩码列表
     • 如果白名单为空，则允许所有IP（黑名单除外）
   • 配置 Discord Webhook，在 Discord 中查看命令结果（可选但推荐）
   • 可选设置 Discord webhook 名称（默认：RCON）。留空则使用 webhook 的默认名称和头像
   • 配置安全Discord webhook以接收安全事件报告（可选但推荐）
4. 重启服务器以应用更改
5. 使用RCON客户端（网页或桌面应用程序）连接到服务器
   • 例如，你可以使用这个网站 https://cmsminecraftshop.com/zh/console/选择《流放者柯南》（它的 RCON 数据包结构类似），然后输入你的服务器 IP、RCON 端口和密码
   • 或者使用像mcrcon这样的桌面RCON客户端 -> https://sourceforge.net/projects/mcrcon/
6. 连接后，你将能够在控制台中执行命令。

使用CIDR的IP地址过滤

该插件支持使用CIDR表示法进行IP地址过滤。使用CIDR掩码来允许或阻止整个IP范围：

• 单IP: 192.168.1.1 （相当于 192.168.1.1/32)
• 子网: 192.168.1.0/24 （允许来自 192.168.1.0 到 192.168.1.255 的 IP）
• 更大的网络: 10.0.0.0/8 （允许来自 10.0.0.0 到 10.255.255.255 的 IP）
• 多条记录: 192.168.1.0/24, 10.0.0.1, 172.16.0.0/16 （逗号分隔）

示例：

• 仅允许本地网络： 白名单IP掩码 = 192.168.1.0/24
• 屏蔽指定IP范围： 黑名单IP掩码 = 203.0.113.0/24
• 允许使用多个网络： 白名单 IP 掩码 = 192.168.1.0/24, 10.0.0.0/8

指令列表

查看所有可用命令：

列表

所有命令 - 详细描述并附带示例。

公告

• 玩家管理命令（踢出、封禁、治疗、伤害）应谨慎使用
• 对象删除命令不可逆
• 这 强制 进入 删除对象 绕过安全检查，并可能移除关键游戏对象（区域控制器、地下城等）。请极其谨慎使用！
• 非持久化对象（完全由玩家控制）无法删除或修改

如果命令执行结果过长，它会在RCON客户端中被截断，但如果你在插件设置中配置了webhook URL，完整结果将发送到Discord。例如，如果你执行findObjects命令，它可能会返回大量对象，而RCON客户端只会显示其中少数几个。但完整结果会发送到Discord。

示例

给予玩家 拉格纳 四级黑金属剑：

给予拉格纳·黑金剑 -品质4

生成4只3级驯服生物 野猪 在坐标 x:90 y:31 z:90 处：

生成野猪 90 31 90 -count 4 -level 3 -tamed

发送一条消息 大家好！ 发送到全球聊天：

大家好！

自定义命令

如果你是模组开发者，想为自己的服务器添加自定义RCON命令，请参阅 文档.

你也可以通过以下方式注册自定义ZDO信息提供者来扩展对象信息显示： 注册信息提供者().

联系人

如果你有任何问题 / bug反馈 / 改进建议，或发现与其他模组不兼容，欢迎在discord联系我 类型定义 或在GitHub上