Item Navigation & Realtime Detection · Features · ok-end-field

Overview

This document covers two trigger/debug tasks:

ItemNavigatorTask (UI name: Item Navigation): points to the nearest gathering point of the selected item and supports pressing a key to mark it as collected. Existing configurations use the master-compatible local WS / official map client path by default; shared world.pose is used only when Unified Localization is selected.
RealtimeDetectTask (UI name: Realtime Detection): runs YOLO detection in a loop for observing model, target-class, and confidence performance online.

Prerequisites

Legacy Compatible starts this task's own official-map client or local WS server; legacy content / 地图账号 values are migrated to the global Nav Config first.
Unified Localization recommends saving the official-map sync content on the account configuration page and selecting its 真值地图账号 in the global Nav Config, or filling in 真值content there directly. Without official truth, the Tampermonkey relay uses the local ws://127.0.0.1:3001.
Unified Localization starts the application-level position service on demand when coordinates are first read; Legacy Compatible does not touch it.
Item point data comes from assets/items/map/summary.json and assets/items/map/item_names.json.
Mark results are written to configs/marked_points.json, used to avoid re-pointing to already-marked points.

Configuration items

Config item	Default	Description
`定位实现` (Position implementation)	`旧版兼容`	`旧版兼容` keeps the original WS / official map client. `统一定位` uses the application-level position service and global Nav Config.
`选择物品` (Select item)	`[]`	List of item names to navigate; no target is filtered when empty.
`标记按键` (Mark key)	`f`	The key pressed to mark an item as "collected" when close to the target.
`标记按住时长` (Mark hold duration)	`2.0`	Seconds the mark key must be held. Timing starts only within a horizontal distance of 20 of the target; reaching the duration marks it as collected. `0`, negative, or non-numeric values fall back to the default 2 seconds.
`浮层信息` (Overlay info)	on	Shows the target item name, distance, bearing and height on the overlay. When off, the overlay keeps only the arrows.
`浮层文字透明度` (Overlay text opacity)	`92`	Text opacity, 0-100 (0 fully transparent, 100 fully opaque). Only shown while `浮层信息` is on.
`浮层背景透明度` (Overlay background opacity)	`59`	Opacity of the black text backdrop, 0-100 (`0` draws no backdrop). Only shown while `浮层信息` is on.
`浮层字号` (Overlay font size)	`26`	Font size in pixels relative to a 1080p window height; scales with the window height. Only shown while `浮层信息` is on.

Opacity and font size are re-read every cycle, so changes apply immediately without restarting the task. The three child options are hidden while 浮层信息 is off.

Obtaining content

content is the account credential for official map sync; you need to grab it once from your browser:

Open a browser and press F12 to open DevTools.
Visit https://game.skland.com/map/endfield and log in.
Switch to the Network tab and type https://web-api.skland.com/account/info/hg/check in the filter box.
Select that request in the filtered list and read data.content from the Response (a long string).
Paste it into 真值content in the global Nav Config; or save it on the account configuration page and select that account via 真值地图账号.

Pick either route: putting it directly in 真值content is handy for a one-off run, while saving it on the account page suits long-term multi-account use. content is equivalent to a login session — never paste it into issues, chat groups, or screenshots.

Local WebSocket (Tampermonkey)

When no content is configured, a browser userscript can relay position data to the application:

Install the Tampermonkey browser extension.
Click the task's Tampermonkey-script help button to open the official guide and locate the script. Import assets/scripts/endfield-ws-position-relay.user.js into Tampermonkey and enable it.
Visit https://game.skland.com/map/endfield, log in, and allow the script to run on that site.
Clear the task's content and its map-account selection so the task has no official-map credential.
Select the target items and start Item Navigation. The application listens on ws://127.0.0.1:3001; after connecting, the script relays position data from the web map.

If no position data arrives, check that the local firewall allows port 3001 and that Tampermonkey permits the script to run on the target site.

Data flow (Unified Localization)

flowchart TD
    A[Nav Config 真值content / 真值地图账号] --> D{Has official truth}
    B[Local WS port 3001] --> C[WorldPoseService sole producer]
    D -->|Yes| E[Official map WS]
    D -->|No| B
    E --> C
    C --> F[RuntimeStateHub: world.pose]
    F --> G[Item Navigation reads x/y/z/map_id]
    G --> H[Query assets/items/map data]
    H --> I[Draw direction arrow]
    I --> J[Hold mark key and write configs/marked_points.json]

Notes

Item Navigation depends on the current map ID and coordinate data; without point data it cannot produce a valid direction.
The task draws a direction arrow on the window; if you cannot see the arrow, first check whether the WebSocket position data is working.
For Unified Localization, "Local WS fallback" only happens when the global Nav Config has no content. If content is configured but the official auth or connection fails, the current run does not automatically switch to local WS; clear the global 真值content and 真值地图账号 to use local mode.
Marking requires holding the key for the duration set by 标记按住时长 (default 2 seconds) within a horizontal distance of 20; releasing the key early or leaving the range cancels the current timing. The value is re-read every cycle, so changes apply without restarting the task.
The Tampermonkey-script help button opens the official Item Navigation guide and the script directory.

Realtime Detection

Use cases

Realtime Detection is for debugging YOLO models, not a daily-automation flow. It continuously takes screenshots and runs object detection, useful for observing how a model and target class hit.

Configuration items

Config item	Default	Description
`YOLO模型` (YOLO model)	`yolo.default_model` in src/config.py	Model config key; the actual model and labels are maintained in src/yolo/models.py.
`检测目标` (Detect target)	The first label of the current model	The target class to observe.
`检测置信度` (Detect confidence)	`0.7`	Range `0` to `1`; the higher, the stricter.
`扫描间隔(秒)` (Scan interval (seconds))	`0.2`	The wait after each detection.

Notes

The target name must exist in the selected model's labels, otherwise the task errors out immediately.
This task loops; when stopped it outputs the total scan count, hit rounds, and highest confidence.