> 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/mechanic-guides/option.md).

# 基础参数 / Option

## 基本设定项

Arcana 每个机制配置文件通过开头的四个基础键值对来完成标识，它们分别用于告诉游戏这些机制在逻辑层面的代号，并用于指定哪些 Tacz 枪械物品应当拥有这些机制。通过这四个键值对，游戏即可识别并正确应用相应的机制。

```yaml
Name: "ExampleName" #程序内部的识别名，用于管理
Lore: "TestLore" #匹配的Lore物品词条，可为空
Attachments: #匹配的配件列表，可为空
- "someid:attachment"
Guns: #匹配的枪械列表，可为空
- "someid:gunid"
```

### Name \[标识名]

该键值对用于给定机制一个内部标识名，主要用于故障排查，拓展包制作时的机制绑定索引以及后续的游戏内便捷操作调用。该值可不唯一，但一般推荐与文件名一致便于管理。可使用中文。

### Lore \[匹配描述字段]

该键值对用于告诉 Arcana 具有何种描述字段的 Tacz 枪械物品可使用这一技能，或者说“具有该机制”。多个不同的机制配置可拥有同样的匹配文本，因此该值不唯一。

```
Lore: "Test"
```

> Arcana 对于物品Lore检测目前仅有子串匹配模式(substring matching)，即仅需包含所设定的字符串程序则判定对应物品拥有该机制。我们正在尽快更新更灵活的正则匹配模式。
>
> 例如，当机制A设定的匹配字符串为"Example"时，具有"ExampleString"这个描述文本的物品也能通过判定，被认为能够具有该机制。而如果另一机制B的匹配字符串为"ExampleString"，则该物品会同时拥有A,B两个机制。同理，该物品也能够拥有所有匹配"String"的机制配置。因此请各位制作者注意避免机制文本重复识别导致的非意料之中的机制安装。

### Attachments \[匹配配件]

该序列用于指定哪些配件与该机制绑定，即在该序列中的配件，被安装至 Tacz 枪械物品上后，该物品则自动拥有绑定了这个配件的所有机制。此项可为空。

```yaml
Attachments:
- "tacz:vert_grip"
- "tacz:stock"
#如果此项为空的话，可直接不写此键值对或使用以下格式
Attachments: []
```

### Guns \[匹配枪械]

该序列用于指定哪些枪械默认与该机制绑定，即在该列表中的枪械(GunId)，默认拥有此机制，且在改装之后仍然拥有该机制。此项可为空。

```yaml
Guns:
- "tacz:ak47"
- "hamster:luger_p08"
#如果此项为空的话，可直接不写此键值对或使用以下格式
Guns: []
```

{% hint style="danger" %}
**格式警告** : Attachment 与 Guns 两个序列的录入格式必须准确，否则可能出现重载成功但游戏内安装配件或拿出枪械后无反应的问题。即使该机制只绑定了一个配件或枪械，也需要按此格式录入。
{% endhint %}

> 对于拓展包制作者，更推荐使用拓展包目录下的索引文件来将拓展包内的武器与机制绑定并一起分发，机制配置中的Guns列表主要是为了方便服务器和整合包的开发所设计的。对于如何将做好的机制文件打包并随 TacZ 拓展资源包一并分发，详见[打包与分发](/hamsterbaron/mechanic-guides/da-bao-yu-fen-fa-distribution.md)章节。


---

# 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/mechanic-guides/option.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.