# BuildAI
## 功能
BuildAI 是一个创造模式实用工具，允许各种大型语言模型在游戏中建造结构。 该插件仅供娱乐，**AI 模型通常不够先进，无法建造出任何好的东西**。
## 设置
在服务器上安装该插件并启动服务器后，将在以下目录中创建一个 config.yml 文件：
`plugins/BuildAI`。 在此文件的底部，您可以配置要使用的提供程序。 您应该能够添加所有常见的提供程序，例如 OpenAI 或 Anthropic（两者均未测试！），但如果您在您的 PC 上运行服务器，我建议[Ollama](https://ollama.com/)，因为它允许您免费在本地运行 LLM。
## 用法
作为操作员，您可以使用命令：
`/aigenerate {model_preset} {x1} {y1} {z1} {x2} {y2} {z2} {somevar=somevalue} {prompt}`。 您可以使用木铲进行选择并使用命令：
`/aigenerate {model_preset} {somevar=somevalue} {prompt}`。 变量 ("somevar") 可以在 config 中进行配置。
## 安全性
大多数提供程序需要 API 密钥才能访问其模型。 保护好此密钥至关重要，因为拥有访问权限的任何人都可以未经您的同意使用该模型。 此插件提供了两种主要的 API 密钥存储方法：
1. **在 `config.yml` 文件中存储密钥：**
虽然此方法可以防止玩家直接查看密钥，但您应该仔细考虑谁可以访问配置文件。 此外，请注意，相关的命令缺乏垃圾邮件保护，因此请确保只有受信任的个人才能执行它。
2. **在配置中使用 `%api-key%` 并允许玩家输入他们自己的密钥：**
重要的是要理解，拥有终端访问权限的任何人都可以查看 API 密钥。 对于玩家来说，除非您拥有服务器，否则强烈建议不要输入您的 API 密钥。
## 版本
BuildAI 是使用[Paper](https://papermc.io/downloads/paper) 1.20.1 开发的，并且主要使用此版本进行测试。 它应该能够在 1.13 之后的基于 bukkit 的所有软件的所有版本上运行。
## 官方链接
- Modrinth: [https://modrinth.com/project/buildai](https://modrinth.com/project/buildai)
- 源代码: [https://github.com/KEL0002/BuildAI](https://github.com/KEL0002/BuildAI)