> 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/help-guide/install.md).
# 安装 Arcana
Arcana 标准用户版 现已开始公开测试。该版本仍未进行充分的边缘情况测试，因此在使用 Arcana 之前建议备份您的存档避免意外损坏。项目组不对未备份的存档损失问题负责，感谢您的理解。
{% hint style="info" %}
**使用须知** : 出于制作精力问题，Arcana 不会考虑对基岩版的兼容，也不会制作 Fabric 等其他 Java Mod 版本的客户端。对 NeoForge 的支持将在 TacZ 更新至 1.21 或以上时跟进。
{% endhint %}
## 下载 Arcana 标准用户版
已发行 Arcana 仅支持 Minecraft JAVA 1.20.1，需要 Forge 47.1.0 以上版本。
### 必要前置模组
* 永恒枪械工坊：零 (Timeless and Classic:Zero) 1.1.5 及以上版本 - [点此跳转下载页](https://www.curseforge.com/minecraft/mc-mods/timeless-and-classics-zero)
* Kotlin 语言支持 (KotlinForForge) 4.11.0 及以上版本 - [点此跳转下载页](https://www.curseforge.com/minecraft/mc-mods/kotlin-for-forge)
### 可选联动模组
* Iron的法术与魔法书 (Iron's Spells 'n Spellbooks)
* 机械动力：火炮学 (CreateBigCannons)
* 瓦尔基里天空 2 (Valkyrien Skies 2)
{% tabs %}
{% tab title="CurseForge (推荐)" %}
[点击此处前往 CurseForge 模组下载页](https://www.curseforge.com/minecraft/mc-mods/tacz-arcana-timeless-and-classics-guns) - Download Arcana-beta-1.6.5
{% endtab %}
{% tab title="Mcmod 模组百科" %}
点击此处前往 MCMOD 模组下载页 - Download Arcana-beta-1.0.1
{% endtab %}
{% tab title="BaiduNetdisk 百度网盘" %}
点击此处前往百度网盘分享链接 - Download Arcana-beta-1.0.1
{% endtab %}
{% endtabs %}
## 下载 Arcana 开发版
鉴于潜在的破坏性风险与项目组人力限制，目前 Arcana 开发版仅对部分活跃 TacZ 拓展包制作者进行邀请测试。若您未收到邀请或并非拓展包制作者，也可通过服务页面的**爱发电赞助链接申请内测资格**并加入内测群聊。在申请前，请务必仔细阅读以下全部内容。
{% hint style="warning" %} **申请前须知** : 在申请加入内测计划之前，您应确保自己有足够的理解能力与基本的社交能力，并能够友好地提出问题，耐心的等待回复。如您无法达到上述要求，制作组有权在事先警告无效后取消您的内测资格。
{% endhint %}
Windows 用户开发版安装指南
请在拥有对应内测资格后联系内测群管理员申请软件激活码，并按群内指引进行开发版激活操作。
Mac OS , Linux 及其他系统用户
由于验证激活系统暂不支持这些软件系统，建议优先使用 Windows 系统或相关虚拟环境使用以避免未知的软件漏洞。如无法使用 Windows 系统，请联系内测群内管理员耐心等待问题解决。
> **为什么不直接公开开发版？**
>
> 由于 Arcana 开发组件的深度模块化和极高的自由度，不可避免的会导致一系列设想之外的功能异常。制作组精力有限，直接发布开发版可能导致大量重复问题反馈，无法一一回复。并且误操作可能导致地图存档内其他已封装好的枪械技能机制运行异常。因此，在充分测试所有功能之前，在相当一段时间内暂不会发布具有完整开发功能的版本。
>
> 此外，由于“附加特性”部分内容是基于本体所做的修改，因此即便不是完整开发版，也可以使用例如镜内放大等。如您只是想要体验 Arcana 提供的全新玩法的玩家，不希望制作自己独特的枪械机制，则无需使用开发版本。此版本主要为模组拓展包作者，整合包作者和服务器制作者服务。
***
## 下载 Arcana 官方拓展包
当前 Arcana 已推出官方拓展包“先锋重装 (Vanguard Armament)” 供您直观体验该组件所带来的独特功能。该拓展包内含数把拥有独特技能机制的枪械，并为原版的许多武器添加了诸如下挂发射器等一系列附加特性体验资源。无论您想要掌握开发功能还是只想游玩丰富的拓展内容，都建议下载官方拓展包实机体验。
{% tabs %}
{% tab title="CurseForge (推荐)" %}
[点击此处前往 CurseForge 拓展包下载页](#xia-zai-arcana-kai-fa-ban) - Download ExtendPower v1.0.0
{% endtab %}
{% tab title="Afdian 爱发电 (支持者版本)" %}
{% endtab %}
{% tab title="BaiduNetdisk 百度网盘" %}
{% endtab %}
{% endtabs %}
---
# 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/help-guide/install.md?ask=&goal=
```
`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.