
tehAon的玩家信标 - 让你的机器人看到车辆领地声明和商人
你的机器人只能读取玩家的位置和生命值,其他重要信息一概无法获取。Player Beacon 将服务器控制台无法看到的内容——该玩家是否在载具上、是否在领地声明范围内、是否在商人区域内——以纯 CVar 形式发布,你可以通过“cvar get”读取。仅限服务器端,仅 XML,只读。客户端无需安装任何东西。
查看大图[size=4][b]运行你服务器的机器人只能看到一半情况。[/b][/size]
通过 telnet 或 Web API,你可以读取玩家的位置、生命值、耐力、等级、击杀数、死亡数和延迟。这就是全部了。没有领地保护的控制台命令,Web API 的世界状态只包含动物、血月、敌对生物和玩家。
所以,在你的机器人对某人采取行动之前,那些真正重要的问题都没有答案:
[list]
[]他们现在是否[b]在载具上[/b],正以 60 公里/小时的速度行驶?[/]
[]他们是否站在[b]领地声明内[/b]——也就是他们自己的基地里?[/]
[]他们是否[b]在商人区域内[/b]?[/]
[/list]
[b]Player Beacon 每秒为每位玩家回答以上全部三个问题。[/b]
[line]
[size=4][b]如何读取[/b][/size]
[code]cvar get %pbGateOk -p <entityId>[/code]
实体 ID 来自 [font=Courier New]lp[/font]。每个值都是玩家身上的一个普通数字。
[b]六个动态标志存在两个名称。[/b][font=Courier New]%pbGateOk[/font] 和 [font=Courier New]$pbGateOk[/font] 含义相同,但 [b]%[/b] 副本到达服务器最多快 5.5 秒,所以优先使用它。[b]$[/b] 名称的计算方式与之前完全一致,对于任何已经在读取它们的程序都没有变化。计数器和两个服务器设置值没有 [b]%[/b] 对应版本。
[list]
[][b]%pbApi[/b] — 此 CVar 集合的契约版本,当前为 2。请先读取此项。[/]
[][b]%pbInVehicle[/b] — 附着在载具上时为 1。[/]
[][b]%pbInTrader[/b] — 在商人区域内时为 1。[/]
[][b]%pbInClaim[/b] — 在领地声明内时为 1(不含商人,因此两者不会重复计数)。[/]
[][b]%pbSafeZone[/b] — 游戏认为该地点受建造保护(领地声明或商人区域)时为 1。[/]
[][b]%pbGateOk[/b] — 三者全部清空时为 1。这就是那个单值答案。[/]
[][b]$pbSafeSecs[/b] — [i]连续[/i]避开全部三者已经过的秒数。[/]
[][b]$pbClaimsArmed[/b] — 如果此服务器实际评估领地声明,则为 1。[/]
[][b]$pbTraderProt[/b] — 商人保护的沙盒值:0、1 或 2。[/]
[/list]
缺失的 CVar 读作 0,所以 [font=Courier New]%pbApi == 0[/font] 和 [font=Courier New]$pbApi == 0[/font] 同时成立时,可靠地表示“此服务器没有安装该模组”,而不是“玩家身处开阔地带”。
[b]一个例外:[/b]玩家会先出现在 [font=Courier New]lp[/font] 中,然后他们的首个值才到达服务器,所以在玩家[i]首次[/i]加入时,[font=Courier New]$pbApi[/font] 可能会在几秒内读作 0。在之后的每次加入中它都是立即就绪的。把“刚刚连接”视为未知状态并稍后重读,而不是断定模组缺失。
[line]
[size=4][b]你大概想要的那个[/b][/size]
如果你要等到某人在开阔地带待了一段时间后才执行命令,[b]不要按你自己的时钟轮询并自行计时[/b]。一个在你的两次轮询之间溜进基地又出来的玩家对你来说是不可见的,而你仍然会开火。
此模组每秒 tick 一次,不可能漏掉这种情况。因此整个决策就变成一次比较:
[code]$pbSafeSecs >= 你希望他们保持清空的时长 + 6[/code]
计数器在[i]条件[/i]上重置,而不是基于自身的值——任何一次进入都会将其归零,无论是否有人在观察。[b]+ 6[/b] 是一个同步窗口,下一节解释了为什么你需要它。
[b]以此作为门槛,而不是以原因为门槛。[/b]三个原因标志由独立的检查在各自的时间点写入,所以当某人走入商人区域时,在下一次同步之前,它可能被读作领地声明。[font=Courier New]$pbGateOk[/font] 和 [font=Courier New]$pbSafeSecs[/font] 在整个过程中都是正确的——两种情况都会将它们保持为低值——所以只是你的“原因”消息措辞不准确,决策永远不会出错。
[line]
[size=4][b]为什么每样东西都有两个名称[/b][/size]
[b]$ 值每 5.5 秒到达服务器一次。% 值一变化就到达服务器。[/b]这就是 % 名称存在的全部原因,而且 5.5 是实测而非估算的——在 % 通道存在之前,一次实时抓包中的每次状态转换都精确落在 5.5 秒的网格上。
只有当实体是远程的,或者名称以 [b]%[/b] 开头时,游戏才会立即将 CVar 放到线路上。此模组的增益运行在玩家[i]自己[/i]的客户端上,写入该玩家[i]自己[/i]的 CVar,所以 [b]$[/b] 名称两者都不符合,只能等待每第 11 个半秒触发的周期性批量同步。11 x 0.5 = 5.5。而 [b]%[/b] 名称会跳过该队列,所以服务器大约在一个 ping 之后就看到了它。
读取 % 名称:
[list]
[][font=Courier New]cvar get %pbGateOk[/font] 是当前的,而不是最多 5.5 秒之前的[/]
[]一个 [font=Courier New]cvar track %pbGateOk[/font] 通知大约在玩家实际移动后一个 ping 到达[/]
[]剩下的唯一延迟是探测本身——它每秒 tick 一次,而领地和商人检测会多花一个 tick。预留一两秒,而不是十一秒。[/]
[/list]
[b]如果你仍然使用 $ 名称,请在任何间隔检查中加上一个同步窗口[/b]——[font=Courier New]$pbSafeSecs >= yourGap + 6[/font]。没有这个余量,一个三秒前走进基地的玩家仍然会被读作长时间清空,而这正是此模组存在所要防止的错误。使用 % 名称时你不需要这个余量。
[b]为什么 $pbSafeSecs 没有 % 对应版本。[/b]它是递增的,所以一个 % 副本会为每位在线玩家永远每秒在网络上放一个数据包,而这个数字只在标志变化时才有意义。有了 % 标志,你可以自己根据边沿计算间隔——而且使用 [font=Courier New]cvar track[/font] 时,你会被告知这些边沿,而不是轮询它们。
[line]
[size=4][b]或者不再询问,改为被告知[/b][/size]
你完全不必轮询。原版控制台可以为一名玩家在任何 CVar 上设置[b]变更通知[/b],而此模组发布的一切都是普通 CVar:
[code]cvar track %pbGateOk true -p 171[/code]
设置后会立即以当前值应答——[font=Courier New]Tracking CVar %pbGateOk with value 1.[/font]——此后,每当该玩家的 [font=Courier New]%pbGateOk[/font] [i]发生变化[/i]时,服务器就会记录
[code]CVar %pbGateOk was set to 0.[/code]
Telnet 是一个实时日志流,所以每个已连接的 telnet 客户端都会在服务器得知变更的那一刻收到该行——对于 [b]%[/b] 名称,大约在玩家移动后一个 ping。一条命令同时给你当前状态和之后的每次变更。用 [font=Courier New]false[/font] 代替 [font=Courier New]true[/font] 来取消设置。
[list]
[][b]它只在变化时触发。[/b]不会产生任何变化的写入在记录之前就被跳过,同步也只携带实际不同的值。一个在开阔地带站着不动的玩家完全不会产生任何行。[/]
[][b]一行不会指明玩家[/b]——但跟踪是针对一名玩家的实体设置的,所以对你关心的玩家设置跟踪,每一行就都属于该玩家。同时跟踪多名玩家会使这些行无法区分,所以一次只跟踪一人,或者对其余玩家继续轮询。[/]
[][b]每次加入时重新设置。[/b]被跟踪列表存在于实时玩家实体上,而不是存档中,所以重新登录后和重启后它都会消失。从你机器人的“玩家加入”处理程序中设置它。[/]
[][b]不要跟踪 $pbSafeSecs。[/b]它是一个计数器——当玩家处于清空状态时,它设计上每秒变化一次,所以跟踪它就像每秒一行的消防水管。跟踪这些标志,并在某个标志表明有事件发生时,用 [font=Courier New]cvar get[/font] 读取计数器。[/]
[/list]
[font=Courier New]cvar track[/font] 是原版控制台命令,在 [font=Courier New]help cvar[/font] 中与 [font=Courier New]get[/font] 和 [font=Courier New]set[/font] 并列列出。这里详细说明它,是因为它把这个模组从你主动询问的东西变成了主动告诉你的东西,而这通常正是一个机器人想要的。
[line]
[size=4][b]当它无法告诉你时,它会告诉你[/b][/size]
两个服务器设置会悄悄关闭这些检查。领地声明扫描在游戏模式 1 之外会被完全跳过,而商人那一半仅在商人保护保持为默认值时适用。无论哪种情况,一个赤裸的 0 都是有歧义的——它可能意味着“他们在开阔地带”,也可能意味着“此服务器不进行检查”。
[b]$pbClaimsArmed[/b] 和 [b]$pbTraderProt[/b] 让这种差异变得可见,所以你的机器人可以说[i]“此服务器未启用领地保护”[/i],而不是悄悄搞错。
而且 [b]$pbInTrader[/b] 是以几何方式测量的,所以无论商人保护被设为[i]什么[/i],它都保持正确。在一个关闭了商人保护的服务器上,你仍然可以选择在某人购物时暂缓生成。
[line]
[size=4][b]它不做任何决策[/b][/size]
此模组只负责报告。你的机器人来做决策。排队、冷却、退款、间隔应该多长、哪些命令才真正关心——所有这些都属于机器人,在那里它可以覆盖你发出的所有内容,而不是只覆盖一个模组的量。
[line]
[size=4][b]安装[/b][/size]
将 [font=Courier New]PlayerBeacon[/font] 文件夹放入你服务器的 [font=Courier New]Mods[/font] 文件夹并重启。[b]专用服务器。[/b]客户端无需安装任何东西——它涉及的两个文件都在连接时从服务器推送,所以没有玩家会版本过旧。
[size=4][b]兼容性[/b][/size]
在游戏 [b]V3.0.0[/b] 上构建并验证;相同的 XML 可在 [b]V3.1[/b] 上加载。它[b]仅追加[/b]——在玩家实体类上添加一个隐藏增益、一个游戏事件、一个效果组——并且不覆盖任何其他模组拥有的内容,所以它不会破坏现有存档,也不会与大型改版模组冲突。
[b]只读。[/b]没有物品、没有方块、没有配方、没有玩法,玩家看不到任何东西。
与 [url=https://www.nexusmods.com/7daystodie/mods/11846]tehAon's Status Buffs (Project Z)[/url] 一同编写,但它不依赖任何东西——不依赖 Project Z,也不依赖其他任何东西。
[line]
[size=5][b]Bug、帮助与更新[/b][/size]
遇到 Bug 或想获取更新消息?请在此处的 [b]Bugs[/b] 标签页发布,或加入 tehAon 模组 Discord——我所有 7 Days to Die 模组的中心:
[b][url=https://discord.gg/DYCzCPSvwa]discord.gg/DYCzCPSvwa[/url][/b]
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。