tarkov-data-patterns

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Tarkov Data Query Patterns

《逃离塔科夫》数据查询模式

CRITICAL: No Speculation or Editorializing

重要提示：禁止猜测或主观评论

NEVER speculate, guess, infer, or make value judgments about game items/mechanics.

Forbidden patterns:

❌ "The two halves can likely be combined..."
❌ "This item is probably used for..."
❌ "These appear to be joke/troll items"
❌ "This is a way to throw away money"
❌ "Verdict: [any editorial conclusion]"
❌ Any value judgment about items being "useless", "worthless", "bad", etc.

Required patterns:

✅ Only state facts directly from the API response
✅ If data is missing: "The API doesn't show uses for this item. Data may be incomplete."
✅ If no crafts/tasks found: "No crafts or tasks found in the API data. Check in-game or wiki for current uses."
✅ Acknowledge data limitations: "This information may not reflect recent game updates."

Remember: Missing data ≠ feature doesn't exist. The API may be incomplete.

绝对不要对游戏物品/机制进行猜测、推断或价值判断。

禁止使用的表述模式：

❌ "这两个部件可能可以组合..."
❌ "这个物品可能用于..."
❌ "这些似乎是恶搞物品"
❌ "这是一种浪费钱的方式"
❌ "结论：[任何主观结论]"
❌ 任何将物品判定为“无用”“不值钱”“差劲”等的价值判断

要求遵循的表述模式：

✅ 仅陈述API响应中的直接事实
✅ 若数据缺失：“API未显示该物品的用途。数据可能不完整。”
✅ 若未找到制作/任务信息：“API数据中未找到相关制作或任务信息。请在游戏内或维基中查看当前用途。”
✅ 需说明数据局限性：“此信息可能未反映游戏的最新更新。”

注意：数据缺失 ≠ 功能不存在。API可能存在不完整的情况。

Data Sources

数据来源

Source	Best For	Tools
tarkov.dev	Stats, numbers, structured data	search_items, get_item, get_tasks, get_boss, get_ammo
eft-wiki	Lore, tactics, guides, narrative	search_wiki, get_wiki_page, get_wiki_section

来源	适用场景	工具
tarkov.dev	统计数据、数值、结构化数据	search_items, get_item, get_tasks, get_boss, get_ammo
eft-wiki	背景设定、战术、指南、叙事内容	search_wiki, get_wiki_page, get_wiki_section

Response Modes

响应模式

All tools accept

mode

parameter:

concise (default): Paginated, essential fields, bounded output
full: All data, all fields, complete details

Use

concise

for:

Discord bots, public interfaces
Initial searches before drilling down
Lists and overviews

Use

full

for:

Development and research
Single-item deep dives
When user explicitly wants everything

所有工具均支持

mode

参数：

concise（默认）：分页展示、仅含必要字段、输出内容有限
full：完整数据、所有字段、细节全面

使用

concise

模式的场景：

Discord机器人、公共交互界面
深入查询前的初步搜索
列表和概览

使用

full

模式的场景：

开发与研究
单个物品的深度探究
用户明确要求获取全部信息时

Common Patterns

常见查询模式

Finding Items

查找物品

search_items(query="bitcoin")           # Find by name
get_item(id="physical-bitcoin")         # Get full details
get_items_by_category(category="keys")  # Browse category

search_items(query="bitcoin")           # 按名称查找
get_item(id="physical-bitcoin")         # 获取完整详情
get_items_by_category(category="keys")  # 按类别浏览

Task Research

任务研究

get_tasks(trader="Prapor")              # All tasks from trader
get_tasks(map="Customs")                # Tasks on specific map
get_task(id="Delivery from the Past")   # Single task details

get_tasks(trader="Prapor")              # 获取该商人的所有任务
get_tasks(map="Customs")                # 获取指定地图的任务
get_task(id="Delivery from the Past")   # 获取单个任务详情

Ammo Comparison

弹药对比

get_ammo(caliber="7.62x39mm")           # All ammo for caliber

get_ammo(caliber="7.62x39mm")           # 获取该口径的所有弹药

Then compare penetration vs damage trade-offs

随后对比穿透与伤害的权衡

undefined

undefined

Boss Intel

Boss情报

get_boss(name="Killa")                  # Stats, health, gear
get_wiki_section("Killa", "Tactics")    # Fight strategies

get_boss(name="Killa")                  # 获取属性、生命值、装备信息
get_wiki_section("Killa", "Tactics")    # 获取战斗策略

Pagination

分页查询

get_items_by_category(category="weapon", limit=10, offset=0)   # First 10
get_items_by_category(category="weapon", limit=10, offset=10)  # Next 10

get_items_by_category(category="weapon", limit=10, offset=0)   # 前10条结果
get_items_by_category(category="weapon", limit=10, offset=10)  # 下10条结果

Data Relationships

数据关系

Items ←→ Tasks (required for / rewarded by)
Items ←→ Hideout (crafts, upgrades)
Items ←→ Barters (trade requirements)
Tasks ←→ Traders (quest givers)
Tasks ←→ Maps (where objectives are)
Bosses ←→ Maps (spawn locations)

物品 ←→ 任务（任务所需/任务奖励）
物品 ←→ 藏身处（制作、升级）
物品 ←→ 以物易物（交易要求）
任务 ←→ 商人（发布任务的NPC）
任务 ←→ 地图（任务目标所在地）
Boss ←→ 地图（刷新位置）

Query Optimization

查询优化

Start narrow: Use specific IDs/names before broad searches
Use filters: trader, map, caliber reduce result sets
Paginate early: Use limit/offset in concise mode
Cache results: Don't re-query same data in one session

精准起步：先使用具体ID/名称，再进行宽泛搜索
使用筛选器：商人、地图、口径等筛选条件可缩小结果范围
尽早分页：在concise模式下使用limit/offset参数
缓存结果：同一会话中不要重复查询相同数据

Error Handling

错误处理

Item not found → Try search_items with partial name
Boss not found → API returns list of valid boss names
Wiki section missing → Response includes available sections

物品未找到 → 尝试使用部分名称调用search_items
Boss未找到 → API会返回有效的Boss名称列表
维基章节缺失 → 响应中会包含可用的章节列表

Caliber Formats

口径格式

Common caliber strings for

get_ammo

```
5.45x39mm
```
,
```
5.56x45mm
```
,
```
7.62x39mm
```
,
```
7.62x51mm
```
```
9x19mm
```
,
```
9x18mm
```
,
```
9x21mm
```
```
12.7x55mm
```
,
```
.338 Lapua Magnum
```
,
```
.300 Blackout
```

get_ammo

常用的口径字符串：

```
5.45x39mm
```
,
```
5.56x45mm
```
,
```
7.62x39mm
```
,
```
7.62x51mm
```
```
9x19mm
```
,
```
9x18mm
```
,
```
9x21mm
```
```
12.7x55mm
```
,
```
.338 Lapua Magnum
```
,
```
.300 Blackout
```

Category Names

类别名称

Common categories for

get_items_by_category

Weapons:

assault-rifle

smg

pistol

shotgun

sniper-rifle

Gear:
```
armor
```
,
```
helmet
```
,
```
rig
```
,
```
backpack
```
Items:
```
keys
```
,
```
medical
```
,
```
provisions
```
,
```
barter
```

get_items_by_category

常用的类别名称：

武器：

assault-rifle

smg

pistol

shotgun

sniper-rifle

装备：
```
armor
```
,
```
helmet
```
,
```
rig
```
,
```
backpack
```
物品：
```
keys
```
,
```
medical
```
,
```
provisions
```
,
```
barter
```