place 场地标点 - Natsukage/PostNamazu GitHub Wiki

执行指令

place 指令用于场地标点。

Triggernometry 具名回调指令：

回调名称: place // 或 DoWaymarks
回调参数：标点指令内容

OverlayPlugin (cactbot) 回调指令：

callOverlayHandler({
   call: 'PostNamazu', 
   c:    'place', 
   p:    '{标点指令内容}'
});

HTTP 请求调用路径：

http://127.0.0.1:{你设置的端口}/place

标点指令

鲶鱼精邮差可以接受一些关键字执行对应的操作，也可以接受一条代表标点数据的 JSON 字符串执行标点。

关键字模式

参数（关键字）	描述
`save` `backup`	储存当前的场地标点至缓存。
`load` `restore`	将此前 `save` 缓存的标点应用为本地标点。
`reset`	清除此前 `save` 缓存的场地标点。
`clear`	本地清除当前场上所有标点。
`public`	脱战状态下，将本地标点公开标记。

[展开查看示意图]

Tip

当你希望本地标点后恢复原本的标点时，可以使用 save - load 指令。
暂存的标点并不会保存到配置，在 ACT 重启后即会失效。若当前无标点缓存，或已使用 reset 清除缓存，则 load 指令会被忽略。

JSON 模式

标点指令的格式兼容 PaisleyPark 所用的 JSON 字符串格式，且会忽视场地 ID 及地图名。

例如下方所示的例子代表以 (100, 100, 0) 为中心的场地八方标记：

{
  "A":     {"X": 100,   "Z": 85.86, "Y": 0, "Active": true},
  "B":     {"X": 114.14,"Z": 100,   "Y": 0, "Active": true},
  "C":     {"X": 100,   "Z": 114.14,"Y": 0, "Active": true},
  "D":     {"X": 85.86, "Z": 100,   "Y": 0, "Active": true},
  "One":   {"X": 110,   "Z": 90,    "Y": 0, "Active": true},
  "Two":   {"X": 110,   "Z": 110,   "Y": 0, "Active": true},
  "Three": {"X": 90,    "Z": 110,   "Y": 0, "Active": true},
  "Four":  {"X": 90,    "Z": 90,    "Y": 0, "Active": true}
  "Log": true, 
  "LocalOnly": true
}

标点参数：X Y Z

代表实际坐标。

Y、Z 为内存与网络日志中的真实顺序，定义与 ACT 中的日志及其他大多数 ACT 插件相反，即 Z 轴为水平轴、Y 轴为高度轴。
标点参数：Active

代表标记或取消标记。

默认为 false，不提供时代表默认值（取消标点）。
整体参数：A B C D One Two Three Four

代表每个点的参数。

已提供的标点会被标记或移除，未提供的标点会被忽略。如下列标点会标记 A、清除 C、并忽略其余六个标点。
```
{
  "A":   {"X": 100, "Z": 85.86,  "Y": 0, "Active": true},  
  "C":   {},   
}
```

Tip

由于 Active 默认值即为 false，上述 "C": {} 即代表取消标点，意为 "C": {"Active": false}。

整体参数：Log

可选参数，不提供时为默认值 true（记录日志）。

代表这条标点是否需要记录到鲶鱼精邮差的日志中，以免没有必要记录的标点数据产生垃圾日志。
整体参数：LocalOnly

可选参数，不提供时为默认值 true（本地标点），不会上传任何数据，其他人不可见。

给定 false（网络标点）时，标点全队可见，但每秒只能生效一次，且仅脱战状态下有效。

使用示例

Triggernometry:

Tip

通常，JSON 字符串由程序自动从预定义的数据结构转换生成，而非依靠手动输入。

如果你在 Triggernometry 中手动给定标点参数（并非在使用 C# 脚本），可以使用此工具简化输入：

高级标点工具箱 AdvWm

OverlayPlugin (cactbot):

callOverlayHandler({
   call: 'PostNamazu', 
   c:    'place', 
   p:    `{
     "A":     {"X": 100,   "Z": 85.86, "Y": 0, "Active": true},
     "B":     {"X": 114.14,"Z": 100,   "Y": 0, "Active": true},
     "C":     {"X": 100,   "Z": 114.14,"Y": 0, "Active": true},
     "D":     {"X": 85.86, "Z": 100,   "Y": 0, "Active": true},
     "One":   {"X": 110,   "Z": 90,    "Y": 0, "Active": true},
     "Two":   {"X": 110,   "Z": 110,   "Y": 0, "Active": true},
     "Three": {"X": 90,    "Z": 110,   "Y": 0, "Active": true},
     "Four":  {"X": 90,    "Z": 90,    "Y": 0, "Active": true}
   }`
});

Tip

JSON 格式中的换行和缩进只是为了美观，便于展示。

导入/导出场地标点

鲶鱼精邮差的主界面可以导入 JSON 字符串为场地标点，或导出当前的场地标点为 JSON 字符串：

你现在可以使用鲶鱼精邮差，完全替代 PaisleyPark 的场地标点功能。