Note
欢迎使用版本0.3.2,当前版本修复了一些问题,将公共数据库的添加数据指令分为覆写和追加两个模式。见本次更新
Important
0.2.1版本更新将帮助命令由!!openai转为!!gamesai
目录(点击展示)
安装
在MCDR控制台中使用如下命令以安装插件
!!MCDR plugin install games_ai
或者在MCDR插件仓库中获取并安装到你的插件目录内
如果选择手动安装,请先安装Python包OpenAI,使用如下命令安装
pip install openai
使用
在任何地方输入命令!!gamesai以显示这个插件的所有功能
你也可以直接输入!!ask向AI提问或者聊天
输入!!data获取有关数据库指令的信息
Tip
更新到0.3.0及以上版本时会自动添加数据库
!!data的指令如下:
| 指令 | 用途 |
|---|---|
!!data write <key> <value> | 在公共数据库内添加一条数据,其中key不能包含空格,value可以是任意字符串 |
!!data add <key> <value> | 将value追加到公共数据库中的key中,不存在时自动创建新key |
!!data del <key> | 在公共数据库内删除一条数据,无论key是否存在 |
!!data read <key> | 读取公共数据库中key对应的value |
!!data list | 读取公共数据库中的所有内容 |
!!data list keys | 读取公共数据库中的所有key |
配置
默认配置文件结构如下:
{
"system_message": "使用简洁的语言回答,但请带有一定的情感,如果你想获取在线玩家列表,请回复get_players;如果你想获取服务器白名单(既全体成员名单),请回复get_whitelist。你是Minecraft服务器的一名机器人",
"prefix": "[GamesAI]",
"permission": 3,
"base_url":"<Your API Base URL>",
"ai_model":"<Your AI Model>",
"api_key":"<Your API Key>",
"max_history": 10
}
以下是每个参数的简介:
1.system_message:
值的类型: str
默认值:见上方文件中的内容
填入你的默认提示词,如果不填入此项,则默认使用上面文件中的值
2.prefix
值的类型: str
默认值: [GamesAI]
填入这个AI的名称,以在AI的回复之前加上一个前缀,可以包含Minecraft格式化代码
3.permission
值的类型:int
默认值:3
执行!!data等指令所必须达到的权限,见MCDR权限相关文档
4.base_url
Warning
必须填入此项,否则会导致报错
值的类型: str
默认值:<无>
填入你的API服务器地址
5.ai_model
Warning
必须填入此项,否则会导致报错
值的类型: str
默认值: <无>
填入你需要使用的AI模型
6.api_key
Warning
必须填入此项,否则会导致报错
值的类型: str
默认值: <无>
填入你的API密钥
7.max_history
值的类型: int
默认值: 10
填入每个玩家最大可的保留历史记录,与公共数据库无关
鸣谢与声明
特别感谢望海公社服务器为此插件的测试提供了基础
AI(LLM)模型生成的一切内容与此插件无关
本次更新
本次更新主要区分了!!data write和!!data add指令,一个用于覆写,一个用于追加。
本次更新还在读取数据(!!data read)之后添加了使用!!data write指令复制到输入框的功能(例如:key为test,value为test,则复制到输入框的文本为!!data write test test),但如果数据过长,可能无法复制;同时也添加了复制到剪贴板的功能
介绍文本来源:README.zh-CN.md