PaperChat

插件

· 作者 DoMax

一个 PaperMC 插件,让服务器用户可以在玩 Minecraft 的同时,内置一个大型语言模型(LLM)!

0 本站下载 0 关注 更新于 1 年前

最新 1.1.0-beta · 1.21.8 · Paper

一键开服(送7天)

PaperChat - 基于 AI 的 Minecraft 插件

PaperChat 是一款 Minecraft 服务器插件,可将 AI 语言模型直接集成到 Minecraft 中。它允许玩家向 AI 助手发送消息并快速获取回答,从而创建由 Google Gemini 和 OpenAI 模型驱动的自然对话体验,并且您还能添加自己的模型!

该插件专为 PaperMC 服务器构建,为每位玩家维护对话历史记录,并在 Minecraft 玩家与现代 AI 能力之间提供无缝连接。

项目理念

PaperChat 遵循“自行运行”的理念。通过要求您使用自己的 AI API 凭据和本地部署,您可以获得:

  • 无速率限制 - 您的 API 密钥,您的使用配额
  • 完全隐私 - 玩家的对话永远不会离开您的基础设施
  • 完全控制 - 自定义 AI 行为、系统提示词和响应过滤
  • 无依赖项 - 除了 AI 提供商本身之外,无需任何外部服务

功能

  • 多提供商 AI 支持:自动注册 Google Gemini 和 OpenAI 提供商,并具有易于扩展性
  • 持久化对话历史:每位玩家的聊天会话,可配置的历史记录限制
  • 智能错误处理:用户友好的错误消息,带有自动响应恢复功能
  • 可配置的系统提示词:定义 AI 行为和响应格式化规则
  • 输入验证:字符限制
  • 异步处理:非阻塞 AI 请求以维持服务器性能
  • Docker 就绪:完整的容器化部署,内置 Minecraft 服务器

配置

PaperChat 通过环境变量进行配置:

变量 描述 值
PAPERCHAT_API_KEY 您的 AI 提供商 API 密钥 your-api-key(仅由您的提供商要求。如果某个 AI 提供商不需要 API 密钥,您可以留空)
PAPERCHAT_MAX_HISTORY 每位玩家保存的最大过去请求数 对话历史记录限制
PAPERCHAT_PROVIDER 可用的 AI 提供商之一 AI 提供商(更多详情请参见 可用提供商)
PAPERCHAT_MODEL 提供商提供的任何 LLM 要使用的模型(仅由您的提供商要求。如果某个 AI 提供商不需要设置模型,您可以留空)
PAPERCHAT_TEMPERATURE 响应创造性 (0.0-1.0) 0.7
PAPERCHAT_TIMEOUT 请求超时时间(秒) 30
PAPERCHAT_MAX_INPUT_CHARACTERS 最大输入消息长度 100
PAPERCHAT_MAX_OUTPUT_TOKENS 最大响应长度 4096
PAPERCHAT_SYSTEM_PROMPT 用于 AI 行为的自定义系统提示词 您的自定义提示词(留空则使用默认系统提示词)

或者位于 data/plugins/PaperChat/ 目录中的 config.yml 文件:

ai:
  api-key: ""  # 如果您的提供商不需要 API 密钥,您可以将其留空
  provider: "google"
  model: "gemini-2.5-flash"  # 如果您的提供商不需要模型参数,您可以将其留空。不过,目前仅 HackClub 提供商如此
  temperature: 0.7
  timeout: 30
  max-output-tokens: 4096
  system-prompt: ""  # 在此处包含您的自定义系统提示词

# 注意:在此处设置系统提示词将覆盖当前提示词
# 如果留空,将使用默认系统提示词

# 聊天配置
chat:
  max-history: 5
  max-input-characters: 100

config.yml 中的配置与环境变量匹配。如果两者都设置了,环境变量优先。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源