Dane statusu
Treść POST /api/v1/status, schemat vw.status/1. Wysyłaj tak często, jak mówi odpowiedź: co 2 s, gdy ktoś ogląda postać, w innym razie co 30 s. Pól, których nie znasz, nie wysyłaj; panel pokazuje to, co dostaje.
| Pole | Typ | Opis |
|---|---|---|
schema | "vw.status/1" | Payload schema and version |
modulewymagane | string | Name and version of the sending module, for example voidwatch-feed/0.5.2do 40 znaków |
onlinewymagane | boolean | The character is logged in |
characterwymagane | Character | |
character.namewymagane | string | Character namedo 30 znaków |
character.vocation | string | Vocation, for example Elite Knightdo 30 znaków |
character.levelwymagane | integer | ≥ 1, ≤ 5000 |
character.expwymagane | integer | Total experience points≥ 0 |
poswymagane | Position | |
pos.xwymagane | integer | Map x≥ 0, ≤ 65535 |
pos.ywymagane | integer | Map y≥ 0, ≤ 65535 |
pos.zwymagane | integer | Floor, 0 to 15; 7 is ground level≥ 0, ≤ 15 |
cap | integer | Free capacity, in oz≥ 0 |
stamina | integer | Stamina, in minutes≥ 0, ≤ 2520 |
expPerHour | integer | Exp per hour as the client measures it≥ 0 |
route | string | The loaded cavebot routedo 80 znaków |
routeOn | boolean | The cavebot is running |
label | string | The route label the bot is atdo 40 znaków |
phase | "hunting" | "to_city" | "in_city" | "to_resp" | "parked" | "stopped" | "unknown" | "town" | "at_check" | "leaving" | Where the character is in its route, from the labels hunt, refill, city and resp: unknown when a label is missing. town, at_check and leaving come from bot adapters before version 4 |
labelsMissing | string[] | Route parts without a label. check and leave come from bot adapters before version 4do 4 elementów |
plan | PlanState | The bot's plan: a command that acts when the bot reaches a label. An ended plan stays for two minutes |
plan.id | integer | The command that started the plan |
plan.kindwymagane | "refill" | "go_depot" | "load_route" | |
plan.route | string | The route a switch loadsdo 80 znaków |
plan.statewymagane | "running" | "done" | "stuck" | "cancelled" | "taken_over" | "failed" | |
plan.step | "hunt" | "city" | "depot" | "switch" | What the running plan waits for |
plan.message | string | do 200 znaków |
plan.since | integer | Unix seconds when the plan started |
plan.until | integer | Unix seconds when the waiting step gives up as stuck |
plan.ended | integer | Unix seconds when the plan ended |
routes | string[] | Every route the bot can loaddo 100 elementów |
supplies | SupplyItem[] | do 60 elementów |
supplies[].namewymagane | string | Item name, as the game writes itdo 60 znaków |
supplies[].havewymagane | integer | How many the character carries, closed bags included where the game said≥ 0 |
supplies[].want | integer | How many the bot keeps in stock; missing when the list comes from the use lines≥ 0 |
suppliesSource | string | bot: the bot's own supply list; used: every item the game's use lines nameddo 20 znaków |
tasks | TaskItem[] | do 10 elementów |
tasks[].namewymagane | string | Item or creature name, as the game writes itdo 60 znaków |
tasks[].havewymagane | integer | How many the character has now≥ 0 |
tasks[].wantwymagane | integer | How many the bot keeps in stock, or the task goal≥ 0 |
tasks[].exp | integer | Exp reward for the goal, if the server says≥ 0 |
tasks[].taskPoints | integer | Task points for the goal, if the server has them≥ 0 |
taskPoints | integer | The task points balance, on servers with task points≥ 0 |
taskWeek | TaskWeek | Task points this week, on servers with a weekly cap |
taskWeek.earnedwymagane | integer | Task points earned this week≥ 0 |
taskWeek.capwymagane | integer | The most task points a week allows≥ 0 |
loot | LootItem[] | do 200 elementów |
loot[].namewymagane | string | Item namedo 60 znaków |
loot[].countwymagane | integer | Looted since the session started≥ 0 |
loot[].sell | integer | NPC price per item, if the module knows it. The server fills it in otherwise≥ 0 |
used | UsedItem[] | Supplies used since the loot counter starteddo 200 elementów |
used[].namewymagane | string | Item namedo 60 znaków |
used[].countwymagane | integer | Used since the counter started≥ 0 |
used[].buy | integer | NPC buy price per item, if the module knows it≥ 0 |
lootHours | number | Hours since the loot counter started≥ 0 |
lootSource | string | Where the loot count comes from: corpse, the loot messages every server sends, or the id of an adapter such as an autolootdo 40 znaków |
skulls | Skull[] | Skulled players in viewdo 20 elementów |
skulls[].namewymagane | string | Player namedo 30 znaków |
skulls[].skullwymagane | "white" | "red" | "black" | "yellow" | "green" | "orange" | Skull colour |
skulls[].dist | integer | Squares away from the character≥ 0, ≤ 100 |
blessed | boolean | Only on servers with blessings |
pz | boolean | The character stands in a protection zone |
pzLock | boolean | The character is PZ locked: it cannot enter a protection zone |
outfit | Outfit | The character's look, drawn on the map |
outfit.typewymagane | integer | The look type≥ 0, ≤ 10000 |
outfit.head | integer | ≥ 0, ≤ 255 |
outfit.body | integer | ≥ 0, ≤ 255 |
outfit.legs | integer | ≥ 0, ≤ 255 |
outfit.feet | integer | ≥ 0, ≤ 255 |
outfit.addons | integer | ≥ 0, ≤ 3 |
skull | "white" | "red" | "black" | "yellow" | "green" | "orange" | The character's own skull, if it has one |
playersInView | integer | Other players in view≥ 0, ≤ 500 |
redemption | boolean | Only on servers with death redemption: it is active now |
redemptionLeft | integer | Only on servers with redemption≥ 0 |
targetOn | boolean | The targeting bot is running |
botConfig | string | The bot preset, for example vBot_4.8do 60 znaków |
targetProfile | string | The loaded targeting profiledo 80 znaków |
botProfile | integer | The bot settings profile, for example vBot's 1 to 5≥ 1, ≤ 20 |
adapters | AdapterState[] | The adapters the module runs, and whether each is ondo 30 elementów |
adapters[].idwymagane | string | Adapter id, for example orion-ots-tasks or botdo 40 znaków |
adapters[].version | string | do 20 znaków |
adapters[].onwymagane | boolean | False: the adapter stopped after errors, or the bot stopped attaching |
adapters[].want | string | For the bot adapter: the version the module ships. A lower version waits for a bot reloaddo 20 znaków |
addons | AddonState[] | The addons in the data folder, and whether each runsdo 30 elementów |
addons[].idwymagane | string | Addon id, for example exiva-map |
addons[].version | string | The module version the addon came withdo 20 znaków |
addons[].onwymagane | boolean | Loaded now |
addons[].error | string | Why it is not loaded: installing, the download failed, or its last errordo 200 znaków |
features | string[] | What the module runs, for example status, captures and commands. The dashboard turns off what is not listed. Left out: everythingdo 20 elementów |
actions | string[] | The command actions this client can run now, for example toggle_cavebot. The dashboard offers only thesedo 40 elementów |
settingsChange | object | A change from the Settings tab of the Voidwatch window: {rev, values}. The values follow the rules of the Clients page. A bad value never refuses the status: settingsSaved in the reply says why |
Przykład
{
"schema": "vw.status/1",
"module": "voidwatch-feed/0.5.2",
"online": true,
"character": {
"name": "Franz Kafka",
"vocation": "Royal Paladin",
"level": 589,
"exp": 3380000000
},
"pos": {
"x": 32376,
"y": 31779,
"z": 7
},
"cap": 8568,
"stamina": 2502,
"expPerHour": 14998739,
"route": "[afk] fu.exodar HH",
"routeOn": true,
"label": "hunt",
"routes": [
"[afk] fu.exodar HH",
"UD & HH Left"
],
"supplies": [
{
"name": "great spirit potion",
"have": 3498,
"want": 4000
}
],
"tasks": [
{
"name": "hellhound",
"have": 578,
"want": 1000
}
],
"loot": [
{
"name": "fire sword",
"count": 192
}
],
"lootHours": 2.4,
"skulls": []
}Wersje
Nazwa schematu niesie wersję. Nowe pole zachowuje wersję; zmienione lub usunięte pole dostaje nową, a stara działa jeszcze co najmniej pół roku.