preset 写入预设标点 - Natsukage/PostNamazu GitHub Wiki

使用 preset 指令,可以通过邮差将指定的标点预设写入游戏中的 30 个预设槽位。

写入预设功能兼容 PaisleyParkR 的标点格式,与 本地标点 不同的是,写入预设功能需要副本 ID。

使用此功能需要格外注意!如果载入的 MAPID 不合法(例如将国际服新副本的标点导入了国服的预设)可能会导致打开标点界面时游戏崩溃!

只要端口号正确对应,无需修改即可继续使用 PaisleyParkR 的标点指令。

[!TIP]

消歧义:

本页面中提及的 MapID 实际上是副本 ContentFinderCondition ID,而非地图 Map 或区域 Territory ID。

鉴于 PaisleyPark 使用了 MapID 这个名称,在此沿用以保证 JSON 兼容性。

可以在 XIVAPI、Godbert(解包工具)、国服文本检索(搜索 filename:ContentFinderCondition + 副本名)等工具查询此 ID。

执行指令

  • OverlayPlugin 回调指令:

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

  • Triggernometry 具名回调指令:

    回调名称:presetDoInsertPreset

    回调参数:标点指令内容

  • HTTP 请求调用路径:

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

  • 标点指令内容为 PaisleyPark 所使用的标点 Json 字符串,例如:

    {
      "Name": "Slot5",
      "MapID": 676,
      "A": {
        "X": -171,
        "Y": 0,
        "Z": 465,
        "Active": true
      },
      "C": {
        "X": -171,
        "Y": 0,
        "Z": 471,
        "Active": true
      }
    }
    

    上面的预设示例会在 71 级水滩村副本出发点附近标记 A C 两个点,可以使用亲信战友或解限进入副本简单测试。

指定预设槽位

若指定标点信息中的 Name 属性为 Slot1-Slot30(忽略大小写),可以将标点预设加载到对应的槽位。

若未提供槽位,或提供的数值超出 1-30 的范围,或提供了无法识别格式的字符串时,默认加载到 Slot1

指定副本 ID

若未传递或传递了超出范围(1-2000)的 MapID,将会默认用当前副本 ID 作为预设写入的副本 ID。

当前地图不属于副本时会报错,不会进行写入操作。(例如在主城中时)

需要注意的是,游戏内的加载预设标点功能对副本 ID 敏感,副本 ID 不对应时将无法进行预设标点。

标点指令

通过 command 文本指令 功能执行 /waymark preset 指令,可以直接加载对应标点预设。需要注意的是此指令为游戏自带指令,不会突破游戏内的限制,在战斗中、副本 ID 不符、副本不支持预设标点(即便可以使用插件写入预设)等无法加载预设的情况下,此指令不会生效。

例如,在副本中执行/waymark preset 2,将会加载存储于第二个槽位的标点预设。