> For the complete documentation index, see [llms.txt](https://hamsterbaron.gitbook.io/hamsterbaron/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hamsterbaron.gitbook.io/hamsterbaron/augment-guide/guidedweapon.md).

# 制导武器 / Guided

## 使用制导武器

本模组为 TacZ 的枪械添加了发射制导武器的能力。具有多种可选的制导方式和制导逻辑，以及在游戏性与拟真度间平衡取舍后提供的细致配置参数，使得轻松制作各类制导武器成为可能。此外，模组还基于镜内渲染功能提供了制作自定义目标跟踪指示图案的功能，提高发射器游玩时的表现力。

***

## 为弹药添加制导属性

Arcana 将导弹参数作为`bullet`属性的一部分，便于在枪械数据文件中直接编辑与控制。模组目前已提供三种制导模式，并配置了四种预设弹道，对于不同的制导模式和弹道类型有不同的可用参数。以下是枪械使用制导弹药时数据配置项的基本属性格式示例：

<pre class="language-json"><code class="lang-json">{
  "ammo": "ts:fgm148_shell",
  "ammo_amount": 1,
  // Other Configs..
  "bullet": {
    "life": 10,
    "bullet_amount": 1,
    // Other Configs..
<strong>    "extras": {
</strong><strong>      "missile": {
</strong><strong>        "is_missile": true,
</strong><strong>        "guidance_type": "active_radar",
</strong><strong>        // Other Configs..
</strong><strong>      }
</strong><strong>    },
</strong>  },
  "draw_time": 1.6,
  "put_away_time": 0.75,
  // Other Configs..
}
</code></pre>

不难看出，导弹相关的配置项<mark style="color:$warning;">是属于</mark><mark style="color:$warning;">`bullet`</mark><mark style="color:$warning;">属性下，</mark>由模组提供的特殊属性`extras`中的子对象`missile`，区别于弹种切换功能中位于顶层键的`extras`属性，请特别注意配置项所处结构是否正确。该对象的基本可配置参数如下所示：

<table><thead><tr><th width="185">属性名</th><th width="108.99993896484375">简述</th><th>说明</th></tr></thead><tbody><tr><td><code>is_missile</code></td><td>制导启用</td><td>该弹药数据是否被视为制导弹药</td></tr><tr><td><code>guidance_type</code></td><td>制导模式</td><td>导弹使用的制导模式</td></tr><tr><td><code>guidance_delay</code></td><td>启动延迟</td><td>发射后多久由TacZ原版子弹逻辑转为制导模式</td></tr><tr><td><code>flight_profile_type</code></td><td>导引逻辑</td><td>导弹制导的弹道逻辑</td></tr><tr><td><code>max_speed</code></td><td>最大速度</td><td>导弹可达到的最大速度，区别于Tacz自带<code>speed</code>参数</td></tr><tr><td><code>thrust</code></td><td>加速度</td><td>导弹从静止达到最大速度的快慢</td></tr><tr><td><code>fuel</code></td><td>导弹油量</td><td>在多少Tick后，导弹耗尽油量变为TacZ原版子弹逻辑</td></tr><tr><td><code>acceleration_limit</code></td><td>过载限制</td><td>导弹的转向能力将由重力，实时速度与此项共同决定</td></tr><tr><td><code>is_simple_locking</code></td><td>锁定限制</td><td>导弹是否可通过开镜瞄准直接进行锁定</td></tr><tr><td><code>must_locking</code></td><td>发射限制</td><td>该武器在未锁定目标时能否进行开火</td></tr></tbody></table>

### 了解制导模式

当前，Arcana 共提供三种合法的制导模式（即属性`guidance_type`）以及一种空模式以便于机制开发。每种制导模式会要求额外的配置项，在操作模式上也有较大不同。此处列举出计划中和当前可用的全部制导模式。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://hamsterbaron.gitbook.io/hamsterbaron/augment-guide/guidedweapon.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.