这个项目提供了一个基于Python的Minecraft Bedrock Edition (MCBE) 服务器端的WebSocket服务,它可以获取玩家的聊天信息,并调用GPT API实现在游戏内使用chatGPT,最终将GPT回复传回到游戏中。项目使用aiohttp和Websockets异步。
如果你问我就一个小项目,自述文件写那么多干嘛?我闲的(
目录
- 捕获玩家消息:实时获取玩家在游戏中的聊天信息。
- GPT回复生成:通过 GPT API 生成回复内容。
- 游戏显示:将 GPT 生成的回复直接发送至 MCBE 中。
- 支持上下文:通过设置
enable_history
为True
来启用会话历史记录。
确保你的环境已安装 Python 3.7+,websockets
和 aiohttp
。
-
克隆项目:
git clone https://github.com/rice-awa/MCBE_WebSocket_gpt.git cd MCBE_WebSocket_gpt
-
安装依赖:
pip install -r requirements.txt
或者单独安装:
pip install aiohttp pip install websockets
-
设置 API 密钥:
在
Websocket.py
文件中找到api_url
和api_key
,并填入你的 GPT API 信息。这里推荐使用第三方转发key,推荐使用这个 免费的apikey 当然官方APIKEY也可以。
-
服务器设置:
根据你的服务器配置,修改
ip
和port
参数。启用
enable_history
来控制是否记录会话上下文。
-
启动 WebSocket 服务器:
python Websocket.py
-
连接服务器:
在 Minecraft 聊天框输入
/wsserver localhost:8080
。 -
使用聊天命令:
聊天输入
GPT 聊天 {内容}
与 GPT 对话。这里注意每个参数需要空格隔开GPT 回复为绿色字体。
-
保存对话:
- 输入
GPT 保存
来保存对话。注意"保存"的后面不要有空格 - 保存和关闭会话后,会在根目录生成对话记录和日志。
- 输入
-
上下文
GPT 上下文
查看当前上下文状态GPT 上下文 启用
开启GPT上下文GPT 上下文 关闭
关闭GPT上下文
- 保护你的 API 密钥:不要在公共代码库中直接编写你的API密钥,可以使用环境变量或其他安全方法。
- 合法使用 API:确保你有权使用 GPT API 并遵守相关条款。不要滥用API。
- 遵守游戏规则:确保你有使用
/wsserver
指令的权限,不要违反联机服务器的游戏规则。 - 本项目仅供学习和研究使用,作者不承担任何由于滥用API或违反游戏规则导致的责任。
欢迎为项目贡献代码:
- Fork 仓库。
- 创建新的特性分支 (
git checkout -b feature/fooBar
)。 - 提交更改 (
git commit -am 'Add some fooBar'
)。 - 推送至分支 (
git push origin feature/fooBar
)。 - 提交 Pull Request。
有问题?联系我。
[ ] 提供详细的安装和配置教程。- 增加更多游戏内交互功能。
- 设计安全存储 API 密钥的方法。