拉格纳维克_进度

创作者: LostKode

已更新:2026-09-16 14:46:27

53KB

下载

关于此 MOD

仅服务器端的首领和EpicMMO里程碑报告器，带有可配置的私有HTTP端点。

拉格纳维克进度

拉格纳维克进度是一个仅服务端运行的英灵神殿里程碑报告器。它会将经过验证的进度快照发送到HTTP端点，该端点可以通过Discord或其他服务发布社区消息。

功能

报告新击败的世界首领。
记录击杀玩家及附近参与者，以便日后击败首领。
报告已连接角色达到可配置的EpicMMO等级区间。
在报告中使用每个角色当前的游戏内名称。
仅使用私有稳定标识符来防止重复。
建立一个安静的基线，这样安装时就不会宣告旧进度。
默认禁用，无端点或凭据。
不报告普通生物击杀。

服务器管理员需要什么

此模组为游戏端报告器。它不捆绑或需要Ragnavik Discord机器人。服务器管理员必须提供一个HTTP接收器，其功能如下：

可从专用 Valheim 服务器访问。
接受经过身份验证的 JSON 帖子 在配置的终结点上的请求。
存储足够的状态，防止重启后重复播报。
将已接受的事件路由到 Discord、其他聊天服务、数据库或日志。
返回 HTTP 204 无内容 安全接受报告后。

接收器可以运行在Docker、系统服务、无服务器端点或现有社区机器人中。Docker并非必需。如果使用Discord，管理员需自行提供机器人应用或Webhook桥接，以及自己的频道ID。

配置

首次启动服务器后，请编辑 BepInEx/config/lostkode.ragnavik.progress.cfg 在服务器上。设置 已启用, 端点，以及可选地 令牌文件 和 令牌头部Boss公告和EpicMMO等级公告有独立开关。等级间隔和附近参与者范围可配置。

EpicMMO 默认的里程碑间隔为 10 级。EpicMMO 为可选安装，未安装时首领通报功能仍可正常使用。

设置	默认	用途
`已启用`	`假`	所有报告的总开关。
`击败首领报告`	`真`	启用首领击败快照与归属。
`报告史诗级大型多人在线游戏等级`	`真`	启用EpicMMO等级快照。
`史诗级大型多人在线等级阶段`	`10`	接收服务使用的关卡间隔。
`首领参与半径`	`100`	用于识别附近参与者的距离（米）。
`端点`	空白	私人接收端点。
`令牌文件`	空白	仅服务器使用的身份验证令牌文件。
`令牌头`	`进度令牌`	认证头名称。
`服务器名称`	`英灵神殿`	报告中包含服务器名称。
`检查秒数`	`30`	进度轮询间隔。
`心跳秒数`	`3600`	未改变状态的重新同步间隔。

端点负载

端点接收包含以下内容的JSON： 服务器, 实例, 首领, 首领击杀数, 玩家，以及 里程碑步骤每位玩家都有一个内部 ID，当前游戏内 名称，以及EpicMMO 关卡每次击杀首领包含事件ID、世界键、首领名称、击杀玩家及附近参与者名称。接受快照后返回HTTP 204。

示例请求正文：

服务器：Example Server，实例：dedicated-server-1，Boss：已击败_eikthyr，Boss击杀：[ { 编号：boss-event-id，键：defeated_eikthyr，Boss：Eikthyr，击杀者：Astrid，参与者：[Astrid, Bjorn] } ]，玩家：[ { 编号：private-character-id，名字：Astrid，等级：20 } ]，里程碑进度：10

当 令牌文件 包含一个令牌时，模组会将其内容发送到指定的头部中，该头部名为 令牌标头接收方应安全地比较该值，拒绝无效请求，验证正文大小和字段，并避免在公开消息中打印令牌或私有标识符。

报告为快照，心跳同步期间可能会重复发送。接收方负责仅通告新的首领事件ID、新增的首领密钥以及新突破的玩家等级阈值。角色ID用于私下重复追踪；请使用随附的游戏内 名称 在社区消息中。